Validation rules
NB-PAYMENT-MEANS-UNSUPPORTED — normbill pre-flight check
Card-payment means codes (48/54/55) need card information (BG-18) that normbill cannot express yet — KoSIT would reject the invoice (BR-DE-24-a).
- Rule
NB-PAYMENT-MEANS-UNSUPPORTED— normbill pre-flight check (no single official rule id applies)- Severity
- error
- Business term
BT-81— Payment means code- Field in your JSON
invoice.payment.means_code
How to fix it
Use a credit-transfer means_code (58 with invoice.payment.iban, or 30) or SEPA direct debit (59 with mandate_id, creditor_id, and debited_iban).
NB-PAYMENT-MEANS-UNSUPPORTED auf Deutsch — was bedeutet der Fehler?
Kartenzahlungs-Codes (means_code 48/54/55) erfordern Karteninformationen (BG-18), die normbill noch nicht abbilden kann — der KoSIT-Validator würde die Rechnung ablehnen (BR-DE-24-a).
So beheben Sie den Fehler
Verwenden Sie eine Überweisung (means_code 58 mit invoice.payment.iban oder 30) oder SEPA-Lastschrift (59 mit mandate_id, creditor_id und debited_iban).
NB-* checks run before generation to catch problems the official rule set would only report indirectly. The authoritative KoSIT validation still has the final word on conformance.
Related rules
BR-DE-1— Payment instructions (BG-16) are missing. XRechnung requires them.BR-DE-25-a— Payment means is a SEPA direct debit (code 59) but direct-debit information (BG-19) is missing.BR-CL-16— The payment means code (BT-81) is not a UNTDID 4461 code.BR-49— Payment instructions (BG-16) are present but the payment means type code (BT-81) is missing.BR-DE-24-a— The payment means is a card payment (code 48, 54 or 55), so card information (BG-18) is required.UBL-SR-27— A cac:PaymentMeans carries more than one cbc:PaymentMeansCode (BT-81) — each payment means states exactly…
Official sources
- XRechnung specification (KoSIT / xeinkauf.de)
- KoSIT validator on GitHub and the XRechnung validator configuration
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.