Validation rules
BR-Z-09 — EN 16931 rule
The tax amount (BT-117) of the zero-rated (Z) breakdown must be 0.
- Rule
BR-Z-09— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-117— VAT category tax amount- Field in your JSON
invoice.lines- Detected by
- tier 3 — KoSIT validator (authoritative)
- Reachability
- Triggerable from your request JSON (generate & validate)
How to fix it
Set line.vat to 0 on Z lines (and vat: 0 on Z allowances/charges) — any other rate makes normbill compute non-zero VAT for the group.
BR-Z-09 auf Deutsch — was bedeutet der Fehler?
Der Steuerbetrag (BT-117) der Nullsatz-Aufschlüsselung (Z) muss 0 sein — der KoSIT-Validator lehnt die Rechnung sonst ab.
So beheben Sie den Fehler
Setzen Sie line.vat auf 0 bei Z-Positionen (und vat: 0 bei Z-Nachlässen/-Zuschlägen); jeder andere Satz führt zu berechneter Umsatzsteuer in der Gruppe.
Related rules
BR-46— A VAT breakdown (BG-23) has no tax amount (BT-117).BR-CO-17— A VAT breakdown's tax amount (BT-117) does not equal its taxable amount (BT-116) multiplied by the category…BR-DEC-20— A VAT category tax amount (BT-117) uses more than 2 decimal places — EN 16931 allows at most 2.BR-AE-09— The tax amount (BT-117) of the reverse-charge (AE) breakdown must be 0.BR-AF-09— The tax amount (BT-117) of an IGIC (L) breakdown must equal its taxable amount (BT-116) multiplied by its…BR-AG-09— The tax amount (BT-117) of an IPSI (M) breakdown must equal its taxable amount (BT-116) multiplied by its…
Official sources
- XRechnung specification (KoSIT / xeinkauf.de)
- KoSIT validator on GitHub and the XRechnung validator configuration
Every 422 from the API lists the rule id, the path in your request JSON, a plain-language message and a suggested fix — see the docs overview for the report format.
Or try it live: drop any XRechnung XML on the free validator — same KoSIT-backed report, no account.