Create strategy repricer API overview

If the seller does not wish to use the default strategy, they can quickly create custom strategies with the Create Strategy endpoint to apply to their items, and then set the rules needed to execute.

The Create Strategy endpoint accepts JSON object with repricerStrategy and strategy information.

The strategy information has: strategyType, adjustmentType, and adjustmentValue. The strategyType can be three types: BuyBox, Competitive Price, and External Price.

Input requirements

The following items are required in the request:

Buy box price – Adjusts your prices to meet or beat the winning Buy Box price. Although pricing is one of the key factors that help determine a Buy Box winner, Walmart analyzes all attributes of your item listing, such as inventory, delivery, and content, when deciding the Buy Box winner. This strategy will automatically adjust prices while keeping the same meet or beat margin.

For example, if the Buy Box price increases from $15.00 to $16.00 and you have established a rule to Beat By $0.20, then your price increases to $15.80. To make this strategy effective, assign items that have competition for the Walmart Buy Box.

External price – Adjusts your prices to meet or beat prices found on other sites. This strategy will automatically adjust prices while maintaining the same meet or beat by a set margin.

For example, if the external site price increases from $15.00 to $16.00 and you have established a rule to Beat By $0.20, then your price will increase to $15.80. To make this strategy effective, assign items that are offered on other marketplaces.

Competitive price – Adjusts your price to beat whichever price is most competitive for a customer between the Walmart Buy Box price or external price.This strategy will automatically adjust prices while maintaining the same meet or beat margin.

For example, if the lowest offer between the Buy Box or external price increases from $15.00 to $16.00 and you have established a rule to Beat by $0.20, then your price will increase to $15.80.

Adjustment value – This is the value by which you want your offer to beat other offers. A valid value can be any floating-point value greater than or equal to 0.

Adjustment type – This can be either UNIT or PERCENTAGE based on the value to be adjusted.

Enable – This is the value by which you have enable or disable your strategies. True is used to enable strategies whereas false is used to pause the strategies.

EnableRepricerForPromotion– This is the value by which you can add item which part of promotion to repricer. True is used to enable promotion items to be part of Repricer else False is used to not include promotion items as part of repricer.

RestoreSellerPriceWithoutTarget – This is the value by which you can restore your last submitted price when no competitive price is found. True is used to enable Repricing back to seller’s last submitted price if no competitive price is found else False is used for Repricer to stop auto-adjusting seller price if no competitive price is found. The default value of this parameter is taken as False if no value is provided.

MeetExternalPrice – This is the value by which you can Match the external price when it’s lower than the Buy Box price after applying your beat by amount. True value means that an enrolled item will beat the Buy Box by your specified Beat By amount, or you’ll be matching the external price, if the external price target is lower. False means that an enrolled item will only beat the Buy Box by your specified Beat By amount. The default value of this parameter is taken as False if no value is provided.

Error responses

The following table explains why request errors could occur. The table identifies error-causing conditions and associated error messages, codes, and sample responses.

Scenario(s)CriteriaError MessageStatusSample Response
Create/UpdateIf the strategy type is invalid. Valid Types are [Buy Box Price, Competitive Price, External Price]Invalid strategy type400{ “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Invalid strategy type”, “payload”: null }
Create/Updatef the adjustment type is invalid. Valid types are [UNIT, PERCENTAGE]Invalid strategy beat by type400{ “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Invalid strategy beat by type”, “payload”: null }
CreateIf the strategy name already existsStrategy name is duplicate400{ “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Strategy name is duplicate”, “payload”: null }
CreateWith the reserved strategy nameStrategy name is reserved by system400{ “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Strategy name is reserved by system.”, “payload”: null }
CreateCreating strategies more than the limit for the seller (200)Only up to 200 strategies are allowed to be created{ “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Only up to 200 strategies are allowed to be created.
“, “payload”: null }