On this page
article
Getting Quotes for an Existing Consignment
Retrieve quotes for a package that already exists in the Consignments platform. Compare qualified and unqualified services before allocation.
Get quotes overview
This page explains how to get delivery quotes for a consignment that already exists in the Consignments platform.
The Get Quotes By Consignment Reference endpoint returns quotes based on the details of an existing consignment. Specifically, it takes a {consignmentReference} and returns an array of {Quotes} for that consignment.
To call Get Quotes by Consignment Reference, send a GET request to https://api.electioapp.com/quotes/consignment/{consignmentReference}.
Once it has received the request, Consignments returns a quote result. The quote result object includes two lists: one containing Quotes and one containing UnqualifiedServices (that is, services that have been disqualified from the quote process or that did not meet the delivery requirements for the consignment and were therefore unable to provide a quote).
Each Quote object contains the following information:
- A unique reference for the quote. This property is important, as it is used when allocating consignments to the quote via the Allocate With Quote endpoint.
- Creation and expiry dates.
- The name and reference of the relevant carrier and carrier service.
- Origin and destination addresses.
- Collection date, and a delivery date range.
- Pricing information.
- Details on each leg of the journey (where applicable).
- The service direction.
At this point, you would be able to display the relevant quote information to your customer service operative.
For full reference information on the Get Quotes by Consignment Reference endpoint, see the Get Quotes by Consignment Reference page of the API reference.
For an example call flow showing the Get Quotes by Consignment Reference endpoint being used, see the Quotes Flow page.
For an example call flow showing the Get Quotes by Consignment Reference endpoint being used, see the Quotes Flow page.
Example: Get quotes by consignment reference
The example shows a Get Quotes by Consignment Reference request and its accompanying response. In this case, the Consignments platform has returned two quotes for the service. The next step in the process is to select one of those quotes.
GET https://api.electioapp.com/quotes/consignment/EC-000-05B-1CM
{
"QuoteRequestReference": "6f9c7ee5-a97e-4df9-bc07-aa3f00e99316",
"Quotes": [
{
"MpdCarrierServiceSource": 2,
"MpdCarrierService": "1st and 2nd Class Account Mail (1st Parcel)",
"OriginAddress": {
"ShippingLocationReference": "Sorted1",
"AddressLine1": "Third Floor",
"AddressLine2": "Merchant Exchange",
"AddressLine3": "Whitworth Street West",
"Town": "Manchester",
"Region": "",
"Postcode": "M1 5WG",
"Country": {
"Name": "United Kingdom",
"IsoCode": {
"TwoLetterCode": "GB",
"ThreeLetterCode": "GBR",
"NumericCode": "826"
}
},
"RegionCode": "",
"SpecialInstructions": "",
"IsCached": false
},
"DestinationAddress": {
"AddressLine1": "13 Porter Street",
"AddressLine2": "Pressington",
"AddressLine3": "Carlsby",
"Town": "Manchester",
"Region": "Greater Manchester",
"Postcode": "M1 5WG",
"Country": {
"Name": "United Kingdom",
"IsoCode": {
"TwoLetterCode": "GB",
"ThreeLetterCode": "GBR",
"NumericCode": "826"
}
},
"SpecialInstructions": "Gate code: 4454",
"IsCached": false
},
"CollectionDate": "2019-05-01T00:00:00",
"EarliestDeliveryDate": "2019-05-02T00:00:00",
"LatestDeliveryDate": "2019-05-02T23:59:00",
"BasePrice": {
"Net": 27.69,
"Gross": 33.23,
"VatRate": {
"Reference": "GB-0.2000",
"CountryIsoCode": "GB",
"Type": "Standard",
"Rate": 0.2
},
"VatAmount": 5.54,
"Currency": {
"Name": "Pound Sterling",
"IsoCode": "GBP"
}
},
"Price": {
"Net": 27.69,
"Gross": 33.23,
"VatRate": {
"Reference": "GB-0.2000",
"CountryIsoCode": "GB",
"Type": "Standard",
"Rate": 0.2
},
"VatAmount": 5.54,
"Currency": {
"Name": "Pound Sterling",
"IsoCode": "GBP"
}
},
"Surcharges": [],
"Legs": [
{
"JourneyStage": 1,
"CarrierService": {
"Reference": "RMDBPR1STPSU",
"Name": "1st and 2nd Class Account Mail (1st Parcel)",
"CarrierReference": "ROYAL_MAIL",
"CarrierName": null,
"IsDropOff": false,
"IsPickUp": false,
"IsTimed": false
},
"CarrierAccountReference": "RM1",
"DeliveryHub": null,
"CostItems": null,
"VolumetricParcelWeight": null,
"CollectionType": "NotApplicable"
}
],
"CarrierAccountOwner": null,
"IsElectioService": false,
"QuoteReference": "f6374a18-a6b5-48c1-841c-aa3f00e9951a",
"CreationDate": "2019-04-30T14:10:26.8551633+00:00",
"ExpiryDate": "2019-05-01T00:00:00+01:00",
"Requestor": "Andy Walton",
"ConsignmentReference": "EC-000-05B-1CM",
"ConsignmentReferenceProvidedByCustomer": "",
"MpdCarrierServiceReference": "MPD_RMDBPR1STPSU"
},
{
"MpdCarrierServiceSource": 2,
"MpdCarrierService": "Tracked 48 Signed For",
"OriginAddress": {
"ShippingLocationReference": "Sorted1",
"AddressLine1": "Third Floor",
"AddressLine2": "Merchant Exchange",
"AddressLine3": "Whitworth Street West",
"Town": "Manchester",
"Region": "",
"Postcode": "M1 5WG",
"Country": {
"Name": "United Kingdom",
"IsoCode": {
"TwoLetterCode": "GB",
"ThreeLetterCode": "GBR",
"NumericCode": "826"
}
},
"RegionCode": "",
"SpecialInstructions": "",
"IsCached": false
},
"DestinationAddress": {
"AddressLine1": "13 Porter Street",
"AddressLine2": "Pressington",
"AddressLine3": "Carlsby",
"Town": "Manchester",
"Region": "Greater Manchester",
"Postcode": "M1 5WG",
"Country": {
"Name": "United Kingdom",
"IsoCode": {
"TwoLetterCode": "GB",
"ThreeLetterCode": "GBR",
"NumericCode": "826"
}
},
"SpecialInstructions": "Gate code: 4454",
"IsCached": false
},
"CollectionDate": "2019-05-01T00:00:00",
"EarliestDeliveryDate": "2019-05-03T00:00:00",
"LatestDeliveryDate": "2019-05-03T23:59:00",
"BasePrice": {
"Net": 27.69,
"Gross": 33.23,
"VatRate": {
"Reference": "GB-0.2000",
"CountryIsoCode": "GB",
"Type": "Standard",
"Rate": 0.2
},
"VatAmount": 5.54,
"Currency": {
"Name": "Pound Sterling",
"IsoCode": "GBP"
}
},
"Price": {
"Net": 27.69,
"Gross": 33.23,
"VatRate": {
"Reference": "GB-0.2000",
"CountryIsoCode": "GB",
"Type": "Standard",
"Rate": 0.2
},
"VatAmount": 5.54,
"Currency": {
"Name": "Pound Sterling",
"IsoCode": "GBP"
}
},
"Surcharges": [],
"Legs": [
{
"JourneyStage": 1,
"CarrierService": {
"Reference": "RMDTPS48HNAST",
"Name": "Tracked 48 Signed For",
"CarrierReference": "ROYAL_MAIL",
"CarrierName": null,
"IsDropOff": false,
"IsPickUp": false,
"IsTimed": false
},
"CarrierAccountReference": "RM1",
"DeliveryHub": null,
"CostItems": null,
"VolumetricParcelWeight": null,
"CollectionType": "NotApplicable"
}
],
"CarrierAccountOwner": null,
"IsElectioService": false,
"QuoteReference": "f63bd4ab-d519-4547-b361-aa3f00e9951a",
"CreationDate": "2019-04-30T14:10:26.8551633+00:00",
"ExpiryDate": "2019-05-01T00:00:00+01:00",
"Requestor": "Andy Walton",
"ConsignmentReference": "EC-000-05B-1CM",
"ConsignmentReferenceProvidedByCustomer": "",
"MpdCarrierServiceReference": "MPD_RMDTPS48HNAST"
}
],
"Message": null,
"UnqualifiedServices": [
{
"Available": true,
"Rates": false,
"MpdCarrierService": "Tracked 48 Hour",
"MpdCarrierServiceReference": "MPD_T48H",
"ExclusionReason": "No cost and/or pricing data configured"
},
{
"Available": false,
"Rates": false,
"MpdCarrierService": "Express With Signature Parcel",
"MpdCarrierServiceReference": "MPD_ANPOS-00001",
"ExclusionReason": "This service is not available for the selected collection/delivery dates."
},
{
"Available": false,
"Rates": true,
"MpdCarrierService": "Next Day Monday - Saturday",
"MpdCarrierServiceReference": "MPD_MNZIS-00001",
"ExclusionReason": "This service is not available between the selected addresses."
},
{
"Available": true,
"Rates": false,
"MpdCarrierService": "UPS EXPRESS (Delivery Confirmation Signature Required)",
"MpdCarrierServiceReference": "EDC5_UPSHEXDCS",
"ExclusionReason": "No cost and/or pricing data configured"
},
{
"Available": true,
"Rates": false,
"MpdCarrierService": "UPS EXPRESS (Saturday Delivery, Delivery Confirmation Signature Required)",
"MpdCarrierServiceReference": "EDC5_UPSHEXSDDCS",
"ExclusionReason": "No cost and/or pricing data configured"
},
{
"Available": true,
"Rates": false,
"MpdCarrierService": "UPS EXPRESS PLUS (Delivery Confirmation Signature Required)",
"MpdCarrierServiceReference": "EDC5_UPSHEP",
"ExclusionReason": "No cost and/or pricing data configured"
},
{
"Available": true,
"Rates": false,
"MpdCarrierService": "UPS SAVER (Delivery Confirmation Signature Required)",
"MpdCarrierServiceReference": "EDC5_UPSHSADCS",
"ExclusionReason": "No cost and/or pricing data configured"
},
{
"Available": true,
"Rates": false,
"MpdCarrierService": "UPS STANDARD (Delivery Confirmation Signature Required)",
"MpdCarrierServiceReference": "EDC5_UPSHSTDCS",
"ExclusionReason": "No cost and/or pricing data configured"
},
{
"Available": false,
"Rates": false,
"MpdCarrierService": "wnDirect International Economy",
"MpdCarrierServiceReference": "MPD_WNDECOM",
"ExclusionReason": "This service is not available between the selected addresses. This service is not available for the given package dimensions/weight."
}
]
}
Next Steps
- Learn how to get quotes without creating a new consignment at the Get quotes page.
- Learn how to create consignments at the Creating a new consignment page.
- Learn how to allocate consignments to your chosen quote at the Allocate to a specific quote page.