Earliest possible delivery date

This page is outdated. Please go to our new documentation under https://docs.fulfillmenttools.com/documentation.

What is the purpose of this endpoint?

The purpose of this endpoint is to provide the earliest possible delivery date for an item or a list of items. This information can be used on a search result or product overview page to inform the shop user about when the delivery of a specific item can be expected.

This becomes especially valuable in industries and situations where delivery time is as important as the item itself—such as when selling gifts that need to be delivered by a certain date or in the case of groceries when you need to be home to receive the delivery. In these contexts, having accurate delivery information is crucial to enhancing the shopping experience.

You find the documentation of this call here.

Please note:

• the maximum amount of days that are checked is limited to 45 days

• Since we check for delivery days it is mandatory to have transit times set p. carrier if you want to use this feature. If this is not the case we cannot perform our calculation ❗

• if set the average fulfillment time and the opening times are included in the calculation

How does it work?

Some additional info about the request:

• earliestDeliveryDate: This is set to "now" by default, meaning the customer is interested in an ASAP delivery. If a different future date is specified, available delivery dates will be checked starting from that point in time (i.e., the user does not want to receive their order before a given date).

• tenantArticleIds: The earliest delivery date can be calculated for a single item or a list of items. If a list of items is requested, the calculation is done for each item individually (not as a basket).

• consumerAddress:The request must include at least the consumer's country. This is important because non-delivery days are taken into account when calculating the earliest delivery date, and these vary by country and region. It is also possible to provide a postal code in the request (e.g., for logged-in shop users). Doing so allows the calculation to consider region-specific non-delivery days.

Some additional info about the response:

You will receive a list of the requested items with

• earliestPredictedDeliveryDate: This is the earliest point in time when the user can expect this particular item to be delivered in case the order would be placed at this moment.

• availableCarrier:

  • 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)

Get earliest delivery

post

Get earliest delivery timepoint for a given checkoutOption

Authorizations

Body

CheckoutOptionsDeliveryEarliestRequest

consumerAddressall ofRequired

Consumer delivery address

earliestDeliveryDatestring · date-timeOptional

Earliest delivery date

filterall ofOptional

Facility filter criteria

includeCalculationHintsbooleanOptional

Whether to include calculation hints in the response

tenantArticleIdsstring[] · min: 1Required

List of tenant article IDs

Responses

200

The request could be evaluated

application/json

400

Invalid input. See response for details.

application/json

401

Your user is not allowed to operate against this API instance

application/json

403

Your user, although recognized, is not authorized to use this

application/json

404

The requested entity was not found

application/json

409

A version conflict occurred.

application/json

post

HTTPcURLJavaScriptPython

POST /api/promises/checkoutoptions/delivery/earliest HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 298

{
  "consumerAddress": {
    "addressType": "POSTAL_ADDRESS",
    "city": "text",
    "country": "DE",
    "houseNumber": "text",
    "postalCode": "text",
    "province": "text",
    "street": "text"
  },
  "earliestDeliveryDate": "2025-08-28T14:56:13.972Z",
  "filter": {
    "customAttributes": {}
  },
  "includeCalculationHints": true,
  "tenantArticleIds": [
    "text"
  ]
}

{
  "calculationHints": [
    "text"
  ],
  "checkoutOptions": [
    {
      "availableCarriers": [
        {
          "carrierRef": "text",
          "latestPickingStartDate": "2025-08-28T14:56:13.972Z",
          "name": "text",
          "nonDeliveryDays": [
            "text"
          ]
        }
      ],
      "availableFacilityConnections": [
        {
          "connectionRef": "text",
          "latestPickingStartDate": "2025-08-28T14:56:13.972Z",
          "nonDeliveryDays": [
            "text"
          ]
        }
      ],
      "earliestPredictedDeliveryDate": "2025-08-28T14:56:13.972Z",
      "tenantArticleId": "text"
    }
  ]
}