Articles in this section

Migrate from Walmart – NetSuite integration app (ItemSpec 4.x) to Template (ItemSpec 5.x)

Saikumar Rachamalla
Updated

Walmart is deprecating its ItemSpec 4.x API and requiring all sellers to adopt the enhanced ItemSpec 5.x API for product listings. To support this change, Celigo has introduced a new template-based flow—Walmart – NetSuite Product Flow (ItemSpec 5.X)—which replaces the category-based product flows in the integration app.

This document provides step-by-step guidance to migrate your existing product flow and mappings from the integration app to the new template-based product flow.

Target audience

  • Existing users of the Walmart – NetSuite integration app using ItemSpec 4.x

  • Customers preparing to migrate before the deprecation deadline: August 31, 2025

Prerequisites

The latest Walmart–NetSuite integration app bundle must be installed or updated.

  • For new users, manually install the bundle. Contact Celigo Support for assistance.

  • For existing users, Celigo will push an automatic update.

Step-by-step migration instructions

Step 1: Install the template

  1. Go to the Celigo Marketplace.

  2. Search for and install Walmart – NetSuite Product Flow (ItemSpec 5.X).

  3. For install steps, refer to: Install Walmart – NetSuite Product Flow (ItemSpec 5.X).

Step 2: Configure migration settings

  1. Go to Settings > General.

  2. In the Walmart - NetSuite integration app ID (for migration only) field, enter the integration ID of your existing Walmart - NetSuite integration app. This is required only during the integration app migration. You can find the app ID in the integration app URL.

    Note

    Once you fill the Walmart – NetSuite integration app ID (for migration only) field, the Walmart – NetSuite integration app Account ID or Name field will appear.

    Mig_Img1.png

  3. In the Walmart – NetSuite integration app Account ID or Name field, enter the Account ID or Account Name associated with your Walmart – NetSuite integration app. You can find this information in the integration app under Settings > General > Walmart Account Name.

  4. Click Save.

    Mig_Img2.png

Important

Each template supports one store. If you use multiple stores, install the template separately for each.

Step 3: Run migration flows

Go to Flows > Migration (One-time). The migration flow group contains three flows, each must be run in sequence

Mig_Img3.png
Flow 1: [Migration Step 1] Auto-configure Pre-requisites:  Turn on the Toggle and run the flow. Running this flow:

  • Prepares the environment and validates the input settings.

Flow 2: [Migration Step 2] Walmart Item Product Type to NetSuite Item’s Walmart Product Type update:  Turn-on the Toggle and run the flow. Running this flow:

  • Fetches item listings from Walmart.

  • Matches them with NetSuite items.

  • Writes back the assigned product types to NetSuite.

Flow 3: [Migration Step 3] Migrate integration app Product flow to the template Product flow Turn-on the Toggle and run the flow. Running this flow:

  • Transfers existing category-based mappings from the integration app to the new product-type-based structure.

  • Links saved searches to the new flow.

  • Any unmapped or skipped fields are logged in the execution log for manual review.

Post migration

Once migration is complete:

  1. Go to the Product Sync flow group in the template.

  2. Enable the flow titled NetSuite Item to Walmart Item Add/Update.

    Mig_Img4.png

  3. Disable the existing integration app flows:

    • (Deprecating on Aug 31, 2025) NetSuite items to Walmart products (add)

    • (Deprecating on Aug 31, 2025) NetSuite items to Walmart products (update)

      Mig_Img5.png

Understand the new flow

The NetSuite Item to Walmart Item Add/Update flow allows you to export an item from NetSuite into Walmart. Whenever an item is created or updated in NetSuite, the flow exports the details of that item as a product on Walmart. The flow:

  • Uses a single unified flow with branching logic for add vs. update.

  • Powered by Mapper 2.0 with:

    • Visible section for product-type-specific mappings

    • Orderable section for common attributes

  • Includes separate mappers for:

    • New listings (requires more fields)

    • Updates (uses existing mapped fields)

For more information about the new flow and settings, refer to Walmart - NetSuite Product Flow (ItemSpec 5.X).

Product variant support

Walmart supports variants through:

  • variantGroupId (equivalent to matrix parent in NetSuite)

  • variantAttributeNames (e.g., Size, Color)

  • isPrimaryVariant (shows the selected variant as the default)

NetSuite fields must be mapped to match Walmart’s variant structure.

Post-migration tips

  • Use the search option in Mapper 2.0 to quickly locate and review fields.

  • You can update or add new product types anytime by editing the Product Types for listing setting and rerunning the Add/Update attribute mappings for Product Typesspecified in Settings flow.

  • Refresh the mapper UI to see newly added product types after running the Add Attribute Mappings flow.

    Mig_Img6.png

Known limitations

  • Only one store per template.

  • Some mappings may require manual adjustment if no 1:1 match is found.

  • No immediate utility to identify required fields per product type, but you can reference Walmart Seller Central. A utility may be introduced later.

Important dates

The existing product flows in the integration app will no longer be supported after August 31, 2025. To ensure continued functionality, install the new template flow and complete your migration before this date.

Related resources