Validation rules

BR-CL-20

A charge reason code (BT-105 document level, BT-145 line level) is not a UNTDID 7161 code.

Rule: BR-CL-20 — official EN 16931 / XRechnung rule
Severity: error

How to fix it

Use a UNTDID 7161 code (e.g. "FC" freight, "ZZZ" mutually defined) as the charge reason_code, or state the reason as free text in reason instead.

BR-CL-20 auf Deutsch — was bedeutet der Fehler?

Der Begründungscode eines Zuschlags (BT-105 Dokumentebene, BT-145 Positionsebene) stammt nicht aus der UNTDID 7161. Der KoSIT-Validator lehnt das Dokument ab.

So beheben Sie den Fehler

Verwenden Sie einen UNTDID-7161-Code (z. B. "FC" für Fracht oder "ZZZ" für frei vereinbart) im reason_code des Zuschlags — oder geben Sie stattdessen reason als Freitext an.

Official sources

XRechnung specification (KoSIT / xeinkauf.de)
KoSIT validator on GitHub and the XRechnung validator configuration

Every 422 from the API lists the rule id, the path in your request JSON, a plain-language message and a suggested fix — see the docs overview for the report format.