Adding products to a promotion or changing their prices
The method is available for all models.
Not yet available for Market Yandex Go sellers.
If you are using an API Key token, one of the accesses in the list is required to call the method
- pricing — Manage prices
- promotion — Product promotion
- all-methods — Full account management
Adds products to the promotion or changes the prices of the products that participate in the promotion.
The changes begin to take effect within 4-6 hours. To find out if they have been applied, use the parameter processing in the method's response POST v2/businesses/{businessId}/promos.
| ⚙️ Limit: 10,000 requests per hour |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/promos/offers/update
Path parameters
|
Name |
Description |
|
businessId |
Type: integer Cabinet ID. To find out, use the request GET v2/campaigns. ℹ️ What is a cabinet and a store on the Market? Min value: |
Body
application/json
{
"promoId": "example",
"offers": [
{
"offerId": "example",
"params": {
"discountParams": {
"price": 1,
"promoPrice": 1
}
}
}
]
}
|
Name |
Description |
||||||||||
|
offers |
Type: object[]
Products that need to be added to the promotion or whose prices need to be changed. Min items: Max items: Example
|
||||||||||
|
promoId |
Type: string The ID of the promotion. Example: |
Responses
200 OK
The result of adding products to the promotion or updating their prices.
Body
application/json
{
"status": "OK"
}
Type: object
400 Bad Request
The request contains incorrect data. Learn more about errors when working with stocks
Body
application/json
{
"status": "OK"
}
Type: object
401 Unauthorized
The authorization data is not specified in the request. More information about the error
Body
application/json
{
"status": "OK"
}
Type: object
403 Forbidden
The authorization data is incorrect or access to the resource is prohibited. More information about the error
Body
application/json
{
"status": "OK"
}
Type: object
404 Not Found
The requested resource was not found. More information about the error
Body
application/json
{
"status": "OK"
}
Type: object
420 Method Failure
The resource access limit has been exceeded. More information about the error
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Internal error of the Market. More information about the error
Body
application/json
{
"status": "OK"
}
Type: object
pathParams:
- description: "Cabinet ID. To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n"
name: businessId
in: path
required: true
schema:
type: integer
format: int64
minimum: 1
searchParams: []
headers: []
body: |-
{
"promoId": "example",
"offers": [
{
"offerId": "example",
"params": {
"discountParams": {
"price": 1,
"promoPrice": 1
}
}
}
]
}
schema:
description: >
Adding products to a promotion or updating their parameters.
To add products to a promotion or update the parameters of some products,
pass them in the parameter `offers`.
type: object
required:
- promoId
- offers
properties:
promoId:
description: The ID of the promotion.
type: string
offers:
description: >-
Products that need to be added to the promotion or whose prices need to
be changed.
type: array
minItems: 1
maxItems: 500
items:
description: Description of the products that participate in the promotion.
type: object
required:
- offerId
properties:
offerId:
description: "Your SKU —\_the product ID in your system.\n\nUsage rules SKU:\n\n* For each product SKU there must be one.\n\n* Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.\n\nSKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\nSpaces at the beginning and end of the value are automatically deleted. For example, `\" SKU123 \"` and `\"SKU123\"` they will be treated as identical values.\n\n{% endnote %}\n\n[What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
type: string
pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
x-transform: trim
minLength: 1
maxLength: 255
params:
description: The parameters of the product that participates in the promotion.
type: object
properties:
discountParams:
description: >
Product parameters in the promotion with the type
`DIRECT_DISCOUNT` or
`BLUE_FLASH`.
A required parameter for stocks with these types.
type: object
properties:
price:
description: >
Crossed out price — the price at which the
product was sold before the promotion.
Indicated in rubles.
The number must be an integer.
type: integer
format: int64
minimum: 1
promoPrice:
description: >
Share price — the one you want to sell the
product at.
Indicated in rubles.
The number must be an integer.
type: integer
format: int64
minimum: 1
bodyType: application/json
method: post
security:
- type: apiKey
name: 'Api-Key'
in: header
- type: oauth2
x-inline: true
flows:
implicit:
authorizationUrl: https://oauth.yandex.ru/authorize
scopes:
market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/businesses/{businessId}/promos/offers/update
host: https://api.partner.market.yandex.ru
No longer supported, please use an alternative and newer version.
Цена, которая действует во всех магазинах.