ZATCA Error Codes & Solutions
Complete reference guide to all ZATCA e-invoicing error codes. Find step-by-step solutions to fix validation, certificate, and submission errors.
Quick Search
Enter error code or keyword to find solution
ZATCA-00001 Invalid TIN (Tax Identification Number)
The Tax Identification Number (TIN) format is invalid or doesn't match ZATCA records.
ZATCA-00002 Invalid VAT Registration Number
The VAT registration number is missing, invalid, or doesn't match ZATCA records.
ZATCA-00003 Invalid Invoice Hash
The cryptographic hash of the invoice doesn't match the expected value. Invoice may have been tampered.
ZATCA-00004 Invalid Digital Signature
The digital signature on the invoice is invalid or cannot be verified by ZATCA.
ZATCA-00005 Missing Mandatory Field
One or more mandatory fields required by ZATCA are missing from the invoice.
ZATCA-00006 Invalid Invoice Format
The invoice XML format doesn't comply with ZATCA UBL 2.1 specifications.
ZATCA-00007 Duplicate Invoice Number
An invoice with this number has already been submitted and cleared by ZATCA.
ZATCA-00008 Invoice Date in Future
The invoice date is set to a future date, which is not allowed by ZATCA.
ZATCA-00009 Invoice Date Too Old
The invoice date is older than the allowed submission window (typically 24-48 hours for simplified invoices).
ZATCA-00010 Invalid QR Code
The QR code embedded in the invoice doesn't contain valid ZATCA-compliant data.
ZATCA-00011 Connection Timeout
The connection to ZATCA server timed out before receiving a response.
ZATCA-00012 ZATCA Server Error
ZATCA's server returned an internal error. The issue is on ZATCA's side.
ZATCA-00013 Invalid Line Item Amount
The calculation of line item amounts (quantity × price) doesn't match the totals.
ZATCA-00014 Invalid VAT Amount
The VAT amount on the invoice doesn't match the calculated 15% of the taxable amount.
ZATCA-00015 Invalid VAT Category Code
The VAT category code used is not recognized by ZATCA (must be S, Z, E, or O).
ZATCA-00016 Missing Buyer Information
For B2B (tax) invoices, buyer TIN and address are required but missing.
ZATCA-00017 Certificate Not Found
The ZATCA compliance certificate required for signing invoices was not found.
ZATCA-00018 Certificate Expired
Your ZATCA compliance certificate has expired and needs to be renewed.
ZATCA-00019 Invalid Credit Note Reference
Credit note references an invoice that doesn't exist or wasn't reported to ZATCA.
ZATCA-00020 Invalid Debit Note Reference
Debit note references an invoice that doesn't exist or wasn't reported to ZATCA.
ZATCA-00021 Invalid Currency Code
The currency code in the invoice does not conform to ISO 4217 standard or is not supported by ZATCA.
ZATCA-00022 Missing Seller Address
The seller's address information is incomplete or missing required fields (street, building, city, postal code, country).
ZATCA-00023 Invalid Invoice Type Code
The invoice type code does not match ZATCA's accepted values (388 for standard, 381 for credit, 383 for debit).
ZATCA-00024 PIH Chain Mismatch (Previous Invoice Hash)
The Previous Invoice Hash (PIH) in the current invoice does not match the hash of the last successfully reported/cleared invoice.
ZATCA-00025 Rate Limit Exceeded
Too many API requests sent to ZATCA in a short period. The system enforces rate limiting to prevent server overload.
ZATCA-00026 Unauthorized Request (401)
The API request was rejected due to invalid or expired authentication credentials (CSID token).
ZATCA-00027 Invalid Invoice Counter Value
The Invoice Counter Value (ICV) is not sequential or contains an invalid number.
ZATCA-00028 XML Schema Validation Error
The invoice XML does not conform to ZATCA's UBL 2.1 schema definition.
ZATCA-00029 Duplicate Invoice UUID
An invoice with the same UUID has already been submitted to ZATCA.
ZATCA-00030 Missing Cryptographic Stamp
The invoice is missing the required digital signature (cryptographic stamp) from the registered EGS.
ZATCA-00031 Invalid Tax Subtotal Calculation
The tax subtotal amounts do not match the sum of line-level tax calculations, or the tax rate is incorrect.
ZATCA-00032 Missing Item Classification Code
Invoice line items are missing the required classification code (GPC, UNSPSC, or custom ZATCA code).
ZATCA-00033 Invalid Payment Means Code
The payment means code does not match ZATCA's accepted UN/EDIFACT 4461 payment method codes.
ZATCA-00034 Missing or Invalid Supply Date
The actual date of supply is missing or does not follow the required format (YYYY-MM-DD).
ZATCA-00035 CSID Certificate Revoked
The Cryptographic Stamp Identifier (CSID) certificate has been revoked by ZATCA and can no longer be used for signing invoices.
No matching errors found
Try a different search term or contact support
Prevent ZATCA Errors Before They Happen
Qeemah validates every invoice against ZATCA requirements before submission, catching errors instantly and saving you time.
Start Free Trial →