Abrufen Ihrer Trackinginformationen

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:

1. Direktabruf einzelner Shipments per shipmentID

2. 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:

GET /shipment/{shipmentId}

Die API-Antwort (Response) enthält unter anderem folgende Statusinformationen und Zeitstempel, die die Verarbeitungskette des Shipments abbilden:

{
  "processedAt": "2025-04-03T10:32:31.329Z",
  "declaredAt": "2025-04-03T10:32:31.329Z",
  "carrierState": "notAvailable",
  "carrierReceivedAt": "2025-04-03T10:32:31.329Z",
  "carrierDeliveredAt": "2025-04-05T15:45:12.000Z"
}

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:

GET /tours

Schritt 2: shipmentIDs innerhalb einer Tour abfragen

Mit den erhaltenen tourIDs kann gezielt ermittelt werden, welche Sendungen zu einer bestimmten Tour gehören:

GET /tour/{tourId}

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:

GET /shipment/{shipmentId}

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