Channel Order Model
Please note that all the fields marked with * are required.
Parameters | Meaning | Type |
---|---|---|
channelOrderId * | The full unique ID from the ordering channel, cannot be reused within 48hr after pickup (across all accounts) | string |
channelOrderDisplayId * | A more human‑readable order reference to provide | string |
validationId | Returned from the dispatch availability endpoint, cannot be reused and is valid for 10 minutes from generation. If expired | string |
orderType * | Order Types are described here. | integer |
deliveryIsAsap * | Boolean indicating whether delivery is ASAP | boolean |
pickupTime | Timestamp is in UTC | string |
deliveryTime | Timestamp is in UTC | string |
placedTime | Time when the order was placed | string |
estimatedPickupTime | Timestamp is in UTC yyyy-MM-ddTHH:mm:ssZ all time values in our API are in UTC time as per ISO8601 | string |
courier | This specifies who is delivering an order. There are only two possible variations | string |
ageCheck | Boolean indicating whether the driver should verify customer's age. | boolean |
deliveryAddress | object | |
deliveryAddress. | The full street address in a single-line string | string |
deliveryAddress. | numerical addresses assigned to homes, businesses, and other properties | string |
deliveryAddress. | The postal or zip code | string |
deliveryAddress. | The name of a geographic area or locality that groups a number of addressable objects for addressing purposes, without being an administrative unit | string |
deliveryAddress. | City | string |
deliveryAddress. | Country | string |
deliveryAddress. | Additional instructions for locating the customer's location | string |
deliveryAddress. |
| array |
deliveryAddress.verification. |
| object |
deliveryInfo | Delivery information | object |
deliveryInfo. | size of the package | string |
deliveryInfo. | e.g. Bicycle, Car, Motorbike etc | string |
payment* | object | |
payment. | The total amount paid should be sent as an integer with 2 decimal digits, for example, 1 euro would be sent as 100. | integer |
payment. | Type of payment(cash,card) | integer |
payment. | Outstanding amount due | integer |
taxes | A consumption tax imposed by the government on the sale of goods and services. | array (object) |
taxes. | An Id corresponding to this tax class as (not currently needed) | integer |
taxes. | The display name for this category of taxes, which is how it should be printed on a receipt (not currently needed) | string |
taxes. | For Tax Exclusive Locations. See section here for more details. It should be sent as an integer with 2 decimal digits e.g. 1 dollar would be sent as 100 | integer |
taxRemitted | In regions where the channel has responsibility for charging tax e.g. where they are 'Marketplace Facilitator' this is the total tax remitted. This value should be sent outside the taxes array. | integer |
items* | array (object) | |
items. | Stands for Price Look Up. The unique code of a product. | string |
items. | name of the product or modifier | string |
items. | Price for each of the items. It should be sent as an integer with 2 decimal digits e.g. 1 dollar would be sent as | integer |
items. | number of items | integer |
items. | item level notes | string |
items. | For ordering platforms in the retail space, if items are not available customer's can specify a preference for actions to take detailed in the guide here | array (strings) |
items. | (where applicable) | array |
items. | array referencing the discount to be applied to that specific item. The discount must be referenced on the "discounts" array. See guide here. | array |
includeCutlery | The boolean indicates whether the cutlery/utensils have been requested or not. | boolean |
table | For 'Eat-in' orders, a table number can be provided | string |
orderIsAlreadyPaid * | Has the order already been paid? | boolean |
note | Order-level note | string |
numberOfCustomer | Number of customers for the order | integer |
customer | object | |
customer. | The name of the customer | string |
customer. | A company name where the order is placed from | string |
customer. | Contact phone number | string |
customer. | Where a contact centre is used to route calls using a unique code | string |
customer. | Contact email of the customer | string |
customer. | Tax Identification Number | string |
customer. | Additional note on the customer | string |
decimalDigits * | Number of decimal digits (typically 2) | integer |
deliveryCost | Cost of delivery applied. It should be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100. | integer |
deliveryCostTax | Cost of delivery tax. It should be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100. | integer |
serviceCharge | Cost of any service charges. It should be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100. | integer |
serviceChargeTax | Tax on service charge | integer |
tip | Tip intended for the restaurant | integer |
driverTip | Tip intended for the courier | integer |
bagFee | Bag fee applied | integer |
discountTotal | Total discount as a negative value | integer (negative) |
discounts | When generating a discount, sending the above field "discountTotal" is required. | array of objects |
discounts. | Mapped channel discount type from the list of Discount Types in Deliverect | string |
discounts. | The issuer of the discount i.e. the one who bears the discounted amount. | string |
discounts. | Actual discounted amount | integer |
discounts. | The name that was given to the discount. | string |
discounts. | The unique discount code used by the channel. | string |