Credit notes

A credit note reverses some or all of a finalized invoice. The accounting model is strict: a credit note carries its own immutable number, references the original invoice, and posts a negative amount that nets against the customer balance. You can apply a credit note to an open invoice (offsetting payment) or refund it via the original payment gateway when supported. The PDF rendering uses a distinct template so customers can tell at a glance.

Tax treatment follows the credit-note rules of the tenant's tax profile (e.g. ZATCA Phase 2 mandates a UBL credit note with the original invoice's UUID).

Related endpoints

• GET /api/tenant/credit-notes — list.
• POST /api/tenant/credit-notes — create against a specific invoice.
• POST /api/tenant/credit-notes/:id/apply — apply to another open invoice.
• POST /api/tenant/credit-notes/:id/refund — push refund to the original gateway.

See the source at apps/web/src/app/(tenant)/credit-notes and apps/api/src/credit-notes.