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 isrequired if existing promotion Information needs to be updated.	String	No	N/A
promotionSettingAction	Seller can select: - Create for promo creation. 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 serves two main purposes: - Delete All existing promotion: Sellers can use Replace All 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. This is a mandatory field for creating new promotions.	Double	Yes For creating new promotions	N/A
promotionPriceStartDateTime	The effective start date for a given promotion. Time should be specified in the UTC format. This is a mandatory field for creating new promotions or deletion of existing promotions.	String	Yes For creating new promotions/deleting existing promotions	N/A
promotionPriceEndDateTime	The effective end date for a given promotion. Time should be specified in the UTC format. This is a mandatory field for creating new promotions or deletion of existing promotions.	String	Yes For creating new promotions/deleting existing promotions	N/A

For more information about the promotional pricing, see our article.

JSON schema files

Price Management XSDs are available for download:

Price&PromotionJSON.zip