Validation rules

BR-CL-23 — EN 16931 rule

A unit code (BT-130 invoiced quantity, BT-150 price base quantity) is not part of UN/ECE Recommendation 20/21; the document is still accepted.

Rule: BR-CL-23 — official EN 16931 / XRechnung rule
Severity: warning
Detected by: tier 3 — KoSIT validator (authoritative)
Reachability: Triggerable from your request JSON (generate & validate)

line.unit is free text (default C62), so unknown units reach the validator. Officially fatal, but the pinned KoSIT configuration downgrades BR-CL-23 to a warning (customLevel). The code list has roughly 2,600 entries — membership checking is deliberately left to the KoSIT tier rather than duplicating the list in the engine.

How to fix it

Set line.unit to a UN/ECE Rec 20/21 code — common ones: "C62" (piece, the default), "HUR" (hour), "DAY" (day), "KGM" (kilogram).

BR-CL-23 auf Deutsch — was bedeutet der Fehler?

Eine Mengeneinheit (BT-130 Rechnungsmenge, BT-150 Preisbasismenge) stammt nicht aus der UN/ECE-Empfehlung 20/21. Offiziell ein Fehler, in der gepinnten KoSIT-Konfiguration jedoch zur Warnung herabgestuft — der Validator meldet eine Warnung, das Dokument bleibt angenommen. Empfängersysteme können die Einheit aber unter Umständen nicht verarbeiten.

So beheben Sie den Fehler

Setzen Sie line.unit auf einen Code der UN/ECE-Empfehlung 20/21 — gebräuchlich sind "C62" (Stück, der Standardwert), "HUR" (Stunden), "DAY" (Tage) und "KGM" (Kilogramm).

Related rules

BR-CL-22 — A VAT exemption reason code (BT-121) is not part of the VATEX code list.
BR-CL-24 — The MIME type of an embedded attachment (BT-125 mimeCode) is not one of the types EN 16931 permits (PDF,…
BR-CL-25 — An electronic address scheme (BT-34 seller, BT-49 buyer — the schemeID on cbc:EndpointID) is not part of the…
BR-CL-21 — The scheme of an item standard identifier (BT-157 schemeID) is not part of the ISO/IEC 6523 ICD list.
BR-CL-20 — A charge reason code (BT-105 document level, BT-145 line level) is not a UNTDID 7161 code.
BR-CL-26 — The scheme of a delivery location identifier (BT-71 schemeID) is not part of the ISO/IEC 6523 ICD list.

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.