erpware logo

EORI-Prüfung: JSON Schnittstelle

Mit der Schnittstelle für den Import für JSON Dateien, bietet Ihnen das Modul EORI-Prüfung eine Möglichkeit, Ihren gesamten Datenbestand aus Ihren Stammdaten heraus zu überprüfen.

Wir achten darauf, dass bei der Erweiterung der JSON EORI-Schnittstelle die Kompatibilität stets 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 einen JSON Datensatz aus Ihrem ERP System eindeutig in der EORI-Prüfung 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 (key1 und key2) jedoch auch leer lassen. Diese sind für die Verarbeitung nicht notwendig.

Da die EORI-Schnittstelle auch den Namen und Adresse zurück gibt, werden wir in einem zukünftigen Release der EORI-Prüfung auch eine Überprüfung Ihrer hinterlegten Daten ermöglichen und die JSON Schnittstelle erweitern.

Bitte beachten Sie, dass alle fettgedruckten Felder in der Importdatei angegeben werden müssen.

Aufbau – EORI JSON Importdatei

Key Format Beispiel
key1 String 4711
key2 String 2
eori String DE123456

Beispiel in Form einer JSON-Datei mit zwei Einträgen:

[
    {
    "key1": "a",
    "key2": "b",
    "eori": "DE123456"
    },
    {
    "key1": "a",
    "key2": "b",
    "eori": "DE789012"
    }
]

Aufbau – EORI JSON Exportdatei

Die JSON-Exportdatei der EORI-Prüfung beinhaltet die zurückgegebenen Werte der einzelnen Prüfungen, ebenfalls, sofern nicht anders angegeben, im gleichen Datenformat. Bitte beachten Sie, dass die JSON Schnittstelle alle verfügbaren Felder ausgibt und somit das vollständigste Format darstellt.

Feld Format Beispiel
key1 String 4711
key2 String 2
eori String DE123456
name String Musterfirma
address String
street String Musterstraße 1
postalCode String 12345
city String Musterdorf
country String Deutschland
status String 0
statusDescr String Valid
errorReason String
requestdate String

Beispiel in Form einer JSON-Datei:

[
 {
  "eori": "DE1537016",
  "status": "0",
  "statusDescr": "Valid",
  "name": "Musterfirma",
  "street": "Musterstraße 1",
  "postalCode": "12345",
  "city": "Musterdorf",
  "country": "Germany",
  "requestdate": "30/01/2021",
  "key1": "4711",
  "key2": "2"
 }
]

Im Gegensatz zu XLSX oder CSV haben wir uns auf die rein englische Notation der Schlüssel der EORI-Prüfung innerhalb von JSON geeinigt. Damit können wir von vorneherein Laufzeitfehler bei einer fehlerhaften Konvertierung vermeiden.

Bitte beachten Sie, dass die Felder in der Exportdatei der EORI-Prüfung nicht immer in der gleichen Reihenfolge ausgegeben werden, wie in der obigen Tabelle angegeben.


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