Hibou Odoo Suite: Accounting Modules: Payment Disperse

Repository Versions:

Modules:

Author:

Hibou Corp.

License:

AGPL-3

Purpose

This documentation outlines the use cases and processes of Hibou's Payment Disperse module for Odoo 12.

The Payment Disperse module allows users to pay multiple invoices or vendor bills at once and manually disperse the amount paid per invoice. It also provides the ability to pre-populate payment amounts based on the remaining balance or the amount due.

Getting Started

First thing's first, we want to install the module! Navigate to the Apps application.


Once there, remove the 'Apps' filter, then search for 'Payment Disperse'. When ready, click install.

Odoo CMS - a big picture

Good to Know!

This module requires Odoo's Invoicing module. However, if you do not already have this module installed, Odoo will install it for you during this modules installation!

Processes

To get started, navigate to the Accounting app.

Odoo - Sample 1 for three columns

Manually Dispersing PaymentsTo

To disperse payment across invoices, select customers > Invoices

To disperse payment across vendor bills, select VendorsBills.

This will bring you to a list view of customer invoices or vendor bills (both are invoice types). Use the  Filters > Open menu option to list only those that are pending payment.

Select all of the invoices that you wish to register payment on by checking the checkbox next to each invoice. Once all have been selected, select Register Payment from the Action dropdown menu.

Odoo CMS - a big picture

This will present a pop-up modal to register a payment. Once the Disperse Manually checkbox is selected, another section of the form will appear. Here you will see lines for each of the selected invoices.There are two new buttons to easily fill amounts on the invoice lines:

  • Fill With Remaining: Pre-populate amount with the remaining amount.
  • Fill With Due: Pre-populate amount with the amount due, which can be seen in the Due column.

    • Note: You can set the date off of which to calculate amount due using the Due Date Cutoff field.

You can choose to leave an open balance, displayed in the Difference column, or write-off the difference.

Odoo CMS - a big picture

Technical

This module adds a new transient model to the Register Payment wizard `account.register.payments.invoice.line`. Additionally, it adds several fields to the `account.register.payments` wizard in order to link invoices for payments as well as journals for write-offs:

  • `is_manual_disperse` Boolean field to indicate if the payment should be dispersed manually

  • `invoice_line_ids` One2many field for Invoices

  • `writeoff_journal_id` Many2one field for the Write-off journal

  • `due_date_cutoff` Date field for cutoff date

 The `account.payment` model also receives a new method `_create_payment_entry_manual_disperse` to create and validate payments, as well as reconcile the invoice lines with the payment.