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: it goes through an approval step before URA issues its FDN.

Flow: original fiscal invoice → apply for credit note → track approval status (/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.
POST/apply-for-credit-note

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.

Note: Export invoices cannot apply for a credit note.

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 & approving 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 /approve-credit-note Approve or reject an 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

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 Fiscal Invoices, scenario H.

Looking for the complete reference? Field definitions, code lists, validation rules, error handling, and ready-to-run examples for every endpoint are available inside your EFRIS Simplified dashboard once your business is registered on the platform.
Sign in to the dashboard · Get started

Stuck on an integration step? Our engineers reply fast.