MODULES / FINANCE
Aging Recovery Letters
English and Urdu customer recovery letters with historical balances and configurable aging.
Overview
| Module id | ask_recovery_letter |
|---|---|
| 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
| Reports / Receivables & payables | Recovery letters |
|---|
The menu entries appear once the module is installed and your role allows them.
How it links to other modules
- Needs: Accounting, Invoicing
- Works better with: Partner Categories
- Needed by: no other module
A module that is needed cannot be turned off while the module that needs it is on.
Details
Aging Recovery Letters
Port of D:/Odoo18/sparkosol/custom-addons.odoo18/ask_recovery_letter. Install Aging Recovery Letters from Settings > Modules, then open Reports > Recovery aging. Select one or more partners, salespeople, or partner categories to choose recipients; the filters combine with OR semantics. Download individual customer letters in English or Urdu. The same recipient filters and balances appear in the report table and PDF.
Each A5 landscape-sized (210 × 148 mm) letter includes company contact and bank details, customer contact, salesperson, five configurable aging buckets, total receivable, and last posted inbound receipt. Long content can continue to another page instead of being clipped. Urdu uses right-to-left layout and available system fonts (Noto Naskh Arabic/Noto Sans Arabic, then Tahoma/Arial); install one of the Noto Arabic fonts on the PDF host for consistent Urdu typography.
ASKERP adaptations: balances are reconstructed historically from the existing aged-receivable service as of the chosen date; the first bucket includes amounts not yet due, and credits reduce receivable. Only actual posted inbound payments are shown as receipts. Odoo's current-residual-only behavior and credit-note-as- payment behavior are not carried over. The saved partner name is used in both languages because ASKERP has no Urdu-name field. Recipients must be customers; the active company is selected through ASKERP's company switcher and protected by RLS.
No migration or new ledger path is required. Access requires this module, Accounting, Sales, and report-read permission. Disable/reinstall preserves source records. The PDF route is company-scoped and does not load external assets.
Tests: npx vitest run addons/recovery-reports/addon.test.ts server/reports/registry.test.ts lib/nav.test.ts lib/modules.test.ts.