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-04official 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

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.

Spotted something?

Bug, missing feature, wrong validation result — tell us. The page you're on is attached automatically; email optional.