Demos & Anwendungsfälle

Automatische USt-ID-Nr. Prüfung über VIES Schnittstelle

Ein Bot aus der Lexemo Bot-Bibliothek prüft Umsatzsteuer-Identifikationsnummern direkt über VIES, zeigt das Ergebnis an und erzeugt einen PDF-Nachweis für die Ablage.

Automatische USt-ID-Nr. Prüfung über VIES Schnittstelle Live ansehen

Ob Kanzlei, Rechtsabteilung, Steuerberatung oder Buchhaltung: Wer mit Geschäftspartnern in der EU arbeitet, muss deren Umsatzsteuer-Identifikationsnummer prüfen und die Prüfung belegen können. Dieser Bot fragt die Nummer direkt bei VIES ab, dem Mehrwertsteuer-Informationsaustauschsystem der EU-Kommission. Am Ende steht ein PDF-Nachweis, der festhält, was VIES zum Zeitpunkt der Abfrage gemeldet hat. Der Bot ist als fertige Vorlage Teil der Lexemo Bot-Bibliothek und lässt sich ohne eigenen Aufbau sofort einsetzen. Live ansehen

Land und Nummer getrennt erfassen

Der Bot fragt Land und Nummer in zwei Pflichtfeldern ab. In der Dropdown-Liste sind die Ländercodes der EU-Mitgliedstaaten als feste Auswahl hinterlegt. Das Textfeld darunter nimmt nur die Nummer selbst auf, ohne Ländercode, Leerzeichen oder Trennzeichen. Beschreibung und Beispiel zeigen das erwartete Format direkt am Feld, die Pflichtangabe sorgt dafür, dass keine Abfrage mit leerem Feld startet.

Konfiguration der Dropdown-Liste dd_land mit den Ländercodes der EU-Mitgliedstaaten, als Pflichtfeld markiert

Konfiguration des Textfelds in_vat für die USt-IdNr. mit Beschreibung, Platzhalter und Pflichtangabe

Optionale Angaben zum Anfragenden

Zwei weitere Felder sind freiwillig: Ländercode und USt-IdNr. des eigenen Unternehmens. Wer beide angibt, erhält von VIES eine Konsultationsnummer, mit der sich die Abfrage später belegen lässt. Eine Anmerkung erklärt das direkt im Formular, sichtbar beim Darüberfahren:

Optional: Geben Sie Ihren eigenen Ländercode und Ihre eigene USt-IdNr. gemeinsam an, um eine Konsultationsnummer anzufragen. Geprüft wird die oben eingetragene Nummer. Ein Abgleich eingegebener Firmennamen und Anschriften ist in diesem Bot nicht eingerichtet.

Konfiguration der Anmerkung zu den Angaben des Anfragenden mit Anzeige beim Darüberfahren

Die Anfrage an VIES

Ein Textbaustein setzt alle Eingaben zu einer JSON-Anfrage zusammen. Die Variablen in geschweiften Klammern verweisen direkt auf die Eingabefelder, nichts muss doppelt erfasst werden:

{ "countryCode": "{dd_land}", "vatNumber": "{in_vat}", "requesterMemberStateCode": "{in_req_land}", "requesterNumber": "{in_req_vat}" }

Der API-Connector schickt diese Anfrage per POST an den Connector VIES VAT Check (EU). Als Auslöser ist „Beim Laden der Node“ eingestellt: Die Prüfung startet von selbst, sobald der Bot diesen Schritt erreicht.

Textbaustein bp_payload mit der JSON-Anfrage und den Variablen für Land, Nummer und Anfragenden

API-Connector api_vies mit dem Connector VIES VAT Check, Methode POST und Auslöser beim Laden der Node

Die Antwort auswerten

Der Variable Mapper übernimmt die Felder der VIES-Antwort in benannte Variablen: Gültigkeit (valid), Name (name), Anschrift (address), Abfragedatum (requestDate) und, falls geliefert, die Konsultationsnummer. Ein Textfeld setzt diese Variablen in eine Ergebnistabelle. Ein Hinweis darunter stellt klar, dass ein leeres Feld für Name oder Anschrift allein kein negatives Prüfergebnis ist. Manche Mitgliedstaaten liefern diese Angaben schlicht nicht mit.

Variable Mapper mit der Zuordnung von valid, name, address und requestDate aus der VIES-Antwort

Ergebnis-Textfeld mit der Tabelle aus geprüfter Nummer, Gültigkeit, Name, Anschrift, Abfragedatum und Konsultationsnummer

Den PDF-Nachweis erzeugen

Zum Schluss erstellt der Bot das PDF USt-IdNr_Nachweis auf Basis der e!-Vorlage. Der Download ist freigegeben, und auch hier startet die Erstellung von selbst, sobald der Bot den Schritt erreicht. Die Vorlage „USt-IdNr Bestätigung“ greift auf dieselben Variablen zu wie die Ergebnisanzeige: geprüfte Nummer, Gültigkeit, Name, Anschrift, Abfragedatum und Konsultationsnummer. Ein Quellenhinweis am Ende nennt VIES und hält fest, dass die zum Abfragezeitpunkt übermittelte Antwort maßgeblich ist.

Konfiguration der PDF-Erstellung pdf_nachweis mit Dateiname, e!-Vorlage, freigegebenem Download und Auslöser beim Laden der Node

PDF-Vorlage „USt-IdNr Bestätigung“ mit Prüftabelle und Quellenhinweis zu VIES

Nutzeransicht

Die Nutzeransicht führt in vier Schritten durch die Prüfung. Der Einstieg sagt kurz, was passiert: Land und Nummer getrennt eingeben, mit „Weiter“ zur automatischen Prüfung wechseln, Ergebnis und PDF-Nachweis erscheinen, sobald eine auswertbare Antwort vorliegt.

Startbildschirm der USt-IdNr.-Prüfung mit kurzer Erklärung des Ablaufs

Nummer eingeben

Die Eingabe beschränkt sich auf zwei Pflichtangaben: das Land aus der Liste und die Nummer ohne Ländercode. Die Felder zum eigenen Unternehmen bleiben leer, wenn keine Konsultationsnummer gebraucht wird. Zwei Info-Symbole erklären Ländercodes und Anfragende direkt am Formular.

Eingabeformular mit Ländercode, USt-IdNr. und optionalen Angaben zum Anfragenden

Automatische VIES-Prüfung

Die Abfrage startet ohne weiteren Klick. Der Statushinweis macht klar, dass ein technischer Fehler keine Feststellung ist, dass die Nummer ungültig ist. Sobald „Weiter“ erscheint, liegt das Ergebnis vor.

Statusansicht der automatischen VIES-Prüfung mit Hinweis zu technischen Fehlern

Ergebnis der Prüfung

Die Ergebnistabelle zeigt die geprüfte Nummer, das Prüfergebnis und das Abfragedatum. Im Beispiel meldet VIES die Nummer als gültig, Name und Anschrift wurden nicht mitgeliefert. Das ist bei einigen Mitgliedstaaten üblich und kein Hinweis auf eine ungültige Nummer.

Ergebnis der Prüfung mit gültiger USt-IdNr. und Abfragedatum

PDF-Nachweis herunterladen

Ein Klick auf „Herunterladen“ liefert den Nachweis als PDF. Er dokumentiert die Abfrage außerhalb des Formulars und lässt sich zu den Unterlagen des Geschäftsvorfalls legen.

Abschlussbildschirm mit dem PDF-Nachweis USt-IdNr_Nachweis.pdf zum Download

Teil der Bot-Bibliothek

Die USt-IdNr.-Prüfung gehört zu den fertigen Vorlagen der Lexemo Bot-Bibliothek. Sie lässt sich direkt nutzen oder an eigene Abläufe anpassen, etwa mit eigenem PDF-Layout oder zusätzlichen Feldern.

Zur Bot-Bibliothek

Bot-Karte „USt-IdNr. validieren und Abfrage nachweisen“ im e! Dashboard

Mehr in dieser Kategorie