ZATCA validation and rejection codes
Every rule code the system or ZATCA can show on an e-invoice, what it means in plain words, and how to fix it.
Before sending a document, the system checks it against ZATCA's rules. If a rule fails, the e-invoice shows ZATCA: Not sent and nothing is sent. If ZATCA itself refuses it, it shows ZATCA: Rejected. Either way, press the chip: each message starts with a code. Find the code below.
- Codes marked "warning" do not stop the document; it is still sent.
- After fixing the data, press Correct and send as a new document. The fix happens on the branch (Settings → Branches), on the customer (Edit) or on the tax rule (Settings → Taxes), as the table says.
- "Internal" means the system built the document wrong: press Correct and send as a new document once; if the same code comes back, contact support.
- ZATCA's own messages use the same codes. A code that is not in this list comes from ZATCA only: read its message text.
Seller (your branch)
| Code | What it means | What to do |
|---|---|---|
| BR-06 | The seller's legal name is missing. | Add the legal name on the branch. |
| BR-KSA-08 | The seller's registration (for example the CR number) is missing, or has a wrong type or characters other than letters and digits. | Fix Registration on the branch. |
| BR-KSA-09 | The seller's address is missing a part (street, building number, district, city, postal code, country). As a warning: no additional number. | Complete the address on the branch, including the 4-digit Additional number. |
| BR-KSA-37 | The seller's building number is not 4 digits. | Fix Building number on the branch. |
| BR-KSA-66 | The seller's postal code is not 5 digits. | Fix Postal code on the branch. |
| BR-KSA-39 | The seller's VAT number is missing. | Add the VAT number on the branch. |
| BR-KSA-40 | The seller's VAT number is not 15 digits starting and ending with 3. | Correct the branch's VAT number. |
| KSA-14 | The QR code is longer than 700 characters, usually because the legal name is very long. | Shorten the legal name on the branch. |
Buyer (your customer)
| Code | What it means | What to do |
|---|---|---|
| BR-KSA-42 | A tax invoice has no buyer name. | Add the customer's name. |
| BR-KSA-81 | A tax invoice has neither the buyer's VAT number nor another id. | Add the VAT number, the Commercial registration or an Other id on the customer. |
| BR-KSA-44 | The buyer's VAT number is not 15 digits starting and ending with 3. | Correct the customer's VAT number. |
| BR-CUSTOM-VALIDATION-01 | The buyer's VAT number is your own. | Correct the customer's VAT number. |
| BR-KSA-14 | The buyer's other id has a wrong type or characters other than letters and digits. | Fix Other id on the customer. |
| BR-KSA-10 | A tax invoice's buyer address is missing the street, the city or the country. | Complete the customer's address and choose its Country. |
| BR-KSA-63 | A Saudi buyer's address needs street, building number, postal code, city and district. | Complete the customer's address. |
| BR-KSA-67 | A Saudi buyer's postal code is not 5 digits. | Fix Postal code on the customer. |
| BR-KSA-46 | An export invoice carries the buyer's VAT number or id. | Remove the buyer's ids, or switch off Export invoices (standard only) for the branch. |
| BR-KSA-25, BR-KSA-49 | Private education or healthcare to citizens needs the buyer's name and national id. | Give the customer an Other id of type National ID. |
| BR-KSA-71 | A simplified summary invoice needs the buyer's name. | Add the customer's name, or switch off Summary invoices. |
Dates and document type
| Code | What it means | What to do |
|---|---|---|
| BR-KSA-15 | A tax invoice has no supply date (the trip's departure). | Check the trip's dates. |
| BR-KSA-35, BR-KSA-36 | The supply end date is missing its start, or is before it (the trip returns before it leaves). | Correct the trip's dates. |
| BR-KSA-72 | A simplified summary invoice needs the supply start and end dates. | Check the trip's dates. |
| BR-KSA-04 | The issue date is in the future. | Internal (server clock). Contact support. |
| BR-KSA-F-01, BR-KSA-70 | The issue date or time has the wrong format. | Internal. |
| BR-KSA-05 | The document type is not invoice, credit note or debit note (388, 381, 383). | Internal. |
| BR-KSA-06 | The transaction code is wrong. | Check the branch's Document options, then internal. |
| BR-KSA-07 | Self-billing is not allowed on export invoices. | Switch off Export invoices (standard only) or Self-billed (standard only, not with export) for the branch. |
| BR-KSA-31 | A simplified document may only be third party, nominal or summary. | Switch off Export invoices (standard only) and Self-billed (standard only, not with export) for the branch. |
| BR-KSA-17 | A credit or debit note has no reason. | Internal (notes always need a reason). |
| BR-KSA-56 | A credit or debit note does not name its original invoice. | Issue notes from the invoice row. Internal otherwise. |
| BR-02, BR-KSA-03, BR-KSA-EN16931-01, UBL, XML | Number, UUID, profile or file format problems. | Internal. |
Lines, tax and currency
| Code | What it means | What to do |
|---|---|---|
| BR-16 | The document has no lines. | Add the booking's items. |
| BR-25 | A line has no name. | Give the booking item a description. |
| BR-KSA-18 | A line's VAT category is not S, Z, E or O. | Fix the tax rule's Category. |
| BR-KSA-11 | A zero rated, exempt or out of scope line has a rate above 0. | Set the rule's rate to 0. |
| BR-S-05 | A standard-rated line has a rate of 0. | Give the rule a rate, or change its category. |
| BR-KSA-DEC-02 | A VAT rate has more than 2 decimals. | Fix the rule's Rate %. |
| BR-KSA-CL-04 | A zero rated, exempt or out of scope part has no exemption reason code. | Choose the Reason on the tax rule. See VAT exemption and zero-rate reason codes. |
| BR-KSA-23, BR-KSA-69, BR-KSA-24 | The reason code does not belong to the category (exempt, zero rated, out of scope). | Choose a reason of that category on the rule. |
| BR-KSA-83 | The exemption reason text is missing. | Fill in Reason printed (English) on the rule. |
| BR-S-10 | A standard-rated part carries an exemption reason. | Remove the reason, or change the category. |
| BR-KSA-16 | The payment means is not one ZATCA allows (10 cash, 30 bank transfer, 42 payment to bank account, 48 card, 1 not defined). | New invoices of e-invoicing branches always get an allowed code: cheque, customer credit, points and other methods become 1. Only older invoices can show it: press Correct and send as a new document. |
| BR-DEC | An amount has more than 2 decimals, or is not a number. | Sell in a 2-decimal currency such as SAR. |
| BR-KSA-EN16931-09 | No exchange rate to SAR for the VAT total (invoice in another currency). | Add a rate to SAR in Settings → Currencies. |
| BR-KSA-CL-01, BR-KSA-CL-02, BR-KSA-68 | Currency codes are wrong. | Internal. |
| BR-KSA-F-04 | An amount is negative or a quantity is not above 0. | Check the booking's items. |
| BR-KSA-50 (warning) | A line's VAT differs from its amount × rate by a rounding cent. | Nothing to do. |
| LINES | The invoice was issued before tax rules existed. | Issue a credit note and a new invoice. |
| BREAKDOWN | The invoice has no tax breakdown. | Issue a credit note and a new invoice. |
| BR-KSA-51, BR-KSA-52, BR-KSA-EN16931-11, BR-CO-18, BR-S-08, BR-S-09 | Line or breakdown amounts do not match. | Internal. |
Totals
| Code | What it means | What to do |
|---|---|---|
| BR-CO-10, BR-CO-13, BR-CO-14, BR-CO-15, BR-CO-16 | The document totals do not add up. | Internal. |
| BT-114 | The rounding is more than one smallest unit per tax category. | Internal. |
| BR-KSA-EN16931-08 | The tax totals are not given once each. | Internal. |
Signature, QR code and chain
| Code | What it means | What to do |
|---|---|---|
| BR-KSA-27, QR-1 to QR-5, QR-9 | The QR code is missing or does not match the document. | Correct and send as a new document. |
| KSA-15, BR-KSA-60 | The electronic signature is missing. | Check that the branch's device is Ready. |
| SIGNATURE | The signature, hash or certificate does not match the device. | Renew the device's certificate or onboard a new device. |
| BR-KSA-33, ICV | The invoice counter is missing or not the expected one. | Correct and send as a new document. |
| BR-KSA-61, PIH | The link to the previous document is missing or broken. | Correct and send as a new document. |
Related articles
- Fix and resend a failed or rejected e-invoiceSend a pending or not-sent e-invoice again, or fix the data of a rejected one and send it to ZATCA as a new document.
- E-invoice rejected, not sent or stuck: fixesWhat to do when ZATCA rejects an invoice, an e-invoice stays pending or not sent, a device or OTP fails, or a Rounding line appears.
- Error messages: e-invoicing (ZATCA)Every message you may see when you set up ZATCA e-invoicing, send invoices to ZATCA or fix a rejected document, and what to do.
- Error messages: invoices and credit notesEvery message you may see when you issue invoices, credit or debit notes, set up branches for tax invoices or export to accounting.
- VAT exemption and zero-rate reason codesThe reason codes a zero rated, exempt or out of scope tax rule can carry, ZATCA's official VATEX list and the other countries' reasons.