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.

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.

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

POST/query-invoice-remain-details

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.

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.