SRV-18 — Billing V1 — invoices, payments, declarations, credit control

SummaryCopy Anchor Link

Invoices with legal mentions and statuses, payment recording and reseller declarations with proof, allocations, credit limit/exposure used at checkout, reseller finance summary.

DescriptionCopy Anchor Link

V1 finance covers invoices, payments, reseller payment declarations and basic credit control (cahier §4.7, §5; FIN-01…FIN-05, FIN-10, ACL-04). This task generates invoices from orders at billing.invoiceOn (default SHIPPED) with InvoiceLine snapshots, FAC-YYYY-NNNNNN numbers and the legal mentions of the invoice template (DQA-09), tracks InvoiceStatus (UNPAID, PARTIALLY_PAID, PAID, OVERDUE by a daily job, CANCELLED), records payments in the back-office and reseller declarations with proof (PaymentStatus PENDING_VERIFICATION → CONFIRMED/REJECTED with reason), allocates payments to invoices (oldest first or manual), and maintains CreditAccount (ceiling, exposure, available) with CreditLimitChange history and the credit check used at checkout and at validation. Credit notes from returns (SRV-20) reduce the balance. It exposes the reseller finance summary. Financial data is visible only to authorised roles (ACL-04). Out of scope: due dates, reminders and accounting exports (V2, SRV-32) and the finance pages (DSH-07).

SubtasksCopy Anchor Link

DeliverablesCopy Anchor Link

• apps/server/src/modules/billing/{invoices,payments,allocations,credit}.{service,router}.ts, jobs.ts, pdf/invoice.tsx
• packages/contracts/src/{finance.ts,admin/finance.ts}
• Invoice legal mentions checklist signed off with HOCO

Acceptance criteriaCopy Anchor Link

• An order reaching SHIPPED (default) gets exactly one invoice with totals equal to its lines (FIN-01)
• A declared payment stays PENDING_VERIFICATION and does not change invoice status until confirmed (FIN-03)
• A payment of 150 000 DA against two unpaid invoices of 100 000 DA each leaves one PAID and one PARTIALLY_PAID (FIN-04)
• A credit checkout that exceeds the available credit returns 422 CREDIT_LIMIT_EXCEEDED under BLOCK policy (FIN-05)
• A user without finance.view gets 403 PERMISSION_DENIED on admin.invoices.list and sees no credit fields elsewhere (ACL-04)
• finance.summary returns balance, available credit, unpaid invoices and recent payments for the reseller only (FIN-10)

Requirements coveredCopy Anchor Link

ScreensCopy Anchor Link

API surfaceCopy Anchor Link

Test measuresCopy Anchor Link

• DB tests for allocation and status computation including credit notes
• Unit tests for exposure computation
• PDF snapshot test of the invoice with a sample order

RisksCopy Anchor Link

• Algerian invoicing specifics (stamp duty on cash payments, mandatory mentions) not confirmed — checklist reviewed with HOCO's accountant before the template is frozen

KPICopy Anchor Link

• Delivered by Mon 19 Oct 2026 within 1 person-day(s).
• Every acceptance criterion above demonstrated before hand-off; linked requirements' acceptance criteria pass.
• Zero open critical defects, permission gaps or data-integrity regressions at sign-off.

---

Generated from content/plan/tasks.json by scripts/generate-team-tasks.mjs. Dates are computed by the scheduler (Sunday–Thursday weeks, holidays excluded) — change the plan, not this page.