Validation rules
BR-CL-03
An amount carries a currencyID attribute that is not an ISO 4217 currency code.
- Rule
BR-CL-03— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-5— Invoice currency- Field in your JSON
invoice.currency- Detected by
- tier 3 — KoSIT validator (authoritative)
- Reachability
- Triggerable from your request JSON (generate & validate)
The request schema checks only the shape (three uppercase letters), not ISO 4217 membership, so an invented code like "EUZ" reaches the validator and fails here on every amount (and as BR-CL-04 on the document currency).
How to fix it
Set invoice.currency to an ISO 4217 code such as "EUR" — normbill stamps it on every amount element it generates.
BR-CL-03 auf Deutsch — was bedeutet der Fehler?
Ein currencyID-Attribut an einem Betrag ist kein gültiger ISO-4217-Währungscode. Der KoSIT-Validator lehnt das Dokument ab; normbill übernimmt die Währung aus invoice.currency in jedes erzeugte Betragselement.
So beheben Sie den Fehler
Setzen Sie invoice.currency auf einen existierenden ISO-4217-Code, z. B. "EUR".
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.