Validation rules

BR-DE-17

This invoice type code is not recommended in XRechnung.

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

How to fix it

Use 326 (partial), 380 (invoice), 384 (correction/credit), 389 (self-billed), or 875/876/877 (construction). 381 (credit note) is valid only in the CII syntaxes — UBL rejects it (BR-CL-01).

BR-DE-17 auf Deutsch — was bedeutet der Fehler?

Der Rechnungstyp-Code (BT-3) gehört nicht zu den in der XRechnung vorgesehenen Codes (eine Teilmenge der UNTDID-1001-Liste). Der KoSIT-Validator meldet das als Warnung — das Dokument wird nicht abgelehnt, aber Empfängersysteme können den Code unter Umständen nicht verarbeiten.

So beheben Sie den Fehler

Verwenden Sie 326 (Abschlagsrechnung), 380 (Handelsrechnung), 384 (Rechnungskorrektur/Gutschrift), 389 (Gutschrift im Gutschriftverfahren) oder 875/876/877 (Bauleistungen). 381 (Gutschrift) ist nur in den CII-Syntaxen zulässig — UBL lehnt es ab (BR-CL-01).

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.