Creating orders for Dispatch / Last Mile Delivery

Overview

For platforms who don't directly handle delivery or aren't currently offering this order type, Deliverect allows for an order to be routed to an integrated 'Dispatch' service.

Formats

There are three ordering formats where dispatch services can be integrated;

Format	Description
Commerce	Deliverect's Commerce Suite orchestrates all aspects of the digital ordering flow, delivery jobs can be assigned to any fulfillment type '`delivery`' and where `"courier": "restaurant"` is specified in Checkout
Channel	This consists of an order creation endpoint where `"courier": "restaurant"` is specified
Standalone Dispatch	This utilizes the same endpoint as above, but for a format where POS order injection isn't a requirement and validation on product PLUs is relaxed

Dispatch Flow

See a complete flow diagram of the dispatch process via the link below;

▶ Dispatch Flow

Pre-requisites

A pre-requisite for delivery orders to be routed to one of our dispatch partners, a customer needs to select one or more services to connect with. See our full list of Dispatch partners here

Create Order for Dispatch

{
  "basket": {
    "id": "62********************3x"
  },
  "order": {
    "channelOrderId": "TEST****629",
    "channelOrderDisplayId": "T**629",
    "validationId": null,
    "courier": "restaurant",
    "by": "Mobile App"
  },
  "note": "ORDER LEVEL NOTE",
  "payments": [
    {
      "type": "dpay",
      "externalId": "68****************44",
      "isPrepaid": true,
      "amount": 900
    }
  ]
}

{
    "items": [
        {
            "plu": "BRG-0398",
            "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",
    "tip": 0,
    "channelOrderId": "501-bffe-f0e97",
    "channelOrderDisplayId": "f0e97"
}

{
    "items": [
        {
            "plu": "1234",
            "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",
    "tip": 0,
    "channelOrderId": "501-bffe-f0e97",
    "channelOrderDisplayId": "f0e97"
}

Pre-validating Dispatch Availability

To enhance the ordering flow and customer experience it is possible to check that an integrated Dispatch service is available before processing an order. The endpoint below can be used to validate Dispatch availability before submitting your order.

▶ Dispatch Availability

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

See more about receiving courier updates below;

▶ Courier Update Webhook

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