Update an existing repricer strategy

Call this endpoint to modify and update a repricer strategy rule, name, amount, and unit for a given strategy. Additionally, you can pause a repricer strategy, enable items as part of promotions, restore seller prices, and match external prices for Buy Box strategies. You can perform the following actions:

  • Pause a strategy - To pause a strategy that has assigned items, set enabled to False.
  • Enable items as part of promotions - To enable item that are part of promotions, set enableRepricerForPromotion to True. Otherwise, set it to False.
  • Restore reseller price - To enable repricing an item back to the seller’s last submitted price if no competitive price is found, set the restoreSellerPriceWithoutTarget to True. The default value of this parameter is False.
  • Match external price for Buy Box strategy - For the Buy Box strategy type, to match the external price when it is lower than the Buy Box price, set MeetExternalPrice to True. Otherwise, set it to False.

Note: This page describes an example using only the required parameters and inputs to update an existing repricer strategy. For a full list of customization options and additional capabilities, refer to the Marketplace Pricing API Reference.

Endpoint

PUT https://marketplace.walmartapis.com/v3/repricer/strategy/{strategyCollectionId}

Sample request

This request updates the repricer strategy identified by strategyCollectionId with the provided configuration. It enables the strategy, sets various flags related to promotions and price restoration, and defines a specific pricing strategy to adjust the Buy Box price by a unit value of 1.2.

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/repricer/strategy/strategyCollectionId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "repricerStrategy": "Buy Box Strategy For testing", "enabled": true, "enableRepricerForPromotion": true, "restoreSellerPriceWithoutTarget": true, "enableBuyboxMeetExternal": true, "strategies": [ { "strategyType": "Buy Box Price", "adjustmentType": "UNIT", "adjustmentValue": 1.2 } ]
}
'
import requests
import json url = "https://marketplace.walmartapis.com/v3/repricer/strategy/strategyCollectionId" payload = json.dumps({ "repricerStrategy": "Buy Box Strategy For testing", "enabled": True, "enableRepricerForPromotion": True, "restoreSellerPriceWithoutTarget": True, "enableBuyboxMeetExternal": True, "strategies": [ { "strategyType": "Buy Box Price", "adjustmentType": "UNIT", "adjustmentValue": 1.2 } ]
})
headers = { 'accept': 'application/json', 'content-type': 'application/json',
} response = requests.request("PUT", url, headers=headers, data=payload) print(response.text) 

Modify your code

To modify your existing repricer strategy, update the necessary parameters in the request to reflect the changes you want. For example, you can:

  • Change the Strategy Name - Modify the repricerStrategy field to reflect a new name for the strategy.
  • Adjust the Price Change - If the adjustment value needs to change, simply update adjustmentValuewith a new number. For instance, increase the adjustment to $1.50 if you want a higher margin for the Buy Box.
  • Enable/Disable Features - Toggle the features by setting enabled, enableRepricerForPromotion, and other flags to true or false based on your requirements.

Sample response

Once the request is processed, the API updates the strategy and returns a unique strategyCollectionId, confirming successful implementation.

 { "repricerStrategy": "Buy Box Strategy For testing", "strategyCollectionId": "41678999-a088-4fd8-9eb4-55f8d8ed4ac8", "enabled": true, "enableRepricerForPromotion": true, "restoreSellerPriceWithoutTarget": true, "enableBuyboxMeetExternal": true, "strategies": [ { "strategyType": "Buy Box Price", "adjustmentType": "UNIT", "adjustmentValue": 1.2 } ]
}

Result

If successful, the API response returns an HTTP status: 200 OK with a JSON response.

  • Walmart’s repricer will adjust the product price dynamically to secure the Buy Box.
  • The adjustmentValue is set to 1.2, indicating that prices will adjust by $1.20.
  • The restoreSellerPriceWithoutTarget flag is set to true, ensuring the seller's last submitted price is restored if there is no competitor price.
  • The enableBuyboxMeetExternal flag is set to true, allowing external marketplace prices to be considered for competitive adjustments.

Error responses

The following table outlines the potential causes of request errors, including the corresponding error messages, codes, and sample responses.

Scenario(s)CriteriaError MessageStatusSample Response
Update/DeleteIf the strategy ID is InvalidStrategy ID not found400{ “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Strategy Id not found”,“payload”: null}
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/UpdateIf 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 }