What the field is for
The specification's description (above, in German) translates as: "The number of item units to
which the price applies." BT-149 says for how many units the price of a line applies. If 100
screws cost €2.10, the net price (BT-146) is 2.10 and the base quantity is 100. The
field is optional; without it, the price is for one unit.
The line amount (BT-131) is calculated with the base quantity:
BT-131 = quantity (BT-129) × net price (BT-146) / base quantity (BT-149)
What goes in it
A positive number in the same unit as the invoiced quantity (BT-130). For prices per
piece: leave it out or write 1.
Which rules check the field
| Rule | What it requires | Level in XRechnung |
|---|---|---|
| PEPPOL-EN16931-R121 | BT-149 is greater than zero | error |
| PEPPOL-EN16931-R130 | the unit of BT-149 (BT-150) is the unit of the quantity (BT-130) | error |
| BR-TMP-3 | in CII: if the base quantity is given with the gross and the net price, value and unit are equal | error |
| PEPPOL-EN16931-R120 | BT-131 matches the formula above | warning |
Where the field is in the file
| Syntax | Element |
|---|---|
| CII | ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice/ram:BasisQuantity (also with the gross price ram:GrossPriceProductTradePrice) |
| UBL | cac:InvoiceLine/cac:Price/cbc:BaseQuantity (credit note: cac:CreditNoteLine) |
Common mistakes
- No base quantity, but the price is for 100 pieces: quantity × price then does not match BT-131 → warning PEPPOL-EN16931-R120. The buyer's program calculates a hundred times the amount.
- Base quantity 0 → PEPPOL-EN16931-R121, the invoice is rejected.
- A different unit from the quantity (quantity in
H87, base quantity inC62) → PEPPOL-EN16931-R130. - Pack size instead of base quantity: BT-149 is the quantity the price refers to — not how many pieces are in a box.
Example
<!-- CII: 250 screws at €2.10 per 100 -->
<ram:SpecifiedLineTradeAgreement>
<ram:NetPriceProductTradePrice>
<ram:ChargeAmount>2.10</ram:ChargeAmount> <!-- BT-146 -->
<ram:BasisQuantity unitCode="H87">100</ram:BasisQuantity> <!-- BT-149, BT-150 -->
</ram:NetPriceProductTradePrice>
</ram:SpecifiedLineTradeAgreement>
<ram:SpecifiedLineTradeDelivery>
<ram:BilledQuantity unitCode="H87">250</ram:BilledQuantity> <!-- BT-129, BT-130 -->
</ram:SpecifiedLineTradeDelivery>
...
<ram:LineTotalAmount>5.25</ram:LineTotalAmount> <!-- BT-131 = 250 × 2.10 / 100 -->
<!-- UBL -->
<cac:Price>
<cbc:PriceAmount currencyID="EUR">2.10</cbc:PriceAmount>
<cbc:BaseQuantity unitCode="H87">100</cbc:BaseQuantity>
</cac:Price>
Sources: KoSIT, XRechnung specification 3.0.2 (BT-149, BT-150, section 11.26, PEPPOL-EN16931-R120/R121/R130); XRechnung 3.0.2 validator configuration (BR-TMP-3).