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 VAT-Validation-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.
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.