Statusverarbeitung & Lieferzeit-Anpassungen
Wie Bestellstatus und Lieferzeiten plattformübergreifend korrekt verarbeitet werden
MERGEPORT
Letztes Update: vor 2 Monaten
Die Verarbeitung von Bestellstatus und Lieferzeit-Anpassungen ist ein zentraler Bestandteil jeder MERGEPORT-Integration.
Dieser Artikel erklärt:
- Wie Status korrekt gesetzt werden
- Wie Lieferzeit-Anpassungen funktionieren
- Wie possibleStateChanges zu interpretieren ist
- Plattform-spezifische Besonderheiten
Um eine Bestellung zu aktualisieren, wird ein PATCH auf den Order-Endpunkt ausgeführt:
Bestellstatus aktualisieren
Um eine Bestellung zu aktualisieren, wird ein PATCH-Request gesendet und im Body wird der neue Status gesetzt.
Regeln
Wir empfehlen, Lieferzeit-Anpassungen hauptsächlich bei folgenden Statusänderungen zu senden:
Häufige oder wiederholte Änderungen sollten vermieden werden.
- Es dürfen nur Status verwendet werden, die im Feld possibleStateChanges enthalten sind.
- possibleStateChanges wird bei jeder Bestellung mitgeliefert.
- Plattformen können Status intern anders darstellen.
- Der einzige verpflichtende Status ist acceptedByPos.
Wir empfehlen, Lieferzeit-Anpassungen hauptsächlich bei folgenden Statusänderungen zu senden:
- acceptedByPos
- preparing
Häufige oder wiederholte Änderungen sollten vermieden werden.
possibleStateChanges verstehen
Jede Bestellung enthält z. B.:
Das bedeutet:
Wenn timeChange auf false steht, darf keine Zeitänderung gesendet werden.
- Welche Status erlaubt sind
- Ob eine Lieferzeit-Anpassung (timeChange) für diesen Status zulässig ist
Wenn timeChange auf false steht, darf keine Zeitänderung gesendet werden.
Lieferzeit-Anpassungen
Lieferzeiten werden über denselben PATCH-Call mit dem Feld timeChange aktualisiert.
Wichtige Regeln:
- timeChange muss immer gemeinsam mit state gesendet werden.
- timeChange muss im ISO-8601-Format (UTC) übermittelt werden.
- In den meisten Fällen wird timeChange als Differenz zur ursprünglich berechneten Zeit übermittelt (z. B. +15, +30 Minuten).
- Wenn die Bestellung als „ASAP“ angelegt wurde und keine Referenzzeit existiert, muss ein absoluter Zeitstempel gesendet werden.
Beispiel (kombiniert):
Plattform-Besonderheiten (Status & Zeit)
Lieferando (Just Eat Takeaway)
- Lieferzeit-Anpassungen werden grundsätzlich unterstützt.
- Bei Nutzung von Scoober (Lieferando-Fahrerflotte) sind Lieferzeit-Anpassungen nicht möglich.
- In diesem Fall kann der Hybridmodus sinnvoll sein, um die Zeit vor Weiterleitung anzupassen.
- Die gesendete Zeit entspricht der finalen Lieferzeit für den Endkunden.
- Der Fahrer muss die Bestellung entsprechend früher abholen.
- „Reject“ wird aktuell nicht unterstützt. Bestellungen müssen verarbeitet werden.
Wolt
- Lieferzeit-Anpassungen werden unterstützt.
- Empfehlung: Anpassung hauptsächlich bei Annahme oder im preparing-Status.
- Die gesendete Zeit entspricht der Abholzeit für den Kurier.
Alternativ kann auch die finale Lieferzeit für den Endkunden gesendet werden.
In diesem Fall muss im POS eine drivingTime konfiguriert werden, damit MERGEPORT die Abholzeit berechnen kann.
Konfiguration erfolgt über:
https://ordering.mergeport.com/v4/documentation#operation/SetSiteSpecs
Begrenzung:
Die angepasste Abholzeit darf maximal 25 Minuten über der ursprünglich berechneten Abholzeit liegen.
Uber Eats
- Lieferzeit-Anpassungen werden unterstützt.
- Empfehlung: Anpassung bei Annahme oder preparing.
- Die gesendete Zeit entspricht der Abholzeit des Kuriers.
Alternativ kann die finale Lieferzeit für den Endkunden gesendet werden.
Dafür muss ebenfalls eine drivingTime im DefaultPreparationTime konfiguriert werden.