Status und Ergebnisse

Jede Antwort der Bestätigungsabfrage trägt ein Feld status mit einem Code der Form evatr-0000. Dieser Code ist das eigentliche Ergebnis — nicht der HTTP-Status, und nicht die Frage, ob die Node einen Fehler geworfen hat.

Die Codes der Bestätigungsabfrage

Gültig

Code	Bedeutung
evatr-0000	Die angefragte USt-IdNr. ist zum Anfragezeitpunkt gültig.
evatr-2008	Gültig, aber bei der qualifizierten Abfrage liegt eine Besonderheit vor. Für Rückfragen ist das BZSt zuständig.

Nicht gültig

Code	Bedeutung
evatr-2002	Nicht gültig zum Anfragezeitpunkt — erst gültig ab dem Datum in gueltigAb.
evatr-2006	Nicht gültig zum Anfragezeitpunkt — war gültig im Zeitraum gueltigAb bis gueltigBis.
evatr-2001	Die angefragte USt-IdNr. ist zum Anfragezeitpunkt nicht vergeben.

Etwas an der Anfrage stimmt nicht

Code	Bedeutung
evatr-0002	Mindestens ein Pflichtfeld ist nicht besetzt.
evatr-0004	Die anfragende deutsche USt-IdNr. ist syntaktisch falsch — siehe Anmeldedaten.
evatr-0005, evatr-0012	Die angefragte USt-IdNr. ist syntaktisch falsch.
evatr-2003	Das Länderkennzeichen der angefragten USt-IdNr. ist nicht gültig.
evatr-2005	Die eigene USt-IdNr. ist zum Anfragezeitpunkt nicht gültig.
evatr-0006	Die anfragende Nummer darf keine deutsche USt-IdNr. abfragen.
evatr-0007	Fehlerhafter Aufruf.
evatr-0008	Die maximale Anzahl qualifizierter Abfragen für diese Session ist erreicht — siehe Fehler und Wiederholungen.

Später erneut versuchen

evatr-0011, evatr-1001 bis evatr-1004, evatr-2004, evatr-2011, evatr-3011 — alle mit derselben Aussage: „Eine Bearbeitung Ihrer Anfrage ist zurzeit nicht möglich.“ Ursache ist die Schnittstelle selbst oder das System des Mitgliedstaats, nicht Ihre Anfrage.

Ergebnis oder Fehler?

Das BZSt meldet auch fachliche Ergebnisse über HTTP-Fehlercodes — eine nicht vergebene Nummer kommt als HTTP 404. Für einen Workflow ist das unbrauchbar: die Antwort „nicht vergeben” ist ein Ergebnis, mit dem weitergearbeitet werden soll, kein Ausfall. Die Node trennt das deshalb so:

HTTP	Behandlung
200	Antwort wird durchgegeben
400, 403, 404 mit evatr-*-Status	normales Item, zusätzlich mit httpCode
500, 503 und alles andere	Fehler (NodeApiError), greift Continue On Fail
Netzwerkfehler, Zeitüberschreitung (30 s)	Fehler

Praktisch heißt das: alles, was Sie durch eine andere Eingabe beheben könnten, und alles, was eine fachliche Aussage über die Nummer ist, landet im Datenstrom. Nur was sich von selbst erledigen kann, wird zum Fehler — damit n8n es wiederholen kann.

Das Feld httpCode taucht also nur bei diesen Ergebnis-Items auf. Es eignet sich als schnelle Unterscheidung: {{ $json.httpCode === undefined }} ist wahr für jede Antwort, die das BZSt selbst als Erfolg ansieht.

Meldungstexte nachschlagen

Die Codes sind stabil, die Texte liefert die Schnittstelle. Ressource Info → Statusmeldungen gibt ein Item je Code zurück:

Feld	Inhalt
status	der Code, z. B. evatr-2001
meldung	der Meldungstext im Klartext
kategorie	Einordnung der Meldung
httpcode	HTTP-Status, unter dem das BZSt den Code ausliefert
feld	betroffenes Feld, falls die Meldung sich auf eines bezieht

Für eine Ausgabe an Menschen — E-Mail, Ticket, Tabelle — holen Sie die Liste einmal und verbinden sie mit dem Ergebnis, etwa über einen Merge-Node im Modus Combine → Matching Fields auf status.

Nicht bei jeder Abfrage neu laden

Die Statusmeldungen ändern sich selten. In einem Workflow, der viele Nummern prüft, gehört der Abruf nicht in die Schleife — einmal vorab reicht, oder eine feste Zuordnung im Workflow.

Verfügbarkeit der Mitgliedstaaten

Die Bestätigung läuft über das System des jeweiligen Mitgliedstaats. Fällt dieses aus, kann das BZSt keine Auskunft geben. Ressource Info → EU-Mitgliedstaaten zeigt den aktuellen Stand:

Feld	Inhalt
alpha2	Länderkennzeichen, z. B. AT
name	Name des Mitgliedstaats
verfuegbar	true, wenn das System gerade erreichbar ist

Bei einer Massenprüfung lohnt es, vorab zu filtern: Nummern eines gerade nicht verfügbaren Staats verursachen sonst Fehler, die Sie hinterher einzeln nachziehen müssen.