Statusmodell von Buchungen

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

Einführung

Jede Buchung bei 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 Buchung muss nicht zwangsläufig alle verfügbaren Status durchlaufen. Manche Status können während der Übergänge übersprungen werden. Wenn zum Beispiel ein Betreiber keine Zahlungen aktiviert hat, wird eine Buchung nie in den Status "Zahlung wird bearbeitet" übergehen.

Wenn du eine Integration mit MotionTools entwickelst, beachte bitte, 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 Buchung erstellt wurde, aber noch nicht in eine Tour eingeplant wurde.

Dies ist auch der Anfangsstatus aller Buchungen, wenn die manuelle Disposition für einen Service einer Buchung aktiviert ist.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Pausiert → Disponiert	dispatch	Alle Stopps einer Buchung wurden in Touren eingeplant. Dies geschieht automatisch, wenn die manuelle Disposition deaktiviert ist.
Pausiert → Teilweise disponiert	partially_dispatch	Einige Stopps einer Buchung wurden in Touren eingeplant
Pausiert → Storniert	cancel	Eine Buchung wurde storniert

Disponiert

dispatched

Der Status "Disponiert" zeigt an, dass alle Stopps einer Buchung zwischen einer oder mehreren Touren verteilt wurden. Die Buchung geht direkt in den Status "Fertig" über, sobald alle Stopps abgeschlossen sind, es sei denn, einige Stopps schlagen fehl.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Disponiert → Fertig	complete_stops	Alle Stopps einer Buchung wurden über die entsprechenden Touren abgeschlossen
Disponiert → Pausiert	undispatch_stops	Alle Stopps einer Buchung wurden aus den Touren entfernt und die manuelle Disposition ist für den Service einer Buchung aktiviert
Disponiert → Pausiert	complete_stops	Eine Buchung wurde operativ abgeschlossen, aber alle Stopps sind fehlgeschlagen
Disponiert → Teilweise disponiert	undispatch_stops	Nur einige Stopps einer Buchung wurden aus den Touren entfernt
Disponiert → Teilweise disponiert	complete_stops	Eine Buchung wurde operativ abgeschlossen, aber einige Stopps sind fehlgeschlagen
Disponiert → Zahlung wird bearbeitet	process_payment	Nur wenn die Zahlungsfunktion aktiviert ist
Disponiert → Storniert	cancel	Eine Buchung wurde storniert

Teilweise disponiert

partially_dispatched

Der Status "Teilweise disponiert" zeigt an, dass nur einige Stopps zwischen Touren verteilt wurden oder dass eine Buchung fehlgeschlagene Stopps hat.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Teilweise disponiert → Disponiert	dispatch	Die verbleibenden Stopps wurden zwischen Touren verteilt
Teilweise disponiert → Pausiert	undispatch_stops	Alle Stopps einer Buchung wurden aus den Touren entfernt und die manuelle Disposition ist für den Service einer Buchung aktiviert
Teilweise disponiert → Storniert	cancel	Eine Buchung wurde storniert

Fertig

done

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

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Fertig → Zahlung wird bearbeitet	process_payment	Die Plattform hat mit der Zahlungsabwicklung begonnen, nachdem eine Buchung operativ abgeschlossen wurde
Fertig → Bezahlt	paid	Wenn ein Betreiber keine Zahlungen aktiviert hat, geht eine Buchung nach operativem Abschluss in den Status "Bezahlt" über

Zahlung wird bearbeitet

processing_payment

Der Status "Zahlung wird bearbeitet" zeigt an, dass die Zahlung noch nicht eingegangen ist. Je nach gewählter Zahlungsmethode für die Buchung kann dieser Prozess automatisch abgeschlossen werden oder erfordert eine manuelle Bestätigung durch einen Admin. Zum Beispiel erfordern Rechnungszahlungen immer eine manuelle Bestätigung, während Kreditkartenzahlungen automatisch abgewickelt werden, es sei denn, die Kartenbelastung schlägt fehl.

Verfügbarer Übergang	Übergangsname in der API	Auslöser
Zahlung wird bearbeitet → Bezahlt	paid	Eine Zahlung wurde automatisch bestätigt oder ein Admin hat eine Buchung manuell als bezahlt markiert
Zahlung wird bearbeitet → Storniert	cancel	Eine Buchung wurde storniert

Bezahlt

paid

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

Storniert

cancelled

Dies ist der finale Status einer Buchung, wenn sie von einem Admin, Organisationsmanager oder Kunden storniert wurde.