Home › E-invoicing reference › Rejection codes

Fatoora rejection codes

Type the code you got, or a word from it. Each code shows its official text and severity, every code has a page with its source, and 40 of them have a fix and an example we ran through ZATCA's SDK.

CodeSeverityOfficial text (ZATCA)Our explanation
BR-02WarningAn Invoice shall have an Invoice number (BT-1). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 35Code page
BR-03ErrorAn Invoice shall have an Invoice issue date (BT-2). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 35Code page
BR-04ErrorAn Invoice shall have an Invoice type code (BT-3). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-05ErrorAn Invoice shall have an Invoice currency code (BT-5). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-06WarningAn Invoice shall contain the Seller name (BT-27). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-08WarningAn Invoice shall contain the Seller postal address (BG-5) ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-09WarningThe Seller postal address (BG-5) shall contain a Seller country code (BT-40). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-10WarningAn Invoice shall contain the Buyer postal address (BG-8).Not applicable for simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-13WarningAn Invoice shall have the Invoice total amount without VAT (BT-109). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-14ErrorAn Invoice shall have the Invoice total amount with VAT (BT-112). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-15ErrorAn Invoice shall have the Amount due for payment (BT-115). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-16ErrorAn Invoice shall have at least one Invoice line (BG-25) ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Invoice has no line
BR-21WarningEach Invoice line (BG-25) shall have an Invoice line identifier (BT-126). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-22ErrorEach Invoice line (BG-25) shall have an Invoiced quantity (BT-129). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-24ErrorEach Invoice line (BG-25) shall have an Invoice line net amount (BT-131). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-25WarningEach Invoice line (BG-25) shall contain the Item name (BT-153). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 36Code page
BR-26ErrorEach Invoice line (BG-25) shall contain the Item net price (BT-146). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-31ErrorEach Document level allowance (BG-20) shall have a Document level allowance amount (BT-92). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-32ErrorEach Document level allowance (BG-20) shall have a Document level allowance VAT category code (BT-95). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-36WarningEach Document level charge (BG-21) shall have a Document level charge amount (BT-99). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-37WarningEach Document level charge (BG-21) shall have a Document level charge VAT category code (BT-102). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-41ErrorEach Invoice line allowance (BG-27) shall have an Invoice line allowance amount (BT-136). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-43WarningEach Invoice line charge (BG-28) shall have an Invoice line charge amount (BT-141). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-45ErrorEach VAT breakdown (BG-23) shall have a VAT category taxable amount (BT-116). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-46ErrorEach VAT breakdown (BG-23) shall have a VAT category tax amount (BT-117). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-47ErrorEach VAT breakdown (BG-23) shall be defined through a VAT category code (BT-118). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-48ErrorEach VAT breakdown (BG-23) shall have a VAT category rate (BT-119), except if the Invoice is not subject to VAT. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-49WarningA Payment instruction (BG-16) shall specify the Payment means type code (BT-81). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-52WarningEach Additional supporting document (BG-24) shall contain a Supporting document reference (BT-122). ZATCA SDK 238-R3.3.8Code page
BR-53WarningIf the VAT accounting currency code (BT-6) is present, then the Invoice total VAT amount in accounting currency (BT-111) shall be provided. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 37Code page
BR-54ErrorEach Item attribute (BG-32) shall contain an Item attribute name (BT-160) and an Item attribute value (BT-161). ZATCA SDK 238-R3.3.8Code page
BR-55ErrorEach Preceding Invoice reference (BG-3) shall contain a Preceding Invoice reference (BT-25). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.1, p. 38Code page
BR-CL-01ErrorThe document type code MUST be coded by the invoice and credit note related code lists of UNTDID 1001. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 44Code page
BR-CL-03ErrorcurrencyID MUST be coded using ISO code list 4217 alpha-3 ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 44Code page
BR-CL-04ErrorInvoice currency code MUST be coded using ISO code list 4217 alpha-3 ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 45Code page
BR-CL-05ErrorTax currency code MUST be coded using ISO code list 4217 alpha-3 ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 45Code page
BR-CL-14WarningCountry codes in an invoice MUST be coded using ISO code list 3166-1 ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 45Code page
BR-CL-16WarningPayment means in an invoice MUST be coded using UNCL4461 code list ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 45Code page
BR-CL-18ErrorInvoice tax categories MUST be coded using UNCL5305 code list. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.7, p. 45Code page
BR-CL-KSA-14Error[KSA-14]Field character limit for QR Code field has been exceeded. The maximum character limit for this field is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-CO-04ErrorEach Invoice line (BG-25) shall be categorized with an Invoiced item VAT category code (BT-151). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Code page
BR-CO-10WarningSum of Invoice line net amount (BT-106) = Σ Invoice line net amount (BT-131). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Code page
BR-CO-11ErrorSum of allowances on document level (BT-107) = Σ Document level allowance amount (BT-92). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Code page
BR-CO-12ErrorSum of charges on document level (BT-108) = Σ Document level charge amount (BT-99). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Code page
BR-CO-13WarningInvoice total amount without VAT (BT-109) = Σ Invoice line net amount (BT-131) - Sum of allowances on document level (BT-107) + Sum of charges on document level (BT-108). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Code page
BR-CO-14ErrorInvoice total VAT amount (BT-110) = Σ VAT category tax amount (BT-117). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Total VAT does not equal the sum of category VAT
BR-CO-15ErrorInvoice total amount with VAT (BT-112) = Invoice total amount without VAT (BT-109) + Invoice total VAT amount (BT-110). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Total with VAT does not equal net total + VAT
BR-CO-16WarningAmount due for payment (BT-115) = Invoice total amount with VAT (BT-112) -Pre-Paid amount (BT-113) + Rounding amount (BT-114). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 38Code page
BR-CO-17WarningVAT category tax amount (BT-117) = VAT category taxable amount (BT-116) x (VAT category rate (BT-119) / 100), rounded to two decimals. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 39Category VAT does not equal amount × rate
BR-CO-18ErrorAn Invoice shall at least have one VAT breakdown group (BG-23). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.2, p. 39Code page
BR-CUSTOM-VALIDATION-01ErrorThe Seller VAT registration number or seller group VAT registration number (BT-31) of The invoice must not match the buyer VAT registration number (BT-48) . ZATCA SDK 238-R3.3.8Code page
BR-DEC-01WarningThe allowed maximum number of decimals for the Document level allowance amount (BT-92) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 45Code page
BR-DEC-02WarningThe allowed maximum number of decimals for the Document level allowance base amount (BT-93) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 45Code page
BR-DEC-05WarningThe allowed maximum number of decimals for the Document level charge amount (BT-99) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-06WarningThe allowed maximum number of decimals for the Document level charge base amount (BT-100) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-09WarningThe allowed maximum number of decimals for the Sum of Invoice line net amount (BT-106) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-10WarningThe allowed maximum number of decimals for the Sum of allowanced on document level (BT-107) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-11WarningThe allowed maximum number of decimals for the Sum of charges on document level (BT-108) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-12WarningThe allowed maximum number of decimals for the Invoice total amount without VAT (BT-109) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-13WarningThe allowed maximum number of decimals for the Invoice total VAT amount (BT-110) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-14WarningThe allowed maximum number of decimals for the Invoice total amount with VAT (BT-112) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-15WarningThe allowed maximum number of decimals for the Invoice total VAT amount in accounting currency (BT-111) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-16WarningThe allowed maximum number of decimals for the Pre-Paid amount (BT-113) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-17WarningThe allowed maximum number of decimals for the Rounding amount (BT-114) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-18WarningThe allowed maximum number of decimals for the Amount due for payment (BT-115) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-19WarningThe allowed maximum number of decimals for the VAT category taxable amount (BT-116) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 46Code page
BR-DEC-20WarningThe allowed maximum number of decimals for the VAT category tax amount (BT-117) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 47Code page
BR-DEC-23WarningThe allowed maximum number of decimals for the Invoice line net amount (BT-131) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 47Code page
BR-DEC-24WarningThe allowed maximum number of decimals for the Invoice line allowance amount (BT-136) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 47Code page
BR-DEC-25WarningThe allowed maximum number of decimals for the Invoice line allowance base amount (BT-137) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 47Code page
BR-DEC-27WarningThe allowed maximum number of decimals for the Invoice line charge amount (BT-141) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 47Code page
BR-DEC-28WarningThe allowed maximum number of decimals for the Invoice line charge base amount (BT-142) is 2. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.8, p. 47Code page
BR-E-01WarningAn Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) or a Document level charge (BG-21) where the VAT category code (BT-151 or BT-95 or BT-102) is "Exempt from VAT" shall contain at least one VAT breakdown (BG-23) with the VAT category code (BT-118) equal to "Exempt from VAT". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.5, p. 41Code page
BR-E-05ErrorIn an Invoice line (BG-25) where the Invoiced item VAT category code (BT-151) is "Exempt from VAT", the Invoiced item VAT rate (BT-152) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.5, p. 41Code page
BR-E-06ErrorIn a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is "Exempt from VAT", the Document level allowance VAT rate (BT-96) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.5, p. 42Code page
BR-E-07ErrorIn a Document level charge (BG-21) where the Document level charge VAT category code (BT-102) is "Exempt from VAT", the Document level charge VAT rate (BT-103) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.5, p. 42Code page
BR-E-08WarningIn a VAT breakdown (BG-23) where the VAT category code (BT-118) is " Exempt from VAT" the VAT category taxable amount (BT-116) shall equal the sum of Invoice line net amounts (BT-131) minus the sum of Document level allowance amounts (BT-92) plus the sum of Document level charge amounts (BT-99) where the VAT category codes (BT-151, BT-95, BT-102) are "Exempt from VAT". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.5, p. 42Code page
BR-E-09ErrorThe VAT category tax amount (BT-117) In a VAT breakdown (BG-23) where the VAT category code (BT-118) equals "Exempt from VAT" shall equal 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.5, p. 42Code page
BR-KSA-03ErrorThe invoice must contain a unique identifier ("UUID") (KSA-1) given by the unit that issued the document (unique message identifier for interchange process). This value must contain only letters, digits, and dashes. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 47Invoice unique identifier (UUID) is missing
BR-KSA-04ErrorThe document issue date (BT-2) must be less or equal to the current date. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 47Issue date is later than today
BR-KSA-05ErrorThe invoice type code (BT-3) must be equal to one of value from the subset of UN/CEFACT code list 1001, D.16B agreed for KSA electronic invoices. Please refer paragraph 11.2.1 of XML implementation Standards. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 48Invoice type code is not allowed
BR-KSA-06ErrorThe invoice transaction code (KSA-2) must exist and respect the following structure: NNPNESB where NN (positions 1 and 2) = invoice subtype: - 01 for tax invoice - 02 for simplified tax invoice P (position 3) = 3rd Party invoice transaction, 0 for false, 1 for true N (position 4) = Nominal invoice transaction, 0 for false, 1 for true E (position 5) = Exports invoice transaction, 0 for false, 1 for true S (position 6) = Summary invoice transaction, 0 for false, 1 for true B (position 7) = Self billed invoice ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 48Transaction code (KSA-2) is incomplete
BR-KSA-07ErrorSelf billing is not allowed (KSA-2, position 7 cannot be "1") for export invoices (KSA-2, position 5 = 1). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 48Code page
BR-KSA-08WarningThe seller identification (BT-29) must exist only once with one of the scheme ID (BT-29-1) (CRN, MOM, MLS, SAG, OTH, 700) and must contain only alphanumeric characters. Commercial Registration number with "CRN" as schemeID. MOMRAH license with "MOM" as schemeID. MHRSD license with "MLS" as schemeID. 700 Number with "700" as schemeID. MISA license with "SAG" as schemeID. Other OD with "OTH" as schemeID. In case of multiple commercial registrations, the seller should fill the commercial registration of the branch in respect of which the Tax Invoice is being issued. In case multiple IDs exist then one of the above must be entered following the sequence specified above. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 48Seller identifier or its type is wrong
BR-KSA-09WarningSeller address must contain street name (BT-35), building number (KSA-17), postal code (BT-38), city (BT-37), district (KSA-3), country code (BT-40). For more information please access this link: https://splonline.com.sa/en/national-address-1/ ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 49Seller address is incomplete
BR-KSA-10WarningBuyer address must contain a street (BT-50), city (BT-52), country code (BT-55). This rule does not apply on the simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 50Code page
BR-KSA-11ErrorAn Invoice line (BG-25) where the VAT category code (BT-151) is "Not subject to VAT", an invoiced item VAT rate (BT-152) shall be 0 (zero), if exist. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 50Code page
BR-KSA-12WarningA Document level allowance (BG-20) where VAT category code (BT-95) is "Not subject to VAT", a Document level allowance VAT rate (BT-96) shall be 0 (Zero), if exist. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 50Code page
BR-KSA-13WarningA Document level charge (BG-21) where the VAT category code (BT-102) is "Not subject to VAT", a Document level charge VAT rate (BT-103) shall be 0 (zero), if exist. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 50Code page
BR-KSA-14ErrorThe buyer identification (BT-46), required only if buyer is not VAT registered, then the buyer identification (BT-46) must be provided with one of the scheme IDs (BT-46-1) (TIN, CRN, MOM, MLS, 700, SAG, NAT, GCC, IQA, OTH) and must contain only alphanumeric characters. Tax Identification Number "TIN" as schemeID ;Commercial registration number with "CRN" as schemeID ;MOMRAH license with "MOM" as schemeID ;MHRSD license with "MLS" as schemeID ;700 Number with "700" as schemeID ;MISA license with "SAG" as schemeID ;National ID with "NAT" as schemeID ;GCC ID with "GCC" as schemeID ;Iqama Number with "IQA" as schemeID ;Passport ID with "PAS" as schemeID ;Other ID with "OTH" as schemeID. ;In case of multiple commercial registrations, the seller should fill the commercial registration of the branch in respect of which the Tax Invoice is being issued. In case multiple IDs exist then one of the above must be entered following the sequence specified above ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 50Code page
BR-KSA-15WarningThe tax invoice ((invoice type code (BT-30) = 388) and (invoice transaction code (KSA-2) has "01" as first 2 digits)) must contain the supply date (KSA-5). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52Code page
BR-KSA-16WarningPayment means code (BT-81) in an invoice exist, then it must contain one of the values from subset of UNTDID 4461 code list ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52Payment means code is not recognised
BR-KSA-17ErrorDebit 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. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52Credit or debit note reason is missing
BR-KSA-18ErrorVAT category code must contain one of the values (S, Z, E, O). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52VAT category is not S, Z, E or O
BR-KSA-19WarningEach Document level charge (BG-21) shall have a code for the reason for document level charge (BT-105). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52Code page
BR-KSA-20WarningEach Invoice line charge (BG-28) shall have a code for the reason for invoice line charge (BT-145). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52Code page
BR-KSA-21WarningEach Document level charge (BG-21) shall have a Reason for document level charge (BT-104). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 52Code page
BR-KSA-22WarningEach Invoice line charge (BG-28) shall have a Reason for invoice line charge (BT-144). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 53Code page
BR-KSA-23WarningA VAT breakdown (BG-23) with VAT Category code (BT-118) 'Exempt from VAT' shall have a VAT exemption reason code (BT-121). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 53Code page
BR-KSA-24WarningA VAT breakdown (BG-23) with VAT Category code (BT-118) 'Not subject to VAT' shall have a VAT exception reason code (BT-121) ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 53Code page
BR-KSA-25WarningIf it is a simplified tax invoice or an associated credit note or a debit note (KSA-2, position 1 and 2 = 02) and the tax exemption reason code (BT-121) is equal with VATEX-SA-EDU or VATEX-SA-HEA, then buyer name (BT-44) is mandatory. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 53Code page
BR-KSA-26WarningIf the invoice contains the previous invoice hash (KSA-13), this hash must be base64 encoded SHA256. The hash shall be computed using the following method as described in the ds:transforms block in the XML Invoice Specifications: 1. Remove the <Invoice><ext:UBLExtensions/> block 2. Remove the <Invoice><cac:AdditionalDocumentReference/> block where <cbc:ID/> = QR 3. Remove the <Invoice><cac:Signature/> block 4. Canonicalize the Invoice using the C14N11 standard 5. Hash the resulting string using SHA256 to a binary object 6. Base64 encode the binary object to generate the digest value For the first invoice, the previous invoice hash is "NWZlY2ViNjZmZmM4NmYzOGQ5NTI3ODZjNmQ2OTZjNzljMmRiYzIzOWRkNGU5MWI0NjcyOWQ3M2EyN2ZiNTdlOQ==", the equivalent for base64 encoded SHA256 of "0" (zero) character. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 53Previous invoice hash (PIH) is in the wrong form
BR-KSA-27WarningThe document must contain a QR code (KSA-14), and this code must be base64Binary. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 54QR code is missing from the invoice
BR-KSA-28ErrorIf the cryptographic stamp (KSA-15) exists in the invoice, this cryptographic stamp (KSA-15) must contain the exact "urn:oasis:names:specification:ubl:signature:1" value for signature information ID. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 55Code page
BR-KSA-29WarningIf the cryptographic stamp (KSA-15) exists in the invoice, this cryptographic stamp (KSA-15) must contain the exact "urn:oasis:names:specification:ubl:signature:Invoice" value for referenced signature ID and signature ID. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 55Code page
BR-KSA-30ErrorThe document cryptographic stamp (KSA-15) must contain the exact "urn:oasis:names:specification:ubl:dsig:enveloped:xades" value for signature method. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 55Code page
BR-KSA-31ErrorFor simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02),only the following transaction types can be "true": - third party (KSA-2, position 3 = 1), - nominal supply (KSA-2, position 4 = 1) and - summary transactions (KSA-2,position 6 = 1). Other transaction types (self-billing and export) are not allowed to be "true" for simplified tax invoices and associated credit notes and debit notes. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 55Code page
BR-KSA-33ErrorEach invoice must have an invoice counter value (KSA-16). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 55Invoice counter (ICV) is missing
BR-KSA-34ErrorThe invoice counter value (KSA-16) contains only digits. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Invoice counter (ICV) holds more than digits
BR-KSA-35WarningIf the invoice contains a supply end date (KSA-24), then the invoice must contain a supply date (KSA-5). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Code page
BR-KSA-36WarningIf the invoice contains a supply end date (KSA-24), then this date must be greater than or equal to the supply date (KSA-5). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Code page
BR-KSA-37WarningThe seller address building number must contain 4 digits. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Seller building number is not 4 digits
BR-KSA-39ErrorThe invoice must contain the seller VAT registration number or seller group VAT registration number (BT-31). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Seller VAT number is missing
BR-KSA-40ErrorIf it exists in the invoice, the seller VAT registration number (BT-31) must contain 15 digits. The first and the last digits are "3".. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Seller VAT number is not 15 digits starting and ending with 3
BR-KSA-42WarningThe buyer name (BT-44) must be present in the tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Buyer name is missing on a tax invoice
BR-KSA-44ErrorIf it exists in the invoice,the buyer VAT registration number or buyer group VAT registration number (BT-48) must contain 15 digits. The first digit and the last digit is "3". ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 56Buyer VAT number is invalid
BR-KSA-46Standard onlyIf it is an export invoice (KSA-2, position 5 is true), the buyer VAT registration number or buyer group VAT registration number (BT-48) must not exist in the invoice. XML standard, 13.3.1, p. 57Code page
BR-KSA-49ErrorIf the tax exemption reason code (BT-121) is equal to VATEX-SA-EDU or VATEX-SA-HEA, then the other buyer ID (BT-46) is mandatory and must be national ID (BT-46-1 = NAT). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 57Code page
BR-KSA-51WarningThe line amount with VAT (KSA-12) must be Invoice line net amount (BT-131) + Line VAT amount (KSA-11). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 57Code page
BR-KSA-52ErrorThe line VAT amount (KSA-11) is mandatory for tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 57Code page
BR-KSA-53ErrorThe line amount with VAT (KSA-12) is mandatory for tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 57Code page
BR-KSA-56WarningFor 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. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 57Credit or debit note without the original invoice number
BR-KSA-60WarningCryptographic stamp (KSA-15) must exist in simplified tax invoices and associated credit notes and debit notes (KSA-2, position 1 and 2 = 02). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 57Cryptographic stamp is missing from a simplified invoice
BR-KSA-61WarningPrevious invoice hash (KSA-13) must exist in an invoice. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Previous invoice hash (PIH) is missing
BR-KSA-63WarningIf the buyer country code (BT-55) is "SA", then these fields are mandatory:street name (BT-50), building number (KSA-18), postal code (BT-53), city (BT-52), District (KSA-4), country code (BT-55).For more information please access this link:https://splonline.com.sa/en/national-address-1/ ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Saudi buyer address is incomplete
BR-KSA-66WarningSeller postal code (BT-38) must be 5 digits. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Seller postal code is not 5 digits
BR-KSA-67WarningIf the buyer country code (BT-55) is "SA", then the Buyer postal code(BT-53) must be 5 digits. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Saudi buyer postal code is not 5 digits
BR-KSA-68ErrorTax currency code (BT-6) must exist in an invoice. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Tax currency code is missing
BR-KSA-69WarningA VAT breakdown (BG-23) with VAT Category code (BT-118) 'Zero rated' shall have a VAT exception reason code (BT-121). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Zero-rate or exemption reason code is missing
BR-KSA-70ErrorThe invoice must contain Invoice Issue Time (KSA-25). This value should be in the format: hh:mm:ss for time expressed in local time (eg 19:20:30) or hh:mm:ssZ for time expressed in UTC (eg 19:20:30Z)."The invoice must contain Invoice Issue Time (KSA-25). This value should be in the format: hh:mm:ss for time expressed in local time (eg 19:20:30) or hh:mm:ssZ for time expressed in UTC (eg 19:20:30Z). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 58Issue time is in a format that is not accepted
BR-KSA-71WarningIf the Invoice is a simplified invoice type and is a summary invoice (KSA-2, position 1 and 2 = 02, position 6 = 1),then the buyer name must be present. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 59Code page
BR-KSA-72ErrorIf the Invoice is a simplified invoice type and is a summary invoice (KSA-2, position 1 and 2 = 02, position 6 = 1), then a supply date (KSA-5) and supply end date (KSA-24) must be present ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 59Code page
BR-KSA-73WarningIf Pre-Paid amount (BT-113) is provided, then the following data is mandatory to provide as additional invoice line(s) -Prepayment ID (KSA-26) -Sequential invoice number (BT-1) of the prepayment invoice(s)-Prepayment Issue Date (KSA-28) -Issue date (BT-2) of the prepayment invoice(s) Prepayment Issue Time (KSA-29) - Issue time (KSA-25) of the prepayment invoice(s) Prepayment Document Type Code (KSA-30)- Invoice type code (BT-3) must be 386.
If Pre-Paid amount (BT-113) is provided, then the following data is mandatory to provide as additional invoice line(s) -Prepayment ID (KSA-26) -Sequential invoice number (BT-1) of the prepayment invoice(s)-Prepayment Issue Date (KSA-28) -Issue date (BT-2) of the prepayment invoice(s) Prepayment Issue Time (KSA-29) - Issue time (KSA-25) of the prepayment invoice(s) Prepayment Document Type Code (KSA-30)- Invoice type code (BT-3) must be 386 ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 59		Code page
BR-KSA-74ErrorPrepayment Document Type Code (KSA-30) for the Invoice line document reference must be '386'. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 59Code page
BR-KSA-75WarningIf Prepayment Document Type code (KSA-30) is provided in an Invoice Line, then the following data is mandatory to provide in that invoice line - Prepayment VAT category Taxable Amount (KSA-31) - Sum total of taxable amounts subject to specific VAT Category code of the prepayment invoice(s); Prepayment VAT Category Tax Amount (KSA-32) - Sum total of tax amounts subject to specific VAT Category code of the prepayment invoice(s); Prepayment VAT category code (KSA-33) - the VAT category code of the associated Prepayment invoice(s); Prepayment VAT rate (KSA-34) - VAT rate of the specific VAT Category code of the prepayment invoice(s) ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 59Code page
BR-KSA-76WarningAn Invoice line (BG-25) where the Prepayment VAT category code (KSA-33) is "Zero rated" the Prepayment VAT rate (KSA-34) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 60Code page
BR-KSA-77WarningAn Invoice line (BG-25) where the Prepayment VAT category code (KSA-33) is "Exempt from VAT" the Prepayment VAT rate (KSA-34) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 60Code page
BR-KSA-78WarningAn Invoice line (BG-25) where the Prepayment VAT category code (KSA-33) is "Not subject to VAT" the Prepayment VAT rate (KSA-34) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 61Code page
BR-KSA-79WarningThe Prepayment VAT Category Tax Amount (KSA-32) must be Prepayment VAT category Taxable Amount( (KSA-31) x Prepayment VAT rate (KSA-34) /100). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 61Code page
BR-KSA-80WarningThe Pre-Paid amount (BT-113) must be equal to the sum total of the Prepayment VAT category Taxable Amount (KSA-31) and the Prepayment VAT Category Tax Amount (KSA-32). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 61Code page
BR-KSA-81WarningThe other Buyer ID (BT-46) must present in the tax invoice and associated debit notes and credit notes (KSA-2, position 1 and 2 = 01), where the buyer VAT registration number or buyer group VAT registration number (BT-48) is not provided. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 61Code page
BR-KSA-82ErrorAn Invoice line (BG-25) where Prepayment Document Type Code (KSA-30) is provided, then Item net price (BT-146); Invoice line allowance amount (BT-136); Invoice line charge amount (BT-141); Item line net amount (BT-131); line VAT amount (KSA-11); and line amount with VAT (KSA-12) for that line shall be 0 (Zero), if exist. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 61Code page
BR-KSA-83WarningA VAT breakdown (BG-23) with VAT Category code (BT-118) 'Exempt from VAT' or 'Zero rated' or 'Not subject to VAT' shall have a VAT exemption (or exception) reason text (BT-120) with one of the values from paragraph 11.2.4 of XML implementation standards on Tax exemption (or exception) reason text - specific to Saudi Arabia. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.1, p. 62Code page
BR-KSA-84ErrorThe Document level allowance VAT rate (BT-96), Document level Charge VAT rate (BT-103), VAT category rate(BT-119), Invoiced item VAT rate (BT-152), Prepayment VAT rate(KSA-34) must be limited to one of the following values (5 or 15) when the relevant Document level allowance VAT category code (BT-95), Document level Charge VAT category code(BT-102), VAT category code(BT-118), Invoiced item VAT category code(BT-151), Prepayment VAT Category Code (KSA-33) is "S"- "Standard rated". In other words, for Standard Rate VAT Category the rate can either be 15% or 5%. ZATCA SDK 238-R3.3.8Standard-rate VAT is not 15 or 5
BR-KSA-85WarningThe Buyer's contact phone number (BT-57) shall start with "0" or "+", followed by a maximum of 15 number and minimum 4 character after the "+" or "0" , if exist. ZATCA SDK 238-R3.3.8Code page
BR-KSA-86WarningBuyer's Contact Email Address (BT-58) shall follow the following format ** XXX@YYY.ZZ where: The [XXX] should consist of alphanumeric characters (a-z, A-Z, 0-9), dots ('.'), underscores ('_'), or hyphens ('-'). It must start and end with an alphanumeric character. The [YYY] should consist of alphanumeric characters (a-z, A-Z, 0-9), hyphens ('-'), and dots ('.'). It must start and end with an alphanumeric character. The [ZZ] should be a valid extension with a maximum 3 and a minimum 2 alphabets (a-z, A-Z), If exist. Multiple emails can be provided using semicolon ';' separator. ZATCA SDK 238-R3.3.8Code page
BR-KSA-87Warning[BR-KSA-87] If the tax exchange rate (KSA-36) exists, then Source Currency Code (KSA-37), Target Currency Code (KSA-38) and Calculation Rate (KSA-39) shall be provided ZATCA SDK 238-R3.3.8Code page
BR-KSA-88Error[BR-KSA-88] If exist, Source Currency Code (KSA-37) must be the same as Invoice currency code (BT-5) ZATCA SDK 238-R3.3.8Code page
BR-KSA-89Error[BR-KSA-89] If exists, Target Currency Code (KSA-38) must be the same as the Tax currency code (BT-6) ZATCA SDK 238-R3.3.8Code page
BR-KSA-90Error[BR-KSA-90] If exists, the allowed maximum number of digits for the Tax Exchange Rate (KSA-39) is 14. ZATCA SDK 238-R3.3.8Code page
BR-KSA-91WarningFor B2G supplies attracting provisions of Article 20(5) of VAT Regulations, Company Legal Form (KSA-40) should be provided with a static value "GOV" in case of a tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01). ZATCA SDK 238-R3.3.8Code page
BR-KSA-92WarningIf the Company Legal Form (KSA-40) is provided as 'GOV', then the Tax Point Date (BT-7) must present in a tax invoice and associated credit notes and debit notes (KSA-2, position 1 and 2 = 01) and it must refer to the Payment Order Date. ZATCA SDK 238-R3.3.8Code page
BR-KSA-93WarningAn Invoice line (BG-25) where the Prepayment VAT category code (KSA-33) is "Zero-rated" the Prepayment VAT exception reason code (KSA-41) should be provided. ZATCA SDK 238-R3.3.8Code page
BR-KSA-94WarningAn Invoice line (BG-25) where the Prepayment VAT category code (KSA-33) is " Exempt from VAT " the Prepayment VAT exemption reason code (KSA-41) should be provided. ZATCA SDK 238-R3.3.8Code page
BR-KSA-95WarningAn Invoice line (BG-25) where the Prepayment VAT category code (KSA-33) is " Not subject to VAT " the Prepayment VAT exception reason code (KSA-41) should be provided. ZATCA SDK 238-R3.3.8Code page
BR-KSA-96WarningAn Invoice line (BG-25) with the Prepayment VAT category code (KSA-33) 'Exempt from VAT' or 'Zero rated' or 'Not subject to VAT' shall have a Prepayment VAT exemption(or exception) reason text (KSA-42) with one of the values from paragraph 11.2.4 of XML implementation standards on Tax exemption (or exception) reason text - specific to Saudi Arabia. ZATCA SDK 238-R3.3.8Code page
BR-KSA-CL-01ErrorCurrency code (BT-5) must be according to ISO 4217:2005 ZATCA SDK 238-R3.3.8 · XML standard, 13.3.3, p. 63Code page
BR-KSA-CL-02ErrorAll currencyID attributes (BT-5) must have the same value as the invoice currency code (BT-5), except for the invoice total VAT amount in accounting currency (BT-111). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.3, p. 64Code page
BR-KSA-CL-03ErrorMime code must be according to subset of IANA code list. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.3, p. 65Code page
BR-KSA-CL-04WarningIf VAT category Code (BT-118) is 'Z', or 'E', VAT exemption (or exception) reason code (BT-121) must exist with one of the values from paragraph 11.2.4 of XML implementation standards on Tax exemption (or exception) reason code - specific to Saudi Arabia. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.3, p. 65Zero-rate or exemption reason code does not fit the category
BR-KSA-CL-06WarningCode for the reason for document level charge (BT-105) and the code for the reason for invoice line charge (BT-145) MUST be coded using UNTDID 7161 code list. https://unece.org/fileadmin/DAM/trade/untdid/d16b/tred/tred7161.htm ZATCA SDK 238-R3.3.8 · XML standard, 13.3.3, p. 65Code page
BR-KSA-CL-07WarningIf the Prepayment VAT Category Code(KSA-33) is 'Z', or 'E' or 'O', the Prepayment VAT exemption (or exception) reason code(KSA-41) must exist with one of the values from paragraph 11.2.4 of XML implementation standards on Tax exemption (or exception) reason code - specific to Saudi Arabia. ZATCA SDK 238-R3.3.8Code page
BR-KSA-DEC-01ErrorThe allowance percentage values (BT-94, BT-138) must be from 0.00 to 100.00, with maximum two decimal places. Only numerals are accepted, the percentage symbol (%) is not allowed. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.2, p. 62Code page
BR-KSA-DEC-02ErrorThe VAT rates (BT-96, BT-103, BT-119, BT-152, KSA-34) must be from 0.00 to 100.00, with maximum two decimals.Only numerals are accepted, the percentage symbol (%) is not allowed. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.2, p. 62Code page
BR-KSA-DEC-03WarningVAT amount at line level (KSA-11) must have a maximum two decimals. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.2, p. 63Code page
BR-KSA-DEC-04WarningAmount with VAT at line level (KSA-12) must have a maximum two decimals. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.2, p. 63Code page
BR-KSA-DEC-06WarningPrepayment VAT category Taxable Amount (KSA-31) and Prepayment VAT Category Tax Amount (KSA-32) must have a maximum two decimals. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.2, p. 63Code page
BR-KSA-EN16931-01ErrorBusiness process (BT-23) must be "reporting:1.0". ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 66Business process (ProfileID) is not reporting:1.0
BR-KSA-EN16931-02ErrorVAT accounting currency code (BT-6) must be "SAR". ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 66Tax currency is not SAR
BR-KSA-EN16931-03WarningAllowance/Charge amount (BT-92, BT-99, BT-136, BT-141) must equal base amount (BT-93, BT-100, BT-137, BT-142) * percentage (BT-94, BT-101, BT-138, BT-143) / 100 if base amount and percentage exists. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 66Code page
BR-KSA-EN16931-04WarningAllowance/Charge base amount (BT-93, BT-100, BT-137, BT-142) must be provided when allowance/Charge percentage (BT-94, BT-101,BT-138, BT-143) is provided. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 66Code page
BR-KSA-EN16931-05WarningAllowance/Charge percentage (BT-94, BT-101, BT-138, BT-143) must be provided when the allowance/Charge base amount (BT-93, BT-100, BT-137, BT-142) is provided. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 66Code page
BR-KSA-EN16931-06ErrorCharge on price level (BG-29) is allowed. The value of Indicator should be ' True'. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 67Code page
BR-KSA-EN16931-07ErrorItem net price (BT-146) must equal (Item Gross price (BT-148) - Allowance amount (BT-147)) when gross price is provided. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 67Code page
BR-KSA-EN16931-08WarningOnly one tax total (BG-22) with tax subtotals must be provided.Refer to Calculation of VAT. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 67More than one tax total with a breakdown
BR-KSA-EN16931-09WarningOnly one tax total (BG-22) without tax subtotals (BG-23) must be provided when tax currency code is provided . ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 67Code page
BR-KSA-EN16931-11WarningInvoice line net amount (BT-131) must equal (Invoiced quantity (BT-129) * (Item net price (BT-146) / item price base quantity (BT-149))-) + Sum of invoice line charge amount (BT-141) - Sum of invoice line allowance amount (BT-136). ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 67Line amount does not equal quantity × price
BR-KSA-EN16931-12ErrorBase quantity (BT-149) must be a positive number above zero. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.4, p. 67Code page
BR-KSA-F-01WarningA date MUST be formatted YYYY-MM-DD, in accordance to the "Calendar date complete representation" as specified by ISO 8601:2004, format YYYY-MM-DD. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.5, p. 68Code page
BR-KSA-F-02ErrorAllowance/Charge Indicator value MUST equal to 'false'/’True’ respectively. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.5, p. 68Code page
BR-KSA-F-03Standard onlyDocument MUST not contain empty elements. XML standard, 13.3.5, p. 68Code page
BR-KSA-F-04ErrorAll the document amounts and quantities must be positive, unless specified otherwise. ZATCA SDK 238-R3.3.8 · XML standard, 13.3.5, p. 68Negative amount or quantity
BR-KSA-F-05WarningPrepayment Issue Time (KSA-29) must be in the format: hh:mm:ss for time expressed in local time or hh:mm:ssZ for time expressed in UTC.(eg 19:20:30) ZATCA SDK 238-R3.3.8 · XML standard, 13.3.5, p. 69Code page
BR-KSA-F-06Standard onlyMinimum & Maximum character limits should be maintained as per data dictionary for every data field XML standard, 13.3.5, p. 69Code page
BR-KSA-F-06-C1WarningField character limits for Invoice number field (BT-1) have not been met. The minimum limit is 1 character and the maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C10WarningField character limits for Seller name field (BT-27) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C11WarningField character limits for the Buyer Address - Additional street field (BT-51) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C12WarningField character limits for Buyer name field (BT-44) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C13WarningField character limits for Reasons for issuance of credit / debit note field (KSA-10) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters . ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C14Warning[BR-KSA-F-06-C14]Field character limits for Payment terms field (KSA-22) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C15WarningField character limits for Payment account identifier field (BT-84) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C16WarningField character limits for VAT exemption reason text field (BT-120) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C17ErrorField character limits for Invoice line identifier field (BT-126) have not been met. The minimum limit is 1 character and the maximum limit is 6 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C18WarningField character limits for Invoiced quantity unit of measure field (BT-130) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C19WarningField character limits for Item name field (BT-153) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C2WarningField character limits for Invoice note field (BT-22) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C20WarningField character limits for Item standard identifier field (BT-157) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C21WarningField character limits for Item price base quantity unit code field (BT-150) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C22ErrorField character limits for Billing reference ID field (BT-25) have not been met. The minimum limit is 1 character and the maximum limit is 5000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C23WarningField character limits for the Buyer Address - Street field (BT-50) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C24WarningField character limits for the Buyer Address - Street field (BT-50) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C25WarningField character limits for the Buyer Address - City field (BT-52) have not been met. The minimum limit is 1 character and the maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C26WarningField character limits for the Buyer Address - City field (BT-52) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C27WarningField character limits for the Buyer Address - Province/State field (BT-54) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C28WarningField character limits for the Buyer Address - District field (KSA-4) have not been met. The minimum limit is 1 character and the maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C29WarningField character limits for the Buyer Address - District field (KSA-4) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C3WarningField character limits for Purchase order ID field (BT-13) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C30WarningField character limits for Item Buyer's identifier field (BT-156) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C31WarningField character limits for Item Seller's identifier field (BT-155) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C32WarningField character limits for Buyer name field (BT-44) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C33WarningField character limits for Reason for the document level charge (BT-104) have not been met. The maximum limit is 1,000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C34WarningField character limits for Reason for invoice line charge (BT-144) have not been met. The maximum limit is 1,000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C35WarningField character limits for Reason for the document level allowance (BT-97) have not been met. The maximum limit is 1,000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C36WarningField character limits for Reason for the invoice line allowance (BT-139) have not been met. The maximum limit is 1,000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C37WarningField character limits for the contact name - Buyer's contact point field (BT-56) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C38WarningField character limits for the contact note - Buyer's Contact Note field (KSA-35) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C39WarningField character limits for the Prepayment VAT exemption reason text (KSA-42) have not been met. The maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C4WarningField character limits for the Seller Address - Street field (BT-35) have not been met. The minimum limit is 1 character and the maximum limit is 1000 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C5WarningField character limits for Contract ID field (BT-12) have not been met. The maximum limit is 127 characters . ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C6WarningField character limits for the Seller Address - Additional street field (BT-36) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C7WarningField character limits for the Seller Address - City field (BT-37) have not been met. The minimum limit is 1 character and the maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C8WarningField character limits for the Seller Address - Province/State field (BT-39) have not been met. The maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-KSA-F-06-C9WarningField character limits for the Seller Address - District field (KSA-3) have not been met. The minimum limit is 1 character and the maximum limit is 127 characters. ZATCA SDK 238-R3.3.8Code page
BR-O-01WarningAn Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) or a Document level charge (BG-21) where the VAT category code (BT-151 or BT-95 or BT-102) is "Not subject to VAT" shall contain exactly at least one VAT breakdown group (BG-23) with the VAT category code (BT-118) equal to "Not subject to VAT". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.6, p. 43Code page
BR-O-08WarningIn a VAT breakdown (BG-23) where the VAT category code (BT-118) is " Not subject to VAT" the VAT category taxable amount (BT-116) shall equal the sum of Invoice line net amounts (BT-131) minus the sum of Document level allowance amounts (BT-92) plus the sum of Document level charge amounts (BT-99) where the VAT category codes (BT-151, BT-95, BT-102) are "Not subject to VAT". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.6, p. 43Code page
BR-O-09ErrorThe VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where the VAT category code (BT-118) is "Not subject to VAT" shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.6, p. 43Code page
BR-O-13Standard onlyAn Invoice that contains a VAT breakdown group (BG-23) with a VAT category code (BT-118) "Not subject to VAT" shall not contain Document level allowances (BG-20) where Document level allowance VAT category code (BT-95) is not "Not subject to VAT". XML standard, 13.2.6, p. 43Code page
BR-S-01WarningAn Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) or a Document level charge (BG-21) where the VAT category code (BT-151, BT-95 or BT-102) is "Standard rated" shall contain in the VAT breakdown (BG-23) at least one VAT category code (BT-118) equal with "Standard rated". ZATCA SDK 238-R3.3.8Code page
BR-S-05WarningFor invoice items (BG-25) in which the VAT category code of invoiced items (BT-151) is "Standard rated" the VAT rate of the invoiced item (BT-152) must be greater than zero. ZATCA SDK 238-R3.3.8Code page
BR-S-06ErrorIn a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is "Standard rated" the Document level allowance VAT rate (BT-96) shall be greater than zero. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.3, p. 39Code page
BR-S-07Warning-In a Document level charge (BG-21) where the Document level charge VAT category code (BT-102) is "Standard rated" the Document level charge VAT rate (BT-103) shall be greater than zero. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.3, p. 39Code page
BR-S-08WarningIn a VAT breakdown (BG-23) where the VAT category code (BT-118) is " Standard rated" the VAT category taxable amount (BT-116) shall equal the sum of Invoice line net amounts (BT-131) minus the sum of Document level allowance amounts (BT-92) plus the sum of Document level charge amounts (BT-99) where the VAT category codes (BT-151, BT-95, BT-102) are "Standard Rate". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.3, p. 39Standard-rate taxable amount does not match the lines
BR-S-09WarningThe VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT category code (BT-118) is "Standard rated" shall equal the VAT category taxable amount (BT-116) multiplied by the VAT category rate (BT-119) / 100), rounded to two decimals. ZATCA SDK 238-R3.3.8 · XML standard, 13.2.3, p. 39Standard-rate VAT does not equal amount × rate
BR-S-10WarningA VAT breakdown (BG-23) with VAT Category code (BT-118) "Standard rate" shall not have a VAT exemption reason code (BT-121) or VAT exemption reason text (BT-120). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.3, p. 40Code page
BR-Z-01WarningAn Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) or a Document level charge (BG-21) where the VAT category code (BT-151 or BT-95 or BT-102) is "Zero rated" shall contain in the VAT breakdown (BG-23) at least one VAT category code (BT-118) equal with "Zero rated". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.4, p. 40Code page
BR-Z-05ErrorIn an Invoice line (BG-25) where the Invoiced item VAT category code (BT-151) is "Zero rated" the Invoiced item VAT rate (BT-152) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.4, p. 40Code page
BR-Z-06ErrorIn a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is "Zero rated" the Document level allowance VAT rate (BT-96) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.4, p. 40Code page
BR-Z-07ErrorIn a Document level charge (BG-21) where the Document level charge VAT category code (BT-102) is "Zero rated" the Document level charge VAT rate (BT-103) shall be 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.4, p. 41Code page
BR-Z-08WarningIn a VAT breakdown (BG-23) where the VAT category code (BT-118) is " Zero rated" the VAT category taxable amount (BT-116) shall equal the sum of Invoice line net amounts (BT-131) minus the sum of Document level allowance amounts (BT-92) plus the sum of Document level charge amounts (BT-99) where the VAT category codes (BT-151, BT-95, BT-102) are "Zero Rated". ZATCA SDK 238-R3.3.8 · XML standard, 13.2.4, p. 41Code page
BR-Z-09ErrorThe VAT category tax amount (BT-117) in a VAT breakdown (BG-23) where VAT category code (BT-118) is "Zero rated" shall equal 0 (zero). ZATCA SDK 238-R3.3.8 · XML standard, 13.2.4, p. 41Code page

Source: ZATCA E-Invoicing SDK 238-R3.3.8, Data/Rules/schematrons · Checked: 26 October 2026 · Electronic Invoice XML Implementation Standard v1.2, 19 May 2023, §13 · Open data: /codes.json

A page for every code (240)

BR-02 An Invoice shall have an Invoice number (BT-1).BR-03 An Invoice shall have an Invoice issue date (BT-2).BR-04 An Invoice shall have an Invoice type code (BT-3).BR-05 An Invoice shall have an Invoice currency code (BT-5).BR-06 An Invoice shall contain the Seller name (BT-27).BR-08 An Invoice shall contain the Seller postal address (BG-5)BR-09 The Seller postal address (BG-5) shall contain a Seller…BR-10 An Invoice shall contain the Buyer postal address…BR-13 An Invoice shall have the Invoice total amount without VAT…BR-14 An Invoice shall have the Invoice total amount with VAT…BR-15 An Invoice shall have the Amount due for payment (BT-115).BR-16 Invoice has no lineBR-21 Each Invoice line (BG-25) shall have an Invoice line…BR-22 Each Invoice line (BG-25) shall have an Invoiced quantity…BR-24 Each Invoice line (BG-25) shall have an Invoice line net…BR-25 Each Invoice line (BG-25) shall contain the Item name…BR-26 Each Invoice line (BG-25) shall contain the Item net price…BR-31 Each Document level allowance (BG-20) shall have a Document…BR-32 Each Document level allowance (BG-20) shall have a Document…BR-36 Each Document level charge (BG-21) shall have a Document…BR-37 Each Document level charge (BG-21) shall have a Document…BR-41 Each Invoice line allowance (BG-27) shall have an Invoice…BR-43 Each Invoice line charge (BG-28) shall have an Invoice line…BR-45 Each VAT breakdown (BG-23) shall have a VAT category…BR-46 Each VAT breakdown (BG-23) shall have a VAT category tax…BR-47 Each VAT breakdown (BG-23) shall be defined through a VAT…BR-48 Each VAT breakdown (BG-23) shall have a VAT category rate…BR-49 A Payment instruction (BG-16) shall specify the Payment…BR-52 Each Additional supporting document (BG-24) shall contain a…BR-53 If the VAT accounting currency code (BT-6) is present, then…BR-54 Each Item attribute (BG-32) shall contain an Item attribute…BR-55 Each Preceding Invoice reference (BG-3) shall contain a…BR-CL-01 The document type code MUST be coded by the invoice and…BR-CL-03 currencyID MUST be coded using ISO code list 4217 alpha-3BR-CL-04 Invoice currency code MUST be coded using ISO code list…BR-CL-05 Tax currency code MUST be coded using ISO code list 4217…BR-CL-14 Country codes in an invoice MUST be coded using ISO code…BR-CL-16 Payment means in an invoice MUST be coded using UNCL4461…BR-CL-18 Invoice tax categories MUST be coded using UNCL5305 code…BR-CL-KSA-14 [KSA-14]Field character limit for QR Code field has been…BR-CO-04 Each Invoice line (BG-25) shall be categorized with an…BR-CO-10 Sum of Invoice line net amount (BT-106) = Σ Invoice line…BR-CO-11 Sum of allowances on document level (BT-107) = Σ Document…BR-CO-12 Sum of charges on document level (BT-108) = Σ Document…BR-CO-13 Invoice total amount without VAT (BT-109) = Σ Invoice line…BR-CO-14 Total VAT does not equal the sum of category VATBR-CO-15 Total with VAT does not equal net total + VATBR-CO-16 Amount due for payment (BT-115) = Invoice total amount with…BR-CO-17 Category VAT does not equal amount × rateBR-CO-18 An Invoice shall at least have one VAT breakdown group…BR-CUSTOM-VALIDATION-01 The Seller VAT registration number or seller group VAT…BR-DEC-01 The allowed maximum number of decimals for the Document…BR-DEC-02 The allowed maximum number of decimals for the Document…BR-DEC-05 The allowed maximum number of decimals for the Document…BR-DEC-06 The allowed maximum number of decimals for the Document…BR-DEC-09 The allowed maximum number of decimals for the Sum of…BR-DEC-10 The allowed maximum number of decimals for the Sum of…BR-DEC-11 The allowed maximum number of decimals for the Sum of…BR-DEC-12 The allowed maximum number of decimals for the Invoice…BR-DEC-13 The allowed maximum number of decimals for the Invoice…BR-DEC-14 The allowed maximum number of decimals for the Invoice…BR-DEC-15 The allowed maximum number of decimals for the Invoice…BR-DEC-16 The allowed maximum number of decimals for the Pre-Paid…BR-DEC-17 The allowed maximum number of decimals for the Rounding…BR-DEC-18 The allowed maximum number of decimals for the Amount due…BR-DEC-19 The allowed maximum number of decimals for the VAT category…BR-DEC-20 The allowed maximum number of decimals for the VAT category…BR-DEC-23 The allowed maximum number of decimals for the Invoice line…BR-DEC-24 The allowed maximum number of decimals for the Invoice line…BR-DEC-25 The allowed maximum number of decimals for the Invoice line…BR-DEC-27 The allowed maximum number of decimals for the Invoice line…BR-DEC-28 The allowed maximum number of decimals for the Invoice line…BR-E-01 An Invoice that contains an Invoice line (BG-25), a…BR-E-05 In an Invoice line (BG-25) where the Invoiced item VAT…BR-E-06 In a Document level allowance (BG-20) where the Document…BR-E-07 In a Document level charge (BG-21) where the Document level…BR-E-08 In a VAT breakdown (BG-23) where the VAT category code…BR-E-09 The VAT category tax amount (BT-117) In a VAT breakdown…BR-KSA-03 Invoice unique identifier (UUID) is missingBR-KSA-04 Issue date is later than todayBR-KSA-05 Invoice type code is not allowedBR-KSA-06 Transaction code (KSA-2) is incompleteBR-KSA-07 Self billing is not allowed (KSA-2, position 7 cannot be…BR-KSA-08 Seller identifier or its type is wrongBR-KSA-09 Seller address is incompleteBR-KSA-10 Buyer address must contain a street (BT-50), city (BT-52)…BR-KSA-11 An Invoice line (BG-25) where the VAT category code…BR-KSA-12 A Document level allowance (BG-20) where VAT category code…BR-KSA-13 A Document level charge (BG-21) where the VAT category code…BR-KSA-14 The buyer identification (BT-46), required only if buyer is…BR-KSA-15 The tax invoice ((invoice type code (BT-30) = 388) and…BR-KSA-16 Payment means code is not recognisedBR-KSA-17 Credit or debit note reason is missingBR-KSA-18 VAT category is not S, Z, E or OBR-KSA-19 Each Document level charge (BG-21) shall have a code for…BR-KSA-20 Each Invoice line charge (BG-28) shall have a code for the…BR-KSA-21 Each Document level charge (BG-21) shall have a Reason for…BR-KSA-22 Each Invoice line charge (BG-28) shall have a Reason for…BR-KSA-23 A VAT breakdown (BG-23) with VAT Category code (BT-118)…BR-KSA-24 A VAT breakdown (BG-23) with VAT Category code (BT-118)…BR-KSA-25 If it is a simplified tax invoice or an associated credit…BR-KSA-26 Previous invoice hash (PIH) is in the wrong formBR-KSA-27 QR code is missing from the invoiceBR-KSA-28 If the cryptographic stamp (KSA-15) exists in the invoice…BR-KSA-29 If the cryptographic stamp (KSA-15) exists in the invoice…BR-KSA-30 The document cryptographic stamp (KSA-15) must contain the…BR-KSA-31 For simplified tax invoices and associated credit notes and…BR-KSA-33 Invoice counter (ICV) is missingBR-KSA-34 Invoice counter (ICV) holds more than digitsBR-KSA-35 If the invoice contains a supply end date (KSA-24), then…BR-KSA-36 If the invoice contains a supply end date (KSA-24), then…BR-KSA-37 Seller building number is not 4 digitsBR-KSA-39 Seller VAT number is missingBR-KSA-40 Seller VAT number is not 15 digits starting and ending with 3BR-KSA-42 Buyer name is missing on a tax invoiceBR-KSA-44 Buyer VAT number is invalidBR-KSA-46 If it is an export invoice (KSA-2, position 5 is true), the…BR-KSA-49 If the tax exemption reason code (BT-121) is equal to…BR-KSA-51 The line amount with VAT (KSA-12) must be Invoice line net…BR-KSA-52 The line VAT amount (KSA-11) is mandatory for tax invoice…BR-KSA-53 The line amount with VAT (KSA-12) is mandatory for tax…BR-KSA-56 Credit or debit note without the original invoice numberBR-KSA-60 Cryptographic stamp is missing from a simplified invoiceBR-KSA-61 Previous invoice hash (PIH) is missingBR-KSA-63 Saudi buyer address is incompleteBR-KSA-66 Seller postal code is not 5 digitsBR-KSA-67 Saudi buyer postal code is not 5 digitsBR-KSA-68 Tax currency code is missingBR-KSA-69 Zero-rate or exemption reason code is missingBR-KSA-70 Issue time is in a format that is not acceptedBR-KSA-71 If the Invoice is a simplified invoice type and is a…BR-KSA-72 If the Invoice is a simplified invoice type and is a…BR-KSA-73 If Pre-Paid amount (BT-113) is provided, then the following…BR-KSA-74 Prepayment Document Type Code (KSA-30) for the Invoice line…BR-KSA-75 If Prepayment Document Type code (KSA-30) is provided in an…BR-KSA-76 An Invoice line (BG-25) where the Prepayment VAT category…BR-KSA-77 An Invoice line (BG-25) where the Prepayment VAT category…BR-KSA-78 An Invoice line (BG-25) where the Prepayment VAT category…BR-KSA-79 The Prepayment VAT Category Tax Amount (KSA-32) must be…BR-KSA-80 The Pre-Paid amount (BT-113) must be equal to the sum total…BR-KSA-81 The other Buyer ID (BT-46) must present in the tax invoice…BR-KSA-82 An Invoice line (BG-25) where Prepayment Document Type Code…BR-KSA-83 A VAT breakdown (BG-23) with VAT Category code (BT-118)…BR-KSA-84 Standard-rate VAT is not 15 or 5BR-KSA-85 The Buyer's contact phone number (BT-57) shall start with…BR-KSA-86 Buyer's Contact Email Address (BT-58) shall follow the…BR-KSA-87 [BR-KSA-87] If the tax exchange rate (KSA-36) exists, then…BR-KSA-88 [BR-KSA-88] If exist, Source Currency Code (KSA-37) must be…BR-KSA-89 [BR-KSA-89] If exists, Target Currency Code (KSA-38) must…BR-KSA-90 [BR-KSA-90] If exists, the allowed maximum number of digits…BR-KSA-91 For B2G supplies attracting provisions of Article 20(5) of…BR-KSA-92 If the Company Legal Form (KSA-40) is provided as 'GOV'…BR-KSA-93 An Invoice line (BG-25) where the Prepayment VAT category…BR-KSA-94 An Invoice line (BG-25) where the Prepayment VAT category…BR-KSA-95 An Invoice line (BG-25) where the Prepayment VAT category…BR-KSA-96 An Invoice line (BG-25) with the Prepayment VAT category…BR-KSA-CL-01 Currency code (BT-5) must be according to ISO 4217:2005BR-KSA-CL-02 All currencyID attributes (BT-5) must have the same value…BR-KSA-CL-03 Mime code must be according to subset of IANA code list.BR-KSA-CL-04 Zero-rate or exemption reason code does not fit the categoryBR-KSA-CL-06 Code for the reason for document level charge (BT-105) and…BR-KSA-CL-07 If the Prepayment VAT Category Code(KSA-33) is 'Z', or 'E'…BR-KSA-DEC-01 The allowance percentage values (BT-94, BT-138) must be…BR-KSA-DEC-02 The VAT rates (BT-96, BT-103, BT-119, BT-152, KSA-34) must…BR-KSA-DEC-03 VAT amount at line level (KSA-11) must have a maximum two…BR-KSA-DEC-04 Amount with VAT at line level (KSA-12) must have a maximum…BR-KSA-DEC-06 Prepayment VAT category Taxable Amount (KSA-31) and…BR-KSA-EN16931-01 Business process (ProfileID) is not reporting:1.0BR-KSA-EN16931-02 Tax currency is not SARBR-KSA-EN16931-03 Allowance/Charge amount (BT-92, BT-99, BT-136, BT-141) must…BR-KSA-EN16931-04 Allowance/Charge base amount (BT-93, BT-100, BT-137…BR-KSA-EN16931-05 Allowance/Charge percentage (BT-94, BT-101, BT-138, BT-143)…BR-KSA-EN16931-06 Charge on price level (BG-29) is allowed. The value of…BR-KSA-EN16931-07 Item net price (BT-146) must equal (Item Gross price…BR-KSA-EN16931-08 More than one tax total with a breakdownBR-KSA-EN16931-09 Only one tax total (BG-22) without tax subtotals (BG-23)…BR-KSA-EN16931-11 Line amount does not equal quantity × priceBR-KSA-EN16931-12 Base quantity (BT-149) must be a positive number above zero.BR-KSA-F-01 A date MUST be formatted YYYY-MM-DD, in accordance to the…BR-KSA-F-02 Allowance/Charge Indicator value MUST equal to…BR-KSA-F-03 Document MUST not contain empty elements.BR-KSA-F-04 Negative amount or quantityBR-KSA-F-05 Prepayment Issue Time (KSA-29) must be in the format…BR-KSA-F-06 Minimum & Maximum character limits should be maintained as…BR-KSA-F-06-C1 Field character limits for Invoice number field (BT-1) have…BR-KSA-F-06-C10 Field character limits for Seller name field (BT-27) have…BR-KSA-F-06-C11 Field character limits for the Buyer Address - Additional…BR-KSA-F-06-C12 Field character limits for Buyer name field (BT-44) have…BR-KSA-F-06-C13 Field character limits for Reasons for issuance of credit /…BR-KSA-F-06-C14 [BR-KSA-F-06-C14]Field character limits for Payment terms…BR-KSA-F-06-C15 Field character limits for Payment account identifier field…BR-KSA-F-06-C16 Field character limits for VAT exemption reason text field…BR-KSA-F-06-C17 Field character limits for Invoice line identifier field…BR-KSA-F-06-C18 Field character limits for Invoiced quantity unit of…BR-KSA-F-06-C19 Field character limits for Item name field (BT-153) have…BR-KSA-F-06-C2 Field character limits for Invoice note field (BT-22) have…BR-KSA-F-06-C20 Field character limits for Item standard identifier field…BR-KSA-F-06-C21 Field character limits for Item price base quantity unit…BR-KSA-F-06-C22 Field character limits for Billing reference ID field…BR-KSA-F-06-C23 Field character limits for the Buyer Address - Street field…BR-KSA-F-06-C24 Field character limits for the Buyer Address - Street field…BR-KSA-F-06-C25 Field character limits for the Buyer Address - City field…BR-KSA-F-06-C26 Field character limits for the Buyer Address - City field…BR-KSA-F-06-C27 Field character limits for the Buyer Address -…BR-KSA-F-06-C28 Field character limits for the Buyer Address - District…BR-KSA-F-06-C29 Field character limits for the Buyer Address - District…BR-KSA-F-06-C3 Field character limits for Purchase order ID field (BT-13)…BR-KSA-F-06-C30 Field character limits for Item Buyer's identifier field…BR-KSA-F-06-C31 Field character limits for Item Seller's identifier field…BR-KSA-F-06-C32 Field character limits for Buyer name field (BT-44) have…BR-KSA-F-06-C33 Field character limits for Reason for the document level…BR-KSA-F-06-C34 Field character limits for Reason for invoice line charge…BR-KSA-F-06-C35 Field character limits for Reason for the document level…BR-KSA-F-06-C36 Field character limits for Reason for the invoice line…BR-KSA-F-06-C37 Field character limits for the contact name - Buyer's…BR-KSA-F-06-C38 Field character limits for the contact note - Buyer's…BR-KSA-F-06-C39 Field character limits for the Prepayment VAT exemption…BR-KSA-F-06-C4 Field character limits for the Seller Address - Street…BR-KSA-F-06-C5 Field character limits for Contract ID field (BT-12) have…BR-KSA-F-06-C6 Field character limits for the Seller Address - Additional…BR-KSA-F-06-C7 Field character limits for the Seller Address - City field…BR-KSA-F-06-C8 Field character limits for the Seller Address -…BR-KSA-F-06-C9 Field character limits for the Seller Address - District…BR-O-01 An Invoice that contains an Invoice line (BG-25), a…BR-O-08 In a VAT breakdown (BG-23) where the VAT category code…BR-O-09 The VAT category tax amount (BT-117) in a VAT breakdown…BR-O-13 An Invoice that contains a VAT breakdown group (BG-23) with…BR-S-01 An Invoice that contains an Invoice line (BG-25), a…BR-S-05 For invoice items (BG-25) in which the VAT category code of…BR-S-06 In a Document level allowance (BG-20) where the Document…BR-S-07 -In a Document level charge (BG-21) where the Document…BR-S-08 Standard-rate taxable amount does not match the linesBR-S-09 Standard-rate VAT does not equal amount × rateBR-S-10 A VAT breakdown (BG-23) with VAT Category code (BT-118)…BR-Z-01 An Invoice that contains an Invoice line (BG-25), a…BR-Z-05 In an Invoice line (BG-25) where the Invoiced item VAT…BR-Z-06 In a Document level allowance (BG-20) where the Document…BR-Z-07 In a Document level charge (BG-21) where the Document level…BR-Z-08 In a VAT breakdown (BG-23) where the VAT category code…BR-Z-09 The VAT category tax amount (BT-117) in a VAT breakdown…

Frequently asked questions

What is the difference between an error and a warning?

An error rejects the invoice, so you fix it and send it again. A warning accepts the invoice with a note, but fix its cause in the next invoices.

Where do the codes come from?

From the validation rule files in ZATCA's SDK 238-R3.3.8 and from the XML Implementation Standard v1.2. We add no code without an official text.

My code has no explanation page?

Its official text is in the table. We started with the codes most tied to cashiers, restaurants and shops, and add the rest over time, logged in the changelog.

Last updated: 26 October 2026 · What we don't do · Methodology · Correct us · Changelog

First published 2026-10-26 · Archived copy

First 500 restaurants, cafés, bakeries and sweet shops: a SAR 99 monthly cap.

Instead of SAR 149, per branch, for a full year. Free to join, no commitment.

Reserve your seat