Überblick

Einleitung
Status-Übersicht
Status im Detail

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

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