# 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

> **FEHLER**: EN-16931-Rechen- und Konsistenzregel (BR-CO)

## Kontext und Bedeutung

Diese EN-16931-Regel verlangt, dass jeder Zuschlag auf Dokumentebene als Text oder Code begründet ist, damit der Käufer erkennt, wofür der zusätzliche Betrag berechnet wird. Der Fehler entsteht oft, wenn Versand-, Verpackungs- oder Bearbeitungskosten nur als Betrag exportiert werden.

## Lösung

Ergänzen Sie für jeden Zuschlag auf Dokumentebene einen Grund (BT-104) und/oder einen Grundcode (BT-105) aus UNCL 7161: cbc:AllowanceChargeReason / cbc:AllowanceChargeReasonCode in UBL, ram:Reason / ram:ReasonCode in ram:SpecifiedTradeAllowanceCharge in CII.

- [XML validieren](/de/xrechnung-validator?source=resource&rule=BR-CO-22)
- [Rechnung konvertieren](/de/pdf-to-xrechnung?source=resource&rule=BR-CO-22)

## 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:TaxCategory>
    <cbc:ID>S</cbc:ID>
    <cbc:Percent>19</cbc:Percent>
    <cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme>
  </cac:TaxCategory>
</cac:AllowanceCharge>
```

### Ungültiges XML
```
<cac:AllowanceCharge>
  <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  <cbc:Amount currencyID="EUR">15.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>
```

## Betroffene Felder

- [BG-21 Zuschläge auf Dokumentebene](/resources/xrechnung/bt-99-document-level-charge-amount)
- [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://github.com/itplr-kosit/validator): Führen Sie den offiziellen KoSIT-Validator mit der XRechnung-Konfiguration aus, um EN-16931- und XRechnung-Regeln zu prüfen.
- [PDF zu XRechnung konvertieren](/pdf-to-xrechnung): Validierungsfehler beim Konvertieren erkennen, prüfen und gezielt beheben.

## Verwandte Ressourcen

- [Offizielle Spezifikation](https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/)
- [Testsuite](https://github.com/itplr-kosit/xrechnung-testsuite)
- [Alle Validierungsfehler](/resources/kosit-validator-errors): Übersicht der hier erklärten Validierungsregeln aus EN 16931, XRechnung und Peppol.