Reference
Markdown exportBT-98 Document level allowance reason code
Coded reason for the document-level allowance.
Quick answer
Discounts and charges
Document-level discounts, surcharges, and the tax data attached to them.
Quick actions
In plain language
Coded reason for the document-level allowance.
Coded reason for the document-level allowance.
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
UN/CEFACT allowance/charge reason code
Typical valid values include: 41, 42, 60
Either BT-97 or BT-98 must be present for each document-level allowance.
What goes wrong often
Avoid values like: discount, 999
Relevant rule codes: BR-33, BR-CO-21
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.
Either BT-97 or BT-98 must be present for each document-level allowance.
Valid Examples
- 41
- 42
- 60
Invalid Examples
- discount
- 999
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-98
Data Type:
code
Cardinality:
0..1
Requirement:
Optional
Max Length:
3 characters
Since Version:
Optional
XML Implementation
/Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReasonCode/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCodeValidation Rules
BR-33
BR-33
BR-CO-21
BR-CO-21
Next step
Check whether your XRechnung sets BT-98 correctly
Upload the XML file to the free validator. It applies the KoSIT rules for XRechnung 3.0 and names each finding with its rule ID, for this field for example BR-33, BR-CO-21. Creating a new invoice instead? The converter checks the invoice against the same rules and shows the findings before download.
Free, no account needed. XML file up to 2 MB.
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
Either BT-97 or BT-98 must be present for each document-level allowance.