Установка цен на товары в конкретном магазине
Устанавливает цены на товары в магазине. Чтобы получить рекомендации Маркета, касающиеся цен, выполните запрос POST businesses/{businessId}/offers/recommendations.
Метод только для отдельных магазинов
Используйте этот метод, только если в кабинете установлены уникальные цены в отдельных магазинах.
Для управления базовыми ценами используйте POST businesses/{businessId}/offer-prices/updates.
Данные в каталоге обновляются не мгновенно
Это занимает до нескольких минут.
⚙️ Лимит: 5000 товаров в минуту |
---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offer-prices/updates
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Body
{
"offers": [
{
"offerId": "string",
"id": "string",
"price": {
"value": 0,
"discountBase": 0,
"currencyId": "RUR",
"vat": 0
},
"shopSku": "string"
}
]
}
Name |
Description |
offers* |
Type: OfferPriceDTO[] Список товаров.
|
OfferPriceDTO
Товар с информацией о новой цене на него.
Name |
Description |
offerId |
Type: string Идентификатор предложения.
|
id |
Type: string Этот параметр устарел. Не используйте его. Идентификатор предложения из прайс-листа. |
price |
Type: PriceDTO Цена с указанием скидки, валюты и времени последнего обновления. |
shopSku |
Type: string Этот параметр устарел. Не используйте его.
|
PriceDTO
Цена с указанием скидки, валюты и времени последнего обновления.
Name |
Description |
value |
Type: number Цена на товар. |
discountBase |
Type: number Цена на товар без скидки. Число должно быть целым. Вы можете указать цену со скидкой от 5 до 75%. Передавайте этот параметр при каждом обновлении цены, если предоставляете скидку на товар. |
currencyId |
Type: CurrencyType Валюта, в которой указана цена на товар. Возможно только значение
|
vat |
Type: integer<int32> Идентификатор ставки НДС, применяемой для товара:
Если параметр не указан, используется ставка НДС, установленная в кабинете. |
CurrencyType
Коды валют. Возможные значения:
BYR
— белорусский рубль.KZT
— казахстанский тенге.RUR
— российский рубль.UAH
— украинская гривна.
Type |
Description |
Enum: |
Responses
200 OK
Маркет принял информацию о новых ценах.
Body
{
"status": "OK"
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Description |
code* |
Type: string Код ошибки. |
message |
Type: string Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |
423 Locked
Возможны две причины такой ошибки.
- В кабинете используются основные цены, установить цену для отдельного магазина не получится.
- Магазин находится в процессе переноса в другой кабинет.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
status |
Type: ApiResponseStatusType Тип ответа.
|
errors |
Type: ApiErrorDTO[] Список ошибок. |