Offer setup by match

The offer setup by match feature lets you use the item setup information from an existing item in the Walmart catalog and set up your own offer by matching the existing item. Unlike a full item setup, offer setup by match requires only a small set of required attributes to submit the payload.

1. Use the Item Search API and Top Trending API requests to search for an item in the Walmart catalog.
2. To set up items that match existing items in Walmart.com, call POST /v3/feeds with feedType set to MP_ITEM_MATCH.
   For example: https://marketplace.walmartapis.com/v3/feeds?feedType=MP_ITEM_MATCH
3. Use the Offer Setup by Match schema and update the information as per the Setup by Match v4.2 schema for each item.
   The items are processed and checked to see if they already exist in the Walmart catalog. If a match is found, your item will be automatically set up and you won’t need to provide your own content.
4. Once the feed has been processed, the Feed Item Status API will return whether a match is found or not. If a match is not found or you want to provide your own content, use the Bulk Item Setup API request.

Example API request:

{ "MPItemFeedHeader": { "processMode": "REPLACE", "subset": "EXTERNAL", "locale": "en", "sellingChannel": "mpsetupbymatch", "version": "4.2" }, "MPItem": [ { "Item": { "sku": "00649081xxxxxx", "condition": "Pre-Owned: Fair", "mainImageUrl": "https://i5-qa.walmartimages.com/asr/549ecbe9-c874-475b-87d8-5e4cb19934ec.8f5d70e62bd0bb8abc6772c9ef1694e0.jpeg", "productIdentifiers": { "productIdType": "GTIN", "productId": "00469710xxxxxx" }, "ShippingWeight": 1, "price": 1 } } ]
}

As you can see in the above example, for items already in our catalog, fewer attributes are required than for new item setup. Only the attributes unique to your offering are required.

• SKU: The Stock Keeping Unit (SKU) of the item.
• Condition: Specify whether the condition of your item is New or one of the non-new closed list conditions. (Non-new conditions are available for program eligible sellers).
• Main Image URL is a conditionally required attribute for these conditions: Remanufactured, Pre-Owned: Like New, Pre-Owned: Good, Pre-Owned: Fair, or New with defects.
• Shipping Weight: The weight of the item.
• Price: The price of the item.

5. Submit the feed (item setup) using the POST Offer Setup by Match API request.
6. Follow steps 3 through 5 in the Item Management API overview section.