USt-IdNr-Prüfung – Dokumentation

Anwendung

Die Software USt-IdNr-Prüfung ist unterteilt in zwei Bereiche. Der Einzelabfrage und der Stapelverarbeitung.

USt-IdNr-Prüfung
USt-IdNr-Prüfung

Einzelabfrage

Die Einzelprüfung ermöglicht es, mit der Eingabe der relevanten Daten eine Prüfung unmittelbar auszuführen. Als Mindestangaben die zu prüfende USt-IdNr anzugeben. Dabei wird eine einfache Prüfung durchgeführt.

Für eine qualifizierte Prüfung können Sie die optionalen Felder Firmenname, Straße, Postleitzahl und Ort angeben.

Seit 01. Januar 2021 gibt es keine schriftliche Bestätigung des Bundeszentralamtes für Steuern. Sie sind selbst dafür verantwortlich, die Überprüfung der Datensätze zu archivieren. Über die Archiv-Funktion und der Verwendung eines revisionssicheren Speichers können Sie den geänderten Anforderungen Rechnung tragen. Gerne helfen wir Ihnen dabei!

Bei der Einzelabfrage findet keine Ausgabe der Prüfergebnisse in eine Datei statt. Diese Anwendungssicht dient zur schnellen Prüfung, z.B. bei der Durchgabe von USt-IdNrn. per Telefon, um diese auf Ihre Gültigkeit zu prüfen. Die Verarbeitung von Dateien werden über die Stapelverarbeitung oder der Hintergrundverarbeitung durchgeführt.

Stapelverarbeitung

Wählen Sie eine Datei aus und prüfen Sie diese durch das Betätigen des “Prüfen-Button”. Dadurch startet die Überprüfung der gesamten Datei. Diese erzeugt im Hintergrund das Protokoll. Das Protokoll kann im Anschluss über den Protokoll-Button geöffnet werden. Dieses beinhaltet alle Prüfergebnisse, der einzelnen Datensätze. Der Vorgang der Überprüfung nimmt je nach Größe der Datei einige Zeit in Anspruch.

Der Name der USt-IdNr-Protokolldatei wird automatisch vergeben und im identischen Format erzeugt, wie das übergebene Format. Wird zum Beispiel eine Datei mit dem Namen “daten.json” übergeben, so ist die Bezeichnung der Protokolldatei “daten-log.json”.

Vorab-Validierung

Die Vorabprüfung einer USt-IdNr Importdatei kann Ihnen helfen, das Format und die Anzahl der gefundenen Datensätze, ohne eine Prüfung durchzuführen, zu prüfen. Die Datei wird dabei analysiert und das Ergebnis Ihnen mit einer Meldung angezeigt.

Hinweise zu qualifizierten Prüfungen

Stimmen bei einer qualifizierten Prüfung Daten der Adresse (Firmenname, Ort, Postleitzahl oder Straße) nicht überein, wird automatisch eine einfache Prüfung durchgeführt. Um bei gültigen Rückmeldungen dennoch die Information zu erhalten, ob Werte nicht übereinstimmen könnten, wird am Ende des jeweiligen Prüfdatensatzes die entsprechende Information angehängt, sofern aus den qualifizierten Angaben eine Prüfung negativ rückgemeldet wurde.

Rückgabewerte BZSt

Die Rückgabewerte werden über das Menü “Extras – Rückgabewerte USt-IdNr” angezeigt und bearbeitet. Die Bezeichnung und Nummer hängt vom BZSt ab. Einige systemische Rückgabewerte werden direkt durch die USt-IdNr-Prüfung ausgegeben. Diese sind im 900er Nummernkreis. Weitere Informationen findet man in der Übersicht der Ergebniscodes.

Zusätzlich zu den Standardrückgabewerten besteht die Möglichkeit Bearbeitungshinweise zu erfassen. Diese sind beispielsweise für eine Integration in einen Workflow hilfreich. Damit erhält der Sachbearbeiter bei der Bearbeitung der Rückgabewerte eine Hilfestellung.

USt-IdNr-Prüfung Rückgabewerte BZSt
USt-IdNr-Prüfung Rückgabewerte BZSt

Die Beschreibung der Rückgabewerte des BZSt ist nicht änderbar. Bei jedem Start des Programmes werden die Rückgabewerte zurückgesetzt. Ihre Bearbeitungshinweise bleiben dabei erhalten.

Platzhalter in Bearbeitungshinweisen

Damit Sie einen Hinweis zur Bearbeitung mit Werten aus der jeweiligen Prüfung anreichern können, wird ein Platzhalter mit einem Doppelklick darauf eingefügt. Die Auswahl der Platzhalter (sogenannten Textmarker) zeigt Ihnen die Übersicht der Variablen. Diese besitzen nicht immer einen Wert. Dieses hängt maßgeblich von den importierten Daten und den Rückgabewerten des BZSt ab.

Rückgabewerte VIES

Die Schnittstelle VIES/MIAS gibt einen geringeren Umfang an möglichen Rückgabewerten. Prinzipiell wird nur “gültig” oder “ungültig” zurückgegeben. Im Falle von Schnittstellenfehlern haben Sie jedoch die Möglichkeit, Bearbeitungshinweise zu erfassen.

ID Validation Rückgabewerte VIES
USt-IdNr-Prüfung Rückgabewerte VIES

Rohdaten-Viewer

Über das Menü Extras – USt-IdNr Rohdaten Viewer können Sie das Archiv durchsuchen. Geben Sie dazu die gewünschte USt-IdNr ein und betätigen Sie die Suchen-Schaltfläche. Alle Einträge werden Ihnen in der Ergebnisansicht bereitgestellt. Um einen Eintrag sich genauer ansehen zu können, klicken Sie in der Liste der gefundenen Einträge auf den gewünschten Eintrag. Es werden Ihnen die Abfragezeit, der original Request-String, die Antwortzeit des BZSt/VIES und die Original-Antwort angezeigt. Damit können Sie genau die Auskunft bekommen, wann eine USt-IdNr mit welchem Ergebnis abgefragt wurde.

ID Validation Rohdaten Viewer
USt-IdNr-Prüfung Rohdaten Viewer

Um die Echtheit eines Datensatzes zu gewährleisten, haben wir einen sog. MD5-Hash erzeugt. Damit können wir die Echtheit und den Schutz vor Manipulationen in den Dateien prüfen.

Sobald ein Datensatz nicht der Prüfsumme entspricht, wird dieses mit dem Zusatz “(Fehler)” angezeigt.

Konfiguration

Über das Hauptmenü Extras – Einstellungen USt-IdNr werden die Einstellungen für die USt-IdNr-Prüfung vorgenommen. In diesen Einstellungen ist zusätzlich für eine erfolgreiche Lizenzierung Ihre Ust-IdNr einzutragen.

Allgemeine Einstellungen

Ihre USt-IdNr

Auf der Reiterkarte “Allgemein” wird Ihre USt-IdNr eingetragen. Diese Nummer dient zeitgleich für die Überprüfung auf eine gültige Lizenz.

USt-IdNr-Prüfung Einstellungen USt-IdNr Allgemein
USt-IdNr-Prüfung Einstellungen USt-IdNr Allgemein

Haben Sie mehrere Mandanten lizenziert, können Sie alle USt-IdNr über den Button “weitere USt-IdNr” erfassen.

USt-IdNr-Prüfung Einstellungen USt-IdNr mehrere USt-IDNrn
USt-IdNr-Prüfung Einstellungen USt-IdNr mehrere USt-IDNrn

Die Auswahl im Hauptfenster wird entsprechend aktualisiert.

Bitte beachten Sie, dass Sie nur lizenzierte USt-IdNr eintragen.

Es werden alle Nummern geprüft und sofern eine eingetragene USt-IdNr nicht lizenziert ist, wird dies als ungültige Lizenz interpretiert.

Schnittstellenauswahl

Sie haben die Möglichkeit zwischen der Schnittstelle des Bundeszentralamtes für Steuern oder der EU (VIES/MIAS) auszuwählen. Für Kunden mit deutscher USt-IdNr empfehlen wir die Verwendung der BZSt-Schnittstelle.

Archiv

Über das Archiv stellen wir Ihnen eine Funktion bereit, um den gesetzlichen Anforderungen der nachvollziehbaren Speicherung der Anfragen und Antworten bereit. Wird die Option aktiviert, geben Sie bitte noch das entsprechende Verzeichnis an, in denen alle Anfragen und Antworten gespeichert werden. Sofern Sie den gesetzlichen Vorgaben unterliegen, um jede Anfrage zu speichern, wählen Sie bitte einen Speicherort aus, der regelmäßig gesichert (Backup) wird und ggf. gegen Veränderung Dritter geschützt ist. Fragen Sie dazu Ihre IT-Abteilung, um einen solchen Speicherplatz für Sie zu konfigurieren.

Bitte beachten Sie, dass jede Anfrage an das BZSt/VIES gespeichert wird. Selbst erneute Versuche werden gespeichert und können schnell zu einem Anwachsen der Anzahl der Dateien führen.

Verarbeitung

Sie haben auf der Reiterkarte die Möglichkeit, einige Einstellungen für die USt-IdNr-Prüfung festzulegen. Diese werden bei der Verarbeitung berücksichtigt. Im Folgenden werden diese Einstellungen im Einzelnen beschrieben.

USt-IdNr-Prüfung Einstellungen USt-IdNr Verarbeitung
USt-IdNr-Prüfung Einstellungen USt-IdNr Verarbeitung

Versuche

Über den eingegebenen Wert der Versuche haben Sie die Möglichkeit, die Anzahl an Wiederholungen einer Prüfung einzustellen. Eine Wiederholung der Anfrage kann ausgelöst werden, wenn die Gegenstelle des Bundeszentralamts für Steuern ausgelastet ist oder Ihre Netzwerkverbindung zu einem Timeout führt. Jeder Versuch wird, sofern aktiviert, im Audit-Log gespeichert.

Trennzeichen

Das Trennzeichen ist nur für den Import von CSV-Dateien für die USt-IdNr-Prüfung relevant (unabhängig ob Stapelverarbeitung oder Hintergrundverarbeitung). Die Daten werden in einzelne Werte anhand dieses Trennzeichens aufgeteilt und zur Prüfung aufbereitet. Berücksichtigen Sie bitte bei der Einstellung des Trennzeichens auf ein Vorkommen in Ihren Stammdaten. Ein Komma oder ein Semikolon kann u.U. in einem Firmennamen vorkommen und zu einem Fehler in der Verarbeitung führen. Wir haben das Pipe-Zeichen “|” als Standardwert definiert. Für JSON und XLSX ist dieses Trennzeichen nicht notwendig.

Leerzeichen

Werden Leerzeichen in Ihren Stammdaten bei der Erfassung von USt-IdNr erlaubt, so kann dies zu Fehlern bei der Prüfung kommen. Diese Einstellung gibt Ihnen die Möglichkeit, dass bei der Prüfung diese ignoriert werden.

Groß- und Kleinschreibung

Sofern die Eingabe von Kleinbuchstaben in Ihren Stammdaten bei der Erfassung von USt-IdNr erlaubt ist, so kann dies zu Fehlern bei der Prüfung kommen. Diese Einstellung gibt Ihnen die Möglichkeit, dass bei der Prüfung die Groß- und Kleinschreibung ignoriert wird und auf das richtige Format automatisch gesetzt wird.

USt-IdNr bereinigen

Wird diese Option gesetzt, wird die bereinigte USt-IdNr (Leerzeichen, Groß- und Kleinschreibung) in der Exportdatei zurückgegeben. Dies bedeutet, dass in Protokolldateien (diese haben den gleichen Aufbau wie die importierte CSV Datei) die USt-IdNr ohne diese fehlerhafte Schreibweise ausgegeben werden. Bei einem Reimport in Ihr ERP System kann somit der Datensatz bereinigt werden.

Gültige USt-IdNr als fehlerhaft kennzeichnen

Die Schnittstelle des Bundeszentralamts prüft automatisch bei einer fehlerhaften qualifizierten Abfrage, ob die USt-IdNr dennoch korrekt ist (einfache Abfrage). Die Rückgabe ist hierbei als gültig gekennzeichnet. Möchten Sie dieses unterbinden, haben Sie mit dieser Option die Möglichkeit dazu. In den Protokolldateien führt dies zu dem Fehler 900.

Zeichenkodierung der Ausgabe

Mit dieser Einstellung haben Sie die Möglichkeit, die Codepage der CSV Ausgabe der USt-IdNr-Prüfung zu steuern. Im Standard ist hier UTF-8 angegeben. Wird die CSV Datei mit Microsoft Excel weiterverarbeitet, empfiehlt es sich Win1252 (dies entspricht der ANSI Kodierung) empfohlen.

Sollte die Datensätze in der Ausgabedatei der USt-IdNr-Prüfung in Ihrem Texteditor oder in Microsoft Excel beispielsweise bei Umlauten nicht korrekt dargestellt werden, stellen Sie bitte ebenfalls diesen Parameter auf den jeweils anderen als der bei Ihnen aktuell eingestellten. Dies behebt in den meisten Fällen Darstellungsprobleme.

Hintergrundverarbeitung

Die Verarbeitung im Hintergrund ermöglicht Ihnen die USt-IdNr-Prüfung in regelmäßigen Abständen und automatisch zu verwenden. Einige Einstellungen sind hierbei vorab durchzuführen.

USt-IdNr-Prüfung Hintergrundverarbeitung
USt-IdNr-Prüfung Hintergrundverarbeitung

Dateiname von Import in Export übernehmen

Haben Sie diese Option aktiviert, wird bei der Verarbeitung der identische Name für die exportierte Datei herangezogen.

Nur ungültige USt-IdNr in Exportdatei ausgeben

Mit dieser Option haben Sie die Möglichkeit, dass nur ungültige Umsatzsteueridentifikationsnummern in die Exportdatei ausgegeben werden. Wurde der E-Mail-Versand aktiviert, erhält der Sachbearbeiter entsprechend auch nur diese Einträge aus der importierten Datei zugesandt.

Gerade bei großen Datenmengen oder sehr regelmäßiger Prüfung von USt-IdNr kann dies das Postfach des Benutzers oder der freigegebenen Gruppe schonen.

Keine Überschriften in CSV Exportdatei

Aktivieren Sie diese Option, damit in der CSV Exportdatei der USt-IdNr Prüfung keine Überschriften ausgegeben werden.

Verzeichnisse

Damit die Hintergrundverarbeitung die Dateiverarbeitung der USt-IdNr-Prüfung ordnungsgemäß durchführen kann, geben Sie bitte für alle notwendigen Verzeichnisse vollständig an. Bitte beachten Sie, dass die Verzeichnisse sich voneinander unterscheiden müssen, damit es beispielsweise nicht zu einer Endlosschleife der Prüfungen kommt, wenn die Exportdatei immer wieder als zu importierende Datei erkannt wird.

Sind für die USt-IdNr-Prüfung die Verzeichnisse nicht angegeben, kann die Hintergrundverarbeitung nicht durchgeführt werden. Haben Sie Verzeichnisse angegeben, die noch nicht vorhanden sind, versucht die Software diese beim ersten Aufruf anzulegen. Sind nicht die notwendigen Rechte vorhanden oder das Anlegen schlägt fehl, so erhalten Sie eine entsprechende Meldung.

Kommandozeile (cli)

Die Hintergrundverarbeitung kann nicht über die Oberfläche gestartet werden. Um die Hintergrundverarbeitung zu starten, öffnen Sie eine Kommandozeile in dem Verzeichnis, in dem die Datei ew_service_vat.exe liegt und rufen diese mit dem Parameter --mode=auto auf.

Um die europäische Schnittstelle zu verwenden, fügen Sie die Option --vies hinzu.

Die Hintergrundverarbeitung verarbeitet damit alle USt-IdNr Dateien, die sich im Importverzeichnis befinden. Im Backup-Verzeichnis wird stets eine Kopie der Importdatei abgespeichert und das fertige Prüfergebnis im Exportverzeichnis abgestellt. Im Protokollverzeichnis werden einzelne Verarbeitungsschritte festgehalten.

Der Aufruf für USt-IdNr-Prüfung mit der Option --mode=auto kann über eine wiederholende Aufgabe oder cronjob eingeplant werden.

Parameter

Führen Sie ew_service_vat --help aus und Sie erhalten die Übersicht aller Parameter der USt-IdNr-Prüfung, die Sie an die cli bzw. den Service übergeben können.

Usage of: ew_service_vat.exe [options]
----------------------------------------------------------------------------
-h  --help              Show this help
-v  --version           Version Return the version information.
    --lang              Language (de,en). Overwrites settings.
    --mode              Set the validation mode (single, batch, auto).
    --dataobject        JSON object for single validation mode.
    --inputfile         Input ImportData file for batch validation.
    --outputfile        Output file for batch validation.
    --returncodesbzst   Writes the returncodes for BZSt to user dir.
    --returncodesvies   Writes the returncodes for VIES to user dir.
    --testmail          Send a testmail.
    --vies              Use VIES instead of BZSt.
    --validatefile      Check file, if structure is readable.
----------------------------------------------------------------------------

-h --help

Zeigen Sie sich alle notwendigen Parameter an, die die cli der USt-IdNr-Prüfung unterstützt.

-v --version

Gibt die aktuelle installierte Version der USt-IdNr-Prüfung aus.

--lang

Mit diesem Parameter können Sie die Sprache der USt-IdNr-Prüfung angeben bzw. überschreiben.

--mode

Der Modus, in dem die USt-IdNr-Prüfung ausgeführt werden soll.

--dataobject

Dieser Parameter ist notwendig bei einer einzelnen Prüfung einer USt-IdNr.

-i --inputfile

Übergeben Sie mit diesem Parameter die Datei mit zu importierenden Daten für die USt-IdNr-Prüfung an.

-o --outputfile

Die Exportdatei für die USt-IdNr-Prüfung wird mit diesem Parameter angegeben. Wichtig ist, dass dieser nicht identisch mit der Importdatei ist.

--returncodesbzst

Dieser Parameter erzeugt eine Konfigurationsdatei für die USt-IdNr-Prüfung, um die Rückgabewerte der BZSt-Schnittstelle zu bearbeiten.

--returncodesvies

Dieser Parameter erzeugt eine Konfigurationsdatei für die USt-IdNr-Prüfung, um die Rückgabewerte der VIES-Schnittstelle zu bearbeiten.

--testmail

Testen Sie aus der USt-IdNr-Prüfung heraus einen Versand einer Test-E-Mail durch. Nach der Verarbeitung einer Datei kann Ihnen am Ende eine E-Mail zugesandt werden.

--vies

Dieser Parameter gibt an, dass die VIES Schnittstelle verwendet werden soll und überschreibt ggf. abweichende Einstellungen.

--validatefile

Überprüfen Sie die Importdatei der USt-IdNr-Prüfung zuvor auf Ihre formale Richtigkeit.

Ausgaben auf der Kommandozeile

Alle Ausgaben sind im JSON Format und variieren nach Ihren Rückgabewerten.

CSV Schnittstelle

Wir empfehlen die Nutzung der XLSX oder JSON Importschnittstellen.

Durch die Verwendung einer einfachen CSV-Datei bietet Ihnen die Software USt-IdNr-Prüfung eine Möglichkeit, Ihren gesamten Datenbestand zu überprüfen.

Wir achten darauf, dass bei der Erweiterung der Schnittstelle für den Import von CSV die Kompatibilität gewahrt bleibt. Damit können Sie jeweils die aktuellste Version einsetzen, ohne zusätzlichen Aufwand bei einer Integration in Ihr ERP System zu generieren.

Um die Zugehörigkeit der einzelnen USt-IdNr Datensätze in Ihre Stammdaten zu gewährleisten, haben Sie die Möglichkeit, bis zu zwei eindeutige Schlüssel in der Importdatei anzugeben. Diese werden in der Exportdatei wieder zurückgegeben und können für den Reimport in Ihr ERP System genutzt werden. Sie können diese beiden Felder (Schluessel_1 und Schluessel_2) auch leer lassen.

Das Standard-Trennzeichen der einzelnen Elemente für die USt-IdNr-Prüfung ist das ‚|‘-Zeichen (pipe). Dieses kann über die Einstellungen geändert werden. Fettgedruckte Feldnamen sind Pflichtfelder (das Trennzeichen über Einstellungen änderbar).

Bitte beachten Sie, dass alle Felder in der Importdatei der USt-IdNr-Prüfung angegeben werden müssen, auch wenn Sie nur eine einfache Prüfung durchführen möchten. Die qualifizierte Prüfung ist momentan nur für die Schnittstelle des BZSt verfügbar.

Aufbau – CSV Importdatei

FeldFormatBeispiel
Schluessel_1String4711
Schluessel_2String2
Eigene USt-IdNrStringDE123456789
Fremde USt-IdNrStringAT12345678
FirmennameString 
OrtString 
PostleitzahlString 
StraßeString 

Beispiel in Form einer CSV-Datei:
4711|2|DE123456789|AT12345678|||| … (weitere USt-IdNr Prüfungen)

Hinweis

Bitte achten Sie bei dem Erstellen der USt-IdNr-Importdatei auf die korrekte Anzahl an Spalten (8 Spalten). Dieser Hinweis ist wichtig für eventuelle Fehler beim Import bei der Verwendung von CSV. Zukünftig werden wir weitere Importformate unterstützen, die diese Einschränkung nicht mehr haben.

Aufbau – CSV Exportdatei

Die CSV-Exportdatei der USt-IdNr-Prüfung beinhaltet die zurückgegebenen Werte der einzelnen Prüfungen.

FeldFormatBeispiel
key1String4711
key2String2
ownvatStringDE123456789
foreignvatStringAT12345678
errorcodeString200
errorcode_descriptionStringDie angefragte USt-IdNr. ist gültig.
valid_fromString 
valid_toString 
errorcode_hintString 
timestampString2021-01-05 16:12:37
companyString 
townString 
zipString 
streetString 

Beispiel in Form einer CSV-Datei (mit Standard-Trennzeichen):

4711|2|DE123456789|AT12345678|200|Die angefragte USt-IdNr. ist gültig.|||2019-11-05 14:35:43

Die Benennung der Felder der USt-IdNr-Prüfung innerhalb der CSV Import bzw. Exportdatei erfolgt in deutscher Sprache. Im Zuge der Erweiterung der Importformate werden diese internationalisiert, d.h. wir werden die Feldnamen zukünftig in englischer Sprache führen. Eine Konfiguration der Feldnamen haben wir allerdings angedacht, um die Flexibilität zu erhöhen.

Die Ausgabe der Exportdatei im CSV Format der USt-IdNr-Prüfung beinhaltet stets eine zusätzliche Spalte, in der die Überschriften enthalten sind. Bitte beachten Sie dies bei einem eventuellen automatischen Reimport der Prüfungsergebnisse.

JSON Schnittstelle

Mit der Schnittstelle für den Import für JSON Dateien, bietet Ihnen die USt-IdNr-Prüfung eine Möglichkeit, Ihren gesamten Datenbestand aus Ihren Stammdaten heraus zu überprüfen.

Wir achten darauf, dass bei der Erweiterung der JSON USt-IdNr-Prüfung-Schnittstelle die Kompatibilität stets gewahrt bleibt. Damit können Sie jeweils die aktuellste Version einsetzen, ohne zusätzlichen Aufwand bei einer Integration in Ihr ERP System zu generieren.

Um einen JSON Datensatz aus Ihrem ERP System eindeutig in der USt-IdNr-Prüfung zuordnen zu können, haben Sie die Möglichkeit, bis zu zwei eindeutige Schlüssel in der Importdatei anzugeben. Diese werden in der Exportdatei wieder zurückgegeben und können für den Reimport in Ihr ERP System genutzt werden. Sie können diese beiden Felder (key1 und key2) jedoch auch leer lassen.

Bitte beachten Sie, dass alle fettgedruckten Felder in der Importdatei angegeben werden müssen. Je nach Angabe der Felder wird automatisch eine qualifizierte Prüfung durchgeführt. Die qualifizierte Prüfung ist momentan nur für die Schnittstelle des BZSt verfügbar.

Aufbau – JSON Importdatei

KeyFormatBeispiel
key1String4711
key2String2
ownvatStringDE123456789
foreignvatStringAT12345678
companyString 
townString 
zipString 
streetString 

Aufbau – JSON Exportdatei

Die JSON-Exportdatei der USt-IdNr-Prüfung beinhaltet die zurückgegebenen Werte der einzelnen Prüfungen, ebenfalls, sofern nicht anders angegeben, im gleichen Datenformat. Bitte beachten Sie, dass die JSON Schnittstelle alle verfügbaren Felder ausgibt und somit das vollständigste Format darstellt.

FeldFormatBeispiel
key1String4711
key2String2
ownvatStringDE123456789
foreignvatStringAT12345678
errorcodeString200
errorcode_descriptionStringDie angefragte USt-IdNr. ist gültig.
valid_fromString 
valid_toString 
errorcode_hintString 
timestampString2021-01-05 16:12:37
companyString 
townString 
zipString 
streetString 

Im Gegensatz zu XLSX oder CSV haben wir uns auf die rein englische Notation der Schlüssel der USt-IdNr-Prüfung innerhalb von JSON geeinigt. Damit können wir von vorneherein Laufzeitfehler bei einer fehlerhaften Konvertierung vermeiden.

Bitte beachten Sie, dass die Felder in der Exportdatei der USt-IdNr-Prüfung nicht immer in der gleichen Reihenfolge ausgegeben werden, wie in der obigen Tabelle angegeben.

XLSX Schnittstelle

Mit der Schnittstelle für den Import für Microsoft Excel (XLSX) Datei, bietet Ihnen die Software zur Prüfung von USt-IdNrn eine Möglichkeit, Ihren gesamten Datenbestand aus Ihren Stammdaten heraus zu überprüfen.

Wir achten darauf, dass bei der Erweiterung der XLSX USt-IdNr-Prüfung-Schnittstelle die Kompatibilität (auch zu Microsoft Excel) gewahrt bleibt. Damit können Sie jeweils die aktuellste Version einsetzen, ohne zusätzlichen Aufwand bei einer Integration in Ihr ERP System zu generieren.

Um einen XLSX Datensatz aus Ihrem ERP System eindeutig in der USt-IdNr-Prüfung zuordnen zu können, haben Sie die Möglichkeit, bis zu zwei eindeutige Schlüssel in der Importdatei anzugeben. Diese werden in der Exportdatei wieder zurückgegeben und können für den Reimport in Ihr ERP System genutzt werden. Sie können diese beiden Felder (Schluessel_1 und Schluessel_2) jedoch auch leer lassen.

Bitte beachten Sie, dass alle hervorgehobenen Felder in der USt-IdNr Importdatei angegeben werden müssen. Je nach Angabe der Felder wird automatisch eine qualifizierte Prüfung durchgeführt. Die qualifizierte Prüfung ist momentan nur für die Schnittstelle des BZSt verfügbar.

Die Bezeichnungen der Spaltenüberschriften der USt-IdNr-Prüfung werden beim Import innerhalb der XLSX Datei gesucht und beim Import zugeordnet. Bitte geben Sie jeweils immer nur eine Bezeichnung ein, bspw. “Firmenname” und nicht “Company,Firmenname”.

Die Groß- und Kleinschreibung der Spaltenüberschriften ist nicht relevant für den Import.

Aufbau – XLSX Importdatei

Spaltenüberschrift (1. Zeile!)FormatBeispiel
key1, schluessel_1String4711
key2, schluessel_2String2
ownvat, eigene ust-idnr, ustid1StringDE123456789
foreignvat, fremde ust-idnr, ustid2StringAT12345678
company, firmennameString 
town, ortString 
zip, postleitzahlString 
street, straßeString 

Aufbau – XLSX Exportdatei

Die XLSX-Exportdatei der USt-IdNr-Prüfung beinhaltet die zurückgegebenen Werte der einzelnen Prüfungen, ebenfalls, sofern nicht anders angegeben, im gleichen Datenformat.

FeldFormatBeispiel
key1String4711
key2String2
ownvatStringDE123456789
foreignvatStringAT12345678
errorcodeString200
errorcode_descriptionStringDie angefragte USt-IdNr. ist gültig.
valid_fromString 
valid_toString 
errorcode_hintString 
timestampString2021-01-05 16:12:37
companyString 
townString 
zipString 
streetString 

XLSX Versionen

Wir unterstützen der Software USt-IdNr-Prüfung alle XLSX Versionen bis einschließlich neuster Version von Office 365. Bitte haben Sie Verständnis dafür, dass wir ältere Versionen (XLS) nicht mehr unterstützen werden.

Unser Testumfang für die Prüfung von USt-IdNrn beinhaltet sehr viele verschiedene Varianten, wie ein Microsoft Excel-Dokument aussehen kann. Dennoch konnten wir nicht alles Funktionen und Möglichkeiten prüfen. Sollten Sie beim Import von XLSX Dateien auf ein Problem stoßen, kontaktieren Sie uns und senden uns bitte ein oder zwei Testdatensätze zu, damit wir Ihnen schnell helfen können.