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

- [Validate XML](/en/xrechnung-validator?source=resource&bt=BT-101)
- [Convert invoice](/en/pdf-to-xrechnung?source=resource&bt=BT-101)

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

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%

## Related Fields

- [BT-99 Document level charge amount](/resources/xrechnung/bt-99-document-level-charge-amount)
- [BT-100 Document level charge base amount](/resources/xrechnung/bt-100-document-level-charge-base-amount)

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

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

- [Convert invoice](/en/pdf-to-xrechnung)
- [Fill in XRechnung in the form](/en/create-xrechnung)

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

- [KoSIT Validator](https://erechnungsvalidator.service-bw.de/)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)