Validation rules

BR-CL-23

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

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.