# BR-36 Toeslagbedrag op documentniveau is verplicht

Elke toeslag op documentniveau (BG-21) moet een toeslagbedrag op documentniveau (BT-99) bevatten.

## Probleembeschrijving

> **FOUT**: Bedrijfsregel van EN 16931 (CEN)

> **Waar BR-36 wordt gecontroleerd**
>
> Een validator controleert een e-factuur in stappen. Eerst moet het bestand goed gevormde XML zijn die past bij het UBL- of CII-schema (XSD). Dan volgen de bedrijfsregels van EN 16931: BR-kernregels, BR-CO-berekeningen, BR-CL-codelijsten, BR-DEC-decimalen en regels per btw-categorie zoals BR-S. Daarna komen de nationale of netwerkregels die BT-24 kiest: BR-DE voor XRechnung, PEPPOL-EN16931 voor Peppol BIS Billing. Het rapport noemt elke geschonden regel: één fout betekent afwijzen, alleen waarschuwingen betekenen nog steeds accepteren. BR-36: kernregel van EN 16931, gemeld in de stap “EN 16931-regels”.

## Context en betekenis

Dit is een kernregel van EN 16931 en de tegenhanger van BR-31 voor toeslagen. Een toeslag op documentniveau (BG-21), zoals vracht of verpakking, verhoogt het factuurtotaal zonder btw (BT-109); zonder bedrag zijn de totalen niet na te rekenen. In UBL 2.1 is cbc:Amount al schema-verplicht; ontbreekt het, dan meldt de validator eerst een XML-schemafout. BR-36 ziet u vooral in CII, wanneer een toeslag geen ram:ActualAmount bevat.

## Oplossing

Voeg cbc:Amount toe aan de cac:AllowanceCharge op documentniveau waar cbc:ChargeIndicator true is (CII: ram:ActualAmount in ram:SpecifiedTradeAllowanceCharge met ram:ChargeIndicator true).

- [XML valideren](/nl/xrechnung-validator?source=resource&rule=BR-36)
- [Factuur converteren](/nl/pdf-to-xrechnung?source=resource&rule=BR-36)

## Geldige voorbeelden

- BT-99 = 9,90 bij een toeslag op documentniveau (bijv. vracht)

## Ongeldige voorbeelden

- CII-documenttoeslag met reden maar zonder ram:ActualAmount (BT-99); in UBL geeft een cac:AllowanceCharge zonder cbc:Amount al een XML-schemafout

## Codevoorbeelden

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

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

## Betrokken velden

- [BT-99 Toeslagbedrag op documentniveau](/resources/xrechnung/bt-99-document-level-charge-amount)

## Gerelateerde regels

- [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)

## Validatietools

- [Officiële KoSIT-validator](https://github.com/itplr-kosit/validator): Draai de officiële KoSIT-validator met de XRechnung-configuratie om EN 16931- en XRechnung-regels te controleren.
- [PDF naar XRechnung converteren](/pdf-to-xrechnung): Vind validatiefouten tijdens de conversie en controleer elke correctie.

## Gerelateerde bronnen

- [Officiële specificatie](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Testsuite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Alle validatiefouten](/resources/kosit-validator-errors): Overzicht van de hier uitgelegde validatieregels uit EN 16931, XRechnung en Peppol.
