Credit Notes — POST /credit-notes

LIVE · FTA SYNC
Live demo · illustrative data, not a real client environment.Reporting and visibility only; accreditation remains with the ASPs and software vendors.Legal disclaimerWhat is TaxFlow Cockpit?

UAE Credit Notes: Multi-Invoice & Partial Credits

Issued today

46

all document types

Multi-invoice

14

reference 2+ originals

Partial credits

68.4%

of issued volume

Value credited

AED 1,284,600

today

Rejected

1

validation failure

Issue a Credit Note

Original invoiceCounterpartyOriginalRemainingCredit amount
Client C · AviationEtisalatAED 48,720AED 40,320
Client D · HealthcareFABAED 96,120AED 96,120
Client F · IndustrialsClient E · LogisticsAED 1,840,000AED 1,720,000
Client A · Real EstateEmirates NBDAED 184,240AED 184,240
self-billedGulf Logistics ServicesClient E · LogisticsAED 742,800AED 742,800
self-billedMedline Supplies LLCClient D · HealthcareAED 268,900AED 242,010
Document typeCredit Note
Invoices referenced1
Reason codepricing_correction
Total creditAED 9,212

Ready to submit — passes multi-reference and partial-credit checks

Endpoint Contract

POST /credit-notes
Content-Type: application/json

{
  "document_type": "credit_note",
  "self_billing_indicator": false,
  "reason_code": "pricing_correction",
  "issuer_trn": "100412887600003",
  "counterparty_trn": "100558123400003",
  "references": [
    { "invoice_id": "INV-2026-184201",
      "credited_amount": 9212.00 },
    { "invoice_id": "INV-2026-184044",
      "credited_amount": 14800.00 }
  ],
  "currency": "AED"
}

201 Created
{ "credit_note_id": "CRN-2026-009126",
  "status": "accepted",
  "fta_ack": "pending" }

422 pint_ae_invalid
{ "errors": [ ... ],
  "suggested_correction": { ... } }
  • One credit note may reference many original invoices, each with its own credited amount.
  • Partial credits are accepted; the sum per invoice may not exceed its remaining creditable value.
  • If any referenced invoice is self-billed, the note is issued as a self-billed credit note with the mandatory indicator.

Credit Note Register

Credit noteTypeIssuer → CounterpartyReferencesReasonCreditedFTAStatus
CRN-2026-0091142026-06-05Credit NoteClient C · AviationEtisalatINV-2026-183990 · AED 8,400Pricing correctionAED 8,400partialDelivered
CRN-2026-0091212026-06-05Credit NoteClient F · IndustrialsClient E · LogisticsINV-2026-184171 · AED 84,000INV-2026-183902 · AED 36,000multi-invoiceGoods returnedAED 120,000partialDelivered
CRN-2026-0091262026-06-05Credit NoteClient A · Real EstateEmirates NBDINV-2026-184201 · AED 9,212INV-2026-184044 · AED 14,800INV-2026-183871 · AED 6,400multi-invoicePost-sale discountAED 30,412partial·In Transit
SBC-2026-0044092026-06-05Self-Billed Credit NoteClient A · Real EstateFalcon Facility MgmtSBI-2026-004301 · AED 32,400Service not renderedAED 32,400partialDelivered
SBC-2026-0043982026-06-05Self-Billed Credit NoteClient E · LogisticsHarbour Crane RentalsSBI-2026-004288 · AED 41,200SBI-2026-004290 · AED 13,000multi-invoicePricing correctionAED 54,200partialDelivered
CRN-2026-0091312026-06-05Credit NoteClient B · Real EstateDubai HoldingINV-2026-183744 · AED 118,000Duplicate invoiceAED 118,000full·Rejected