Validation rules
UBL-CR-002
cbc:UBLVersionID is present with a value other than 2.1. EN 16931 invoices are UBL 2.1 — omit the element or set it to exactly 2.1.
- Rule
UBL-CR-002— official EN 16931 / XRechnung rule- Severity
- warning
- Detected by
- tier 3 — KoSIT validator (authoritative)
- Reachability
- Only reachable when validating your own XML — normbill-generated documents cannot trigger it
normbill's serializer omits UBLVersionID entirely; the namespace already pins UBL 2.1.
How to fix it
Remove cbc:UBLVersionID, or set it to "2.1".
UBL-CR-002 auf Deutsch — was bedeutet der Fehler?
Der KoSIT-Validator meldet eine Warnung, weil cbc:UBLVersionID mit einem anderen Wert als 2.1 vorhanden ist. Rechnungen nach EN 16931 sind UBL 2.1 — das Element entfällt oder trägt exakt 2.1.
So beheben Sie den Fehler
Entfernen Sie cbc:UBLVersionID — oder setzen Sie es auf "2.1".
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.