Validation rules

BR-CL-01 — EN 16931 rule

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

If the document cancels or corrects an existing invoice, use type_code 384 (corrected invoice) with invoice.preceding_invoice — negative quantities for a cancellation. For a commercial credit note without a preceding invoice, switch to a CII format (xrechnung-cii-3.0, zugferd-2.x, facturx-1.0), where 381 is valid; normbill does not emit UBL CreditNote documents yet.

Cancellation, correction or credit note — which type code applies, and why a UBL Invoice rejects 381: see the guide on cancellations, corrections and credit notes.

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

Der Rechnungstyp-Code 381 (kaufmännische Gutschrift) ist in der UBL-Invoice-Syntax nicht zulässig — die UNTDID 1001 führt 381 nur für UBL-CreditNote-Dokumente. normbill meldet das schon in der Vorprüfung (Stufe 1); auch der KoSIT-Validator lehnt das Dokument ab.

So beheben Sie den Fehler

Storniert oder korrigiert das Dokument eine bestehende Rechnung, verwenden Sie type_code 384 (Rechnungskorrektur) mit invoice.preceding_invoice — beim Storno mit negativen Mengen (qty). Für eine kaufmännische Gutschrift ohne Vorgängerrechnung wechseln Sie zu einem CII-Format (xrechnung-cii-3.0, ZUGFeRD, Factur-X), in dem 381 zulässig ist; UBL-CreditNote-Dokumente gibt normbill noch nicht aus.

Welcher Typcode für Storno, Korrektur oder Gutschrift gilt: Leitfaden zu Storno, Korrektur und Gutschrift.

Related rules

BR-DE-17 — This invoice type code is not recommended in XRechnung.
BR-04 — The invoice type code (BT-3) is missing.
BR-CL-03 — An amount carries a currencyID attribute that is not an ISO 4217 currency code.
BR-CL-04 — The invoice currency code (BT-5) is not part of ISO 4217.
BR-CL-05 — The VAT accounting currency code (BT-6) is not part of ISO 4217.
BR-CL-06 — The VAT point date code (BT-8) is not one of the UNTDID 2005 codes EN 16931 permits (3, 35 or 432).

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.