Create / Cancel Order

Purpose

A channel integration can use this endpoint to place a new order or process a cancellation of an existing order.

Path Parameters

ParameterDescription
channelNameThis is provided as a 'Scope' to grants permission to create orders within linked accounts only. This value must be provided in lowercase.
channelLinkIdThe unique identifier for the channel configured on a restaurant location. This value is provided in the Register Channel request.

Order Types

Depending on the format of the order created, the relevant orderType should be sent;

TypeInteger Value
pick up1
delivery2
Eat-in3
Curbside4
Drive Thru5

Order Response
All orders sent in a valid format with the correct scope applied will receive a 201. This does not indicate that the POS has successfully processed the order. You should reference the events sent to your Order Status Update webhook to confirm whether the order was successfully processed.

Request Parameters

See full list of order attributes;

Payments

Details on processing discounts, payments, taxes or other charges in the guide below;

Create Orders for Dispatch / Last Mile Fulfillment

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.

Standalone Dispatch Integration

Our Dispatch functionality can also be integrated as a “Standalone” solution, enabling full courier assignment and delivery, whilst bypassing requirements for POS order injection i.e. product validation. This format supports several use cases such as;

  • First-party ordering platforms which already integrates to a customer POS via an existing direct integration
  • Phone orders entered directly into a POS requiring delivery

For details on handling dispatch orders, see guide below;

Channel Cancelations

Your channel integration can process a cancellation using the same endpoint used create a new order

Sending a secondary order with the same channelOrderId and "status": 100 (Cancel) will initiate a POS cancellation request which typically involves 'voiding' the order.

Once the cancellation is processed by the POS, a status CANCELED (110) will be returned to confirm this has been handled. See Update Order Status Webhook on how to receive this, and other statuses from the POS.

Cancelling Already Accepted Orders
NB: There is no validation in Deliverect to prevent cancellation requests based on the current order status.


Path Params
string
required
Defaults to {channelName}

A unique scope provided to channel integrators to create orders in authorised locations

string
required
Defaults to {channelLinkId}

The unique identifier of the channel in a specific location.

Body Params
string
required

The full unique ID from the ordering channel.

string
required

A humanly-readable order reference.

string

Validation ID returned from dispatch validation when used.

integer
required

Order type. Use 1 for pickup, 2 for delivery, 3 for eat-in, and 4 for curbside.

boolean
string
string
string
string
required

Who delivers the order.

boolean
deliveryAddress
object
deliveryInfo
object
integer
payment
object
required
taxes
array of objects
taxes
integer
items
array of objects
items
boolean
string
boolean
string
integer
customer
object
integer
integer
integer
integer
integer
integer
integer
integer
discounts
array of objects
discounts
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json