GET Retrieve Items: Item Setup and Maintenance Implementation Guide
This section outlines a possible implementation plan. The subsections in the proposed implementation are:
- Client-Side Statuses of Walmart Items
- Sending Items for Ingestion
- Checking Ingestion Status
- Checking Published Status
- Correcting Item Errors
Client-Side Statuses of Walmart Items (Legacy and New Item Setup)
For this implementation, we assume that suppliers will use their own client-side database to store the status of their items and feeds on Walmart.com. A possible set of statuses could be:
Status | Description | Comment |
---|---|---|
transmit | To be transmitted to Walmart | Can be set to this by the supplier deciding to sell item to Walmart, or by the system requesting a re-transmission because data errors were detected and fixed |
data fix | Schema or content is incompatible with Walmart.com | Check the item feed file schema against the submitted JSON file |
ingestion in progress | Item is in the ingestion process | No updates allowed at this time |
publish in progress | Item is in publishing process | Ingestion is completed, but publishing must be completed before suppliers can add inventory |
published | Item is published on Walmart.com | Inventory can be added, and the item can be seen by customers on Walmart.com |
system error | An error was encountered during publishing | Contact Walmart Partner Support |
unpublished | Not available on Walmart.com | Item is no longer visible on Walmart.com |
data fix – ticket | Support ticket submitted | Underlying error status is data fix |
systemerror – ticket | Support ticket submitted | Underlying error status is a system error |
Feed Status | Feed Status | Comment |
---|---|---|
active | Has items that still need ingestion status checked | Do not archive or delete |
archive | All items in the feed have finished processing | Archive the feed IDs or delete them |
Sending Items for Ingestion
This flow describes how suppliers may want to send their items to Walmart and process immediate errors. On an initial ingestion, suppliers must use a setup feed file. Afterwards, suppliers are recommended to use an item maintenance feed file for updates.

Checking Ingestion Status (Legacy and New Item Setup)
The flow below describes how suppliers may monitor the status of their items as the items are ingested.

Checking Published Status (Legacy and Published)
The flow below describes how suppliers may monitor the status of their items as the items move through the publishing process.

Correcting Item Errors (Legacy and New Item Setup)
The flow below describes how suppliers may implement a process for correcting item errors. In addition to the flow below, suppliers may want to build their own process for correcting items and item statuses as Partner Support responds to support cases.

Updated about 1 month ago