cross-financial-management/PHASE_3_AP_TEST_PLAN.md

Phase 3 — Accounts Payable: Manual Test Checklist

Mirrors Accounts Receivable exactly, but for money owed to suppliers instead of money owed by customers: Suppliers, Supplier Invoices (Bills), Debit Notes, and Payments with allocation — same Draft → Post workflow, same shared PostingService, same Tax Codes. Backend correctness is already covered by tests/integration/ap.posting.spec.ts (7 tests, passing alongside AR's 7 and GL's 9) and was additionally verified over the real HTTP API by hand (create supplier → create/post invoice → create/post payment → allocate → invoice balance hit zero). This checklist is for the parts only a human can judge.

Start the same four dev servers as before and sign in through the Manager.

0. New nav items

• Sidebar shows a new Purchasing section (between Sales and General Ledger): Suppliers, Bills, Payments

1. Suppliers

• "New Supplier" requires a branch selection; creating one without a branch shows an error
• A created supplier appears in the Suppliers grid
• Branch switcher filters the Suppliers grid the same way it does Customers
• Clicking a supplier opens their detail page (the AP equivalent of Customer 360)

2. Supplier detail page

• Header shows the supplier's name and an Active/Closed status pill
• Three summary tiles: Outstanding Balance, Overdue (30+ days), Payment Terms
• A brand-new supplier with no invoices shows R0.00 everywhere
• Contact Details card shows code/email/phone/tax number (or "—" for anything empty)
• Three tabs — Invoices / Payments / Debit Notes — each show "No … yet." until you create one
• "New Invoice" and "Make Payment" buttons only appear if you have the AP permissions

3. Creating and posting a supplier invoice (Bill)

• From the supplier's page, "New Invoice" opens the form with that supplier pre-selected
• Due date auto-fills from invoice date + the supplier's payment terms and is read-only
• Adding a line, picking an expense account (only EXPENSE-type accounts for that supplier's branch are offered) and a tax code updates that line's Amount live
• Applying the STD (15%) tax code to a R1,000 line shows R150 tax and R1,150 line total
• "Save Draft" creates the invoice with status DRAFT and does not create a GL entry
• "Post Invoice" posts it — status flips to POSTED, and a new balanced entry appears in General Ledger under journal PURCHASES
• Opening that entry shows: debit line(s) to the expense account(s) for the subtotal, a debit line to Input Tax Receivable for the tax (if any), and a credit line to Accounts Payable Control for the total
• A draft invoice can be Voided; a posted invoice has no Void option — only a debit note can reverse it
• The invoice appears in the supplier's Invoices tab and in the global Bills list

4. Making a payment

• From the supplier's page, "Make Payment" opens the form with the supplier pre-selected
• "Paid from" only offers accounts marked as a Bank control account
• Posting a payment for the invoice's exact total creates a balanced GL entry: debit to Accounts Payable Control, credit to Bank, journal CASH_PAYMENT
• The posted payment's detail page shows an "Allocate Against Invoices" panel listing the supplier's open (posted, balance > 0) invoices
• "Full" fills in the invoice's exact remaining balance, capped at what's still unallocated on the payment
• Applying the allocation reduces both the invoice's balance and the payment's unallocated amount — reload both pages and confirm the numbers persist
• Over-allocating (more than the payment's unallocated amount, or more than an invoice's balance) is rejected with a clear error and changes nothing
• A part-paid invoice shows the correct partial balance on its detail page and on the supplier's Invoices tab

5. Debit notes

• Create a debit note for the same supplier, one line mirroring a posted invoice line
• Posting it creates the mirror-image GL entry: debit to Accounts Payable Control, credit to the expense account (+ credit to Input Tax if taxed) — and is balanced
• The debit note's detail page shows the same allocation panel; allocating it against the open invoice reduces both the invoice's balance and the debit note's remaining balance
• A draft debit note can be voided; a posted one cannot

6. Cross-cutting checks

• Every invoice/payment/debit-note number follows its own series (APINV-2026-######, APPMT-2026-######, APDN-2026-######) and never repeats or skips oddly
• The Dashboard's "Posted Movement by Account Type" bars now also reflect AP activity (LIABILITY bar grows from AP Control movement, EXPENSE bar grows from bills)
• Switching to a specific branch shows only that branch's suppliers/invoices/payments
• No console errors in the browser dev tools while working through this checklist

---

Once this is ticked, the plan's next step is Tax reporting (VAT/output-input reconciliation), then Stock Control + Procurement Matching (GRV/PPV, incorporating the Posting Ledger reference already reviewed).