# 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

Canonical EN 16931 / XRechnung facts for this business term — citable from this anchor.

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

## 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-2, BR-DEC-05

## 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 Invoice line allowance charge indicator](/resources/xrechnung/bt-146-invoice-line-allowance-charge-indicator)

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

### BR-DEC-05
BR-DEC-05

## 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/)
- [Invoice Converter](/pdf-to-xrechnung)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)