Validation rules

BR-Z-09

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.

Official sources

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.