Courier Status Update

To receive courier-related updates while a location is using dispatch partners you need to listen to this webhook. It would be providing new information about the courier journey as soon as a change has been made to it :

  • deliveryTimeETA changes by greater than 60 seconds (UTC format)
  • Changes in courier name
  • The delivery partner has performed an action that resulted in the status change for the order
  • Coordinates where provided by Dispatch partner will be shared

The same status may received be multiple times. If there are relevant updates on the pickupTime, deliveryTime or coordinates, a new update will be triggered.

📘

Delivery Updates from Dispatch Partners

Note that this webhook is returning results only when there is a registered Dispatch partner that has integrated with our Dispatch API and is connected to the customer (restaurant, food business) account. It does not return results from channel partners that may also deliver the orders.

Definitions

ParameterMeaning
orderIdThe unique ID from Deliverect
channelOrderIdThe unique ID from the ordering channel
statusThe status from the list of value supported for updates.
deliveryTimeThe delivery time from the partner.
courierNameName of the courier delivery.
coordinatesThe coordinates object.

Available status for courier update

StatusDescriptionValue
In DeliveryThe Delivery partner has confirmed the job is assigned to a courier for the completion of the delivery80
Delivery CreatedIt would be set when Deliverect has assigned a dispatch partner to the delivery job81
En Route To PickupSpecific stage of the courier approaching the pickup location83
Arrived At PickupCourier has arrived at the pickup location85
En Route To DropoffSpecific stage of the courier approaching the drop off location87
Arrived At DropOffCourier has arrived at the drop off location89
DeliveredFinalized , order is fully handled and no further POS status updates are coming90
Delivery CanceledDispatch partner cancels the delivery115
{
    "orderId": "651142e93c54c5405****6a3",
    "channelOrderId": "TEST12341156",
    "status": 83,
    "courierName": "DRIVER NAME"
}

Response format

OK
Language