Feeds

DSV /
Reference Guide

Feeds API Overview

Feeds are constructed to handle bulk functions. A feed consists of an HTTP request with an attached file. The attached file contains the XML representing the objects that need to be created or updated.

To use the 1P Supplier APIs, users need to upload the XML or Excel file that contains information about their request.

Once users upload the feeds, they can use the feed ID (feedId) to track the feed status and items statuses within those feeds.

Use the latest XML schema definition (XSD) to construct the XML payload for the supplier feed.

Feed Statuses

The API returns the feed status and items statuses as part of the feed. A processed feed can have the following status:

  • RECEIVED: The Walmart gateway received the feed, but the processing (asynchronous) has not yet started.
  • INPROGRESS: The element processing in the feed has begun, but is not yet completed.
  • PROCESSED: The element processing in the feed is complete. Nothing is implied about the status of the individual elements.
  • ERROR: The feed, as a whole, has failed. No elements within the feed were processed.

If a request returns a feed status of INPROGRESS, users should continue to call until they retrieve a different status. For item feeds, the recommended calling intervals are: 15 minutes, 1 hour, 2 hours, and every 4 hours.

Ingestion Statuses

The ingestion statuses are set at a per-object level.

  • DATA_ERROR: There is either a malformed XML error, or system data is missing. If the XML passes validation against the relevant XML schema definition (XSD) and the error persists, contact Walmart Partner Support.
  • SYSTEM_ERROR: A downstream Walmart system returned an error to an attempted operation during ingestion. If this error occurs, wait one hour and try again. If the error persists, contact Walmart Partner Support.
  • TIMEOUT_ERROR: A downstream Walmart system is not available during ingestion. If this error occurs, wait one hour and try again. If the error persists, contact Walmart Partner Support.
  • SUCCESS: The object was ingested successfully.
  • INPROGRESS: The ingestion is not complete.