Validation rules

BR-Z-08

The taxable amount (BT-116) of the zero-rated (Z) breakdown does not equal the sum of line net amounts minus allowances plus charges with category Z.

Rule: BR-Z-08 — official EN 16931 / XRechnung rule
Severity: error
Business term: BT-116 — VAT category taxable amount
Field in your JSON: invoice.lines
Detected by: tier 3 — KoSIT validator (authoritative)
Reachability: Triggerable from your request JSON (generate & validate)

The engine computes breakdown amounts from the lines, so generated documents only violate this when Z is used with more than one rate.

How to fix it

Use VAT rate 0 on every Z line, allowance and charge — a second Z rate splits the breakdown so no part matches the category-wide sum this rule checks.

BR-Z-08 auf Deutsch — was bedeutet der Fehler?

Der Grundbetrag (BT-116) der Nullsatz-Aufschlüsselung (Z) entspricht nicht der Summe der Positionsnettobeträge abzüglich Nachlässen zuzüglich Zuschlägen der Kategorie Z. Bei normbill passiert das nur, wenn Z mit mehr als einem Steuersatz verwendet wird.

So beheben Sie den Fehler

Verwenden Sie den Steuersatz 0 auf allen Z-Positionen, -Nachlässen und -Zuschlägen — ein zweiter Z-Satz teilt die Aufschlüsselung so auf, dass keine Teilsumme mehr passt.

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.