Erste Schritte

Ziel dieser Seite: eine Abfrage, die eine Antwort des BZSt zurückgibt, und das Verständnis, was in dieser Antwort steht. Voraussetzung sind Installation und Anmeldedaten.

Die erste Abfrage

1. Neuen Workflow anlegen und Add first step → Trigger manually wählen.
2. Node hinzufügen, nach BZSt API suchen.
3. Anmeldedaten auswählen.
4. Ressource USt-IdNr., Operation Validate.
5. Bei Zu prüfende USt-IdNr. den Beispielwert des BZSt eintragen: ATU12345678
6. Execute step klicken.

Das Ergebnis ist ein Item mit ungefähr diesem Inhalt:

{
  "id": "…",
  "anfrageZeitpunkt": "2026-09-30T09:12:44Z",
  "status": "evatr-0000"
}

evatr-0000 ist die Antwort, auf die es ankommt: gültig zum Anfragezeitpunkt. Alle anderen Codes und ihre Bedeutung stehen unter Status und Ergebnisse.

Die qualifizierte Abfrage

Interessiert nicht nur die Gültigkeit, sondern auch, ob die Firmendaten stimmen, kommen zwei weitere Felder hinzu:

1. Zusätzliche Felder → Feld hinzufügen öffnen.
2. Firmenname und Ort eintragen — beide gemeinsam, sonst bricht die Node mit einer Meldung ab. Optional zusätzlich Straße und PLZ.

Mit den Beispielwerten des BZSt:

Feld	Wert
Zu prüfende USt-IdNr.	ATU12345678
Firmenname	Musterhaus GmbH & Co KG
Ort	Musterort
Straße	Musterstrasse 22

Die Antwort enthält nun zusätzlich ein Vergleichsergebnis je übermitteltem Feld:

{
  "anfrageZeitpunkt": "2026-09-30T09:14:02Z",
  "status": "evatr-0000",
  "ergFirmenname": "A",
  "ergOrt": "A",
  "ergStrasse": "B",
  "ergPlz": "C"
}

A heißt Übereinstimmung, B keine Übereinstimmung, C nicht angefragt, D vom Mitgliedstaat nicht mitgeteilt. Was das für die Auswertung bedeutet, steht unter Einfache und qualifizierte Abfrage.

Mit echten Daten statt fester Eingabe

In einem laufenden Workflow kommt die Nummer aus dem vorherigen Schritt — aus einem Formular, einer Tabelle, dem ERP. Statt eines festen Werts setzen Sie einen Ausdruck ein:

{{ $json.ustid }}

Die Node verarbeitet ein Item pro Abfrage: kommen 50 Items an, stellt sie 50 Abfragen. Für größere Mengen lesen Sie vorher Fehler und Wiederholungen — insbesondere den Abschnitt zur Begrenzung qualifizierter Abfragen.

Auf das Ergebnis verzweigen

Ein ungültiges Ergebnis ist kein Fehler, sondern eine Antwort — die Node gibt sie als normales Item zurück. Die Verzweigung übernimmt ein IF-Node:

Bedingung	{{ $json.status }} is equal to evatr-0000
true	gültig — weiterarbeiten
false	nicht gültig — Meldung schreiben, Aufgabe anlegen, Vorgang stoppen

Soll in diesem Zweig der Klartext der Meldung auftauchen, holen Sie sich die Texte einmalig über Ressource Info → Statusmeldungen und verbinden Sie sie über den Code — siehe Info-Ressource.