Zum Hauptinhalt springen

Statusmodell von Touren

Support avatar
Verfasst von Support
Diese Woche aktualisiert

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.

Überblick


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.

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".

Hat dies deine Frage beantwortet?