Validation rules
UBL-SR-12
The seller VAT identifier (BT-31) appears more than once — only one PartyTaxScheme with TaxScheme/ID 'VAT' may carry a CompanyID.
- Rule
UBL-SR-12— 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
- Only reachable when validating your own XML — normbill-generated documents cannot trigger it
The serializer emits at most one VAT PartyTaxScheme, from invoice.seller.vat_id.
How to fix it
Keep a single VAT PartyTaxScheme on the supplier party. Through normbill, invoice.seller.vat_id is a single value.
UBL-SR-12 auf Deutsch — was bedeutet der Fehler?
Der KoSIT-Validator lehnt die Rechnung ab, weil die USt-IdNr. des Verkäufers (BT-31) mehrfach vorkommt — nur ein PartyTaxScheme mit TaxScheme/ID „VAT“ darf eine CompanyID tragen.
So beheben Sie den Fehler
Behalten Sie genau ein VAT-PartyTaxScheme beim Verkäufer. Über normbill ist invoice.seller.vat_id ein einzelner Wert.
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.