Skip to main content

BT-101 Document level charge percentage

The percentage used with the charge base amount to calculate the charge amount.

Quick answer

Discounts and charges

Document-level discounts, surcharges, and the tax data attached to them.

Quick actions

In plain language

Document-level allowances reduce the invoice total; document-level charges increase it. ChargeIndicator selects the BG-20 allowance or BG-21 charge interpretation in UBL/CII.

What you usually enter here

Decimal percentage, transmitted together with BT-100 when used

Typical valid values include: 10.00, 5.50

Optional, but must be paired with BT-100 when percentage-based calculation is used.

Where the field sits

Totals and tax
UBL 2.1 Syntax
  1. Invoice
  2. cac:AllowanceCharge[cbc:ChargeIndicator=true()]
  3. cbc:MultiplierFactorNumericBT-101
CII (UN/CEFACT) Syntax
  1. rsm:CrossIndustryInvoice
  2. rsm:SupplyChainTradeTransaction
  3. ram:ApplicableHeaderTradeSettlement
  4. ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=true()]
  5. ram:CalculationPercentBT-101
BT-101 belongs to the Totals and tax part of the invoice. UBL 2.1 Syntax: Invoice › cac:AllowanceCharge[cbc:ChargeIndicator=true()] › cbc:MultiplierFactorNumeric. CII (UN/CEFACT) Syntax: rsm:CrossIndustryInvoice › rsm:SupplyChainTradeTransaction › ram:ApplicableHeaderTradeSettlement › ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator=true()] › ram:CalculationPercent.

What goes wrong often

Avoid values like: -5.00, 10%

Relevant rule codes: PEPPOL-EN16931-R040, PEPPOL-EN16931-R041

Valid Examples

  • 10.00
  • 5.50

Invalid Examples

  • -5.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-101

Data Type:

percentage

Cardinality:

0..1

Requirement:

Optional

XML Implementation

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

Validation Rules

PEPPOL-EN16931-R040

PEPPOL-EN16931-R040

PEPPOL-EN16931-R041

PEPPOL-EN16931-R041

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