Validation rules

UBL-SR-30

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.

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.