# 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

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

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

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.

## What goes wrong often

Avoid values like: -5.00, 10%

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

## Examples in context

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.

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

## Valid Examples

- 10.00
- 5.50

## Invalid Examples

- -5.00
- 10%

## Related Fields

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.

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

### Since Version:
Optional

## XML Implementation

### UBL 2.1 Syntax
```
/Invoice/cac:AllowanceCharge/cbc:MultiplierFactorNumeric
```

### CII (UN/CEFACT) Syntax
```
/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/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.

## Why the standard cares about this field

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

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

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