Validation rules

BR-CL-22 — EN 16931 rule

A VAT exemption reason code (BT-121) is not part of the VATEX code list.

Rule: BR-CL-22 — official EN 16931 / XRechnung rule
Severity: error
Business term: BT-121 — VAT exemption reason code
Field in your JSON: invoice.tax_exemptions[*].reason_code

How to fix it

Set the entry in invoice.tax_exemptions to a valid VATEX code — e.g. reason_code "VATEX-EU-AE" (reverse charge), "VATEX-EU-IC" (intra-community supply), "VATEX-EU-G" (export) — or use the free-text reason instead.

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

Der Code des Steuerbefreiungsgrundes (BT-121) stammt nicht aus der VATEX-Codeliste. reason_code ist im Eingabeschema Freitext — ein Tippfehler fällt erst beim KoSIT-Validator auf, der das Dokument ablehnt.

So beheben Sie den Fehler

Setzen Sie tax_exemptions[].reason_code auf einen VATEX-Code, z. B. "VATEX-EU-AE" (Reverse Charge), "VATEX-EU-IC" (innergemeinschaftliche Lieferung) oder "VATEX-EU-G" (Ausfuhr) — oder verwenden Sie stattdessen reason als Freitext.

Related rules

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-23 — A unit code (BT-130 invoiced quantity, BT-150 price base quantity) is not part of UN/ECE Recommendation…
BR-CL-20 — A charge reason code (BT-105 document level, BT-145 line level) is not a UNTDID 7161 code.
BR-CL-24 — The MIME type of an embedded attachment (BT-125 mimeCode) is not one of the types EN 16931 permits (PDF,…
BR-CL-19 — An allowance reason code (BT-98 document level, BT-140 line level) is not part of the UNCL 5189 subset EN…
BR-CL-25 — An electronic address scheme (BT-34 seller, BT-49 buyer — the schemeID on cbc:EndpointID) is not part of the…

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.