USt-IdNr-Prüfung – CSV Schnittstelle

Wir empfehlen die Nutzung der XLSX oder JSON Importschnittstellen.

Durch die Verwendung einer einfachen CSV-Datei bietet Ihnen die Software 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

FeldFormatBeispiel
Schluessel_1String4711
Schluessel_2String2
Eigene USt-IdNrStringDE123456789
Fremde USt-IdNrStringAT12345678
FirmennameString 
OrtString 
PostleitzahlString 
StraßeString 

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.

FeldFormatBeispiel
key1String4711
key2String2
ownvatStringDE123456789
foreignvatStringAT12345678
errorcodeString200
errorcode_descriptionStringDie angefragte USt-IdNr. ist gültig.
valid_fromString 
valid_toString 
errorcode_hintString 
timestampString2021-01-05 16:12:37
companyString 
townString 
zipString 
streetString 

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.

Schreiben Sie einen Kommentar

Ihre E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.

Nach oben scrollen