ZATCA answers a submission with a list of rules, each with an identifier you can quote back. Some are errors, which stop the document; some are warnings, where the document is accepted but something should still be put right before it becomes an error in a later version of the rules.
The five usual causes
-
No buyer VAT number on a tax invoice
A tax invoice to a registered business must identify that business. Add the VAT number to the customer record rather than to the invoice — it will be needed on every document you ever raise for them.
-
An incomplete national address
A building number that is not four digits, an empty district, or a postal code that is not five. This applies to your own address as well as the customer's, and it is the most common reason an onboarding compliance check fails.
-
An exemption reason that does not match the category
Every exempt or zero-rated line needs a reason from ZATCA's published list, and the reason has to belong to the category it is attached to. A zero-rated export with an exemption reason for medicines fails.
-
Rounding differences
The line totals, the VAT per category and the document total must agree to the halalah. This is a software problem rather than a user one — but it shows up as a rejected invoice, so it is worth knowing what it is when you see it.
-
A credit or debit note with no reason or no reference
A correcting document has to say what it corrects and why. Both are required, and a note is rejected without them.
After you fix it
Correct the data and send the same document again. Do not raise a replacement invoice to work around a rejection — a rejected document was never cleared, so there is nothing to correct with a credit note, and a second invoice for the same supply is a second liability.
Four of the five causes are a field in a record somebody filled in once. Fixing them at the source is the difference between a rejection you handle and a rejection you keep handling.
Questions people actually ask
Does a rejection use up my invoice number?
The document number stays with the document, and the chain position it consumed is not reused. That is by design: a gap the authority can see is recoverable, two documents sharing a counter is not.
What is the difference between a warning and an error?
An error blocks the document. A warning does not — the invoice is filed — but it is the only notice you get before that same finding becomes blocking in a later specification.
Where these facts come from
Checked against the following on 12 September 2026. Rules and dates change — if you are reading this long after that date, verify before you act on it.
WisoBooks is a bookkeeping and business-management tool, not an accounting, tax or legal advisor. Nothing on this page is tax advice, and tax rules change. Confirm your own obligations with the relevant authority or a qualified advisor.
