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 NameString ValueDimensionsDescription
SMALLsmall22 x 42 x 45 cmStandard delivery with a Courier on a bicycle or scooter.
LARGElarge30 x 124 x 80 cmDelivery which will require to be delivered via car
EXTRA LARGEextraLargeLarger than 30 x 124 x 80 cmFor large catering orders with many different trays to be delivered requiring a van
Transport Type NameString Value
BICYCLEbicycle
CARGOBIKEcargobike
MOTORBIKEmotorbike
MOTORBIKE XLmotorbikexl
CARcar
{
    "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"
}