Availability for delivery date

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

Summary

The purpose of this endpoint is to provide available stock quantities over facilities for items on a specific delivery date.

This information can be used to determine the availability of certain products for a delivery day selected by the customer. Thus, the consumer knows at an early stage of the checkout journey if an item can be delivered on a certain delivery date.

You find the documentation of this call here.

Additional info about the request:

• desiredDeliveryDate: This is the date when the item should arrive at the customer.

• tenantArticleIds: Contains all tenantArticleIds that the customer is interested in buying.

• facilityRef: Contains all facilities that should be considered for the delivery.

• latestPickingStart: This is the point in time at which the picking for the delivery must be started to arrive in time at the customer. If the latest possible picking start for a certain delivery date in a facility is not known, it can be requested via the /api/promises/checkoutoptions endpoint. Our systems then calculate the latestPickingStartbased on cut-off time of carriers and fulfillment process buffer.​

Additional info about the response:

The response lists the available quantity for all requested items and facilities. Facility / item combinations with zero availability are included.

Expected stocks that were announced via purchase order are also considered in the response. Only purchase orders with requestedDate.type "ASAP" are not considered as we expect these deliveries to arrive as soon as possible and there is no exact date that our systems can use to check the potential availability of these stocks for incoming orders.

Example response

{
    "items": [
        {
            "facilityRef": "cgn-01",
            "tenantArticleId": "0631",
            "available": 300
        },
        {
            "facilityRef": "cgn-01",
            "tenantArticleId": "2027",
            "available": 200
        },
        {
            "facilityRef": "dus-01",
            "tenantArticleId": "06031",
            "available": 4
        },
        {   
            "facilityRef": "dus-01",
            "tenantArticleId": "2027",
            "available": 0
        }
    ]
}

Get delivery timepoint

post

This endpoint is to be used to get information about the possible delivery of items.

Authorizations

Body

CheckoutOptionsDeliveryTimePointRequest

desiredDeliveryDatestring · date-timeRequired

Desired delivery date-time

tenantArticleIdsstring[]Required

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/timepoint HTTP/1.1
Host: your-tenant-name.api.fulfillmenttools.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "desiredDeliveryDate": "2025-08-23T11:20:25.308Z",
  "facilities": [
    {
      "facilityRef": "text",
      "latestPickingStart": "2025-08-23T11:20:25.308Z"
    }
  ],
  "tenantArticleIds": [
    "text"
  ]
}

{
  "items": [
    {
      "available": 1,
      "facilityRef": "text",
      "latestPickingStart": "2025-08-23T11:20:25.308Z",
      "tenantArticleId": "text"
    }
  ]
}