Set up item: Add your items from Walmart’s catalog

To set up items that match existing items in Walmart.ca / Walmart.com.mx , call < POST /v3/feeds> with feedType set to < MP_ITEM_MATCH>.

For example:

https://marketplace.walmartapis.com/v3/feeds?feedType=MP_ITEM_MATCH

Use the Item Setup by Match schema and update the information as per the Setup by Match v4.1 schema for each item. The items you submit will be 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.

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.

Item setup by match JSON schema

Download the Item Setup by Match API JSON schema:
CA_MP_ITEM_MATCH.JSON

Attribute Grouping	Attribute Key Name	Definition	Example Values	Valid Values	Requirement Level	Conditionally Required Fields
	sku	The string of letters and/or numbers a partner uses to identify the item. Walmart includes this value in all communications regarding item information such as orders.	TRVAL28726		Required
productIdentifiers	productIdType	UPC: GTIN-12, the 12-digit number including check-digit. If less than 12-digits, such as UPC-E which is 8-digits, add leading zeros up to 12-digits.; GTIN: GTIN-14, the 14-digit number including check-digit. If less than 14-digits add leading zeros up to 14-digits. ISBN: International Standard Book Number, the 10 or 13-digit number including check-digit.; EAN: GTIN-13, the 13-digit number including check-digit. If less than 13-digits add leading zeros up to 13-digits.		UPC; GTIN; ISBN; EAN	Required
productIdentifiers	productId	Alphanumeric ID that uniquely identifies the product. Used in conjunction with “Product ID Type”. NOTE: For GTIN-14 or UPC, include the check digit.	00123456781011		Required
	price	The price the customer pays for the product. Please do not use commas or currency symbols. Only 2 digits allowed after decimal point.	100.33		Required
	ShippingWeight	The weight (in pounds) including all of its packaging materials. Only 3 digits maximum allowed after decimal point.	5.255		Required
	condition	This refers to the state of an item, indicating its level of wear, prior use (if any), appearance, and overall quality. Availability of condition types may vary by product/category as well as by Seller eligibility per program. For more details, review this Help article: </ca-marketplace/docs/set-up-item-add-your-items-from-walmarts-catalog>.		New;New without box;New without tags;Remanufactured;Open Box;Pre-Owned: Like New;Pre-Owned: Good;Pre-Owned: Fair;New with defects	Required
	mainImageUrl	Image of the item is required for the following conditions: Remanufactured, Pre-Owned: Like New, Pre-Owned: Good, Pre-Owned: Fair, or New with defects. Main image of the item. File Format: JPEG (.jpg). Recommended Pixel Dimensions: 2200px x 2200px. Minimum Pixel Dimensions for Zoom 1500px x 1500px. Swatch Pixel Dimensions: 50px x 50px. Resolution: 300 ppi. Maximum file size: 5MB. Aspect Ratio: 1:1 (Square). Recommended File Naming: GTIN-14 digitImage URLs should end in an image file type (.jpg) to follow best practices. They must link to a public image file that loads as an image.			Conditionally Required	Conditionally Required when condition = Remanufactured, Pre-Owned: Like New, Pre-Owned: Good, Pre-Owned: Fair, New with defects
	productSecondaryImageURL	Secondary images of the item. File Format: JPEG (.jpg). Recommended Pixel Dimensions: 2200px x 2200px. Minimum Pixel Dimensions for Zoom 1500px x 1500px. Swatch Pixel Dimensions: 50px x 50px. Resolution: 300 ppi. Maximum file size: 5MB. Aspect Ratio: 1:1 (Square). Recommended File Naming: GTIN-14 digitImage URLs should end in an image file type (.jpg) to follow best practices. They must link to a public image file that loads as an image			Optional
	productCategory	Please select your Product Category from the drop down list. Product Category is used to organize and define products. Adding Product Category will have some improvements to the match rate of items.		Baby Transport;Movies;Carriers & Accessories;Footwear;Baby Furniture;Animal Health & Grooming;Video Projectors;Bedding;Baby Diapering, Care, & Other;Safety & Emergency;Animal Accessories;Beauty, Personal Care, & Hygiene;Grills & Outdoor Cooking;Tools & Hardware Other;Computers;Cycling;Food & Beverage;Land Vehicles;Watches;Tires;Music Cases & Bags;Cameras & Lenses;Baby Toys;Large Appliances;Building Supply;Animal Other;Electronics Cables;Funeral;TVs & Video Displays;Tools;Jewelry;Garden & Patio;Cases & Bags;Plumbing & HVAC;Ceremonial Clothing & Accessories;Optical;Sound & Recording;Gift Supply & Awards;Video Games;Electrical;Printers, Scanners, & Imaging;Hardware;Vehicle Parts & Accessories;Costumes;Vehicle Other;Electronics Accessories;Furniture;Optics;Decorations & Favors;TV Shows;Watercraft;Books & Magazines;Toys;Animal Food;Software;Sports & Recreation Other;Electronics Other;Office;Storage;Fuels & Lubricants;Other;Health & Beauty Electronics;Baby Food;Wheels & Wheel Components;Music;Clothing;Household Cleaning Products & Supplies;Art & Craft;Photo Accessories;Medical Aids & Equipment;Musical Instruments;Instrument Accessories;Medicine & Supplements;Home Decor, Kitchen, & Other;Computer Components	Optional
externalProductIdentifier	externalProductIdType	ASIN is the Amazon Standard Identification Number. It is the unique 10-digit sequence of letters and/or numbers		ASIN	Optional
externalProductIdentifier	externalProductId	Provide the ID for your “External Product ID Type”.	B002Z36VJE		Optional
stateRestrictions	stateRestrictionsText	Please select the level of restriction you are applying to your item, Illegal for Sale or Commercial. Illegal for Sale restrictions apply to items for sale in the United States of America which have a federal, state, and or local law/regulation. Commercial Restrictions apply to items for any reason out side of local or state laws. If your item does not have any Restriction please select None. If your item has a Commercial or Illegal for Sale Restrictions you must provide the States or Zip Codes which the item is Restricted in.		Commercial;Illegal for Sale;None	Optional
stateRestrictions	states	Please list all States in which your product must and/or should be prohibited from being sold. You MUST provide us a list of all States and Zip Codes where your product is prohibited or restricted from being sold due to a law, regulation, ordinance, etc. You MAY, at your discretion, provide Walmart a list of all States and Zip Codes where you prefer to prohibit your product from being sold. Please remember that it is your obligation to understand and inform Walmart of any laws, regulations, ordinances etc. that would prohibit or restrict your product from being sold in a specific State or Zip Code.	CA		Optional
stateRestrictions	zipCodes	Please list all Zip Codes where your product should not be sold for legal or commercial reasons. You have an obligation to notify Walmart of any Zip Codes where laws, regulations, ordinances etc. prohibit or restrict your product from being sold. At your discretion, you may also specify any Zip Codes where you prefer not to have your product sold for commercial reasons. Please be aware that placing a Zip Code restriction on a product will only restrict that product from being sold within that Zip Code. To restrict an entire State, please specify the State instead of using Zip Codes. While Maintaining a Zip Code Restriction please be aware that you are required to re-submit all restrictions which apply to your item. Adding a Single Value will remove any previous restriction which was originally placed on the item and only restrict the single value which was added.	94085, 94086, 94087, 72712, 72716		Optional
additionalProductAttributes	productAttributeName	Add an additional attribute not present in this template. Use camelCase for the name.	additionalAttributeName		Optional
additionalProductAttributes	productAttributeValue	Write your “Additional Product Attribute Value” to give a description or answer for your “Additional Product Attribute Name.” Together, these allow you to create your own descriptor that is not already in the taxonomy.	15″; 19mm; Yes; No		Optional
additionalOfferAttributes	additionalOfferAttributeName	Add an additional offer attribute not present in this template. Use camelCase for the name.	planetNames		Optional
additionalOfferAttributes	additionalOfferAttributeValue	Write your “Additional Offer Attribute Value” to give a description or answer for your “Additional Offer Attribute Name.” Together, these allow you to create your own descriptor that is not already in the taxonomy.	36418238480545		Optional