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
toFalse
. - Enable items as part of promotions - To enable item that are part of promotions, set
enableRepricerForPromotion
toTrue
. Otherwise, set it toFalse
. - 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
toTrue
. The default value of this parameter isFalse
. - 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
toTrue
. Otherwise, set it toFalse
.
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
adjustmentValue
with 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) | Criteria | Error Message | Status | Sample Response |
---|---|---|---|---|
Update/Delete | If the strategy ID is Invalid | Strategy ID not found | 400 | { “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Strategy Id not found”,“payload”: null} |
Create/Update | If the strategy type is invalid. Valid types are [Buy Box Price, Competitive Price, External Price] | Invalid strategy type | 400 | { “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Invalid strategy type”, “payload”: null } |
Create/Update | If the adjustment type is invalid. Valid types are [UNIT, PERCENTAGE] | Invalid strategy beat by type | 400 | { “status”: “BAD_REQUEST”, “errorMessage”: “Error(s) : Invalid strategy beat by type”, “payload”: null } |
Updated about 6 hours ago