For credit notes ((BT-3) has the value of 381) and debit notes ((BT-3) has the value of 383), the billing reference ID (BT-25) is mandatory.
What does this mean?
A credit note and a debit note are corrective documents, and a correction that does not say what it corrects means nothing. That is why field BT-25 (Billing Reference ID) is mandatory on every document of type 381 or 383, and carries the number of the original invoice.
Why does it happen?
Ordered from the most common to the least — your cause is most likely the first or the second.
- Issuing a standalone note as an adjustment with no reference invoice.
- The original invoice number sitting in the reason text instead of field BT-25.
- A note that corrects several invoices, so the field is left empty because no single invoice can be chosen.
-
An empty reference field, or one holding a space, which
BR-KSA-F-06-C22rejects because the minimum is one character.
How to fix it
2 steps, then send the invoice again.
-
1
Link the note to one specific invoice
Put the original invoice number, exactly as it was issued, in BT-25, along with the reason for issuing that
BR-KSA-17requires. -
2
Several invoices mean several notes
If the correction covers three invoices, issue three notes, each linked to its own invoice. A single note with no reference will be rejected, and linking it to one invoice arbitrarily leaves your records inconsistent.
This code does not block acceptance, so the invoice you have is compliant. Correct the data so the warnings disappear from future invoices.
Does ZATCA Tools prevent it?
Yes. Credit and debit notes in ZATCA Tools are created from the invoice itself, so the reference is filled in automatically and no orphan note can be issued.
Related codes
Frequently asked questions
What is the difference between a credit note and a debit note? +
Does a note need to be signed and reported like an invoice? +
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