Validation rules

BR-AE-01

Lines or document-level allowances/charges use VAT category "AE" (reverse charge), so the VAT breakdown (BG-23) must contain exactly one reverse-charge entry.

Rule: BR-AE-01 — official EN 16931 / XRechnung rule
Severity: error
Business term: BT-151 — Line VAT category
Field in your JSON: invoice.lines[*].vat_category
Detected by: tier 3 — KoSIT validator (authoritative)
Reachability: Triggerable from your request JSON (generate & validate)

normbill derives one breakdown per category and rate, so generated documents only violate this when AE is used with more than one rate — which already violates BR-AE-05.

How to fix it

Give every AE line, allowance and charge the same VAT rate 0 (line.vat: 0) — normbill then emits exactly one AE breakdown.

BR-AE-01 auf Deutsch — was bedeutet der Fehler?

Positionen oder Nachlässe/Zuschläge auf Dokumentebene verwenden die Kategorie "AE" (Reverse Charge), also muss die Umsatzsteueraufschlüsselung (BG-23) genau einen Reverse-Charge-Eintrag enthalten — der KoSIT-Validator lehnt die Rechnung sonst ab.

So beheben Sie den Fehler

Verwenden Sie für alle AE-Positionen, -Nachlässe und -Zuschläge denselben Steuersatz 0 (line.vat: 0) — normbill erzeugt dann genau eine AE-Aufschlüsselung.

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.