Skip to content
Theme
English
Sign in
Theme

Fatal: fails the selected checks

BR-CL-23: Units of measure must come from UN/ECE Recommendation 20 or 21

In short

BR-CL-23 means a unit of measure code (BT-130 or BT-150) is not in UN/ECE Recommendation 20 or 21. Map the units in your invoicing software to UN/ECE codes (most programs have a setting for this) and export again.

On this page

What it means

Every unit of measure, for quantities (BT-130) and for the price base quantity (BT-150), must be a code from UN/ECE Recommendation 20 or 21, for example C62 for pieces (one), H87 for piece, HUR for hours, DAY for days, KGM for kilograms or MTR for metres. Abbreviations such as "pcs", "Stk", "h" or "kg" are not codes.

Why it matters

Codes are read by software, not by people. A value outside the agreed code list cannot be interpreted, so the recipient's system rejects the invoice even when the value looks sensible to a person.

How to fix it

Map the units in your invoicing software to UN/ECE codes (most programs have a setting for this) and export again. If you build the XML yourself, write the code in the unitCode attribute, for example unitCode="HUR" for hours.

The rule as published

Unit code MUST be coded according to the UN/ECE Recommendation 20 with Rec 21 extension

Where this rule applies

Rule set Version
EN 16931 (UBL) 1.3.17
EN 16931 (UBL credit note) 1.3.17
EN 16931 (CII) 1.3.17
XRechnung 3.0 (UBL) 3.0.2
XRechnung 3.0 (UBL credit note) 3.0.2
XRechnung 3.0 (CII) 3.0.2
Peppol BIS Billing 3.0 (invoice) 2026.5
Peppol BIS Billing 3.0 (credit note) 2026.5
SI-UBL 2.0 / NLCIUS (invoice) 2.0.3.13
SI-UBL 2.0 / NLCIUS (credit note) 2.0.3.13
NLCIUS (CII) 1.0.3.13
France CTC (UBL invoice) 1.4.0-04
France CTC (UBL credit note) 1.4.0-04
France CTC (CII) 1.4.0-04
CIUS-RO UBL Invoice 1.0.9 1.0.9
CIUS-RO UBL Credit Note 1.0.9 1.0.9
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether BR-CL-23 still fails, and which other rules do.