Zum Inhalt

Sendungsverfolgung (Tracking)

Überblick

Der Hermes Connector bietet eine automatische Sendungsverfolgung. Wenn das Tracking aktiviert ist, werden offene Sendungen periodisch bei der Hermes API abgefragt und Statusänderungen als Events historisiert.

Tracking aktivieren

  1. Öffnen Sie das Hermes Setup
  2. Setzen Sie Tracking aktiviert auf Ja
  3. Legen Sie das Abfrageintervall fest (in Minuten)
Einstellung Empfehlung Beschreibung
Tracking aktiviert Ja Automatische Statusabfrage einschalten
Abfrageintervall 60–120 Min. Häufigere Abfragen = aktuellere Daten, aber höhere API-Last

Performance

Ein Intervall von 60 Minuten ist für die meisten Anwendungsfälle ausreichend. Die Hermes API hat Rate Limits — zu häufige Abfragen können geblockt werden.

Tracking-Status

Statusübersicht

Status Symbol Bedeutung
Picked Up 📦 Sendung wurde abgeholt
In Transit 🚚 Sendung ist unterwegs im Hermes-Netzwerk
Out for Delivery 🏠 Sendung befindet sich in der letzten Meile (Zustellung)
Delivered ✅ Erfolgreich zugestellt
Returned ↩️ Sendung wurde an den Absender zurückgeschickt
Exception ⚠️ Fehler bei der Zustellung (Empfänger nicht angetroffen, Adressfehler)

Statusübergänge

stateDiagram-v2
    [*] --> PickedUp: Abholung
    PickedUp --> InTransit: Eingang im Depot
    InTransit --> OutForDelivery: Letzte Meile
    OutForDelivery --> Delivered: Zustellung erfolgreich
    OutForDelivery --> Exception: Zustellung fehlgeschlagen
    Exception --> InTransit: Erneuter Versuch
    Exception --> Returned: Rücksendung
    InTransit --> Returned: Nicht zustellbar

Tracking-Events

Jede Statusänderung wird als Tracking-Event gespeichert. Die Event-Historie zeigt den vollständigen Verlauf einer Sendung:

Feld Beschreibung
Zeitstempel Datum und Uhrzeit des Events
Status Neuer Sendungsstatus
Standort Ort des Events (Depot, Zustellfahrzeug, PaketShop)
Beschreibung Detaillierte Beschreibung des Events

Events einsehen

  1. Öffnen Sie die merchantCENTRAL Sendungsliste
  2. Wählen Sie eine Sendung mit Tracking-Nummer
  3. Klicken Sie auf Tracking-Verlauf (oder öffnen Sie die Sendungsdetails)
  4. Die Event-Liste zeigt alle Statusänderungen chronologisch

Proof of Delivery (Zustellnachweis)

Bei erfolgreicher Zustellung kann ein digitaler Zustellnachweis (Proof of Delivery / POD) abgerufen werden:

  • Digitale Unterschrift des Empfängers
  • Zustellzeitpunkt (exaktes Datum und Uhrzeit)
  • Zustellort (Haustür, Nachbar, PaketShop)

Verfügbarkeit

Der Zustellnachweis ist nicht sofort nach Zustellung verfügbar. Es kann einige Stunden dauern, bis die Daten im System bereitstehen.

Automatische Verarbeitung

Job Queue Integration

Das Tracking wird über den Hub-Job-Queue-Mechanismus gesteuert:

  1. Der Hub erstellt automatisch einen Job Queue Entry für das Tracking
  2. Der Job läuft im konfigurierten Intervall
  3. Nur offene Sendungen (nicht zugestellt, nicht zurückgeschickt) werden abgefragt
  4. Zugestellte Sendungen werden automatisch aus der Tracking-Schleife entfernt

Hub-Events

Der Hermes Connector reagiert auf folgende Hub-Events:

Event Beschreibung
OnGetTrackingStatus Tracking-Status für eine einzelne Sendung abfragen
OnGetProofOfDelivery Zustellnachweis (POD) für eine Sendung abrufen

Fehlerfälle

Situation Verhalten
API nicht erreichbar Abfrage wird beim nächsten Intervall wiederholt
Tracking-Nummer ungültig Sendung wird aus dem Tracking entfernt, Fehlermeldung im Log
Rate Limit erreicht Abfrage wird automatisch pausiert und beim nächsten Intervall fortgesetzt

Einschränkungen

Einschränkung Beschreibung
Nur Hermes-Sendungen Tracking funktioniert nur für über diesen Connector erstellte Sendungen
Kein Echtzeit-Tracking Status wird periodisch abgefragt (Polling), kein Webhook/Push
Nationale Sendungen Tracking nur für deutsche Sendungen verfügbar