Validation rules

BR-CL-01

Type code 381 (credit note) is not allowed in the UBL Invoice syntax — UNTDID 1001 lists 381 only for UBL CreditNote documents, so the KoSIT validator rejects it.

Rule: BR-CL-01 — official EN 16931 / XRechnung rule
Severity: error
Business term: BT-3 — Invoice type code
Field in your JSON: invoice.type_code

How to fix it

Use type_code 384 (corrected invoice) with negative quantities for UBL credits, or switch to a CII format (xrechnung-cii-3.0, ZUGFeRD, Factur-X) where 381 is valid.

BR-CL-01 auf Deutsch — was bedeutet der Fehler?

Der Rechnungstyp-Code 381 (Gutschrift) ist in der UBL-Invoice-Syntax nicht zulässig — die UNTDID 1001 führt 381 nur für UBL-CreditNote-Dokumente. normbill erkennt das bereits vor der Erzeugung (Stufe 1); der KoSIT-Validator würde das Dokument ebenfalls ablehnen.

So beheben Sie den Fehler

Verwenden Sie für UBL-Gutschriften type_code 384 (Rechnungskorrektur) mit negativen Mengen (qty) — oder wechseln Sie zu einem CII-Format (xrechnung-cii-3.0, ZUGFeRD, Factur-X), in dem 381 zulässig ist.

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.