Skip to content

BR-22: Invoiced quantity (BT-129) is missing

Official message

[BR-22] Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).

EN 16931 (CII) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-22] Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).

EN 16931 (UBL) · Error · Message language: English · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-22] Each Invoice line (BG-25) shall have an Invoiced quantity (BT-129).

Factur-X / ZUGFeRD EN 16931 · Error · Message language: English · Version: Factur-X 1.08 / ZUGFeRD 2.4
Severity
Error The invoice is invalid and may be rejected by the recipient.
Applies to
EN 16931 (CII), EN 16931 (UBL), Factur-X / ZUGFeRD EN 16931
Affected fields
BG-25, BT-129

What does this mean?

Every invoice line (BG-25) must contain an invoiced quantity (BT-129). The element is missing for at least one line.

Typical causes

No quantity was given for lump sums or services.
The generating system only writes the quantity if a unit is present as well, and the unit is missing.

How to fix the error

State the quantity for every line, e.g. 1 for lump sums; the unit (BT-130) belongs to it as attribute unitCode (BR-23).
CII: ram:SpecifiedLineTradeDelivery/ram:BilledQuantity, UBL: cbc:InvoicedQuantity or cbc:CreditedQuantity.
Generate and validate the invoice again.

In E-Rechnungsfreund

In the invoice form, section "Rechnungspositionen (BG-25)" (invoice lines), fill in the fields "Menge (BT-129)" (quantity) and "ME (BT-130)" (unit) for every line (simple view "Einfach": "Menge" and "Einheit"). The quantity is only output if a unit is selected as well.

Example

Wrong

<ram:IncludedSupplyChainTradeLineItem>
  ...
  <ram:SpecifiedLineTradeDelivery/>
  ...
</ram:IncludedSupplyChainTradeLineItem>

Correct

<ram:IncludedSupplyChainTradeLineItem>
  ...
  <ram:SpecifiedLineTradeDelivery>
    <ram:BilledQuantity unitCode="C62">1</ram:BilledQuantity>
  </ram:SpecifiedLineTradeDelivery>
  ...
</ram:IncludedSupplyChainTradeLineItem>
For developers: test expression per syntax

EN 16931 (CII) (CII)

Context: //ram:IncludedSupplyChainTradeLineItem

(ram:SpecifiedLineTradeDelivery/ram:BilledQuantity)

EN 16931 (UBL) (UBL)

Context: cac:InvoiceLine | cac:CreditNoteLine

exists(cbc:InvoicedQuantity) or exists(cbc:CreditedQuantity)

Factur-X / ZUGFeRD EN 16931 (CII)

Technical ID in the source: FX-SCH-A-000201

Context: //ram:IncludedSupplyChainTradeLineItem

(ram:SpecifiedLineTradeDelivery/ram:BilledQuantity)

Related validation rules

  • BR-01: Specification identifier (BT-24) is missing
  • BR-02: Invoice number (BT-1) is missing
  • BR-03: Invoice issue date (BT-2) is missing
  • BR-04: Invoice type code (BT-3) is missing
  • BR-05: Invoice currency code (BT-5) is missing
  • BR-06: Seller name (BT-27) is missing

Last updated:
Explanation of the validation rule, not legal or tax advice.