Abrufen von Trackinginformationen für Sendungen
Mit der exporto API können technische Integrationspartner den Verarbeitungsstatus einzelner Sendungen (Shipments) abrufen. Diese Informationen geben Aufschluss darüber:
-
ob eine Sendung bereits durch exporto verarbeitet wurde,
-
ob sie erfolgreich verzollt wurde,
-
und welchen Status die Zustellung durch den Last-Mile-Carrier aktuell hat.
Empfohlener Ablauf zum Abrufen von Trackingdaten
Es gibt zwei Möglichkeiten, Trackinginformationen abzurufen:
-
Direktabruf einzelner Shipments per shipmentID
-
Abruf verarbeiteter Shipments über Touren (empfohlen bei größerem Sendungsvolumen9
1. Direktabruf einzelner Sendungen
Wenn die shipmentID bekannt ist, kann der aktuelle Status direkt über den folgenden Endpunkt abgefragt werden:
Die API-Antwort (Response) enthält unter anderem folgende Statusinformationen und Zeitstempel, die die Verarbeitungskette des Shipments abbilden:
Diese Werte geben Aufschluss darüber, wann eine Sendung verarbeitet, verzollt, an den Carrier übergeben oder zugestellt wurde.
2. Abruf verarbeiteter Sendungen über Touren
Wenn regelmäßig der Status mehrerer Sendungen abgefragt werden soll, empfiehlt exporto den Abruf über Touren.
Schritt 1: Liste verfügbarer Touren abrufen
Eine Tour entspricht bei exporto einem internen Tagesabschluss. Über den folgenden Endpunkt kann eine Liste der verfügbaren tourIDs abgefragt werden:
Schritt 2: shipmentIDs innerhalb einer Tour abfragen
Mit den erhaltenen tourIDs kann gezielt ermittelt werden, welche Sendungen zu einer bestimmten Tour gehören:
Die Antwort (Response) enthält alle shipmentIDs, die zu dieser Tour gehören.
Schritt 3: Detaillierte Informationen zu einzelnen Sendungen abrufen
Für jede erhaltene shipmentID können anschließend die Trackinginformationen individuell über den bekannten Endpunkt abgerufen werden:
Hinweis
Durch die Nutzung des tourbasierten Abrufs können effizient nur jene Sendungen abgefragt werden, die bereits verarbeitet wurden. Dies reduziert unnötige API-Requests auf noch nicht abgeschlossene Shipments.
Kontakt
Bei technischen Rückfragen oder Unterstützung bei der Implementierung steht das exporto Team gerne zur Verfügung.
Kontakt: product@exporto.de
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.