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 |
| Eine Tour wird freigegeben. Dies geschieht automatisch, wenn Manuelles Dispatching aktiviert ist |
Pausiert → Auswählbar |
| Eine Tour ist bereit, von Fahrern ausgewählt zu werden |
Pausiert → Storniert |
| 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 |
| Eine Tour wurde zurück auf Pausiert gesetzt |
Geplant → Akzeptiert |
| Ein Fahrer hat eine Tour akzeptiert oder die Tour wurde zugewiesen |
Geplant → Auswählbar |
| Keine Fahrer haben die Tour bis zum festgelegten Zeitpunkt akzeptiert und die Auswählbar-Funktion ist aktiviert |
Geplant → Storniert |
| 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 |
| Ein Fahrer hat eine akzeptierte Tour gestartet |
Akzeptiert → Geplant |
| Ein Fahrer hat die zuvor akzeptierte Tour abgelehnt |
Akzeptiert → Geplant |
| Eine Tour wurde im Namen des Fahrers abgelehnt, weil sie nicht pünktlich gestartet wurde |
Akzeptiert → Pausiert |
| Eine Tour wurde zurück auf Pausiert gesetzt |
Akzeptiert → Storniert |
| 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 |
| Ein Fahrer hat eine Tour gestartet oder die Tour wurde zugewiesen |
Auswählbar → Pausiert |
| Eine Tour wurde zurück auf Pausiert gesetzt |
Auswählbar → Storniert |
| 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 |
| Eine Tour wurde ohne fehlgeschlagene Stopps abgeschlossen |
Auf dem Weg → Pausiert |
| Eine Tour wurde abgeschlossen, aber alle Stopps sind fehlgeschlagen |
Auf dem Weg → Geplant |
| Eine Tour wurde von einem Fahrer abgelehnt |
Auf dem Weg → Bezahlt |
| Eine Tour wurde zwangsbeendet |
Auf dem Weg → Storniert |
| 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 |
| 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".