Fehlerbehebung

Die Node erscheint nicht in der Suche

Nach der Installation lädt n8n die Node nach; in manchen Aufstellungen erst nach einem Neustart. Bleibt sie aus, prüfen Sie unter Einstellungen → Community Nodes, ob das Paket dort als installiert steht, und suchen Sie nach BZSt API (nicht nach „eVatR” oder „USt-IdNr.“).

Läuft n8n in Docker und war das Paket nach einem Neuaufbau verschwunden, fehlt das persistente Volume für /home/node/.n8n — siehe Installation.

„Für die qualifizierte Abfrage müssen Firmenname und Ort gemeinsam angegeben werden”

Genau das: es ist nur eines der beiden Felder gefüllt. Entweder das zweite nachtragen, oder beide leeren — dann läuft die einfache Abfrage. Der Grund für den Abbruch steht unter Einfache und qualifizierte Abfrage.

Der Fall tritt gern mit Ausdrücken auf: {{ $json.ort }} ist leer, wenn das Feld im Vorgänger-Item fehlt oder anders heißt. Ein Blick in die Eingabedaten der Node zeigt es.

„… darf nicht leer sein”

Die Node prüft beide Nummern vor dem Senden. Betrifft es die eigene USt-IdNr., fehlt der Wert in den Anmeldedaten. Betrifft es die zu prüfende, liefert der Ausdruck im Feld nichts — häufig, weil das Vorgänger-Item das erwartete Feld nicht hat.

evatr-0004 — anfragende USt-IdNr. syntaktisch falsch

Die Nummer in den Anmeldedaten passt nicht ins deutsche Schema. Erwartet wird DE plus neun Ziffern. Leerzeichen und Kleinschreibung sind unkritisch, die Node normalisiert sie — Bindestriche, Punkte oder eine Nummer aus einem anderen Mitgliedstaat sind es nicht.

evatr-2005 — eigene USt-IdNr. nicht gültig

Die Nummer ist formal richtig, aber zum Anfragezeitpunkt nicht gültig. Das ist eine Aussage über Ihr Unternehmen, nicht über den Geschäftspartner: Zahlendreher in den Anmeldedaten, oder die Nummer wurde tatsächlich geändert. Auskunft gibt das BZSt.

evatr-0006 — nicht berechtigt, diese Nummer abzufragen

Sie fragen mit einer deutschen Nummer eine deutsche USt-IdNr. ab. Das lässt die eVatR-Abfrage nicht zu; sie ist für Nummern der anderen Mitgliedstaaten gedacht. Filtern Sie deutsche Nummern vorher heraus.

evatr-0008 — maximale Anzahl qualifizierter Abfragen erreicht

Eine Grenze der Schnittstelle, keine Aussage über die Nummer. Die betroffenen Items gehören in einen zweiten Lauf, nicht in den Ablehnungszweig. Was dagegen hilft, steht unter Fehler und Wiederholungen.

Alles wird als „ungültig” behandelt, obwohl die Nummern stimmen

Meist prüft die Bedingung im IF-Node auf das falsche Feld oder auf einen Wahrheitswert, den es nicht gibt. Gültigkeit steht ausschließlich in status, und der Wert für „gültig” ist evatr-0000. Ein {{ $json.gueltig }} gibt es nicht.

Zweiter häufiger Fall: die Prüfung verlangt, dass alle erg*-Felder A sind. Bei einfacher Abfrage fehlen die Felder ganz, und C oder D sind keine Widersprüche — siehe Einfache und qualifizierte Abfrage.

Der Workflow bricht mitten in einer Massenprüfung ab

Ein Fehler beendet standardmäßig den ganzen Workflow. Für Massenprüfungen gehören On Error → Continue und Retry On Fail gesetzt; beides in Fehler und Wiederholungen.

„Eine Bearbeitung Ihrer Anfrage ist zurzeit nicht möglich”

Die Codes evatr-0011, evatr-1001 bis evatr-1004, evatr-2004, evatr-2011 und evatr-3011 kommen von der Schnittstelle oder vom System des Mitgliedstaats. Sie werden als Fehler geworfen, damit n8n sie wiederholen kann. Hält es an, zeigt Info → EU-Mitgliedstaaten, ob der betroffene Staat gerade überhaupt erreichbar ist.

Zeitüberschreitung oder Netzwerkfehler

Die Node wartet 30 Sekunden auf eine Antwort. Läuft das regelmäßig ab, prüfen Sie den ausgehenden Zugriff der n8n-Instanz auf api.evatr.vies.bzst.de — in Containerumgebungen meist ein Proxy oder eine Firewallregel.