Validation rules

UBL-SR-05

Payment terms (BT-20) appear more than once — across all cac:PaymentTerms elements only a single cbc:Note is allowed.

Rule
UBL-SR-05official EN 16931 / XRechnung rule
Severity
error
Business term
BT-20 — Payment terms
Field in your JSON
invoice.payment.terms
Detected by
tier 3 — KoSIT validator (authoritative)
Reachability
Only reachable when validating your own XML — normbill-generated documents cannot trigger it

The serializer writes invoice.payment.terms as exactly one cac:PaymentTerms/cbc:Note.

How to fix it

Merge your payment terms into one cac:PaymentTerms/cbc:Note. Through normbill, invoice.payment.terms is a single string.

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

Der KoSIT-Validator lehnt die Rechnung ab, weil die Zahlungsbedingungen (BT-20) mehrfach vorkommen — über alle cac:PaymentTerms hinweg ist nur eine cbc:Note erlaubt.

So beheben Sie den Fehler

Fassen Sie die Zahlungsbedingungen in einer cac:PaymentTerms/cbc:Note zusammen. Über normbill ist invoice.payment.terms ein einzelner 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.

Spotted something?

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