Reference
Markdown exportBT-98 Document level allowance reason code
Coded reason for the document-level allowance.
Quick answer
Coded reason for the document-level allowance.
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
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.