Articles in this section

Migrate Walmart product flows to the ItemSpec 5.x template

Saikumar Rachamalla
Updated

Walmart replaced its ItemSpec 4.x API with the ItemSpec 5.x API for product listings, so Walmart product listing has moved out of the Walmart - NetSuite integration app into a separate template, Walmart - NetSuite Product Flow (ItemSpec 5.X). The template's NetSuite Item to Walmart Item Add/Update flow replaces the integration app's category-based product flows, NetSuite items to Walmart products (add) and (update), which are no longer supported after August 31, 2025. This article is for integration app users who list products with ItemSpec 4.x and need to install the template and migrate their product mappings to it.

How the template differs from the integration app product flows

  • Product types instead of categories: Mappings are organized by Walmart product type instead of product category, and the template supports more than 6,600 Walmart product types.
  • Separate template: The template is installed and managed outside the integration app, so it can be updated independently.
  • One flow for adds and updates: NetSuite Item to Walmart Item Add/Update exports an item to Walmart as a product whenever the item is created or updated in NetSuite, with branching for new listings and updates. New listings use their own mapper, which needs more fields, and updates use the existing mapped fields.
  • Mapper 2.0: Product-type-specific fields are in the Visible section, and attributes common to all products are in the Orderable section.
  • One store per template: If you sell in several Walmart stores, install the template once for each store.

Walmart supports product variants through variantGroupId (the equivalent of a matrix parent in NetSuite), variantAttributeNames (for example, Size and Color), and isPrimaryVariant (the variant shown by default). Map your NetSuite fields to match this variant structure.

Prerequisites: Make sure the latest Walmart - NetSuite integration app bundle is installed in NetSuite. Existing users get the bundle update automatically. New users install it manually; contact Celigo Support for help.

Install the template

  1. In integrator.io, go to Marketplace marketplace-icon.png.
  2. Search for Walmart - NetSuite Product Flow (ItemSpec 5.X), and install it. For details, see Install Walmart - NetSuite Product Flow (ItemSpec 5.X).

Configure the migration settings

  1. In the template, go to Settings > General.
  2. In Walmart - NetSuite integration app ID (for migration only), enter the integration ID of your Walmart - NetSuite integration app. You can find it in the integration app's URL. This setting is used only for the migration.
  3. In Walmart - NetSuite integration app Account ID or Name, which appears after you enter the ID, enter the account ID or name of the integration app's Walmart account. You can find the name in the integration app under Settings > General > Walmart Account Name.
  4. Select Save.

Run the migration flows

In the template, go to Flows > Migration (One-time). Turn on and run the three flows in this order:

  1. [Migration Step 1] Auto-configure Pre-requisites: Prepares the template and validates the migration settings.
  2. [Migration Step 2] Walmart Item Product Type to NetSuite Item's Walmart Product Type update: Gets your item listings from Walmart, matches them with NetSuite items, and writes the assigned product types back to NetSuite.
  3. [Migration Step 3] Migrate integration app Product flow to the template Product flow: Moves your category-based mappings from the integration app to the product-type-based structure, and links your saved searches to the new flow. Fields that can't be mapped, or are skipped, are logged in the execution log for you to review.

Switch to the template flow

  1. In the template, go to Flows > Product Sync, and turn on NetSuite Item to Walmart Item Add/Update.
  2. In the integration app, go to Flows > Product, and turn off (Deprecating on Aug 31, 2025) NetSuite items to Walmart products (add) and (Deprecating on Aug 31, 2025) NetSuite items to Walmart products (update).
  3. Review your mappings, and create the product type records in NetSuite that the ItemSpec 5.x model requires. Use the search in Mapper 2.0 to find fields.

Add product types

To add or change product types, edit the template's Product Types for listing setting, and then run the Add/Update attribute mappings for Product Types specified in Settings flow. Refresh the mapper to see the new product types.

Known limitations

  • Each template supports one Walmart store.
  • Some mappings need manual adjustment when there's no one-to-one match.
  • The template doesn't identify the required fields for each product type. Check them in Walmart Seller Central.