Validation rules

UBL-CR-001

The document contains ext:UBLExtensions. Extensions are valid UBL but not part of the EN 16931 core model — receivers are free to ignore their content (embedded signatures included).

Rule
UBL-CR-001official EN 16931 / XRechnung rule
Severity
warning
Detected by
tier 3 — KoSIT validator (authoritative)
Reachability
Only reachable when validating your own XML — normbill-generated documents cannot trigger it

normbill's serializer never emits UBL extensions.

How to fix it

Remove the UBLExtensions block, or keep it only if your receiver explicitly supports it.

UBL-CR-001 auf Deutsch — was bedeutet der Fehler?

Der KoSIT-Validator meldet eine Warnung, weil das Dokument ext:UBLExtensions enthält. Extensions sind gültiges UBL, gehören aber nicht zum Kernmodell der EN 16931 — Empfänger dürfen ihren Inhalt (auch eingebettete Signaturen) ignorieren.

So beheben Sie den Fehler

Entfernen Sie den UBLExtensions-Block — oder behalten Sie ihn nur, wenn Ihr Empfänger ihn ausdrücklich unterstützt.

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.