JSON Importschnittstelle

verfügbar ab ID Validation 1.5.0 / kostenlos für alle bestehenden Kunden

Mit der Importschnittstelle für JSON Dateien, bietet Ihnen das Modul “Dublettenprüfung” eine Möglichkeit, Ihren gesamten Datenbestand aus Ihren Stammdaten heraus zu überprüfen.

Wir achten darauf, dass bei der Erweiterung der JSON Dubletten-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 Dublettenprü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.

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

Aufbau – Importdatei

FeldFormatBeispiel
key1String
key2String
firstnameString
lastnameString
name1String
name2String
name3String
name4String
streetString
numberString
postcodeString
townString
departmentString
countryString

Beispiel in Form einer JSON-Datei:

[
    {
        "key1":"val_key1",
        "key2":"val_key2",
        "firstname":"val_firstname",
        "lastname":"val_lastname",
        "name1":"val_name1",
        "name2":"val_name2",
        "name3":"val_name3",
        "name4":"val_name4",
        "street":"val_street",
        "number":"val_number",
        "postcode":"val_postcode",
        "town":"val_town",
        "department":"val_department",
        "country":"val_country"
    },
    {...}
]

Aufbau – Exportdatei

Die JSON-Exportdatei der Dubletten Prüfung beinhaltet die zurückgegebenen Werte der einzelnen Abfragen, 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.

FeldFormatBeispiel
internalidString
key1String
key2String
firstnameString
lastnameString
name1String
name2String
name3String
name4String
streetString
numberString
postcodeString
townString
departmentString
countryString
// cleaned data
cleaned firstnameString
cleaned lastnameString
cleaned name1String
cleaned name2String
cleaned name3String
cleaned name4String
cleaned streetString
cleaned numberString
cleaned postcodeString
cleaned townString
cleaned departmentString
cleaned countryString
// applied cleaners
applied cleanersString
// applied duplicates
duplicate idsString
address groupString

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