XML File Causing BR-S-06 and BR-KSA-84 Errors

General
1

cac:AllowanceCharge
cbc:ChargeIndicatorfalse</cbc:ChargeIndicator>
cbc:AllowanceChargeReasonCode</cbc:AllowanceChargeReasonCode>
cbc:AllowanceChargeReason</cbc:AllowanceChargeReason>
<cbc:Amount currencyID=“SAR”>0.00</cbc:Amount>
cac:TaxCategory
cbc:IDS</cbc:ID>
cbc:Percent0.00</cbc:Percent>
cac:TaxScheme
cbc:IDVAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:AllowanceCharge>

Errors:

  • BR-S-06: In 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.
  • BR-KSA-84: The 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 category code is ‘Standard rated’.

We are not applying any document-level allowance manually, but the system may be generating it automatically — especially for discounts or inclusive pricing.

Important Notes:

  • The same VAT configuration works perfectly for POS invoices, even with discounts.
  • The error only appears when submitting standard Sales Invoices.
  • We are using 1-Frappe|2-15|3-1 as our unit serial on Fatoorah.
  • All required address, tax, and business settings are configured properly.
  • This behavior only occurs in the Production environment.

Request:

  • Could you help us identify what may be generating the invalid Document Level Allowance section?
  • Is there a way to enforce item-level discount VAT handling instead of document-level to avoid this issue?
  • Could you confirm if this is a known issue or a configuration bug?

We appreciate your help in resolving this to ensure full ZATCA compliance for standard invoices.

ZATCA Submission Error (BR-S-06, BR-KSA-84) – Document Level Allowance VAT Issue on Standard Invoice
2

@Ahmdr2 you are getting these warnings and errors because VAT percentage is provided as 0 while VAT Category is “S” (standard rated). You have two options to fix these, first one is to remove document level allowance tags completely or second option is to simply update the percent from 0 to 15 <cbc:Percent15</cbc:Percent>. When VAT Category Code is standard rate, the VAT rate (percent tag) must be 15.