Validation rules
BR-CL-08
An invoice note (BT-22) starts with a #...# prefix whose subject code (BT-21) is not part of UNTDID 4451.
- Rule
BR-CL-08— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-22— Invoice note- Field in your JSON
invoice.notes- Detected by
- tier 3 — KoSIT validator (authoritative)
- Reachability
- Triggerable from your request JSON (generate & validate)
The UBL binding embeds the note subject code as a #CODE# prefix inside cbc:Note. invoice.notes entries are free text and serialized verbatim, so a note that begins with an unknown three-letter code between two hashes triggers this rule.
How to fix it
Remove the leading #CODE# prefix from the entry in invoice.notes, or use a valid UNTDID 4451 code such as "#AAI#" (general information).
BR-CL-08 auf Deutsch — was bedeutet der Fehler?
Eine Rechnungsnotiz (BT-22) beginnt mit einem "#...#"-Präfix, dessen Betreff-Code (BT-21) nicht in der UNTDID 4451 enthalten ist. In der UBL-Syntax wird der Notiz-Betreff als Präfix in cbc:Note codiert — eine Freitext-Notiz, die zufällig mit einem unbekannten Drei-Zeichen-Code zwischen zwei Rauten beginnt, führt zur Ablehnung durch den KoSIT-Validator.
So beheben Sie den Fehler
Entfernen Sie das führende "#CODE#"-Präfix aus dem Eintrag in invoice.notes — oder verwenden Sie einen gültigen UNTDID-4451-Code, z. B. "#AAI#" für allgemeine Informationen.
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.