Fulfillability Check

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

The fulfillability endpoint of the fulfillmenttools platform API can be used to inform a client application about possible fulfillment options that could be shown during checkout.

This endpoint can be queried with specific data which is available (for example) during the checkout in an eCommerce shop, such as the basket, the desired service type (Ship From Store, Click and Collect), etc..

The Service will respond with the possible fulfillment options based on the supplied data in the request.

The fulfillability endpoint can check for the following service levels / service type combinations:

  • Ship-from-Store/Best Effort

  • Ship-from-Store/Same Day

  • Click & Collect/Best Effort

The following input parameters can be provided:

  • Which service level should be checked

  • Address of the customer

  • Optional: requested articles of the customer (e.g. the basket)

  • Click & Collect-only: the radius (in KM) around the address of the customer to determine the area in which for matching facilities is checked

Examples

Best Effort Ship-From-Store Delivery

Check if a delivery to the specified address is possible by the given date

Request:

curl -sSL -X POST 'https://your.api.fulfillmenttools.com/api/fulfillability' \
  --header 'Authorization: Bearer <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "estimatedOrderDate": "2020-02-11T12:45:00Z", 
  "shipping": {  
    "serviceLevels": [ 
      "DELIVERY" 
    ], 
    "targetAddress": { 
      "postalCode": "40764", 
      "country": "DE" 
    } 
  } 
}'

Response:

200 OK
{ 
  "shipping": { 
    "DELIVERY": { 
      "available": true 
    } 
  } 
}

Click & Collect Best Effort

This Service Type / Service Level Combination should be used when a Click and Collect service should be provided to the consumer. Currently there is no possibility to query for a specific time slot - hence this is Service-Level "Best Effort": Is there a facility within the specified area that can fulfill the Click and Collect service as fast as possible.

Check for facilities within 10km from the given coordinates that have the specified items available

  • Are there facilities within 10km from the given coordinates that offer Click & Collect as a service type?

  • Does at least one of those facilities have the specified items available?

Request:

curl -sSL -X POST 'https://your.api.fulfillmenttools.com/api/fulfillability' \
  --header 'Authorization: Bearer <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "constraints": [
    {
      "type": "ITEMS",
      "value": {
        "mode": "ITEMS_COMPLETE",
        "items": [
          {
            "tenantArticleId": "1",
            "amount": 80
          }
        ]
      }
    }
  ],
  "estimatedOrderDate": "2020-02-11T12:45:00Z",
  "collect": {
    "geoFence": {
      "lat": 50.941357,
      "lon": 6.958307,
      "radius": 10
    }
  }
}'

Response(positive):

200 OK
{
  "collect": {
    "facilities": [
      {
        "city": "Köln",
        "country": "DE",
        "created": "2022-03-11T12:01:40.283Z",
        "houseNumber": "42",
        "id": "14b3f6ea-42db-48e0-b9cc-0c3826adcc0f",
        "lastModified": "2022-03-11T12:01:40.503Z",
        "name": "Store-01",
        "status": "ONLINE",
        "version": 1
      },
      {
        "city": "Köln",
        "country": "DE",
        "created": "2022-03-11T12:01:40.756Z",
        "houseNumber": "31",
        "id": "61815cb1-6349-4acb-b1d1-42665457c96e",
        "lastModified": "2022-03-11T12:01:41.000Z",
        "name": "Store-02",
        "status": "ONLINE",
        "version": 1
      }
    ]
  }
}

Response(negative):

200 OK
{
  "collect": {
    "facilities": []
  }
}

Same-Day Ship-From-Store Delivery

Check if same-day delivery is possible for the given address

  • Is there a facility with the type Ship from Store which has at least one same day carrier?

  • Is the consumer within the delivery area of the same day carrier originating from a facility in the network?

  • Is there enough time for the same day fulfillment? (estimated order date + buffer time < cutoff time of the same day carrier)

  • Are all items available?

Request:

curl -sSL -X POST 'https://your.api.fulfillmenttools.com/api/fulfillability' \
  --header 'Authorization: Bearer <TOKEN>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "constraints": [
    {
      "type": "ITEMS",
      "value": {
        "mode": "ITEMS_COMPLETE",
        "items": [
          {
            "tenantArticleId": "1",
            "amount": 80
          }
        ]
      }
    }
  ],
  "estimatedOrderDate": "2020-03-12T10:00:00Z",
  "shipping": {
    "serviceLevels": [
      "SAMEDAY"
    ],
    "targetAddress": {
      "postalCode": "48157",
      "country": "DE"
    }
  }
}'

Response(positive):

200 OK
{
  "shipping": {
    "SAMEDAY": {
      "available": true,
      "validUntil": "2020-03-12T11:00:00.525Z"
    }
  }
}

Response(negative):

200 OK
{
  "shipping": {
    "SAMEDAY": {
      "available": false
    }
  }
}

Last updated

Was this helpful?