Notify marketplace of price update
This endpoint is used by sellers to notify marketplaces that the price has changed for one of their SKUs.
There is no request body in this call, indicating the new price value, for instance. It only notifies a specific marketplace (accountName) that a seller (sellerId) has changed the price of an SKU (skuId).
Marketplaces will then call the fulfillment endpoint provided in the seller registration form to get the updated price information.
Permissions
Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:
| Product | Category | Resource |
|---|---|---|
| Seller Register | Seller Administration | View Seller |
You can create a custom role with that resource or use one of the following predefined roles:
| Role | Resource |
|---|---|
| Seller manager | View Seller |
❗ Assigning a predefined role to users or application keys usually grants permission to multiple License Manager resources. If some of these permissions are not necessary, consider creating a custom role instead. For more information regarding security, see Best practices for using application keys.
Path parameters
Name of the VTEX account that belongs to the marketplace. The notification will be posted into this account.
Environment to use. Used as part of the URL.
A string that identifies the seller in the marketplace. This ID must be created by the marketplace and informed to the seller before the integration is built.
A string that identifies the seller's SKU that suffered the change. This is the ID that the marketplace will use for all references to this SKU, such as price and inventory notifications.
Headers
HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
Type of the content being sent.
Response
Accepted