Validation rules
BR-O-04
A document-level charge uses VAT category O ("not subject to VAT"), which forbids a seller VAT identifier (BT-31) and a buyer VAT identifier (BT-48) on the invoice.
- Rule
BR-O-04— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-31— Seller VAT identifier- Field in your JSON
invoice.seller.vat_id- Detected by
- tier 3 — KoSIT validator (authoritative)
- Reachability
- Triggerable from your request JSON (generate & validate)
How to fix it
Remove invoice.seller.vat_id and invoice.buyer.vat_id, or correct the charge's vat_category. Use invoice.seller.tax_number (BT-32) to keep satisfying BR-DE-16.
BR-O-04 auf Deutsch — was bedeutet der Fehler?
Ein Zuschlag auf Dokumentebene verwendet die Kategorie O ("nicht umsatzsteuerbar"); dann dürfen weder eine USt-IdNr. des Verkäufers (BT-31) noch eine USt-IdNr. des Käufers (BT-48) angegeben sein.
So beheben Sie den Fehler
Entfernen Sie invoice.seller.vat_id und invoice.buyer.vat_id — oder korrigieren Sie die vat_category des Zuschlags. Nutzen Sie invoice.seller.tax_number (BT-32), um BR-DE-16 weiter zu erfüllen.
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.