Настройка размещения товаров в магазине
Изменяет параметры размещения товаров в конкретном магазине: доступность товара, условия доставки и самовывоза, применяемую ставку НДС.
| ⚙️ Лимит: 5000 товаров в минуту, не более 500 товаров в одном запросе |
|---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offers/update
Path parameters
|
Name |
Type |
Description |
|
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Body
{
"offers": [
{
"offerId": "string",
"quantum": {
"minQuantity": 0,
"stepQuantity": 0
},
"available": false,
"vat": 0
}
]
}
|
Name |
Type |
Description |
|
offers* |
Параметры размещения товаров в заданном магазине. |
UpdateCampaignOfferDTO
Параметры размещения товара в магазине.
|
Name |
Type |
Description |
|
offerId* |
string |
Ваш SKU — идентификатор товара в вашей системе. Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы Правила использования SKU:
Что такое SKU и как его назначать
|
|
quantum |
Настройка продажи квантами. Что это значит? |
|
|
available |
boolean |
Есть ли товар в продаже. |
|
vat |
integer<int32> |
Ставка НДС, применяемая для товара. Задается цифрой:
Если параметр не указан, используется ставка НДС, установленная в кабинете продавца на Маркете. |
QuantumDTO
Настройка продажи квантами.
Чтобы сбросить установленные ранее значения, передайте пустой параметр quantum.
{
"offers": [
{
"offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
"quantum": {}
}
]
}
|
Name |
Type |
Description |
|
minQuantity |
integer<int32> |
Минимальное количество единиц товара в заказе. Например, если указать 10, покупатель сможет добавить в корзину не меньше 10 единиц. ⚠️ Если количество товара на складе меньше заданного, ограничение не сработает и покупатель сможет его заказать. |
|
stepQuantity |
integer<int32> |
На сколько единиц покупатель сможет увеличить количество товара в корзине. Например, если задать 5, покупатель сможет добавить к заказу только 5, 10, 15, ... единиц товара. ⚠️ Если количество товара на складе не дотягивает до кванта, ограничение не сработает и покупатель сможет заказать количество, не кратное кванту. |
Responses
200 OK
Ответ 200 обозначает, что новые параметры получены Маркетом и скоро вступят в силу.
Body
{
"status": "OK"
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
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 |
Список ошибок. |
423 Locked
К ресурсу нельзя применить указанный метод.
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 |
Список ошибок. |