erpware logo

USt-IdNr-Prüfung: XLSX Schnittstelle

Mit der Schnittstelle für den Import für Microsoft Excel (XLSX) Datei, bietet Ihnen das Modul 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.

Wir haben Ihnen zwei leere Beispieldateien mit jeweils englischer oder deutscher Spaltenbeschriftung eingefügt.

Aufbau – USt-IdNr XLSX Importdatei

Spaltenüberschrift (1. Zeile!) Format Beispiel
key1, schluessel_1 String 4711
key2, schluessel_2 String 2
ownvat, eigene ust-idnr, ustid1 String DE123456789
foreignvat, fremde ust-idnr, ustid2 String AT12345678
company, firmenname String
town, ort String
zip, postleitzahl String
street, straße String

Aufbau – USt-IdNr 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.

Feld Format Beispiel
key1 String 4711
key2 String 2
ownvat String DE123456789
foreignvat String AT12345678
errorcode String 200
errorcode_description String Die angefragte USt-IdNr. ist gültig.
valid_from String
valid_to String
errorcode_hint String
timestamp String 2021-01-05 16:12:37
company String
town String
zip String
street String

XLSX Versionen

Wir unterstützen im Modul 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.


Diese Dokumentation gehört zu unserem Modul USt-IdNr-Prüfung der ID Validation.