Credit Notes
A credit note reverses or adjusts an already-fiscalised invoice - returns, cancellations, and pricing corrections. Unlike an invoice, a credit note is an application: URA reviews and approves it before issuing its FDN. Approval is done by URA only - you apply, track, void or cancel.
/query-credit-notes, /query-credit-note-details) → once approved, retrieve the credit
note's FDN and QR code via /invoice-details.Time limit: a credit note cannot be submitted after the URA-configured maximum number of days from the original invoice date.
A credit note reverses the original invoice, so its quantities and amounts are negative.
A. Credit note against an original invoice
{
"credit_note": {
"oriInvoiceNo": "322000150744",
"applicationTime": "2026-06-01 10:00:00",
"sellersReferenceNo": "CN-2026-001",
"remarks": "Customer returned defective goods",
"goodsDetails": [
{
"item": "Premium Water 500ml",
"qty": "-1",
"unitPrice": "100000",
"total": "-100000",
"tax": "-15254.24",
...
}
],
...
}
}
Want a working example of a credit note application? Chat with our team
Response: data contains a referenceNo - keep it to track the
application through approval.
Credit notes can be raised for returned goods (expired, damaged, and so on), a cancelled purchase, a miscalculated price, tax or discount, a full or partial waiver after the invoice was issued, or any other reason you describe.
Excise items can be credited too - the original excise details carry over to the credit note. Supporting documents can optionally be attached to the application.
Credit note for a receipt
A receipt carries no VAT, so neither does its credit note. Mark it as a receipt and leave out every tax
field - the net and gross amounts are the same. Everything else follows scenario A, and the response is the
same referenceNo.
{
"credit_note": {
"oriInvoiceNo": "326044358128",
"applicationTime": "2026-06-01 10:00:00",
"sellersReferenceNo": "CN-2026-002",
"goodsDetails": [
{
"item": "Premium Water 500ml",
"qty": "-2",
"unitPrice": "100000",
"total": "-200000",
...
}
],
"summary": {
"netAmount": "-200000.00",
"grossAmount": "-200000.00",
...
},
"basicInformation": {
"invoiceKind": "2"
},
...
}
}
Want a working example of a receipt credit note? Chat with our team
B. Credit note without an original FDN
Credit notes can also be raised without an original FDN - for example for invoices issued before your business adopted EFRIS. The request looks the same as scenario A, without the original invoice references.
C. Tracking applications
| Endpoint | Purpose |
|---|---|
POST /query-credit-notes |
Paginated list of credit/debit note applications, with optional filters |
POST /query-credit-note-details |
Details of a single application |
POST /query-credit-note-application-details |
Query credit note / cancel-debit-note application details |
D. Cancelling & voiding
| Endpoint | Purpose |
|---|---|
POST /cancel-credit-note |
Cancel an already-approved credit note |
POST /void-credit-note |
Void a pending (not yet approved) application |
POST /query-canceled-credit-notes-details |
Query cancellation details |
E. Checking what is left to credit
An invoice can be credited in several applications, but never beyond its original quantities. This returns the invoice with only what can still be credited on each line - call it before applying.
{
"invoiceNo": "322000150744"
}
Want a working example of checking what is left to credit? Chat with our team
What comes next
Once an application is approved, fetch the credit note's own FDN and QR code with
POST /invoice-details - the response structure is described in
Invoice Response. For debit notes (which increase an
invoice's value instead of reducing it), see
E-Invoices, scenario H.
Sign in to the dashboard · Get started