POST Bulk Item Setup and Maintenance by Product Type: Overview & Capabilities

The POST Bulk Item Setup and Maintenance by Product Type calls are all performed through Walmart's standard bulk async feed files. For more on bulk async feed files or to find the latest schema available, see the Feeds guide.

Select the needed JSON schema, depending on whether the supplier is creating new items for Walmart (item setup by product type) or maintaining currently set up items (item maintenance by product type). Feed files or specs vary depending on the channel in which the item is being set up to be sold. Each feed file contains all relevant attributes aligned to the standards displayed in the Walmart item style guides.

Item setup and maintenance by product type are available in JSON schema format. The planned implementation dates are listed in the following table.

The core setup capabilities include:

• Item Setup: Set up one or multiple items to sell through a defined channel
• Variant Group Creation: Create a group of items with a common variant to display on the site on one product page

The core maintenance capabilities include:

• Product Content and Site Experience: Manage basic item information, site dates and details, compliance and regulatory attributes, and category-specific attributes at the global trade item number (GTIN) level (selling channel agnostic)
• Supply Chain Maintenance: Manage trade items, item configuration details, and logistics and warehousing details (selling channel specific – DSV, Stores, Online Only)

How to Set Up Multiple Variants of an Item

Suppliers can set up multiple variants of a single item using the variant parameters in the POST Bulk Item Setup and Maintenance by Product Type call. The variant group attributes defined in the POST Bulk Item Setup call should only be used to set up variant groups of new items not yet in a supplier's catalog. Contact the appropriate Walmart merchant to edit or create variant groups for existing items.

Each item in a variant group should be set up as a separate item. For example, a curtain set that comes in two sizes and six colors should have a total of 12 individual items (SupplierItems), and they can all be included in the same submission. Each item should include the same variant group ID and the relevant variant group information (for example, the attribute on which the variant is based).

Variant group attributes include:

• variantGroupId: Identifies all of the items in a variant group. Different variant group IDs will be in different groups.
• isPrimaryVariant: Defines the default item on the Walmart.com item page. This is usually the top-selling item or the item with the most inventory.
• variantAttributeNames: Indicates which attributes vary within the group. Variant groups can vary by up to three attributes, such as size, color, and count per pack.

Example:

{ "SupplierItemFeedHeader": { "businessUnit": "WALMART_US", "locale": "en", "version": "2.0.20230221-12_22_32-api" }, "SupplierItem": [ { "Orderable": { "supplierId": "123456", "sku": "ABC123" }, "Visible": { "Toothpastes": { "productName": "Colgate Crest Toothpaste", "flavor": "Peppermint", "variantGroupId": "001960968586AX6", "isPrimaryVariant": "Yes", "variantAttributeNames": "flavor" } } }, { "Orderable": { "supplierId": "123456", "sku": "ABC1245" }, "Visible": { "Toothpastes": { "productName": "Colgate Crest Toothpaste", "flavor": "Spearmint", "variantGroupId": "001960968586AX6", "isPrimaryVariant": "No", "variantAttributeNames": "flavor" } } } ]
}