Statusmodell von Touren

Dieser Artikel erklärt die verschiedenen Status, die eine Tour durchläuft. Wenn du noch nicht weißt, was eine Tour ist, lies bitte zuerst den Tours-Artikel.

Einführung

Jede Tour in MotionTools durchläuft verschiedene Status. Es ist wichtig, die Bedeutung jedes Status zu verstehen, da verfügbare Aktionen und Funktionen sowie die Sichtbarkeit direkt damit verbunden oder dadurch eingeschränkt sind.

Eine Tour muss nicht unbedingt alle verfügbaren Status durchlaufen. Einige Status können während der Übergänge übersprungen werden.

Wenn du eine Integration mit MotionTools entwickelst, beachte, dass sich die im Dashboard angezeigten Statusnamen leicht von den in der API verwendeten Namen unterscheiden können. Um Benachrichtigungen für jede Statusänderung zu erhalten, kannst du das entsprechende Webhook-Event abonnieren.

Status

Pausiert

to_be_dispatched

Der Status "Pausiert" bedeutet, dass eine Tour für Fahrer nicht sichtbar ist. Dieser Status ermöglicht es Admins und Organisationsmanagern, eine Tour für einen Fahrer vorzubereiten.

Wenn die Funktion "Manuelles Dispatching" aktiviert ist, ist "Pausiert" auch der Anfangsstatus aller Touren.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Pausiert → Geplant	schedule	Eine Tour wird freigegeben. Dies geschieht automatisch, wenn Manuelles Dispatching aktiviert ist
Pausiert → Auswählbar	ready_to_pick	Eine Tour ist bereit, von Fahrern ausgewählt zu werden
Pausiert → Storniert	cancel	Eine Tour wurde storniert

Geplant

scheduled

Der Status "Geplant" zeigt an, dass eine Tour für ein bestimmtes Datum und eine bestimmte Uhrzeit geplant wurde und von Fahrern akzeptiert werden kann.

Dies ist auch der Anfangsstatus aller Touren, wenn die Funktion "Manuelles Dispatching" für einen Service einer Tour deaktiviert ist. Beachte, dass neu erstellte Soforttouren direkt in den Status "Auswählbar" übergehen, während geplante Touren im Status "Geplant" bleiben.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Geplant → Pausiert	revoke	Eine Tour wurde zurück auf Pausiert gesetzt
Geplant → Akzeptiert	claim	Ein Fahrer hat eine Tour akzeptiert oder die Tour wurde zugewiesen
Geplant → Auswählbar	ready_to_pick	Keine Fahrer haben die Tour bis zum festgelegten Zeitpunkt akzeptiert und die Auswählbar-Funktion ist aktiviert
Geplant → Storniert	cancelled	Eine Tour wurde storniert

Akzeptiert

claimed

Der Status "Akzeptiert" zeigt an, dass ein Fahrer eine für die Zukunft geplante Tour akzeptiert hat. Der Fahrer ist nun dafür verantwortlich, die Tour pünktlich zu starten.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Akzeptiert → Auf dem Weg	start	Ein Fahrer hat eine akzeptierte Tour gestartet
Akzeptiert → Geplant	unclaim	Ein Fahrer hat die zuvor akzeptierte Tour abgelehnt
Akzeptiert → Geplant	release	Eine Tour wurde im Namen des Fahrers abgelehnt, weil sie nicht pünktlich gestartet wurde
Akzeptiert → Pausiert	revoke	Eine Tour wurde zurück auf Pausiert gesetzt
Akzeptiert → Storniert	cancel	Eine Tour wurde storniert

Auswählbar

pickable

Der Status "Auswählbar" zeigt an, dass eine Tour für alle berechtigten Fahrer im Servicegebiet der Tour sichtbar ist. Jeder berechtigte Fahrer kann die Tour nun auswählen und starten. Dabei ist zu bedenken, dass die tatsächliche Sichtbarkeit bzw. Berechtigung durch weitere Dispositionsfunktionen und Regeln wie dem schrittweisen Ausrollen und den verwaltenden Organisationen beeinflusst wird.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Auswählbar → Auf dem Weg	pick	Ein Fahrer hat eine Tour gestartet oder die Tour wurde zugewiesen
Auswählbar → Pausiert	revoke	Eine Tour wurde zurück auf Pausiert gesetzt
Auswählbar → Storniert	cancel	Eine Tour wurde storniert

Auf dem Weg

en_route

Der Status "Auf dem Weg" zeigt an, dass ein Fahrer gerade eine Tour durchführt. Eine Tour in diesem Status kann auch als aktive Tour bezeichnet werden.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Auf dem Weg → Fertig	complete_stops	Eine Tour wurde ohne fehlgeschlagene Stopps abgeschlossen
Auf dem Weg → Pausiert	complete_stops	Eine Tour wurde abgeschlossen, aber alle Stopps sind fehlgeschlagen
Auf dem Weg → Geplant	ditch	Eine Tour wurde von einem Fahrer abgelehnt
Auf dem Weg → Bezahlt	force_end	Eine Tour wurde zwangsbeendet
Auf dem Weg → Storniert	cancel	Eine Tour wurde storniert

Fertig

done

Der Status "Fertig" zeigt an, dass eine Tour operativ abgeschlossen wurde, d.h. alle Stopps der Tour wurden von einem Fahrer abgeschlossen.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Fertig → Bezahlt	paid	Eine Tour wechselt zu Bezahlt, nachdem sie operativ abgeschlossen wurde

Bezahlt

paid

Dies ist der finale Status einer Tour. Beachte, dass eine Tour auch dann in diesen Status übergeht, wenn Zahlungen für einen Mandanten deaktiviert sind.

Storniert

cancelled

Dies ist ebenfalls ein finaler Status einer Tour, wenn sie von einem Admin oder Organisationsmanager storniert wurde. Die zugehörigen Buchungen der Tour werden nicht storniert, sondern sind nicht mehr zugewiesen und wechseln in den Status "Pausiert".