MODULES / FINANCE
Physical Cheque Management
Track cheques held, endorsed, deposited, partially settled, bounced and returned using the ordinary accounting ledger.
Overview
| Module id | ask_pdc_management |
|---|---|
| Version | 1.0.0 |
| Who uses it | Anyone who uses the screens listed below. |
| Installed | On demand, from Settings → Modules. Anything it needs is installed with it. |
Where to find it
| Accounting | Physical cheque management |
|---|
The menu entries appear once the module is installed and your role allows them.
How it links to other modules
- Needs: Post-Dated Cheques
- Works better with: no other module in particular
- Needed by: no other module
A module that is needed cannot be turned off while the module that needs it is on.
Details
Physical Cheque Management
Adapted from D:/Odoo18/asksol/custom_addons/ask_pdc_management as an optional extension to ASKERP's existing ask_pdc register. The ordinary PDC workflow remains available for records created before this extension; new cheques use the management page when the extension is enabled.
Accounting behavior
Configure one active current-asset account as Cheques in Hand. The addon creates dedicated PDC Received and PDC Paid journals using that account; it does not change an existing bank or cash journal. Receiving a customer cheque posts a normal inbound payment to Cheques in Hand and Accounts Receivable. Issuing a vendor cheque or endorsing a received cheque to a vendor posts a normal outbound payment to Accounts Payable and Cheques in Hand. These payment transitions use ASKERP's approval-aware posting service.
Depositing a customer cheque records the physical step only. Each full or partial amount credited by the bank creates one balanced entry through the normal ledger posting engine: bank/cash debit and Cheques in Hand credit. The register derives settled and remaining amounts from immutable settlement entries. A bounce or return reverses any live settlement entries and cancels the linked payment, which reopens the customer/vendor open item. The reason is kept in the managed-cheque record and its audit event.
If FIFO payment reconciliation is installed, its ordinary payment posting behavior applies. Otherwise the payment remains an open partner credit/debit for reconciliation through the existing payment workflow. The addon does not duplicate reconciliation logic. Returning a customer cheque uses ASKERP's payment reversal path rather than creating a second, manually matched payment.
The dedicated journals and cheque-in-hand account are protected from settings changes while configured. Managed terms and payment/settlement history are company-scoped and immutable after creation. Disabling this module hides the workflow while retaining the register and ledger evidence; reinstalling it restores access. Migration 0125_pdc_management.sql adds forced-RLS tables and database guards.
Validation
npx vitest run addons/ask_pdc_management/addon.test.ts
The tests cover receipt posting, partial/full bank settlement, vendor payment, customer cheque endorsement, bounce reversal, concurrency, tenant isolation, and persistence across disable/reinstall.