XLSX-Schnittstelle der VAT-Validation

Verwendung der XLS-Schnittstelle der VAT-Validation

Inhaltsverzeichnis

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-Schnittstelle der USt-IdNr-Prüfung 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.

Informationen zur XLSX-Schnittstelle

Um einen XLSX Datensatz aus Ihrem ERP System eindeutig in der VAT-Validation 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 VAT-Validation 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!) 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 – XLSX Exportdatei

Die XLSX-Exportdatei der VAT-Validation 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 der Software VAT-Validation 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.

Beispieldatei XLSX

Wir haben in unsere VAT-Validation die Möglichkeit eingefügt, eine Beispieldatei direkt aus dem Menü heraus zu erzeugen. Daher haben wir den Download auf dieser Seite entfernt, um stets aktuell zu bleiben. Diese Funktion erzeugt Ihnen eine XLSX-Datei, die Sie als Vorlage verwenden können. Bitte beachten Sie, dass wir hierbei nur eine der möglichen Notationen unterstützen können.