Skip to content

BR-Z-06: VAT rate of document level allowance with category Z is not 0

Official message

[BR-Z-06] In 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).

EN 16931 (CII) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-Z-06] In 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).

EN 16931 (UBL) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-Z-06] In 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).

Factur-X / ZUGFeRD EN 16931 · Error · Message language: English · Version: Factur-X 1.08 / ZUGFeRD 2.4
Severity
Error The invoice is invalid and may be rejected by the recipient.
Applies to
EN 16931 (CII), EN 16931 (UBL), Factur-X / ZUGFeRD EN 16931
Affected fields
BG-20, BT-95, BT-96

What does this mean?

For a document level allowance (BG-20) with VAT category (BT-95) Z (Zero rated) the document level allowance VAT rate (BT-96) must be 0 (zero). The rate has another value or is missing.

Typical causes

Category Z was selected but the previous rate (e.g. 19) was kept.
The rate is missing; it must be stated as 0.

How to fix the error

State rate 0 for every document level allowance of category Z.
If the rate does not match the category, correct the category and adjust the VAT breakdown (BG-23).
CII: ram:SpecifiedTradeAllowanceCharge (ChargeIndicator false)/ram:CategoryTradeTax/ram:RateApplicablePercent, UBL: cac:AllowanceCharge (cbc:ChargeIndicator false)/cac:TaxCategory/cbc:Percent.

In E-Rechnungsfreund

In the invoice form ("Experte" view), section "Zu-/Abschläge auf Dokumentenebene (BG-20/BG-21)" (document level allowances and charges), for every entry of type "Abschlag (BG-20)" (allowance) with "St-Kat." (VAT category) Z enter 0 in the field "St-Satz %" (VAT rate). An empty field is not written to the XML for the allowance/charge.

Example

Wrong

<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>false</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:ActualAmount>50.00</ram:ActualAmount>
  <ram:Reason>Discount</ram:Reason>
  <ram:CategoryTradeTax>
    <ram:TypeCode>VAT</ram:TypeCode>
    <ram:CategoryCode>Z</ram:CategoryCode>
    <ram:RateApplicablePercent>19.00</ram:RateApplicablePercent>
  </ram:CategoryTradeTax>
</ram:SpecifiedTradeAllowanceCharge>

Correct

<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>false</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:ActualAmount>50.00</ram:ActualAmount>
  <ram:Reason>Discount</ram:Reason>
  <ram:CategoryTradeTax>
    <ram:TypeCode>VAT</ram:TypeCode>
    <ram:CategoryCode>Z</ram:CategoryCode>
    <ram:RateApplicablePercent>0</ram:RateApplicablePercent>
  </ram:CategoryTradeTax>
</ram:SpecifiedTradeAllowanceCharge>
For developers: test expression per syntax

EN 16931 (CII) (CII)

Context: //ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()]/ram:CategoryTradeTax[ram:CategoryCode = 'Z'][upper-case(ram:TypeCode) = 'VAT']

ram:RateApplicablePercent = 0

EN 16931 (UBL) (UBL)

Context: cac:AllowanceCharge[cbc:ChargeIndicator=false()]/cac:TaxCategory[normalize-space(cbc:ID)='Z'][cac:TaxScheme/normalize-space(upper-case(cbc:ID))='VAT']

(xs:decimal(cbc:Percent) = 0)

Factur-X / ZUGFeRD EN 16931 (CII)

Technical ID in the source: FX-SCH-A-000098

Context: //ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='false']/ram:CategoryTradeTax[ram:CategoryCode = 'Z']

ram:RateApplicablePercent = 0

Related validation rules

  • BR-Z-01: Not exactly one VAT breakdown for category Z
  • BR-Z-02: Seller VAT or tax registration identifier missing for invoice line with category Z
  • BR-Z-03: Seller VAT or tax registration identifier missing for document level allowance with category Z
  • BR-Z-04: Seller VAT or tax registration identifier missing for document level charge with category Z
  • BR-Z-05: VAT rate of invoice line with category Z is not 0
  • BR-Z-07: VAT rate of document level charge with category Z is not 0

Last updated:
Explanation of the validation rule, not legal or tax advice.