Validation rules

UBL-CR-002 — UBL rule

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".

Related rules

UBL-CR-001 — The document contains ext:UBLExtensions. Extensions are valid UBL but not part of the EN 16931 core model —…
UBL-CR-006 — cbc:IssueTime is present. The EN 16931 core model works with dates only (BT-2) — a time of day is not part…
UBL-CR-561 — An invoice line contains cac:TaxTotal. In EN 16931 VAT is broken down at document level only (BG-23) — lines…
UBL-CR-646 — An invoice line contains cac:SubInvoiceLine. XRechnung prohibits sub-invoice lines — the KoSIT validator…

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.