Request delivery dates in time-period

Introduction

The purpose of the api/promises/checkoutoptions/delivery/timeperiod endpoint is to provide all available delivery dates based on a basket of items within a defined timeframe.

You find the documentation of this call here.

The length of the time period is restricted to 60 days. Please note that the longer the time period, the more time may be needed to calculate all the results (depending on the size of your fulfillment network).

Swagger UI

Request:

• startDate: This is the start date of the requested time range. If no info is given we use the default "now" (timestamp of the request).

• endDate: This is the start date of the requested time range. If no info is given we use the default "now" (timestamp of the request).

• basket:Contains all tenantArticleIds and the respective quantities that the customer is interested in buying

• consumerAddress:The request needs to contain at least the consumer country. This is important, as the nondeliverydays are taken into account when calculating the earliest delivery day and these differ from country to county and also from to region. It also possible to provide a postal code in the request (i.e. for logged in shop users). By doing so, the calculation can also consider region specific non delivery days.

• deliveryPreferences: By setting deliveryPreferences like preferredCarrier(s) or preferredCarrierProductCategories only matching carrier options are considered when evaluating which dates are possible delivery dates.

Response:

• date: Defines the date on which the calculation took place and on which the following information applies

• overallStatus: The result can be be ALL, NONE or PARTIAL. ALL: all items within the requested basket can be delivered at the corresponding date NONE: none of the items within the requested basket can be delivered at the corresponding date. PARTIAL: part of the items within the requested basket can be delivered at the corresponding date.

• availableCarriers:

  • name:Name of the carrier (key) like "DHL"

  • nonDeliveryDays:Regions where this particular date is a non delivery date of the corresponding carrier (i.e. DE-NW: DHL does not deliver on the March 3rd 2025 in North Rhine Westphalia due to carnival)

Please note that the usage of the overallStatusis an aggregate of the basket and used in order to improve the performance of the call. If there is need for more specific information on item level you can request this call multiple times but with only one item in the basket or use our checkout options and promising endpoints.