Show / Hide Table of Contents

    Allocating to a Specific Quote

    • v1
    • allocation
    • pro
    • api
    • consignments

    Obtaining quotes to carry an individual consignment and then allocating to the most suitable response is a key part of many customer service workflows in PRO. This page explains how to use the Allocate With Quote endpoint to select a quote.


    Quotes Overview

    In PRO, delivery quotes are generally used outside of a "regular" consignment allocation workflow, as a means of managing consignments that require manual intervention. For example, your customer service teams might want to get quotes for an expedited delivery on a consignment that was missed by a carrier and so did not meet its delivery promise.

    PRO's Quotes API enables you to get delivery quotes for both uncreated and existing consignments. All Quotes endpoints return one or more Quote objects, of which each represents an offer for carriage of a consignment with a specific carrier service. Each quote can be uniquely identified by a {quoteReference}, which is used when selecting a quote via the Allocate With Quote endpoint.

    Note
    • For a full user guide on working with quotes, see the Managing Quotes page.
    • For reference information on the Quotes API, see the API reference.
    • For worked examples showing a consignment being allocated from a quote, see the Quotes call flow page.

    Using Allocate With Quote

    The Allocate With Quote endpoint enables you to allocate an individual consignment based on a specific delivery quote from a carrier. To call Allocate With Quote, send a PUT request to https://api.electioapp.com/allocation/{consignmentReference}/allocatewithquote/{quoteReference}, where {consignmentReference} corresponds to the consignment you want to allocate and {quoteReference} is the quote you want to select.

    Once the request is received PRO attempts to allocate the consignment to the carrier service specified in the quote (as denoted by the {MpdCarrierService} and MpdCarrierServiceReference fields contained within the Quote object), and returns an Allocation Summary.

    Note

    For full reference information on the Allocate With Quote endpoint, see the Allocate With Quote page of the API reference.

    Allocate With Quote Example

    The example shows a request to allocate a consignment with a {consignmentReference} of EC-000-05B-N40 to the carrier service associated with a quote that has the {quoteReference} 112236d5-4460-492f-a6bd-aa3f00f62dfb.

    • Allocate With Quote Request
    PUT https://api.electioapp.com/allocation/EC-000-05B-N40/allocatewithquote/112236d5-4460-492f-a6bd-aa3f00f62dfb
    

    Next Steps

    • Learn about alternative methods of allocating consignments at the Allocating Consignments page.
    • Learn how to get and print delivery labels at the Getting Labels page.
    • Learn how to add consignments to a carrier manifest at the Manifesting Consignments page.
    Back to top Copyright © Sorted Group 2023. Generated by DocFX