# BR-36 Document level charge amount is required

Each Document level charge (BG-21) shall have a Document level charge amount (BT-99).

## Problem Description

> **ERROR**: EN 16931 core business rule (CEN)

## Context and Significance

This is an EN 16931 core rule and the charge counterpart of BR-31. A document level charge (BG-21), such as freight, packaging or a handling fee, raises the invoice total without VAT (BT-109); without its amount the totals cannot be recalculated. The UBL schema already requires cbc:Amount, so BR-36 is mainly reported for CII invoices whose charge holds only a reason or a percentage.

## Solution

Add cbc:Amount to the document level cac:AllowanceCharge where cbc:ChargeIndicator is true (CII: ram:ActualAmount in ram:SpecifiedTradeAllowanceCharge with ram:ChargeIndicator true).

- [Validate XML](/en/xrechnung-validator?source=resource&rule=BR-36)
- [Convert invoice](/en/pdf-to-xrechnung?source=resource&rule=BR-36)

## Valid Examples

- BT-99 = 9.90 on a document level charge (e.g. freight)

## Invalid Examples

- CII document level charge with a reason but no ram:ActualAmount (BT-99); in UBL a cac:AllowanceCharge without cbc:Amount is already an XML schema error

## Code Examples

### Valid XML
```
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>true</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:ActualAmount>9.90</ram:ActualAmount>
  <ram:Reason>Freight</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>
```

### Invalid XML
```
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>true</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:Reason>Freight</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>
```

## Affected Fields

- [BT-99 Document level charge amount](/resources/xrechnung/bt-99-document-level-charge-amount)

## Related Rules

- [BR-37](/resources/kosit-validator-errors/br-37-document-charge-vat-category-required)
- [BR-38](/resources/kosit-validator-errors/br-38-document-charge-reason-required)
- [BR-31](/resources/kosit-validator-errors/br-31-document-allowance-amount-required)

## Validation Tools

- [Official KoSIT Validator](https://github.com/itplr-kosit/validator): Run the official KoSIT validator with the XRechnung configuration to check EN 16931 and XRechnung rules.
- [Convert PDF to XRechnung](/pdf-to-xrechnung): Find validation errors during conversion and review each correction.

## Related Resources

- [Official Specification](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Test Suite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [All validation errors](/resources/kosit-validator-errors): Overview of the EN 16931, XRechnung and Peppol validation rules explained here.