Validation rules

BR-CL-19 — EN 16931 rule

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.

Related rules

BR-CL-20 — A charge reason code (BT-105 document level, BT-145 line level) is not a UNTDID 7161 code.
BR-CL-18 — A line VAT category code (BT-151) is not one of the UNCL 5305 values EN 16931 permits (AE, L, M, E, S, Z, G,…
BR-CL-17 — A VAT category code at document level (BT-95, BT-102 or BT-118) is not one of the UNCL 5305 values EN 16931…
BR-CL-21 — The scheme of an item standard identifier (BT-157 schemeID) is not part of the ISO/IEC 6523 ICD list.
BR-CL-16 — The payment means code (BT-81) is not a UNTDID 4461 code.
BR-CL-22 — A VAT exemption reason code (BT-121) is not part of the VATEX code list.

Official sources

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.

Or try it live: drop any XRechnung XML on the free validator — same KoSIT-backed report, no account.