CSV-Schnittstelle der VAT-Validation
Verwendung der CSV-Schnittstelle der VAT-Validation
Inhaltsverzeichnis
Wir empfehlen die Nutzung der XLSX oder JSON Importschnittstellen.
Durch die Verwendung einer einfachen CSV-Datei bietet Ihnen die Software VAT-Validation 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 der USt-IdNr-Prüfung 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 CSV-Schnittstelle
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 VAT-Validation ist das ‚|‘-Zeichen (pipe). Dieses kann über die Einstellungen geändert werden. Fettgedruckte Feldnamen sind Pflichtfelder.
Bitte beachten Sie, dass alle Felder in der Importdatei der VAT-Validation 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
| Feld | Format | Beispiel |
|---|---|---|
| Schluessel_1 | String | 4711 |
| Schluessel_2 | String | 2 |
| Eigene USt-IdNr | String | DE123456789 |
| Fremde USt-IdNr | String | AT12345678 |
| Firmenname | String | |
| Ort | String | |
| Postleitzahl | String | |
| Straße | String |
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. Die Angabe der Überschriften ist optional. Bitte achten Sie darauf, dass wir nur auf bestimmte Schreibweisen prüfen können, um welchen Wert es sich handelt. Bitte führen Sie selbst einen intensiven Test durch, damit falsche Prüfungen vermieden werden.
Aufbau – CSV Exportdatei
Die CSV-Exportdatei der VAT-Validation beinhaltet die zurückgegebenen Werte der einzelnen Prüfungen.
| 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 |
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 VAT-Validation 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 VAT-Validation beinhaltet stets eine zusätzliche Spalte, in der die Überschriften enthalten sind. Bitte beachten Sie dies bei einem eventuellen automatischen Reimport der Prüfungsergebnisse.
Beispieldatei CSV
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 CSV-Datei, die Sie als Vorlage verwenden können. Bitte beachten Sie, dass wir hierbei nur eine der möglichen Notationen unterstützen können.