Order Status Handling
MERGEPORT
Last Update 1 个月前
To update an order, issue a PATCH to the order endpoint:
Change status (state)
Include state in the body.
Allowed states are always listed in possibleStateChanges of the order.
Example:
Rules
Only use states that appear in possibleStateChanges.
Some providers internally map states (e.g., pickedUp may appear as “in delivery” to the customer).
Change time (timeChange)
You may add timeChange together with a state if allowed.
Important
timeChange must be sent together with state.
Whether timeChange is allowed for a given state is indicated per entry in possibleStateChanges as timeChange: true|false.
timeChange value is an ISO-8601 timestamp (UTC).
Combined example
How to read possibleStateChanges
Platform-specific notes (status & time)
Lieferando (Just Eat Takeaway)
Time updates are supported, except when Scoober (JET’s courier fleet) is used. Consider the hybrid mode to enable restaurant-side time changes. The time sent is the final customer delivery time (not pickup). MERGEPORT
“Reject” is not supported in the current version (incoming orders must be processed; rejects are ignored). MERGEPORT
Pre-orders: With Scoober, pre-orders are dispatched shortly before the expected delivery time; with own delivery they’re dispatched immediately. MERGEPORT
Wolt
Time updates supported; recommended mainly on accept and preparing (avoid frequent changes). The time you send is the courier pickup time. Optionally, you can also send a final customer delivery time (requires a drivingTime in POS to compute pickup). MERGEPORT
Limit: Adjusted pickup time must not exceed +25 minutes from the initial estimated pickup time. MERGEPORT
Pre-orders: ETA cannot be updated during the schedule. MERGEPORT
Uber Eats
Time updates supported; recommended at accept and preparing. The time you send is the courier pickup time. Optionally, you can send the final customer delivery time (use POS drivingTime to derive pickup). MERGEPORT
Pre-orders: ETA cannot be updated during the schedule.