Skip to content

BR-Z-09: Tax amount of category Z (BT-117) is not 0

Official message

[BR-Z-09] The 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).

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

[BR-Z-09] The 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).

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

[BR-Z-09] The 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).

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
BT-117, BG-23, BT-118

What does this mean?

In a VAT breakdown (BG-23) with category Z (Zero rated) the VAT category tax amount (BT-117) must be 0 (zero). Another amount is stated.

Typical causes

A rate greater than zero (e.g. 19) was kept for lines of category Z, so a tax amount was calculated.
The tax amount was entered manually.

How to fix the error

Set BT-117 in the breakdown of category Z to 0.
Check that the rate of the breakdown (BT-119) and of the lines and allowances/charges of category Z is 0 (BR-Z-05 to BR-Z-07).
CII: ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CalculatedAmount, UBL: cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount.

In E-Rechnungsfreund

In the invoice form, the tax amount per VAT category (BT-117) is calculated from taxable amount and rate when the XML is generated; the value in the field "Steuerbetrag (BT-117)" in section "Steueraufstellung (BG-23)" (VAT breakdown) is not used. Enter 0 in the fields "Steuersatz % (BT-152)" and "St-Satz %" ("Experte" view) for lines and allowances/charges of category Z.

Example

Wrong

<ram:ApplicableTradeTax>
  <ram:CalculatedAmount>190.00</ram:CalculatedAmount>
  <ram:TypeCode>VAT</ram:TypeCode>
  <ram:BasisAmount>1000.00</ram:BasisAmount>
  <ram:CategoryCode>Z</ram:CategoryCode>
  <ram:RateApplicablePercent>0</ram:RateApplicablePercent>
</ram:ApplicableTradeTax>

Correct

<ram:ApplicableTradeTax>
  <ram:CalculatedAmount>0.00</ram:CalculatedAmount>
  <ram:TypeCode>VAT</ram:TypeCode>
  <ram:BasisAmount>1000.00</ram:BasisAmount>
  <ram:CategoryCode>Z</ram:CategoryCode>
  <ram:RateApplicablePercent>0</ram:RateApplicablePercent>
</ram:ApplicableTradeTax>
For developers: test expression per syntax

EN 16931 (CII) (CII)

Context: //ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode[. = 'Z']

../ram:CalculatedAmount = 0

EN 16931 (UBL) (UBL)

Context: /*/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory[normalize-space(cbc:ID) = 'Z'][cac:TaxScheme/normalize-space(upper-case(cbc:ID))='VAT']

xs:decimal(../cbc:TaxAmount) = 0

Factur-X / ZUGFeRD EN 16931 (CII)

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

Context: //ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode[. = 'Z']

../ram:CalculatedAmount = 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-06: VAT rate of document level allowance with category Z is not 0

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