Price and promotional price management API overview (new)

The price is a fundamental building block for your listing on Walmart.com. You can use the price and promotional price management APIs to set up and manage the price and promotional price for a given item. The following rules apply to set the promotions:

The maximum number of promotions for a given item should not be more than 10.
The effective start date for a given promotion should be more than four hours from the current date and time.
You cannot cancel a promotion within four hours of the start time. If you want to cancel a promotion that is about to start, you should let it begin and then use the delete an item call.
A promotion end date cannot be before or equal to the promotion start date.
The end date of a given promotion should be within 180 days from the start date and time. Any promotions beyond 180 days will result in an error.
If a promotion’s start and end dates overlap with other promotions for the same item, it will result in an error.

When setting up price and/or promotional pricing on Walmart.com, seller needs to provide below information in API

Name	Description	Type	Required	Default
sku	SKU of an item for which Price/Promotion need to be setup or update	String	Yes	N/A
price	The Price customer pays for the product that would be showing on walmart.com	Double	No	N/A
msrp	Sellers can submit the MSRP for the SKU. After sellers submit MSRP, we will substantiate it and use it for strikethrough pricing calculation	Double	No	N/A
promoid	Promotion Id will be required if existing Promotion Information needs to be updated	String	No	N/A
promotionSettingAction	Seller can select: “Create” for promo creation Note if sellers would like to create promotion, they will need to fill in Promo Price and Promo Price Start Date and Promo Price End Date “Delete” to delete an existing promotion. Sellers would need to input the exact Promo Price Start Date and Promo Price End Date which match with an existing promotion in the system (note: sellers can refer to their existing promotion via promo report) “Replace All” serve for two main purposes Delete All existing promotion: sellers can use ReplaceAll to delete all existing promotions. Replace All existing promotions and create new promotions at the same time	String	Yes For setting up promotions	N/A
promotionPlacement	Seller can select “MAP Cart” to hide the price until customers click add to cart during checkout	String	No	N/A
promotionType	Sellers can select “Reduced” for temporary price reduction which lasts for a minimum of 14 days (e.g. during special merchandising events on Walmart.com) “Clearance” if an item has either reached end of its lifecycle or is being liquidated	String	No	N/A
promotionPrice	Promotion price that sellers would like to set for the SKU Note: This field is mandatory for creating new promotions	Double	Yes For creating new promotions	N/A
promotionPriceStartDateTime	The effective start date for a given promotion Note: This field is mandatory for creating new promotions or deletion of existing promotions and the time is in UTC time zone	String	Yes For creating new promotions/deleting existings promotions	N/A
promotionPriceEndDateTime	The effective end date for a given promotion Note: This field is mandatory for creating new promotions or deletion of existing promotions and the time is in UTC time zone	String	Yes For creating new promotions/deleting existings promotions	N/A

For more information about the promotional pricing, see Seller Help: Promotion Rules.

JSON schema files

Price Management XSDs are available for download:

Price&PromotionJSON.zip