Create Order (Legacy)

post

https://sandbox.api.deliverysolutions.co/api/v2/order/placeorder

Use this API to place an order from the selected pickup location to the delivery address.

Body Params

type

string

enum

Order Type. If not specified, orchestration preference of Providers and services will be based on orchestration.

Allowed:

storeExternalId

string

required

Unique Id of the pickup location for which the order is being placed, see Create Location.

orderExternalId

string

required

Unique Id of the order generated in your system and configured in our system. Can be configured to be non-unique.

groupId

string

Group ID allows you to group a number of orders together. It further helps in providing a combined post-purchase experience for these orders.

orderValue

double

required

The value of the order in major units as decimals. E.g; 10.00. In USD this will be $10.00

tips

double

Driver tip amount in major units as decimals. E.g; 9.00. In USD this will be $9.00

pickupTime

object

Time Window in which the package will be ready to be picked up.

dropoffTime

object

Time Window in which the package must be delivered by. Not needed for pickup order.

deliveryContact

object

required

Customer information to obtain an estimate

deliveryAddress

object

required

Address to deliver the package to. Not needed for order type: in-store-pickup and curbside.

packages

array of objects

Package details. Package dimension and weight details help in surfacing accurate estimates and winning Providers. For shipping type orders, packages are converted to shipments with applicable Providers.

packages

isSpirit

boolean

Delivery contains spirits

isBeerOrWine

boolean

Delivery contains beer or wine

isTobacco

boolean

Delivery contains tobacco

isFragile

boolean

Delivery has fragile items

isRx

boolean

Delivery has Rx items.

hasRefrigeratedItems

boolean

Delivery has refrigerated items

hasPerishableItems

boolean

Delivery has perishable items

notification

object

Status update notification recipients.

signature

string

enum

Signature requirement. If available, defaults to Provider-level configuration. Defaults to not_required if Provider-level configuration is not available.

Allowed:

pickupInstructions

string

Pickup instruction for the location. This will override the instructions configured with the pickup location.

deliveryInstructions

string

Delivery instructions for drop-off.

orderAttributes

json

Configurable key-value pairs of custom order attributes. See Attributes.

itemList

array of objects

Array of items in the order. Details offer improved post-purchase experiences. In the absence of packages, cubic dimensions and weight will be derived from this list.

itemList

alternateLocation

object

Alternate location details in case order is to be delivered to alternate location.

proposedProviders

array of objects

Override orchestration and place order with the specified Provider and Service.

proposedProviders

dispatch

object

Order dispatch settings. e.g., dispatch order 10 mins before pickup time. In case of null, settings will be inherited.

temperatureControl

string

enum

Temperature information of the package.

Allowed:

locale

string

Preferred locale by the customer for an order. Value to be sent in the format of language code(ISO-639-1)-country code(ISO-3166-1-alpha-2). E.g fr-CA, en-US. Here, fr, en are language codes & CA, US are country codes.

createdDate

int32

Date at which the order was originally created in Unix time in milliseconds. e.g., 1500616800000

Responses

201201

202202

400400