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

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.