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.
Wo anfangen?
Abschnitt betitelt „Wo anfangen?“- 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.
Was die Node abdeckt
Abschnitt betitelt „Was die Node abdeckt“| 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.
Zwei Arten der Abfrage
Abschnitt betitelt „Zwei Arten der Abfrage“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.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- 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.
