Validation rules

UBL-SR-01

The contract reference (BT-12) appears more than once — only one cac:ContractDocumentReference with one cbc:ID is allowed.

Rule: UBL-SR-01 — official EN 16931 / XRechnung rule
Severity: error
Detected by: tier 3 — KoSIT validator (authoritative)
Reachability: Only reachable when validating your own XML — normbill-generated documents cannot trigger it

The normbill invoice model has no contract reference; generated XML never contains cac:ContractDocumentReference.

How to fix it

Keep a single ContractDocumentReference element in your XML.

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

Der KoSIT-Validator lehnt die Rechnung ab, weil die Vertragsreferenz (BT-12) mehrfach vorkommt — es ist nur ein cac:ContractDocumentReference mit einer cbc:ID erlaubt.

So beheben Sie den Fehler

Behalten Sie genau ein ContractDocumentReference-Element im XML.

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.