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

- [Validate XML](/en/xrechnung-validator?source=resource&bt=BT-129)
- [Convert invoice](/en/pdf-to-xrechnung?source=resource&bt=BT-129)

## 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

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

## Related Fields

- [BT-130 Invoice line quantity unit of measure code](/resources/xrechnung/bt-130-invoice-line-quantity-unit-of-measure-code)
- [BT-131 Invoice line net amount](/resources/xrechnung/bt-131-invoice-line-net-amount)
- [BT-146 Item Net Price](/resources/xrechnung/bt-146-item-net-price)

## 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

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

- [Validate XML](/en/xrechnung-validator)
- [Convert invoice](/en/pdf-to-xrechnung)

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

## Official sources and tools

- [KoSIT Validator](https://erechnungsvalidator.service-bw.de/)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)