Status von Paketen

Einleitung

Jedes Paket in MotionTools durchläuft während seines Lebenszyklus unterschiedliche Status. Es ist wichtig zu verstehen, was jeder Status bedeutet, da verfügbare Aktionen und Funktionen sowie die Sichtbarkeit direkt mit dem jeweiligen Status zusammenhängen bzw. durch ihn eingeschränkt werden.

Ein Paket muss nicht zwingend alle Status durchlaufen – einige Status können bei Übergängen übersprungen werden.

Status-Übersicht

Dies ist ein kurzer Überblick über alle verfügbaren Status. Für detailliertere Erklärungen und die möglichen Status-Übergänge siehe den nächsten Abschnitt.

Status	Kurzbeschreibung
Erstellt	Paket erstellt
Warten auf Abholung	Paket wurde zur Abholung eingeplant
In Abholung	Paket wurde abgeholt und ist auf dem Weg zum Hub
Am Hub	Paket wurde im Hub abgegeben oder direkt im Status „Am Hub“ erstellt
Auslieferung geplant	Paket wurde zur Auslieferung eingeplant
In Auslieferung	Paket wurde vom Fahrer übernommen und ist auf dem Weg zum Ziel
Geliefert	Paket wurde am Zielort übergeben/abgegeben
Abholbereit	Abholung des Pakets aus dem Hub wurde vom Kunden angefragt
Abgeholt	Paket wurde vom Kunden im Hub abgeholt
Beim Zoll	Paket wird beim Zoll bearbeitet
Storniert	Zustellung des Pakets wurde storniert
Fehlgeschlagen	Paket konnte nicht abgeholt oder zugestellt werden

Status im Detail

INFO

Wenn du eine Integration mit MotionTools entwickelst, beachte bitte: Die Statusnamen, die im Dashboard angezeigt werden, können sich leicht von den Namen unterscheiden, die in der API verwendet werden. Um Benachrichtigungen zu jeder Statusänderung zu erhalten, kannst du das entsprechende Webhook-Event abonnieren.

Erstellt

created

Ein Paket wurde mit dem Ort eines Kunden als Ursprung erstellt.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Erstellt → Abholung ausstehend	announce	Paket wurde zur Abholung eingeplant
Erstellt → Im Hub	relocate	Disponent/Admin hat das Paket in einen Hub umgelagert
Erstellt → Fehlgeschlagen	miss	Abhol-/Zustellversuch ist direkt nach Erstellung fehlgeschlagen (Sonderfall)
Erstellt → Storniert	cancel	Admin hat das Paket storniert

Warten auf Abholung

awaiting_pickup

Ein Paket wurde zur Abholung eingeplant.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Warten auf Abholung → In Abholung	pickup	Fahrer hat das Paket abgeholt
Warten auf Abholung → In Auslieferung	pickup	Fahrer hat das Paket abgeholt
Warten auf Abholung → Am Hub	tour_cancelled tour_force_ended remove_from_tour	Tour wurde abgebrochen/zwangsbeendet oder Paket wurde nach Erreichen eines Hubs aus der Tour entfernt
Warten auf Abholung → Erstellt	tour_cancelled tour_force_ended remove_from_tour	Tour wurde abgebrochen/zwangsbeendet oder Paket wurde vor Abholung aus der Tour entfernt (Paket kehrt in den Initialstatus zurück)
Warten auf Abholung → Fehlgeschlagen	miss	Abholversuch fehlgeschlagen (z. B. Fahrer konnte das Paket nicht abholen)

In Abholung

in_transit

Ein Paket wurde von einem Fahrer abgeholt und ist auf dem Weg zu einem Hub.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
In Abholung → Warten auf Abholung	dropoff	Fahrer hat das Paket wieder am Ursprung abgegeben (z. B. Abholung wurde rückgängig gemacht)
In Abholung → Am Hub	dropoff tour_force_ended	Fahrer hat das Paket im Hub abgegeben (oder Tour wurde nach Erreichen des Hubs zwangsbeendet)
In Abholung → Geliefert	tour_force_ended	Tour wurde zwangsbeendet und das Paket wurde als zugestellt markiert
In Abholung → Fehlgeschlagen	miss tour_cancelled	Abhol-/Zustellversuch fehlgeschlagen oder Tour wurde während des Transports abgebrochen

Am Hub

at_hub

Ein Paket wurde im Hub abgegeben oder direkt im Status „Am Hub“ erstellt (z. B. durch Erwähnung des Ortes eines Admins).

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Am Hub → Am Hub	relocate tour_cancelled tour_force_ended	Paket wurde in einen anderen Hub umgelagert oder eine Tour wurde abgebrochen/zwangsbeendet, während das Paket im Hub blieb
Am Hub → Warten auf Abholung	announce	Paket wurde zur Abholung aus dem Hub eingeplant
Am Hub → Auslieferung geplant	announce	Paket wurde zur Zustellung eingeplant
Am Hub → Abholbereit	request_collection	Kunde hat die Abholung des Pakets aus dem Hub angefragt
Am Hub → Fehlgeschlagen	miss	Hub-Übergabe/Abholversuch fehlgeschlagen
Am Hub → Storniert	cancel	Zustellung des Pakets wurde storniert
Am Hub → Geliefert	force_delivery	Disponent/Admin hat das Paket manuell als zugestellt markiert (Force-Delivery)

Auslieferung geplant

scheduled_for_delivery

Ein Paket wurde zur Zustellung eingeplant.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Auslieferung geplant → In Auslieferung	pickup	Fahrer hat das Paket im Hub übernommen und startet die Zustelltour
Auslieferung geplant → Abholbereit	request_collection	Kunde hat Hub-Abholung statt Zustellung angefragt
Auslieferung geplant → Am Hub	tour_cancelled removed_from_tour	Zustelltour wurde abgebrochen oder Paket wurde aus der Tour entfernt (Paket bleibt im Hub)
Auslieferung geplant → Geliefert	tour_force_ended	Zustelltour wurde zwangsbeendet und Paket wurde als zugestellt markiert
Auslieferung geplant → Fehlgeschlagen	miss	Zustellversuch fehlgeschlagen (z. B. Fahrer konnte das Paket nicht übergeben)

In Auslieferung

out_for_delivery

Ein Paket wurde vom Fahrer übernommen und ist auf dem Weg zum Ziel.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
In Auslieferung → Geliefert	dropoff tour_force_ended	Fahrer hat das Paket am Ziel abgegeben (oder Tour wurde nach Abgabe zwangsbeendet)
In Auslieferung → Fehlgeschlagen	miss tour_cancelled	Zustellversuch fehlgeschlagen oder Tour wurde während der Zustellung abgebrochen

Geliefert

delivered

Ein Paket wurde am Zielort abgegeben/zugestellt.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Geliefert → Geliefert	tour_cancelled tour_force_ended	Tour wurde nach der Zustellung abgebrochen/zwangsbeendet (Paket bleibt zugestellt)

Abholbereit

ready_for_collection

Die Abholung eines Pakets aus einem Hub wurde vom Kunden angefragt.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Abholbereit → Abholbereit	removed_from_tour	Eine abholbezogene Tour-Zuweisung wurde entfernt (Paket bleibt zur Abholung bereit)
Abholbereit → Am Hub	relocate	Paket wurde in einen anderen Hub umgelagert
Abholbereit → Abgeholt	collect	Kunde hat das Paket im Hub abgeholt
Abholbereit → Storniert	cancel	Abholanfrage wurde storniert
Abholbereit → Fehlgeschlagen	miss	Abholversuch fehlgeschlagen (z. B. Paket konnte nicht übergeben werden)

Abgeholt

collected

Ein Paket wurde vom Kunden im Hub abgeholt.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Abgeholt → Fehlgeschlagen	miss	Nachträgliches Problem wurde gemeldet und die Abholung gilt als fehlgeschlagen (Sonderfall)

Beim Zoll

at_customs

Ein Paket wurde beim Zoll angemeldet und der Abfertigungsprozess hat begonnen. Die zollspezifischen Status findest du im Artikel „Statusmodell von Paketen im Zoll“.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Beim Zoll → Beim Zoll	relocate	Paket wurde umgelagert, während es im Zollprozess bleibt
Beim Zoll → Im Hub	customs_approved	Zollabfertigung wurde genehmigt (Paket wird zurück in den Hub freigegeben)
Beim Zoll → Fehlgeschlagen	miss	Zollabfertigung fehlgeschlagen oder Paket konnte nicht beim Zoll bearbeitet werden

Storniert

cancelled

Die Zustellung eines Pakets wurde storniert.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Storniert → Storniert	tour_cancelled tour_force_ended	Eine zugehörige Tour wurde nach der Stornierung abgebrochen/zwangsbeendet

Fehlgeschlagen

failed

Ein Paket konnte nicht abgeholt oder zugestellt werden.

Verfügbare Übergänge	Übergangsbezeichnung (API)	Auslöser
Fehlgeschlagen → Fehlgeschlagen	miss tour_cancelled tour_force_ended	Ein erneuter Versuch ist wieder fehlgeschlagen oder die zugehörige Tour wurde abgebrochen/zwangsbeendet, während das Paket bereits fehlgeschlagen war
Fehlgeschlagen → Storniert	cancel	Disponent/Admin hat das Paket nach dem Fehlschlag storniert
Fehlgeschlagen → Zugestellt	force_delivery	Disponent/Admin hat das Paket manuell als zugestellt markiert (Force-Delivery)
Fehlgeschlagen → Erstellt	recover	Disponent/Admin hat das Paket in den Initialstatus zurückgesetzt
Fehlgeschlagen → Im Hub	recover	Disponent/Admin hat das Paket in den Hub-Status zurückgesetzt