Validation rules

UBL-SR-50 — UBL rule

An item carries more than one description (BT-154) — only one cbc:Description per cac:Item is allowed.

Rule
UBL-SR-50 — official EN 16931 / XRechnung rule
Severity
error
Business term
BT-154 — Item description
Field in your JSON
invoice.lines[*].description
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 Description per item, from invoice.lines[i].description.

How to fix it

Merge the texts into one cbc:Description per item. Through normbill, line.description is a single string.

UBL-SR-50 auf Deutsch — was bedeutet der Fehler?

Der KoSIT-Validator lehnt die Rechnung ab, weil ein Artikel mehrere Beschreibungen (BT-154) trägt — nur eine cbc:Description je cac:Item ist erlaubt.

So beheben Sie den Fehler

Fassen Sie die Texte in einer cbc:Description je Artikel zusammen. Über normbill ist line.description ein einzelner String.

Related rules

  • UBL-SR-49 — The tax point date code (BT-8) appears more than once — only one cac:InvoicePeriod/cbc:DescriptionCode is…
  • UBL-SR-51 — An address carries more than one cac:AddressLine — only one additional address line (line 3) is allowed per…
  • UBL-SR-48 — An invoice line does not have exactly one cac:ClassifiedTaxCategory — every line states its VAT category…
  • UBL-SR-52 — An invoice line carries more than one cac:DocumentReference — the line-level invoiced-object identifier…
  • UBL-SR-47 — Several cac:PaymentMeans elements carry different cbc:PaymentMeansCode values — when the code (BT-81) is…
  • UBL-SR-53 — A cac:PartyTaxScheme states a TaxScheme/ID but no cbc:CompanyID — the identifier itself (e.g. the VAT…

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.

Spotted something?

Bug, missing feature, wrong validation result — tell us. The page you're on is attached automatically; email optional.