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

Software-Tipp

Rechnung selbst gebaut?

Wer das XML aus dem eigenen System oder von Hand zusammensetzt, muss Regeln wie diese kennen. Diese Programme erzeugen ZUGFeRD und XRechnung und füllen die Pflichtfelder von sich aus.

Lexware Office Weit verbreiteter Allrounder (früher lexoffice) für Einsteiger und kleine Unternehmen. Ansehen *

sevDesk Rechnung und Buchhaltung in einem, beliebt bei Selbstständigen und kleinen Firmen. Ansehen *

BuchhaltungsButler Starke Beleg-Automatik, wenn viel hereinkommt. Wir nutzen es selbst. Ansehen *

* Werbelinks. Wir bekommen eine Provision, für dich bleibt der Preis gleich. Fünf Programme im Vergleich