Bulk item maintenance

Use the Bulk Item Setup API request for bulk item maintenance. Use the MP_MAINTENANCE feedType to do partial updates. The maintenance feed type has the same layout as the Item Setup specification and entries are submitted based on the product type, but an entire item setup payload submission is not needed for a partial update. Unlike a full item setup, the maintenance feed type requires only a small set of required attributes to submit the payload.

Item maintenance schema key points

Just like the item setup schema, the item maintenance schema consists of the MPItemFeedHeader, Orderable, and Visible sections.

The MPItemFeedHeader contains attributes that are applicable for all items in the submission. These headers are only completed once for the entire submission and are required.

The MPItem object is completed for each item submitted. It is an array, meaning the seller can include multiple items per submission. The MPItem object contains the Orderable and Visible schemas. Unlike the Item setup schema where there are large sets of required attributes, item maintenance requires only the SKU and GTIN attributes. The remaining attributes are optional in case you want to make updates to the existing content. If you leave an attribute blank, there will be no change to the content. If you fill out an attribute, it will be an update to replace the existing content.

Submissions for item maintenance should only include the specific sets of attributes from the Orderable and Visible schemas, which are intended to be updated.

To successfully maintain a GTIN Exempt item:
• Do not submit “CUSTOM” for Product ID and Product ID Type during Item Maintenance.
• Use the Get Item Details API to find the Walmart generated GTIN and add it to the item

NOTE: MP_MAINTENANCE feed type can be used to update item content for both Seller fulfilled and Walmart fulfilled items.

Example

{"title": "MPItemFeed", "properties": { "MPItemFeedHeader": { "type": "object", "definition": "Contains attributes applicable to the entire submission. Only required one time for the item(s) being maintained in the submission."}, "MPItem": { "minItems": 1, "definition": "This object is used to define each item being maintained as part of the submission.", "type": "array", "items": { "properties": { "Orderable": { "type": "object", "definition": "This section of the item maintenance schema contains the offer attributes that can be maintained during item maintenance. This section will contain required attributes such as SKU and Product ID.” {"productIdentifiers": {"type": "object",
"properties": {"productId": {
"type": "string",
"title": "Product ID",
"productIdType": {"type": "string",
"title": "Product ID Type",
"enum": ["ISBN","GTIN","UPC","EAN"]}},
"definition": "During Item Maintenance you must provide a valid Product ID and Product ID Type. If your item was created utilizing GTIN Exemption, you must provide the Walmart generated GTIN for maintenance request to process successfully, CUSTOM is not a valid entry during Item Maintenance.” "Visible": { "type": "object", "definition": "This section of the item maintenance schema contains the Product Types that can be selected during Item maintenance, and all of the relevant attributes that can be maintained." Please note not all attributes available during item creation are available in item maintenance. For example, you cannot change the Condition of the item once the item is setup.”, "properties": { "Product Type 1": "Animal Feed", "Product Type 2": "Tires"}}, }, "type": "string", "productSecondaryImageURL": { "type": "array", "title": "Additional Image URL", "minEntries": 1, "definition”: “Requirements such as minEntries are relaxed in item maintenance, so Sellers have the flexibility of submitting partial updates and not having to re-submit item content that was required to list the product.”

Item maintenance recommended steps

Use the An Item and All Items API requests to identify which items in the catalog are available for maintenance.
Use the Get Spec API request and select the MP_MAINTENANCE feed type.
Run the Bulk Item Setup API https://marketplace.walmartapis.com/v3/feeds request.
Select MP_MAINTENANCE from the feedType drop-down list.
- MP_MAINTENANCE is the fastest, and least error prone way to update item attributes after completing initial item setup.
- Maintenance specs require far fewer required attributes compared to a new item setup.
Complete the required information and submit the item maintenance update.
Use the Feeds APIs (AllFeedStatusesAPI, FeedItemStatusAPI, and GetFeedErrorReportAPI) to track the status of feed uploads and errors on any of the feeds.