# BR-CO-22 Zuschlag auf Dokumentebene benötigt Grund oder Grundcode

Jeder Zuschlag auf Dokumentebene (BG-21) muss einen Zuschlagsgrund auf Dokumentebene (BT-104) oder einen Code des Zuschlagsgrunds (BT-105) enthalten, oder beides.

## Problembeschreibung

Jeder Zuschlag auf Dokumentebene (BG-21) muss einen Zuschlagsgrund auf Dokumentebene (BT-104) oder einen Code des Zuschlagsgrunds (BT-105) enthalten, oder beides.

> **FEHLER**: XRechnung 3.0

## Kontext und Bedeutung

Diese EN16931-Kernregel stellt sicher, dass jeder Zuschlag begründet ist, damit Käufer und Prüfer erkennen, warum der Betrag hinzugefügt wurde.

## Lösung

Ergänzen Sie für jeden Zuschlag auf Dokumentebene einen AllowanceChargeReason (BT-104) und/oder AllowanceChargeReasonCode (BT-105).

- validate
- convert

## Gültige Beispiele

- Zuschlag auf Dokumentebene mit BT-105 = FC und BT-104 = "Frachtkosten"

## Ungültige Beispiele

- Zuschlagsbetrag 15,00 ohne BT-104 und ohne BT-105

## Code-Beispiele

### Gültiges XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:AllowanceChargeReasonCode>FC</cbc:AllowanceChargeReasonCode>
  <cbc:AllowanceChargeReason>Freight charge</cbc:AllowanceChargeReason>
  <cbc:Amount currencyID="EUR">15.00</cbc:Amount>
</cac:AllowanceCharge>
```

### Ungültiges XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">15.00</cbc:Amount>
</cac:AllowanceCharge>
```

## Betroffene Felder

- [BG-21 Zuschläge auf Dokumentebene](/resources/xrechnung)
- [BT-104 Grund des Zuschlags auf Dokumentebene](/resources/xrechnung/bt-104-document-level-charge-reason)
- [BT-105 Code des Zuschlagsgrunds auf Dokumentebene](/resources/xrechnung/bt-105-document-level-charge-reason-code)

## Verwandte Regeln

- [BR-CO-06](/resources/kosit-validator-errors/br-co-06-charge-reason-code-match)
- [BR-CO-21](/resources/kosit-validator-errors/br-co-21-document-allowance-reason-required)
- [BR-CO-24](/resources/kosit-validator-errors/br-co-24-line-charge-reason-required)

## Validierungstools

- [Offizieller KoSIT Validator](https://erechnungsvalidator.service-bw.de/): Überprüfen Sie Ihre XRechnung-Dateien gegen alle BR-DE-Regeln.
- [PDF zu XRechnung konvertieren](/pdf-to-xrechnung): Validierungsfehler beim Konvertieren erkennen, prüfen und gezielt beheben.

## Verwandte Ressourcen

- [Offizielle Spezifikation](https://xeinkauf.de/xrechnung/)
- [Testsuite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Vollständige Fehlerliste](/resources/kosit-validator-errors): Übersicht aller deutschen XRechnung-Validierungsregeln.