Order a Non-Dedicated Delivery

View as Markdown
If you’re unsure which type of delivery you need, have a read of our article on the different order types.

Placing an order for a non-dedicated delivery with Zippd requires all delivery data upfront. This will include things like:

  • Pick-up and drop-off addresses
  • Details about the goods
  • Additional data that can be referenced later for your team’s benefit
Only accounts that have set up credit agreements with us will be able to place orders using our API.

Placing an order is as simple as sending a POST request to our API. Take a look at the endpoint reference for specifics on the data required.

Pricing

It is not possible to receive pricing estimates for this type of order. Currently, pricing for non-dedicated deliveries is agreed during account set-up and configured on the account level.

Location Addresses

You can provide either a pick-up address only, a drop-off address only, or both addresses. Anything else will result in a 422 failure response.

Examples

Send only the drop-off address:

1{
2 // Other data
3 "order_locations": [
4 {
5 "is_collection": false,
6 "address": {
7 // Address data
8 }
9 }
10 ]
11 // Other data
12}

When both locations are provided, the address data in each object will be treated separately. This means you can pull a previously used address for one location and add a new address for the other:

1{
2 // Other data
3 "order_locations": [
4 {
5 "is_collection": true,
6 "address": {
7 "id": 57358
8 }
9 },
10 {
11 "is_collection": false,
12 "address": {
13 "address_line_1": "123 Grovesby Road",
14 "city": "Manchester",
15 "postcode": "M1 2AB"
16 }
17 }
18 ]
19 // Other data
20}
When using the id field for an address object, the API will return with an error response if any of the following fields are also in the object: address_line_1, city, postcode, contact_name

Our system makes use of latitude/longitude coordinates for geographical processes such as calculating distances and displaying points on maps. If you have the coordinates for your addresses, you can provide them with the latitude and longitude items in the address object:

1{
2 // Other data
3 "order_locations": [
4 {
5 "is_collection": true,
6 "address": {
7 "address_line_1": "123 Grovesby Road",
8 "city": "Manchester",
9 "postcode": "M1 2AB",
10 "latitude": 51.234567,
11 "longitude": -2.123456
12 }
13 }
14 ]
15 // Other data
16}

Where the latitude and longitude items have not been provided, the API will geocode the address on your behalf.

Date and Time

These types of orders cannot be placed in advance, only on the day of. This means that the endpoint does not accept any date parameters.

Additionally, pick-up time is agreed prior, and set on the account level; drop-off, if applicable, is determined by our route optimisation technology.

Get Updates on Order Progress

Through webhooks, you can receive status updates about your orders as they happen. See the documentation.

You can also make requests to the API the retrieve order data as and when you need it. See the API reference.