Skip to main content

BT-138 Invoice Line Allowance Percentage

The percentage used to calculate an invoice line allowance.

Quick answer

Line items

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

Quick actions

In plain language

Captures line-level discounts and surcharges so the invoice line net amount can be reconciled from quantity, price, allowances, and charges.

What you usually enter here

Decimal percentage

Typical valid values include: 10.00, 2.50

Defined by EN 16931 for invoice line allowance and charge details; apply profile cardinality and the listed code list or calculation rules when the element is present.

Where the field sits

Lines
UBL 2.1 Syntax
  1. Invoice
  2. cac:InvoiceLine
  3. cac:AllowanceCharge[cbc:ChargeIndicator=false()]
  4. cbc:MultiplierFactorNumericBT-138
CII (UN/CEFACT) Syntax
  1. rsm:CrossIndustryInvoice
  2. rsm:SupplyChainTradeTransaction
  3. ram:IncludedSupplyChainTradeLineItem
  4. ram:SpecifiedLineTradeSettlement
  5. ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()]
  6. ram:CalculationPercentBT-138
BT-138 belongs to the Lines part of the invoice. UBL 2.1 Syntax: Invoice › cac:InvoiceLine › cac:AllowanceCharge[cbc:ChargeIndicator=false()] › cbc:MultiplierFactorNumeric. CII (UN/CEFACT) Syntax: rsm:CrossIndustryInvoice › rsm:SupplyChainTradeTransaction › ram:IncludedSupplyChainTradeLineItem › ram:SpecifiedLineTradeSettlement › ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()] › ram:CalculationPercent.

What goes wrong often

Avoid values like: -1.00, 10%

Valid Examples

  • 10.00
  • 2.50

Invalid Examples

  • -1.00
  • 10%

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

Data Type:

percentage

Cardinality:

0..1

Requirement:

Optional

XML Implementation

UBL 2.1 Syntax
/Invoice/cac:InvoiceLine/cac:AllowanceCharge[cbc:ChargeIndicator=false()]/cbc:MultiplierFactorNumeric
CII (UN/CEFACT) Syntax
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=false()]/ram:CalculationPercent

Next step

Create an XRechnung from your PDF

The converter reads the invoice and shows the fields it found before download, so you can check and correct the values. No PDF? Fill in the XRechnung directly in the form.

Download requires an account. Subscriptions from €10/month with annual billing (excl. taxes), or €5 per conversion (excl. taxes) without a subscription.

Official sources and tools