Validation rules
BR-CL-19
An allowance reason code (BT-98 document level, BT-140 line level) is not part of the UNCL 5189 subset EN 16931 permits.
- Rule
BR-CL-19— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-98— Document allowance reason code- Field in your JSON
invoice.allowances[*].reason_code
How to fix it
Use a permitted UNCL 5189 code (e.g. "95" = discount) as the allowance reason_code, or state the reason as free text in reason instead. Charge codes (UNTDID 7161, e.g. "ZZZ") are a different list.
BR-CL-19 auf Deutsch — was bedeutet der Fehler?
Der Begründungscode eines Nachlasses (BT-98 Dokumentebene, BT-140 Positionsebene) stammt nicht aus der von EN 16931 zugelassenen Teilmenge der UNCL 5189. Der KoSIT-Validator lehnt das Dokument ab. Achtung: Die Codeliste für Zuschläge (UNTDID 7161) ist eine andere.
So beheben Sie den Fehler
Verwenden Sie einen zulässigen UNCL-5189-Code (z. B. "95" = Rabatt) im reason_code des Nachlasses — 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.