Zum Inhalt springen

n8n BZSt

Die BZSt-Node bindet die eVatR-Schnittstelle des Bundeszentralamts für Steuern in n8n ein. Damit lässt sich die Umsatzsteuer-Identifikationsnummer eines EU-Geschäftspartners direkt im Workflow bestätigen — beim Anlegen eines Kunden, vor dem Schreiben einer Rechnung oder regelmäßig über den bestehenden Kundenstamm.

Ausgewählt wird über zwei Felder: Ressource (USt-IdNr. oder Info) und Operation.

  • Neu hier? Installation → Anmeldedaten → Erste Schritte. Danach läuft Ihre erste Abfrage.
  • Sie bauen bereits Workflows? Die Grundlagen erklären den Unterschied zwischen einfacher und qualifizierter Abfrage, die Statuscodes und die Fehlerbehandlung.
  • Etwas klemmt? Die Fehlerbehebung sammelt die Meldungen, die in der Praxis auftreten.
Ressource Operation Wofür
USt-IdNr. Validate Eine USt-IdNr. eines EU-Mitgliedstaats bestätigen — einfach oder qualifiziert
Info Statusmeldungen Alle evatr-*-Statuscodes mit ihrem Meldungstext
Info EU-Mitgliedstaaten Mitgliedstaaten und ob ihr System gerade erreichbar ist

Die vollständige Liste der Felder steht in der Referenz.

Die eVatR-Schnittstelle kennt zwei Abfragen, und der Unterschied entscheidet darüber, was Sie mit dem Ergebnis belegen können:

  • Die einfache Bestätigungsabfrage beantwortet nur, ob die USt-IdNr. zum Anfragezeitpunkt gültig ist.
  • Die qualifizierte Bestätigungsabfrage vergleicht zusätzlich Firmenname, Ort und optional Straße und PLZ mit den im Mitgliedstaat registrierten Daten und meldet je Feld, ob es übereinstimmt.

Welche der beiden die Node ausführt, hängt allein davon ab, ob Sie Firmenname und Ort mitgeben. Details in Einfache und qualifizierte Abfrage.

  • n8n 2.0 oder neuer
  • eine eigene deutsche USt-IdNr. (die Schnittstelle braucht sie bei jeder Abfrage)
  • ausgehender Zugriff auf api.evatr.vies.bzst.de

Kein API-Schlüssel, keine Registrierung, kein Lizenzschlüssel — die eVatR-Schnittstelle ist offen zugänglich.