Creating orders for Dispatch / Last Mile Delivery
Overview
When processing a delivery order, if the delivery job isn't being directly handled by the ordering platform, Deliverect allows an integrated 'Dispatch' service to be assigned.
Specifying the Courier
To have an order for Delivery handled by one of our dispatch partners, an order should include"courier": "restaurant,
This signifies the restaurant have arranged for self-delivery via connecting with one of our Dispatch partners (see our list of partners here) or that they will be using their own resources for delivery.
"courier": "restaurant"
Specifying any other string than
"restaurant"
will signal that your channel will be fully handling delivery
Validating Dispatch Availability
To enhance the ordering flow and customer experience it is possible to check that an integrated Dispatch service is available before completing an order. The endpoint below can be used to validate Dispatch availability before submitting your order.
https://developers.deliverect.com/reference/validate-delivery
Receiving Courier Updates
Once an order is submitted, a webhook can be delivered when various courier-related events occur. These cover the following scenarios;
- The status change for the order
- Co-ordinates updated
- The
deliveryTimeETA
changes by greater than 60 seconds - Courier name changes
https://developers.deliverect.com/reference/post-courier-update
Package sizes & Transport types
It is optional to also specify the package sizes and transport types which will be sent using the format below.
"deliveryInfo": {
"packageSize": "large",
"transportType": "car"
}
Package Size Name | String Value | Dimensions | Description |
---|---|---|---|
SMALL | small | 22 x 42 x 45 cm | Standard delivery with a Courier on a bicycle or scooter. |
LARGE | large | 30 x 124 x 80 cm | Delivery which will require to be delivered via car |
EXTRA LARGE | extraLarge | Larger than 30 x 124 x 80 cm | For large catering orders with many different trays to be delivered requiring a van |
Transport Type Name | String Value |
---|---|
BICYCLE | bicycle |
CARGOBIKE | cargobike |
MOTORBIKE | motorbike |
MOTORBIKE XL | motorbikexl |
CAR | car |
{
"items": [
{
"plu": "123",
"name": "Burger",
"price": 1500,
"quantity": 1,
"subItems": [],
"productType": 1
}
],
...
"courier": "restaurant",
...
"orderType": 2,
"deliveryAddress": {
"street": "Brown Street",
"streetNumber": "900",
"postalCode": "1120",
"city": "New York",
"extraAddressInfo": "Use Buzzer"
},
"deliveryCost": 0,
...
"deliveryIsAsap": true,
"deliveryTime": "yyyy-MM-ddTHH:mm:ssZ",
"pickupTime": "yyyy-MM-ddTHH:mm:ssZ",
...
"tip": 0,
"channelOrderId": "501-bffe-f0e97",
"channelOrderDisplayId": "f0e97"
}