# BT-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.

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

## 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-97 Document level allowance reason](/resources/xrechnung/bt-97-document-level-allowance-reason)

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

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

### CII (UN/CEFACT) Syntax
```
/CrossIndustryInvoice/SupplyChainTradeTransaction/ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode
```

## Validation 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.

## Official sources and tools

- [KoSIT Validator](https://erechnungsvalidator.service-bw.de/)
- [Invoice Converter](/pdf-to-xrechnung)
- [XRechnung Standard](https://xeinkauf.de/xrechnung/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)