erpware logo

USt-IdNr-Prüfung: CSV Schnittstelle

Wir empfehlen die Nutzung der XLSX oder JSON Importschnittstellen.

Durch die Verwendung einer einfachen CSV-Datei bietet Ihnen das Modul 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 des Moduls USt-IdNr-Prüfung 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 – USt-IdNr 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.

Aufbau – USt-IdNr CSV Exportdatei

Die CSV-Exportdatei der USt-IdNr-Prüfung 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 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.


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