BR-CL-20 beheben: Zuschlagsgrund-Code ungültig (UNCL 7161)

BR-CL-20 in deiner eigenen Rechnung? Lade die Datei hoch und finde alle Fehler in Sekunden.

Rechnung prüfen API-Key holen

Was bedeutet BR-CL-20?

Wird ein Zuschlag mit einem Grund-Code versehen, muss dieser aus UNCL 7161 stammen — der Codeliste für Zuschlagsgründe.

Häufige Ursachen für BR-CL-20

Freitext wie 'Versand' oder 'Verpackung' steht im ReasonCode statt im Reason-Feld.
Ein Abschlags-Code aus UNCL 5189 wurde faelschlich fuer einen Zuschlag genutzt.
'INS' oder ein anderer Code ausserhalb UNCL 7161 wurde verwendet.

So behebst du BR-CL-20

Fehlerhafte Stelle im XML finden. Öffne die XML der E-Rechnung und navigiere zum Feld BT-105 über den folgenden XPath://ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='true']/ram:ReasonCode
Korrektur einsetzen. Kodiere den Zuschlagsgrund (BT-105 auf Belegebene, BT-145 auf Positionsebene) mit einem Code aus UNCL 7161, z. B. 'FC' (Frachtkosten), 'PC' (Verpackung), 'AA' (Werbung), 'AAA' (Telekommunikation), 'ABK' (Sonstiges). Freitext gehoert in ram:Reason, nicht in ram:ReasonCode.
Erneut validieren. Speichere die Datei und validiere sie erneut, um zu prüfen, dass BR-CL-20 nicht mehr gemeldet wird.

Konkreter Korrekturvorschlag

Kodiere den Zuschlagsgrund (BT-105 auf Belegebene, BT-145 auf Positionsebene) mit einem Code aus UNCL 7161, z. B. 'FC' (Frachtkosten), 'PC' (Verpackung), 'AA' (Werbung), 'AAA' (Telekommunikation), 'ABK' (Sonstiges). Freitext gehoert in ram:Reason, nicht in ram:ReasonCode.

XPath

//ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='true']/ram:ReasonCode

Vorher / Nachher: das XML-Beispiel

So sieht die betroffene Stelle vor und nach der Korrektur aus (Cross-Industry-Invoice, ZUGFeRD/Factur-X).

Fehlerhaft

<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator><udt:Indicator>true</udt:Indicator></ram:ChargeIndicator>
  <ram:ActualAmount>15.00</ram:ActualAmount>
  <ram:ReasonCode>VERSAND</ram:ReasonCode>
  <ram:Reason>Versandkosten</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>

Korrekt

<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator><udt:Indicator>true</udt:Indicator></ram:ChargeIndicator>
  <ram:ActualAmount>15.00</ram:ActualAmount>
  <ram:ReasonCode>FC</ram:ReasonCode>
  <ram:Reason>Versandkosten</ram:Reason>
</ram:SpecifiedTradeAllowanceCharge>

Häufige Fragen zu BR-CL-20

Worin unterscheiden sich UNCL 7161 und UNCL 5189?

UNCL 7161 kodiert Zuschlaege (ChargeIndicator=true, BT-105/BT-145), UNCL 5189 kodiert Abschlaege (ChargeIndicator=false, BT-98/BT-140). Verwechsle die Listen nicht.

Was, wenn kein passender Code existiert?

Nutze 'ABK' (Sonstiges) als Zuschlagsgrund und beschreibe den Sachverhalt im Textfeld ram:Reason (BT-104).

BR-CL-20 automatisch prüfen

Statt das XML manuell zu durchsuchen, kannst du deine ZUGFeRD- oder XRechnung-Datei online validieren – lade die PDF oder XML hoch und du bekommst jeden Fehler mit Regel-ID, betroffenem Feld, Korrekturvorschlag und XPath, als lesbaren Report oder strukturiertes JSON über die API.

Jetzt online validieren Zurück zum Lexikon