fulfillmenttools
API documentationIncident ManagementFeedback
Products
Products
  • Products
  • Core
    • Fulfillmenttools and it's surrounding system
    • Facilities
      • Managed facilities
      • Supplier facilities
      • Facility groups
      • Facility discounts
    • User management
    • GDPR
    • External actions
    • Notification center
    • Incident management
    • Tags
    • Stickers
    • Articles
  • Inventory Management
    • Overview inventory modules
    • Listing
    • Article categories
    • Stock
      • Stock availability
      • Stock properties
      • Stock updates
    • Reservations
    • Inbound process
    • Storage location
    • Zone
    • Inventory traits
    • Channel inventory
    • Measurement units
    • Stow jobs
    • External stock change reasons
    • Configurations
  • Availability & Promising
    • Availability & promising in customer journey
      • Earliest possible delivery date
      • Availability in delivery time period
      • Availability for specific delivery date
      • Checkout options
      • Delivery promise
    • Latest picking start
  • Distributed Order Management
    • Order management
    • Order routing
      • Fences
      • Ratings
      • Order split
      • Routing strategy
      • Item bundles
      • Re-route
      • Decision logs
      • Unroutable orders
      • Pre- and backorders
      • DOMS toolkit
  • Order fulfillment
    • Picking
    • Packing
    • Handover
    • Custom services
    • External documents
    • Load units
    • Interfacility transfer
    • Pick job target time
    • Configurations
      • Picking configuration
      • Packing configuration
      • Handover configuration
      • Printing & document configuration
      • Parcel tag configuration
  • Carrier management
    • Carriers and connection to facilities
    • Carrier country service mapping
    • Same day delivery
    • Custom carrier
    • Available carriers
  • Returns Management
    • Introduction to returns
    • Return reasons
  • Use Cases
    • Creating & executing stow jobs
    • Creating orders with interfacility transfers
    • Demand-driven replenishment
    • Expected stock in availability
    • Incoming goods & storage
    • Multi order picking
Powered by GitBook
On this page
  • Summary
  • Request & response
  • Request
  • Response
Edit on GitHub
  1. Availability & Promising
  2. Availability & promising in customer journey

Earliest possible delivery date

Last updated 19 hours ago

Summary

This endpoint provides 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 the earliest delivery date that can be expected for a specific item.

More API information can be found here:

Limitations & mandatory configurations

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

  • Since the endpoint checks for delivery days, it is mandatory to have transit times configured per carrier.

  • When defined for the tenant, , of the facilities, and are included in the calculation.

Request & response

Request

  • earliestDeliveryDate: 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 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 considering region-specific non-delivery days.

  • filter: Since the request does not check for fences it is possible to include filters referring to . If the request contains a filter with a custom attribute only those facilities are checked which also have the matching custom attribute attached to the facility entity.

Response

The response contains a list of the requested items with:

  • earliestPredictedDeliveryDate: 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 (e.g., DE-NW: DHL does not deliver on March 3rd 2025 in North Rhine Westphalia due to carnival)

that were announced via 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.

REST API documentation – checkoutoptions/delivery/earliest
Expected stocks
purchase order
average fulfillment duration
fulfillment times
carrier capacities
non-delivery days
custom attributes