Create, update, and cancel quick-commerce delivery orders
Create order
Raise a new delivery request for an order placed at a store/dark-store.
The eta_details object communicates pickup and delivery timing expectations for quick-commerce orders; all fields inside it are optional.
Create order › Responses
Order created
messageerrorsEdit / update order
Update order attributes, OTPs, pickup readiness, and returns after creation. Update overrides existing order parameters — awb_number is mandatory; all other fields are optional and only the fields present in the request are updated.
Important: If product_details is supplied, the complete product list must be sent — it replaces the existing list. When product composition changes, weight / product_value / total_amount must be updated accordingly.
Restriction: Once the shipment has been picked up by the rider and is out for delivery, edit order is no longer permitted (rejected with HTTP 400).
Field Update Eligibility Window
| Field(s) | Allowed Order Status |
|---|---|
eta_details, pickup_rack_details, is_ready_for_pickup | Pre-pickup only (New / Assigned) |
society_gate_entry, delivery_otp | New / Assigned / Out-for-delivery |
return_verification_otp | Return-in-progress (RTS / In-return-process) |
product_details | Pre-pickup only |
return_received_products | Only once, while return-in-progress |
Edit / update order › Request Body
awb_numberShadowfax-generated tracking number for the shipment
is_ready_for_pickupMarks the order ready for rider pickup at store. Allowed pre-pickup only
Bag/rack mapping for in-store staging; blocked once is_ready_for_pickup is true
event_typeEvent relay, e.g. society_gate_entry_passed
event_time_utcsourceRevised order attributes; eta_details only editable pre-pickup
Full replacement list of order line items. Allowed pre-pickup only
Line items confirmed received back at store/warehouse. Allowed only once, while return-in-progress
Edit / update order › Responses
Order updated
messagechild_mps_awbsCancel order
Cancel an order. Cancellation is permitted up to the point the rider enters the customer's delivery geofence (order status transitions to Arriving). Once the rider is inside the customer geofence, or the order has already been delivered, cancellation is rejected.
Cancel order › Request Body
request_idAWB number of the shipment to cancel
cancel_remarksFree-text reason for cancellation
Cancel order › Responses
Order cancelled
responseMsgresponseCode