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:


StatusDescriptionComment
transmitTo be transmitted to WalmartCan 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 fixSchema or content is incompatible with Walmart.comCheck the item feed file schema against the submitted JSON file
ingestion in progressItem is in the ingestion processNo updates allowed at this time
publish in progressItem is in publishing processIngestion is completed, but publishing must be completed before suppliers can add inventory
publishedItem is published on Walmart.comInventory can be added, and the item can be seen by customers on Walmart.com
system errorAn error was encountered during publishingContact Walmart Partner Support
unpublishedNot available on Walmart.comItem is no longer visible on Walmart.com
data fix – ticketSupport ticket submittedUnderlying error status is data fix
systemerror – ticketSupport ticket submittedUnderlying error status is a system error

Feed StatusFeed StatusComment
activeHas items that still need ingestion status checkedDo not archive or delete
archiveAll items in the feed have finished processingArchive 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.