# 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

## Quick answer

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

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

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.

## What goes wrong often

Avoid values like: -1, 0, quantity

Relevant rule codes: BR-22

## Examples in context

Essential for calculating line totals and inventory management.

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

## Valid Examples

- 1
- 10
- 0.5
- 100.25

## Invalid Examples

- -1
- 0
- quantity

## Related Fields

Essential for calculating line totals and inventory management.

- [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
```
/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeSettlementLineMonetarySummation/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.

## Why the standard cares about this field

### Business Context
Essential for calculating line totals and inventory management.

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

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