Validation rules

UBL-SR-18

The buyer VAT identifier (BT-48) appears more than once — only one PartyTaxScheme with TaxScheme/ID 'VAT' may carry a CompanyID.

Rule: UBL-SR-18 — official EN 16931 / XRechnung rule
Severity: error
Business term: BT-48 — Buyer VAT identifier
Field in your JSON: invoice.buyer.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 buyer VAT PartyTaxScheme, from invoice.buyer.vat_id.

How to fix it

Keep a single VAT PartyTaxScheme on the customer party. Through normbill, invoice.buyer.vat_id is a single value.

UBL-SR-18 auf Deutsch — was bedeutet der Fehler?

Der KoSIT-Validator lehnt die Rechnung ab, weil die USt-IdNr. des Käufers (BT-48) 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 Käufer. Über normbill ist invoice.buyer.vat_id ein einzelner Wert.

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.