Reference
Markdown exportBT-97 Document level allowance reason
Text reason for the document-level allowance.
Quick answer
Text reason for the document-level allowance.
Discounts and charges
Document-level discounts, surcharges, and the tax data attached to them.
In plain language
Text reason for the document-level allowance.
Text 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
Free text
Typical valid values include: Volume discount, Early payment discount
Either BT-97 or BT-98 must be present for each document-level allowance.
What goes wrong often
Avoid values like:
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
- Volume discount
- Early payment discount
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-97
Data Type:
text
Cardinality:
0..1
Requirement:
Optional
Max Length:
500 characters
Since Version:
Optional
XML Implementation
/Invoice/cac:AllowanceCharge/cbc:AllowanceChargeReason/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ReasonValidation 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.