Fares / Quotes

Last updated 3 months ago

In this document you will be able to request a Quotation or Quote to estimate the price of a delivery in your area/city at the times available.

You can choose from 3 types of Quotes that depend on each city. If you are a company with less than 100 deliveries a day, you are most likely to use these available fares to create a delivery in our system.

Note: There are fares previously arranged with certain companies that will be generated automatically when a delivery is created using this endpoint . Learn more about contracts and covenants with companies that have specific operation rules and volume contacting to our team at http://shippify.co

Types of Quotes

There are 3 types of Quotations you can choose that will have different prices, pickup and delivery scheduled times.

  • Express (Deliver under 3 hours)

  • Scheduled time slots (Time windows during the day)

  • Flex (Collect in the morning, deliver in the afternoon)

If you want to see how this is currently working you can login in our dashboard and follow the steps here.

This is a UI example of how we use QUOTES to show to every user in our system. You can do your own implementation in your e-commerce or mobile commerce.

Request Quotes

List the quotes available for a given delivery(or set of deliveries).

POST /deliveries/quotes

date => If you'd like to set the pickup time when the delivery has to get started. (UNIXTIMESTAMP in ms)(Optional)

deliveries => List of deliveries

express => false if you want to avoid listing express quotes.(Default: true, Optional)

flexible => true if you want to list flexible quote times, for same day delivery (Default: false, Optional)

limit => Maximum number of quotes to be returned (Optional, integer)

timeslots => false if you want to avoid listing express with time slots, for same day delivery. (Default: true, Optional)

curl
JavaScript
curl -X POST \
https://api.shippify.co/v1/deliveries/quotes/ \
-H 'authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXX' \
-H 'content-type: application/json' \
-d '{
"deliveries": [
{
"pickup": {
"contact": {
"name": "John Doe",
"email": "john@doe.com",
"phonenumber": "+19209489292"
},
"location": {
"address": "Central Park, New York, NY, United States",
"instructions": "Central Park West, APT 10920"
},
"date": 1578787200000
},
"dropoff":{
"contact": {
"name": "Mary Doe",
"email": "mary@doe.co",
"phonenumber": "+19209085222"
},
"location": {
"address": "200 Eastern Pkwy, Brooklyn, NY 11238, USA",
"instructions": "APT 2094",
"lat": 40.6720036,
"lng": -73.9593279
}
},
"packages": [
{
"name": "paperwork1",
"size": "xs",
"qty": 1
}
]
}
]
}'
var data = JSON.stringify({
"deliveries": [
{
"pickup": {
"contact": {
"name": "John Doe",
"email": "john@doe.com",
"phonenumber": "+19209489292"
},
"location": {
"address": "Central Park, New York, NY, United States",
"instructions": "Central Park West, APT 10920"
},
"date": 1578787200000
},
"dropoff": {
"contact": {
"name": "Mary Doe",
"email": "mary@doe.co",
"phonenumber": "+19209085222"
},
"location": {
"address": "200 Eastern Pkwy, Brooklyn, NY 11238, USA",
"instructions": "APT 2094",
"lat": 40.6720036,
"lng": -73.9593279
}
},
"packages": [
{
"name": "paperwork1",
"size": "xs",
"qty": 1
}
]
}
]
});
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.shippify.co/v1/deliveries/quotes/");
xhr.setRequestHeader("authorization", "Basic XXXXXXXXXXXXXXXXXXXXXXX");
xhr.setRequestHeader("content-type", "application/json");
xhr.send(data);

Responses

After a Quote is retrieved, the following payload is received and you can use the `quoteId` in order to create a delivery .

200|Success

curl
JavaScript
{
message: "quotes created successfully",
payload: {
"slots": [
{
"quoteId": 136498,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518267600000,
"pickupEndTime": 1518271200000,
"dropoffStartTime": 1518271200000,
"dropoffEndTime": 1518274800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518274800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136507,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518300000000,
"pickupEndTime": 1518303600000,
"dropoffStartTime": 1518303600000,
"dropoffEndTime": 1518307200000,
"expiration": 30,
"pickupMaxAvailableTime": 1518307200000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136508,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518303600000,
"pickupEndTime": 1518307200000,
"dropoffStartTime": 1518307200000,
"dropoffEndTime": 1518310800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518310800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136509,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518307200000,
"pickupEndTime": 1518310800000,
"dropoffStartTime": 1518310800000,
"dropoffEndTime": 1518314400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518314400000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136510,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518310800000,
"pickupEndTime": 1518314400000,
"dropoffStartTime": 1518314400000,
"dropoffEndTime": 1518318000000,
"expiration": 30,
"pickupMaxAvailableTime": 1518318000000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
}
],
"express": {
"quoteId": 136514,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518304378591,
"pickupEndTime": 1518306178591,
"dropoffStartTime": 1518306178591,
"dropoffEndTime": 1518307978591,
"expiration": 30,
"pickupMaxAvailableTime": 1518307978591,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"flex": {
"quoteId": 136497,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518008400000,
"pickupEndTime": 1518026400000,
"dropoffStartTime": 1518026400000,
"dropoffEndTime": 1518044400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518030000000,
"isFlexible": true,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"steps": {}
}
}
{
message: "quotes created successfully",
payload: {
"slots": [
{
"quoteId": 136498,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518267600000,
"pickupEndTime": 1518271200000,
"dropoffStartTime": 1518271200000,
"dropoffEndTime": 1518274800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518274800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136507,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518300000000,
"pickupEndTime": 1518303600000,
"dropoffStartTime": 1518303600000,
"dropoffEndTime": 1518307200000,
"expiration": 30,
"pickupMaxAvailableTime": 1518307200000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136508,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518303600000,
"pickupEndTime": 1518307200000,
"dropoffStartTime": 1518307200000,
"dropoffEndTime": 1518310800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518310800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136509,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518307200000,
"pickupEndTime": 1518310800000,
"dropoffStartTime": 1518310800000,
"dropoffEndTime": 1518314400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518314400000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136510,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518310800000,
"pickupEndTime": 1518314400000,
"dropoffStartTime": 1518314400000,
"dropoffEndTime": 1518318000000,
"expiration": 30,
"pickupMaxAvailableTime": 1518318000000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
}
],
"express": {
"quoteId": 136514,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518304378591,
"pickupEndTime": 1518306178591,
"dropoffStartTime": 1518306178591,
"dropoffEndTime": 1518307978591,
"expiration": 30,
"pickupMaxAvailableTime": 1518307978591,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"flex": {
"quoteId": 136497,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "wander@me.cu"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "andresr@me.cu"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518008400000,
"pickupEndTime": 1518026400000,
"dropoffStartTime": 1518026400000,
"dropoffEndTime": 1518044400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518030000000,
"isFlexible": true,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"steps": {}
}
}

400|Bad Request

curl
JavaScript
{
message: "Bad Request",
payload: { }
}
{
message: "Bad Request",
payload: { }
}

500|Internal Server error

curl
JavaScript
{
message: "Error while retrieving the quote",
payload: { }
}
{
message: "Error while retrieving the quote",
payload: { }
}