Item setup & maintenance

What are common issues during item setup?
Frequent errors include invalid GTIN/UPC lengths, conflicting titles/prices, and outdated item management schema versions. Always use the latest item management schema and ensure accurate product data.

For information about the latest item management schema version, refer to the Item Management API releases guide.

Additional requirements for item setup and maintenance

The following table notes some additional requirements to the item setup and maintenance process.

NoteDescription
Some item submissions require manual reviewCertain item setup and maintenance events require manual review and approval by a Walmart Associate.

The manual review extends the submission SLA beyond the usual 4 hour system processing time by an additional 24-72 hours.

To identify items in review, check the ingestionStatus field:"ingestionStatus": "IN_REVIEW"

If the item stays in review for more than 72 hours, contact your merchant.
Certain product types cannot be used in item setup and maintenance.The following product types cannot be used for item setup and maintenance:
  • Motorcycle and All-Terrain Vehicle (ATV) Accessories
  • Bath Spa Sets
  • Pendants and Charms
  • Shower and Bathtub Enclosures
  • Sushi Rolls
  • Shower Stalls and Bases
  • Maternity Belly Bands
You must include the GTIN for trade item hierarchy.You must include the global trade item number (GTIN) of the trade item (TI) hierarchy when updating the following: Each (EA), inner pack (PK), case (CA), pallet (PL), or dimensions (height, width, or depth/length).Example: In the following response sample, suppliers must include caseGTIN:{"case": { "caseGTIN": "00196096858236", "caseWidth": 28.33, "caseWeight": 15}}
You cannot update trade item hierarchy for items synchronized with the Global Data Synchronization Network (GDSN)Item maintenance includes the ability to update the trade item hierarchy dimensions (each, inner, case, and pallet) of the consumable and orderable global trade item number (GTIN) associated with the Walmart Item Number (WIN) setup.However, if the item is synchronized with GDSN, Walmart ignores all updates made to the trade item hierarchy.To identify items synchronized with GDSN, check the itemConfigurations.tradeItemSyncStatusCode field in the GET An Item (v4) call.