BR-Z-08: Zero-rated (Z) taxable amount must match its lines

Explained by Matheel from ZATCA's rule text and the condition SDK 3.4.8 executes · Updated October 24, 2026

Warning: accepted with a warningConditional, see belowFields: BG-23, BT-118, BT-116, BT-131, BT-92, BT-99, BT-151, BT-95, BT-102

For each cac:TaxSubtotal with VAT category 'Z' (Zero rated), cbc:TaxableAmount must equal the sum of cbc:LineExtensionAmount of lines with category Z, plus document-level charges, minus document-level allowances with category Z. The executed check also warns if no line or document-level allowance/charge uses category Z. The published test expression sums category 'S' amounts instead of 'Z' and passes whenever Z lines or allowances/charges exist; the executed check uses 'Z'.

How to fix it

Set the Z breakdown's cbc:TaxableAmount to Σ line net amounts (Z) + Σ document charges (Z) − Σ document allowances (Z), and remove the Z breakdown if no line or allowance/charge uses category Z.

ZATCA's official text

[BR-Z-08]-In 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".
Source: ZATCA SDK 3.4.8 · EN 16931 (CEN) rules

Fails when (the condition ZATCA's SDK runs)

count(/*/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory[normalize-space(cbc:ID) = 'Z'][cac:TaxScheme/normalize-space(upper-case(cbc:ID))='VAT'])> 0 and not(exists(../../../cac:AllowanceCharge/cac:TaxCategory[cac:TaxScheme/normalize-space(upper-case(cbc:ID))='VAT']/cbc:ID[normalize-space(.) = 'Z']) or exists(../../../cac:InvoiceLine[cac:Item/cac:ClassifiedTaxCategory[cac:TaxScheme/normalize-space(upper-case(cbc:ID))='VAT']/cbc:ID[normalize-space(.) = 'Z']])) or not( (xs:decimal(../cbc:TaxableAmount) =(sum(../../../cac:InvoiceLine[cac:Item/cac:ClassifiedTaxCategory/normalize-space(cbc:ID)='Z']/xs:decimal(cbc:LineExtensionAmount)) + sum(../../../cac:AllowanceCharge[cbc:ChargeIndicator=true()][cac:TaxCategory/normalize-space(cbc:ID)='Z']/xs:decimal(cbc:Amount)) - sum(../../../cac:AllowanceCharge[cbc:ChargeIndicator=false()][cac:TaxCategory/normalize-space(cbc:ID)='Z']/xs:decimal(cbc:Amount)) )))

Related rules

• BR-24 · Each invoice line needs a line net amount (BT-131)
• BR-31 · Each document-level allowance needs an amount (BT-92)
• BR-32 · Each document-level allowance needs a VAT category code (BT-95)
• BR-36 · Each document-level charge needs an amount (BT-99)
• BR-37 · Each document-level charge needs a VAT category code (BT-102)
• BR-45 · Each VAT breakdown needs a taxable amount (BT-116)