validation_failedSchnittstelle
Normprüfung nicht bestanden
HTTP 422 der Schnittstelle: Der Aufruf war vollständig, aber die daraus gebaute Rechnung fällt bei der Normprüfung durch. Die Liste „checks“ trägt die Regelmeldungen – meist fehlt eine Pflichtangabe am BETRIEB im Portal, nicht an der Bestellung.
Wortlaut der Meldung
[validation_failed] Die Rechnung erfüllt noch nicht alle Vorgaben nach EN 16931.
Stand: Juli 2026 · Geprüft und geschrieben von Pascal Wagner
Warum das passiert
- Am Betrieb fehlt eine Pflichtangabe der XRechnung: Ansprechpartner, Telefon oder E-Mail (BR-DE-5, BR-DE-6, BR-DE-7) stehen nicht in den Einstellungen.
- Keine Bankverbindung hinterlegt, obwohl die Rechnung auf Überweisung lautet (BR-DE-23).
- Eine Position trägt Steuerkategorie und Satz, die nicht zusammenpassen – etwa Kategorie S mit 0 %.
- Weder USt-IdNr. noch Steuernummer am Betrieb (BR-DE-16).
So behebst du es
- Lies die Regelcodes in „checks“ – jeder hat hier in der Fehlerdatenbank eine eigene Seite mit Ursache und Lösung.
- Vervollständige den Betrieb im Portal unter Einstellungen: Ansprechpartner, Telefon, E-Mail, Bankverbindung, Steuernummer. Das sind neun von zehn Fällen.
- Wiederhole den Aufruf erst danach – die Prüfung ist deterministisch, ohne Änderung fällt sie wieder durch.
Was die Regel nicht prüft
Dieser Code ist kein Mangel, sondern die Zusage der Schnittstelle: Kein Dokument verlässt den Server ungeprüft. Andere Systeme erzeugen die Datei trotzdem und lassen den Empfänger den Fehler finden – hier kommt statt einer ungültigen Rechnung die Liste der Gründe, bevor irgendjemand etwas sieht.
Was der Empfänger sieht
Nichts. Die Prüfung läuft, bevor irgendetwas den Server verlässt – dein Kunde bekommt keine fehlerhafte Datei, es gibt schlicht noch keine.
Tritt oft zusammen auf mit
- invalid_input – Angaben passen nicht zusammen
- BR-DE-5 – Ansprechpartner fehlt
- BR-DE-6 – Telefonnummer fehlt
- BR-DE-21 – Spezifikationskennung falsch
Begriffe dazu
- Rechnungsprüfung – Die Kontrolle einer Eingangsrechnung, bevor sie bezahlt und gebucht wird.
Quelle: die Schnittstelle des Rechnungslotsen (/api/v1). Diese Seite beschreibt das dokumentierte Verhalten des Dienstes und ist keine Rechts- oder Steuerberatung. Fehlt etwas oder stimmt etwas nicht? Schreib uns.