Skip to main content

BT-129 Invoice line quantity

The quantity of items (goods or services) in the invoice line.

BT-129 (Invoiced quantity) is the count of items billed on a line, paired with BT-130 (unit of measure). Mandatory under EN 16931. Decimal numbers are allowed for divisible units (e.g. hours, kilograms). Negative values represent returns. Example: 10.

BT-129 · EN 16931 / XRechnung 3.x

BT Reference Card

Key EN 16931 and XRechnung facts for this business term.

BT code
BT-129
Name
Invoice line quantity
Cardinality
Mandatory (M)
Business group
BG-25 INVOICE LINE
Data type
Quantity
Example value
10

Line items

The goods or services on each invoice line, including quantities, prices, and VAT.

Quick actions

In plain language

The quantity of items (goods or services) in the invoice line.

Essential for calculating line totals and inventory management.

What you usually enter here

Decimal number with up to 2 decimal places, positive

Typical valid values include: 1, 10, 0.5, 100.25

Mandatory for each invoice line according to EN 16931-1.

Where the field sits

Lines
UBL 2.1 Syntax
  1. Invoice
  2. cac:InvoiceLine
  3. cbc:InvoicedQuantityBT-129
CII (UN/CEFACT) Syntax
  1. rsm:CrossIndustryInvoice
  2. rsm:SupplyChainTradeTransaction
  3. ram:IncludedSupplyChainTradeLineItem
  4. ram:SpecifiedLineTradeDelivery
  5. ram:BilledQuantityBT-129
BT-129 belongs to the Lines part of the invoice. UBL 2.1 Syntax: Invoice › cac:InvoiceLine › cbc:InvoicedQuantity. CII (UN/CEFACT) Syntax: rsm:CrossIndustryInvoice › rsm:SupplyChainTradeTransaction › ram:IncludedSupplyChainTradeLineItem › ram:SpecifiedLineTradeDelivery › ram:BilledQuantity.

What goes wrong often

Avoid values like: -1, 0, quantity

Relevant rule codes: BR-22

Valid Examples

  • 1
  • 10
  • 0.5
  • 100.25

Invalid Examples

  • -1
  • 0
  • quantity

XML mapping and field facts

Open the technical reference if you need XML paths, validator rule codes, legal wording, or schema-specific mapping details.

Field ID:

BT-129

Data Type:

quantity

Cardinality:

1..1

Requirement:

Mandatory

Since Version:

XRechnung 1.0+

XML Implementation

UBL 2.1 Syntax
/Invoice/cac:InvoiceLine/cbc:InvoicedQuantity
CII (UN/CEFACT) Syntax
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeDelivery/ram:BilledQuantity

Validation Rules

BR-22

BR-22

Next step

Check whether your XRechnung sets BT-129 correctly

Upload the XML file to the free validator. It applies the KoSIT rules for XRechnung 3.0 and names each finding with its rule ID, for this field for example BR-22. Creating a new invoice instead? The converter checks the invoice against the same rules and shows the findings before download.

Free, no account needed. XML file up to 2 MB.

Official sources and tools