Validation rules
UBL-SR-30 — UBL rule
A document-level allowance carries more than one reason text (BT-97) — only one cbc:AllowanceChargeReason per allowance is allowed.
- Rule
UBL-SR-30— official EN 16931 / XRechnung rule- Severity
- error
- Business term
BT-97— Document allowance reason- Field in your JSON
invoice.allowances[*].reason- Detected by
- tier 3 — KoSIT validator (authoritative)
- Reachability
- Only reachable when validating your own XML — normbill-generated documents cannot trigger it
The serializer emits at most one reason per allowance, from invoice.allowances[i].reason.
How to fix it
Keep a single AllowanceChargeReason per cac:AllowanceCharge. Through normbill, each allowance has one reason string.
UBL-SR-30 auf Deutsch — was bedeutet der Fehler?
Der KoSIT-Validator lehnt die Rechnung ab, weil ein Nachlass auf Dokumentebene mehrere Begründungstexte (BT-97) trägt — nur eine cbc:AllowanceChargeReason je Nachlass ist erlaubt.
So beheben Sie den Fehler
Behalten Sie genau eine AllowanceChargeReason je cac:AllowanceCharge. Über normbill hat jeder Nachlass einen reason-String.
Related rules
BR-33— A document-level allowance must state why it is granted (BT-97/BT-98).BR-CO-21— A document-level allowance (BG-20) carries neither a reason text (BT-97) nor a reason code (BT-98) — at…UBL-SR-29— The SEPA creditor identifier (BT-90) appears more than once — only one PartyIdentification/ID with schemeID…UBL-SR-31— A document-level charge carries more than one reason text (BT-104) — only one cbc:AllowanceChargeReason per…UBL-SR-28— The direct-debit mandate reference (BT-89) appears more than once — only one PaymentMandate/cbc:ID per…UBL-SR-32— A VAT breakdown carries more than one exemption reason text (BT-120) — only one cbc:TaxExemptionReason per…
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.