Kuehne + Nagel Konnektor

Der Kuehne + Nagel Konnektor verbindet Syncler mit der API von Kühne + Nagel, einem internationalen Logistikunternehmen.
Über diesen Konnektor können Container-Informationen und Frachtstatusdaten abgerufen und in Syncler weiterverarbeitet werden.
Aktuell unterstützt der Konnektor ausschließlich Lesevorgänge zur Abfrage von Container- und Sendungsinformationen.

Voraussetzungen

Zur Nutzung des Konnektors werden API-Zugangsdaten aus dem Kuehne + Nagel Developer Portal benötigt.
Melden Sie sich im Kundenportal an und öffnen Sie den Bereich „My Applications“.
Dort finden Sie die für die Verbindung erforderlichen Werte:

• user
• password
• client-id
• client-secret

Tragen Sie diese Zugangsdaten in die entsprechenden Felder der Verbindung ein.

Einrichtung

1. Neues System anlegen

• Erstellen Sie in Syncler ein neues System mit dem Typ „Kuehne + Nagel“.
• Geben Sie einen Namen und optional eine Beschreibung an.

2. Verbindung konfigurieren

• Tragen Sie die folgenden Verbindungsparameter ein:
  • Benutzername (user)
  • Passwort (password)
  • Client-ID (client-id)
  • Client-Secret (client-secret)
• Speichern Sie die Verbindung, um die Authentifizierung zu testen.

Nach erfolgreicher Anmeldung steht das Schema zur Verfügung.

Funktionen

Schema ermitteln

Der Konnektor stellt automatisch das Schemaobjekt containerInfo bereit.
Dieses Objekt enthält alle relevanten Felder, die für die Container-Statusinformationen verfügbar sind.

Lesen von Schema-basierten Daten

Das Lesen von Containerinformationen erfolgt ausschließlich über einen Filter.
Dieser Filter muss aus zwei Werten, getrennt durch ein Semikolon (;), bestehen:

• Der erste Wert legt den referenceType fest.
• Der zweite Wert enthält den Suchwert (z. B. eine Containernummer).

Unterstützte Referenztypen

• ALL_CUSTOMER_REFERENCES
• SPECIFIC_CUSTOMER_REFERENCE
• BILL_OF_LADING
• DELIVERY_LOCATION
• TRACKING_NUMBER
• CONTAINER_NUMBER

Beispiele

Einzelner Container

CONTAINER_NUMBER;ABCD12345

Abfrage aller Kundenreferenzen

ALL_CUSTOMER_REFERENCES;%

Die API liefert eine Liste der gefundenen Containerinformationen mit Detaildaten zum Transport- und Lieferstatus.

Lesen von Abfrage-basierten Daten

Diese Funktion arbeitet identisch zum Schema-basierten Lesen.
Auch hier erfolgt die Abfrage über zwei Werte (Referenztyp und Wert).
Sie kann insbesondere in Transformationen verwendet werden, um vorhandene Datensätze mit Containerdaten anzureichern.

Schreiben von Daten

Das Schreiben von Daten wird nicht unterstützt.
Die Verbindung ist ausschließlich für Lesevorgänge ausgelegt.