Invoices

Invoices are the canonical billing artifact. Each invoice is immutable once finalized — edits after that point produce a credit note plus a fresh invoice (see Credit notes). The detail screen at Sales → Invoices → :id shows the line items, applied tax rules, payment history, the rendered PDF preview, and a payment link the customer can pay via any enabled gateway (see Payment gateways). E-invoice compliance (KSA ZATCA Phase 2, EU EN 16931) is opt-in per customer — see E-invoice.

Recurring invoices are a separate entity (see Recurring invoices) that generates invoices on a schedule.

Related endpoints

• GET /api/tenant/invoices — list with status, customer, date range filters.
• POST /api/tenant/invoices — create draft.
• POST /api/tenant/invoices/:id/finalize — issue (assigns invoice number, locks).
• POST /api/tenant/invoices/:id/send — email the PDF to the customer.
• POST /api/tenant/invoices/:id/payments — record an offline or online payment.
• GET /api/tenant/invoices/:id/pdf — download the rendered PDF.

See the source at apps/web/src/app/(tenant)/invoices and apps/api/src/invoices.