Check Delivery Assurance

There are 4 services available within Delivery Assurance:

  1. Store Boundary: Checks if the delivery address is within the coverage boundary of any store and returns a list of stores that can service the delivery address. We recommend passing either the zip code or latitude and longitude in the request to avoid geo-coding costs. Boundary needs to be defined around each store for this feature to work. (Refer: Add Boundary to define boundary for a store).
  2. DSP: This checks if at least one of the providers associated with the store has delivery coverage.
  3. Store Boundary + DSP: This is a combination of both the store boundary and DSP. It checks if drop-off address is within the coverage boundary as well as at least one of the providers associated with the store can service the drop-off address.
  4. Risk Score: This provides a risk score for a specified drop-off address.

📘

  • BothpickupTimeanddropoffTimemust be provided to check for delivery within a specific time window.

  • The dsp and store-boundary-dspDelivery Assurance check is restricted to the providers configured for the pickup location. This API is for assurance of delivery, hence the first positive response from a provider is considered assurance of delivery.

  • WhennearestPickupvalue is passed, showTags and showBoundaries tags will not be available in the response.

  • Risk Scores are currently available only for locations in the United States.

❗️

Caching can be enabled through configuration to reduce latency, especially when used on a PDP page. Caching works only if parameters that affect assurance (pickupTime and dropoffTime) are not provided.

🚧

Delivery Assurance does not utilize business rules and the orchestration engine.

Store-boundary service response

PropertyDescriptionTypeRequired
store-boundaryName of the selected serviceObjectConditional
Based on the service selected for the delivery assurance call
valueList of storeExternalIds that can deliver to the delivery addressArray of Stringstrue
errorsList of base errorsArray of BaseError Objectsfalse
fulfillmentsList of provider fulfillment options.Array of Fulfillment ObjectsConditional
This is sent when showFulfillmentOptions is true
boundariesList of boundaries associated with a pickup locationArray of Boundary DetailsConditional
This is sent when showBoundaries is true
distancesList of storeExternalIds sorted by distance.Array of Distance DetailsConditional
This is sent when sortByDistance is true

dsp service response

PropertyDescriptionTypeRequired
dspName of the selected serviceObjectBased on the service selected for the delivery assurance call
valueList of providers that can deliver to the delivery addressArray of Stringstrue
errorsList of Base and Provider ErrorsArray of Errorsfalse

store-boundary-dsp service response
This service is a combination of both store-boundary and dsp service. Hence all sub-properties of both the services are shown

PropertyDescriptionTypeRequired
store-boundary-dspName of the selected serviceObjectBased on the service selected for the delivery assurance call
valueList of providers that can deliver to the delivery addressArray of Stringstrue
errorsList of Base and Provider Errors and storeExternalIdArray of Errorsfalse

risk-score service response

PropertyDescriptionTypeRequired
risk-scoreName of the selected serviceObjectBased on the service selected for the delivery assurance call
valueaddressScore for the delivery addressArray of Stringstrue
scoreList of scores for the delivery addressObjecttrue
errorsList of Base ErrorsArray of Errorsfalse
Language
Authorization
Click Try It! to start a request and see the response here!