BR-KSA-17 Rejects the invoice

Note issued with no reason

Every credit or debit note must carry the reason it was issued in a dedicated field. The original invoice alone is not enough: the Authority asks for the reason text itself, and its absence rejects the whole note.

The message text as the Authority sends it in English, unedited

Debit and credit note (invoice type code (BT-3) is equal to 383 or 381) must contain the reason (KSA-10) for this invoice type issuing.

What does this mean?

The rule applies to notes only — documents whose type (BT-3) is credit 381 or debit 383. Ordinary invoices are not asked for a reason.

The reason is a data field (KSA-10) inside the note file, not a free-text remark on the printed page.

This rule is not the original-invoice reference rule: a note needs both — the number of the invoice it corrects, and the text of the reason for correcting it.

Why does it happen?

Ordered from the most common to the least — your cause is most likely the first or the second.

  • A store integration that turns returns into notes without passing the return reason through from the platform.
  • An issuing screen that makes the reason field optional, or drops it from the request when it is left empty.
  • A note template built by copying the invoice template, where the reason field does not exist in the first place.

How to fix it

2 steps, then send the invoice again.

  1. 1
    Write the actual reason in one short sentence

    Clear text is enough: goods returned, price correction, or a discount agreed after issuing. What matters is that it describes what really happened — it is part of a tax document that will be referred back to.

  2. 2
    Make the field mandatory in your system

    If notes are issued from an integration or a form, make the reason a field that cannot be skipped, and pass it from the source of the transaction (the return reason in the store, for example) instead of leaving it to memory.

Once corrected, send the invoice again. A rejected invoice was never recorded with the Authority, so it needs no credit note — send the corrected invoice itself.

Does ZATCA Tools prevent it?

Yes. A note in ZATCA Tools is only created linked to an original invoice and with a written reason for issuing — the system refuses to save it without one.

Related codes

Frequently asked questions

What do I write in the reason? +
What actually happened, briefly: a return, a cancellation, a quantity or price correction, a later discount. The full steps are in how to issue a credit note.
Does quoting the original invoice number remove the need for a reason? +
No. The reference (BT-25) is one rule and the reason (KSA-10) is another, and the absence of either rejects the note — see also BR-KSA-56, which covers the reference.
When do I choose a credit note and when a debit note? +
A credit note reduces the value of an earlier invoice; a debit note increases it. The differences and the cases are in credit and debit notes.
You fixed this one — now avoid the next

ZATCA Tools builds the signature, the PIH, the counter and the encoding for you, and validates your data before it is sent. Completely free for now, and no credit card.

Start for free

← All ZATCA error codes