# BR-CO-21 Korting op documentniveau vereist een reden of redencode

Elke korting op documentniveau (BG-20) moet een reden voor de korting (BT-97) of een redencode (BT-98) bevatten, of beide.

## Probleembeschrijving

> **FOUT**: Reken- en consistentieregel van EN 16931 (BR-CO)

> **Waar BR-CO-21 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-CO-21: rekenregel van EN 16931, gemeld in de stap “EN 16931-regels”.

## Context en betekenis

Elke korting op documentniveau (UBL: cac:AllowanceCharge met cbc:ChargeIndicator = false) heeft een reden in tekst of een redencode nodig, zodat de koper ziet waarvoor de korting geldt en die juist kan boeken. De fout ontstaat vaak wanneer het ERP alleen een kortingsbedrag of -percentage exporteert, zonder omschrijving.

## Oplossing

Voeg voor elke korting op documentniveau een reden (BT-97) en/of een redencode (BT-98) uit UNCL 5189 toe: cbc:AllowanceChargeReason / cbc:AllowanceChargeReasonCode in UBL, ram:Reason / ram:ReasonCode in ram:SpecifiedTradeAllowanceCharge in CII.

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

## Geldige voorbeelden

- Korting op documentniveau met BT-98 = 95 en BT-97 = "Volumekorting"

## Ongeldige voorbeelden

- Kortingsbedrag 10,00 zonder BT-97 en zonder BT-98

## Codevoorbeelden

### Geldig XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Volume discount</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
  <cac:TaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>19</cbc:Percent>
    <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
  </cac:TaxCategory>
</cac:AllowanceCharge>
```

### Ongeldig XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
  <cac:TaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>19</cbc:Percent>
    <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
  </cac:TaxCategory>
</cac:AllowanceCharge>
```

## Betrokken velden

- [BG-20 Kortingen op documentniveau](/resources/xrechnung/bt-92-document-level-allowance-amount)
- [BT-97 Reden korting op documentniveau](/resources/xrechnung/bt-97-document-level-allowance-reason)
- [BT-98 Redencode korting op documentniveau](/resources/xrechnung/bt-98-document-level-allowance-reason-code)

## Gerelateerde regels

- [BR-CO-05](/resources/kosit-validator-errors/br-co-05-allowance-reason-code-match)
- [BR-CO-22](/resources/kosit-validator-errors/br-co-22-document-charge-reason-required)
- [BR-CO-23](/resources/kosit-validator-errors/br-co-23-line-allowance-reason-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.