BR-23

The invoiced quantity must carry a unit of measure (BT-130) — a code from UN/ECE Recommendation 20, not your item master's own abbreviation.

Severity: Error
Applies to: CII, UBL
Rule set: v2026-01-31

Official rule text

An Invoice line (BG-25) shall have an Invoiced quantity unit of measure code (BT-130).

Why does BR-23 happen?

Systems keep units as text: pcs, hrs, kg. The code is a translation that has to be built in the mapping first, and without it the attribute stays empty.

How do you fix BR-23?

Set the unitCode attribute on cbc:InvoicedQuantity in UBL, ram:BilledQuantity in CII: C62 for pieces, HUR for hours, KGM for kilograms, MTR for metres.

In the XML

A UBL fragment. The CII path is named above — same change, different element names.

Fails

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cbc:InvoicedQuantity>10</cbc:InvoicedQuantity>
  <cbc:LineExtensionAmount currencyID="EUR">1000.00</cbc:LineExtensionAmount>
  <cac:Item>
    <cbc:Name>Beratungsleistung</cbc:Name>
  </cac:Item>
  <cac:Price>
    <cbc:PriceAmount currencyID="EUR">100.00</cbc:PriceAmount>
  </cac:Price>
</cac:InvoiceLine>

Fixed

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cbc:InvoicedQuantity unitCode="C62">10</cbc:InvoicedQuantity>
  <cbc:LineExtensionAmount currencyID="EUR">1000.00</cbc:LineExtensionAmount>
  <cac:Item>
    <cbc:Name>Beratungsleistung</cbc:Name>
  </cac:Item>
  <cac:Price>
    <cbc:PriceAmount currencyID="EUR">100.00</cbc:PriceAmount>
  </cac:Price>
</cac:InvoiceLine>

NormAPI provides technical validation, not tax or legal advice.