Availability for specific delivery date

This endpoint provides 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.

More API information can be found here: REST API documentation – checkoutoptions/delivery/timepoint

Request and response

Request

• desiredDeliveryDate: Date when the items should arrive at the customer.

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

• facilityRef: Contains 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 in order to be delivered to the customer on time. If the latest possible picking start for a certain delivery date in a facility is not known, it can be requested via the Checkout Options endpoint. Systems then calculate the latest picking start based on cut-off time of carriers and fulfillment process buffer​.

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 these deliveries are expected to arrive as soon as possible and there is no exact date that can be used 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

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

CheckoutOptionsDeliveryTimePointRequest

desiredDeliveryDatestring · date-timeRequired

Desired delivery date-time

tenantArticleIdsstring[]Required

Tenant article IDs

Responses

200

The request could be evaluated

application/json

CheckoutOptionsDeliveryTimePointResponse

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

/api/promises/checkoutoptions/delivery/timepoint

HTTPcURLJavaScriptPython

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

{
  "desiredDeliveryDate": "2026-03-02T18:02:31.419Z",
  "facilities": [
    {
      "facilityRef": "text",
      "latestPickingStart": "2026-03-02T18:02:31.419Z"
    }
  ],
  "tenantArticleIds": [
    "text"
  ]
}

{
  "items": [
    {
      "available": 1,
      "facilityRef": "text",
      "latestPickingStart": "2026-03-02T18:02:31.419Z",
      "tenantArticleId": "text"
    }
  ]
}