Reference
Markdown exportBT-101 Document level charge percentage
The percentage used with the charge base amount to calculate the charge amount.
Quick answer
The percentage used with the charge base amount to calculate the charge amount.
Discounts and charges
Document-level discounts, surcharges, and the tax data attached to them.
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%
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
/Invoice/cac:AllowanceCharge/cbc:MultiplierFactorNumeric/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CalculationPercentValidation Rules
PEPPOL-EN16931-R040
PEPPOL-EN16931-R040
PEPPOL-EN16931-R041
PEPPOL-EN16931-R041
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.