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

BR-CL-20 in Ihrer eigenen Rechnung? Laden Sie die Datei hoch und finden Sie 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 beheben Sie BR-CL-20

Fehlerhafte Stelle im XML finden. Öffnen Sie die XML der E-Rechnung und navigieren Sie zum Feld BT-105 über den folgenden XPath://ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='true']/ram:ReasonCode
Korrektur einsetzen. Kodieren Sie 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. Speichern Sie die Datei und validieren Sie sie erneut, um zu prüfen, dass BR-CL-20 nicht mehr gemeldet wird.

Konkreter Korrekturvorschlag

Kodieren Sie 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). Verwechseln Sie die Listen nicht.

Was, wenn kein passender Code existiert?

Nutzen Sie 'ABK' (Sonstiges) als Zuschlagsgrund und beschreiben Sie den Sachverhalt im Textfeld ram:Reason (BT-104).

BR-CL-20 automatisch prüfen

Statt das XML manuell zu durchsuchen, können Sie Ihre ZUGFeRD- oder XRechnung-Datei online validieren: Laden Sie die PDF oder XML hoch, und Sie bekommen 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 Sie bleibt der Preis gleich. Fünf Programme im Vergleich