MODULES / FINANCE

Physical Cheque Management

Track cheques held, endorsed, deposited, partially settled, bounced and returned using the ordinary accounting ledger.

Overview

Module idask_pdc_management
Version1.0.0
Who uses itAnyone who uses the screens listed below.
InstalledOn demand, from Settings → Modules. Anything it needs is installed with it.

Where to find it

AccountingPhysical 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.

Physical Cheque Management | ASKERP Docs