Validation rules
BR-CL-04 — EN 16931 rule
The invoice currency code (BT-5) is not part of ISO 4217.
- Rule
BR-CL-04— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-5— Invoice currency- Field in your JSON
invoice.currency
How to fix it
Set invoice.currency to a real ISO 4217 alpha-3 code, e.g. "EUR", "USD" or "CHF".
BR-CL-04 auf Deutsch — was bedeutet der Fehler?
Die Rechnungswährung (BT-5) ist kein Code der ISO-4217-Liste. Das Eingabeschema prüft nur das Format (drei Großbuchstaben) — ein erfundener Code wie "EUZ" fällt erst beim KoSIT-Validator auf, der das Dokument ablehnt.
So beheben Sie den Fehler
Setzen Sie invoice.currency auf einen echten ISO-4217-Code, z. B. "EUR", "USD" oder "CHF".
Related rules
BR-05— The invoice currency code (BT-5) is missing.BR-CL-03— An amount carries a currencyID attribute that is not an ISO 4217 currency code.BR-CL-05— The VAT accounting currency code (BT-6) is not part of ISO 4217.BR-CL-06— The VAT point date code (BT-8) is not one of the UNTDID 2005 codes EN 16931 permits (3, 35 or 432).BR-CL-01— Type code 381 (credit note) is not allowed in the UBL Invoice syntax — UNTDID 1001 lists 381 only for UBL…BR-CL-07— The scheme of an invoiced-object identifier (BT-18 schemeID) is not a UNTDID 1153 code.
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.
Or try it live: drop any XRechnung XML on the free validator — same KoSIT-backed report, no account.