Lead time API overview

Marketplace Sellers are expected to ship items the day they receive the purchase order (PO). However, there may be times when Marketplace Sellers have an item that does not ship the same day. This delay is called a lead time. These Lead Time requests allow sellers to update the lead time or to view the number of days between when an item is ordered and when it is shipped.

There are two requests to manage lead time:

Lead time API access

Only business-approved Sellers will have access or permissions to update and access Lead Time requests. If sellers do not have access to the Lead Time API, they can obtain access by contacting the Business Operations team.

Update lead time (PUT)

This request allows the seller to update the lead time of items in bulk by indicating the primary identifier, the stock keeping unit (SKU).

Submission flow

The PUT Update Lead Time submission process is an asynchronous flow. After a successful submission, the seller must continue to track the submission feed status using the feed ID (feedId) when each item lead time update was successful.

For more about feed statuses and how to track them, see the GET Feed Item Status request.

GET lead time (POST)

This request is used to view the lead time of a list of item. The seller must indicate the list of SKUs in request to get the lead time. It will return both the SKU as well as the lead time of the item in question.

The value -1 indicate the SKU’s lead time is not found.

FAQ

Q: How does the user track a feed?

A: Once the seller perform update lead time for a set of SKUs, they will receive a feed ID. Feeds are used to track all asynchronous API requests to Walmart. Click here to learn more about how to track a feed.

List of common terms

• FeedId: Unique identifier with which a given feed status can be tracked.

• Stock keeping unit (SKU): Unique identifier for the item (stock keeping unit).