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.
Übersicht
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 |
| Alle Stopps einer Buchung wurden in Touren eingeplant. Dies geschieht automatisch, wenn die manuelle Disposition deaktiviert ist. |
Pausiert → Teilweise disponiert |
| Einige Stopps einer Buchung wurden in Touren eingeplant |
Pausiert → Storniert |
| 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 |
| Alle Stopps einer Buchung wurden über die entsprechenden Touren abgeschlossen |
Disponiert → Pausiert |
| Alle Stopps einer Buchung wurden aus den Touren entfernt und die manuelle Disposition ist für den Service einer Buchung aktiviert |
Disponiert → Pausiert |
| Eine Buchung wurde operativ abgeschlossen, aber alle Stopps sind fehlgeschlagen |
Disponiert → Teilweise disponiert |
| Nur einige Stopps einer Buchung wurden aus den Touren entfernt |
Disponiert → Teilweise disponiert |
| Eine Buchung wurde operativ abgeschlossen, aber einige Stopps sind fehlgeschlagen |
Disponiert → Zahlung wird bearbeitet |
| Nur wenn die Zahlungsfunktion aktiviert ist |
Disponiert → Storniert |
| 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 |
| Die verbleibenden Stopps wurden zwischen Touren verteilt |
Teilweise disponiert → Pausiert |
| Alle Stopps einer Buchung wurden aus den Touren entfernt und die manuelle Disposition ist für den Service einer Buchung aktiviert |
Teilweise disponiert → Storniert |
| 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 |
| Die Plattform hat mit der Zahlungsabwicklung begonnen, nachdem eine Buchung operativ abgeschlossen wurde |
Fertig → Bezahlt |
| 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 |
| Eine Zahlung wurde automatisch bestätigt oder ein Admin hat eine Buchung manuell als bezahlt markiert |
Zahlung wird bearbeitet → Storniert |
| 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.