Edit Order

post

https://sandbox.api.deliverysolutions.co/api/v2/order/edit/orderExternalId/{orderExternalId}

Use this API to modify the details of the order after it has been placed in our system.

Path Params

orderExternalId

string

required

The external Id passed in Create Order call as orderExternalId

Query Params

forceUpdate

boolean

To forcefully perform an order edit operation this field should be assigned true.

Body Params

orderExternalId

string

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

orderValue

double

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.

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

Customer information to obtain an estimate

deliveryAddress

object

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

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.

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

dispatch

object

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

release

object

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

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.

temperatureControl

string

enum

Defaults to none

Temperature information of the package.

Allowed:

type

string

enum

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

Allowed:

orderAttributes

json

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

createdDate

int32

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

Responses

200200

400400

404404