Modern POS Invoice Module
Sales invoices, purchase invoices, AR/AP, returns, credit notes, reporting, and modern document features
Last Updated: June 7, 2026
UI Routes Task Route Sales invoices (default) /dashboard/invoicesNew sales invoice /dashboard/invoices/newPurchase invoices /dashboard/invoices/purchaseNew purchase invoice /dashboard/invoices/purchase/newCustomer advances /dashboard/invoices/advancesAR/AP reports /dashboard/invoices/reportsRecurring templates /dashboard/invoices/recurring
Permissions Sales Invoices Permission Purpose invoices:listView invoices and returns invoices:createCreate draft invoices invoices:updateEdit draft invoices invoices:approveIssue draft invoices invoices:cancelCancel invoices invoices:paymentRecord receipts, advances, split payments invoices:returnCreate and approve invoice returns / credit notes
Purchase Invoices Permission Purpose purchaseInvoices:listView purchase invoices and supplier returns purchaseInvoices:createCreate draft purchase invoices purchaseInvoices:updateEdit draft purchase invoices purchaseInvoices:approveReceive purchase invoices (inventory + AP) purchaseInvoices:cancelCancel purchase invoices purchaseInvoices:paymentRecord supplier payments purchaseInvoices:returnCreate and approve supplier returns / credit notes
Recurring Invoices Permission Purpose recurringInvoices:listView recurring templates recurringInvoices:createCreate templates recurringInvoices:updateUpdate templates and run due generation recurringInvoices:deleteDelete templates
API Endpoints Sales Invoices — /api/v1/invoices
Full CRUD, payments, split payments, advances, returns, QR verify, PDF/email receipts
Purchase Invoices — /api/v1/purchase-invoices
Full CRUD, receive, payments, returns, QR verify
Recurring — /api/v1/recurring-invoices
Template CRUD and POST /run-due scheduler endpoint
Reports Method Path Description GET /api/v1/reports/invoices/overviewSales invoice KPIs GET /api/v1/reports/invoices/ar-agingReceivables by days outstanding GET /api/v1/reports/purchase-invoices/overviewPurchase invoice KPIs GET /api/v1/reports/purchase-invoices/ap-agingPayables by days outstanding GET /api/v1/reports/invoices/profitGross profit by product
Features Implemented
Sales invoices: customer snapshot, shipping, terms, multi-currency fields, QR payload, WhatsApp share link, card/cheque payments, split payments, credit notes on returnsPurchase invoices: supplier snapshot, AP balance tracking, inventory increase + weighted average cost on receive, supplier payments, supplier returns with credit notesAccounting: AR/Revenue/VAT on sales issue; Inventory/Input VAT/AP on purchase receive; payment and return reversalsReports: receivables by days outstanding (current, 1-30, 31-60, 61-90, 90+), payables by days outstanding (current, 30, 60, 90, 120+), profit by productModern: QR verification, recurring invoice templates, electronic signature on purchase receive, branch-prefixed numbering
Business Rules Sales invoice
Draft does not affect inventory or accounting
Issue decrements stock, posts AR/Revenue/VAT, generates QR payload
Split payments create multiple receipt records in one transaction
Purchase invoice
Draft does not affect inventory or supplier balance
Receive increases stock, updates product average cost, posts Inventory/Input VAT/AP, updates supplier currentBalance
Supplier payment reduces AP balance and posts Cash/AP entries
Returns
Customer returns generate credit note numbers and restock good items only
Supplier returns decrement restockable items and reduce AP balance