Цены для продвижения товаров
Возвращает цены для продвижения товаров, которые вы размещаете на Маркете.
Товары, для которых нужно получить цены, передаются в теле POST-запроса.
Цены для продвижения зависят от цен, установленных на товары другими партнерами. Если один товар поставляют несколько партнеров, на Маркете сначала продается товар с более низкой ценой. Когда закончится товар по низкой цене, начнет продаваться товар по более высокой цене.
Выходные данные содержат для каждого товара несколько цен, соответствующих разным типам продвижения.
Установить цены на товары можно с помощью запроса POST campaigns/{campaignId}/offer-prices/updates или другими способами: например, указать их в файле с каталогом. Также вы можете использовать стратегии для автоматической установки рекомендованных цен или минимальных цен на Маркете.
В одном запросе можно получить цены не более чем для 1000 товаров.
Подробно об автоматическом управлении ценами рассказано в Справке для продавцов.
⚙️ Лимит: 100 000 товаров в час |
---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offer-prices/suggestions
Path parameters
Name |
Type |
Description |
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Body
{
"offers": [
{
"offerId": "string",
"marketSku": 0
}
]
}
Name |
Type |
Description |
offers* |
Список товаров. |
SuggestOfferPriceDTO
Товар, для которого требуется получить цены для продвижения.
Name |
Type |
Description |
offerId |
string |
Идентификатор предложения из прайс-листа.
|
marketSku |
integer<int64> |
SKU на Маркете. |
Responses
200 OK
Список цен для продвижения на Маркете
Body
{
"status": "OK",
"result": {
"offers": [
{
"marketSku": 0,
"offerId": "string",
"priceSuggestion": [
{
"type": "BUYBOX",
"price": 0
}
]
}
]
}
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
result |
Результат запроса цен для продвижения. |
SuggestPricesResultDTO
Результат запроса цен для продвижения.
Name |
Type |
Description |
offers |
Список товаров с ценами для продвижения. |
PriceSuggestOfferDTO
Товар с ценами для продвижения.
Name |
Type |
Description |
marketSku |
integer<int64> |
SKU на Маркете. |
offerId |
string |
Идентификатор предложения из прайс-листа.
|
priceSuggestion |
Цены для продвижения.
|
PriceSuggestDTO
Тип цены.
Name |
Type |
Description |
type |
Тип цены.
|
|
price |
number |
Цена в рублях. |
PriceSuggestType
Тип цены:
BUYBOX
— самая низкая цена на товар, по которой он продается сейчас. Эта цена обновляется в режиме реального времени. Если вы установите цену ниже, начнет показываться ваше предложение. Если для этого значения в параметреprice
указана цена, которая совпадает с вашей, значит, ваш товар уже показывается на витрине. Если кроме вас этот товар продают другие продавцы по такой же цене, их предложения также будут отображаться вместе с вашими по очереди.DEFAULT_OFFER
— рекомендованная Маркетом цена, которая привлекает покупателей. Рассчитывается только для популярных на сервисе товаров и обновляется раз в четыре часа.MIN_PRICE_MARKET
— минимальная цена на Маркете. Самая низкая цена среди всех предложений товара на Маркете во всех регионах, включая те, которые не видны на витрине. Эта цена обновляется в режиме реального времени и обеспечивает большее количество показов на Маркете, чем самая низкая или рекомендованная цена.MAX_DISCOUNT_BASE
— максимальная цена товара без скидки (старая цена), при которой он может быть показан со скидкой. Данная цена рассчитывается автоматически на основе SKU на Яндексе.
Примечание
Если цена типа MAX_DISCOUNT_BASE
не возвращается, скидка на товар не будет показана, так как для него еще не накопилась история цен.
MARKET_OUTLIER_PRICE
— максимальная цена товара, которая обеспечивает показы на Маркете. Если ваша цена выше указанной, товар будет скрыт, так как цена превышает рекомендованную Маркетом на 40% или больше.MAX_DISCOUNT_PRICE
— максимальная цена товара после применения скидки, при которой он будет показан на Маркете со скидкой.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Type |
Description |
code* |
string |
Код ошибки. |
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |