Zippd API V1Orders

Cancel an Order

View as Markdown
This endpoint can be used to cancel any type of order

Authentication

AuthorizationBearer

Path parameters

orderIdstringRequired

Request

This endpoint expects an object.
statusenumRequired
The new status for the order.
Allowed values:
descriptionstringRequired
A reason for the change of status.

Response

OK
idstringformat: "uuid"
The ID of the order.
codestring
Zippd's short ID code for the order. Unique and always starts with "DA".
typeenum
The order type.
Allowed values:
order_datedate
Date on which the order was placed.
fulfilment_datedate
The date on which the order will be fulfilled by the driver.
internal_refstring or null
An order reference provided by your systems.
statusenum
The current status of the order.
total_itemsinteger

The total number of items (or parcels) attributed to this order.

is_urgentboolean
Whether or not the order has been flagged as urgent.
started_atdatetime or null

Date/time when the delivery driver began fulfilling the order.

completed_atdatetime or null

Date/time when the delivery driver completed fulfilling the order.

canceled_atdatetime or null

Date/time when the order was cancelled.

time_change_requestsinteger
Number of time change this order has received from drivers.
vehicleobject
The details of a vehicle type.
payment_cardobject
The details of a payment card used to place orders.
additional_notesstring
Additional information that will be seen by the delivery driver before and during order fulfilment.
co_loadingboolean

Whether or not co-loading is allowed for this delivery.

two_man_deliveryboolean

Whether or not two-person delivery is required for this delivery.

has_handballingboolean

Whether or not the delivery requires the driver to assist with loading/unloading items. This is only appropriate for delivery order types. Other order types will always be false.

cost_of_goodsinteger
The total cost of goods being delivered. Must be in lowest unit of currency, e.g. in pence for GBP.
cost_of_goods_formattedstring

The total cost of goods being delivered in a human-readable format.

driverobject
Details about the driver who will be fulfilling the order.
time_zonestring
The ID of the time zone in which the delivery job will take place.
locationslist of objects
All locations relating to this order's deliveries. The first item is always the location where the driver will pickup the parcels to be delivered.
pricesobject
A breakdown of the costs involved with this delivery order.
allowed_distanceobject
An object representing a maximum allowed distance from a set point.
barcodeslist of objects

A list of barcodes (parcels) that are to be delivered on with this order.

printable_label_urlstring or null
An absolute URL to a PDF with all package labels for this order.
durationenum or null

The duration within which the order is expected to be fulfilled. This will always be null for delivery type orders.

Allowed values:
total_timeobject or null
The total time it took for the delivery driver to fulfil the order.
additional_timeobject or null

If fulfilling the order took more time than set in duration, the additional time will be outlined here.

mileageobject
Information about the distance travelled by the delivery driver.

Errors

404
Not Found Error