Передача информации об остатках
Передает данные об остатках товаров на витрине.
Обязательно указывайте SKU в точности так, как он указан в каталоге. Например, 557722 и 0557722 — это два разных SKU.
Данные в каталоге обновляются не мгновенно
Это занимает до нескольких минут.
| ⚙️ Лимит: 100 000 товаров в минуту, не более 500 товаров в одном запросе с 1 марта 2024 года |
|---|
Request
PUT
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offers/stocks
Path parameters
|
Name |
Type |
Description |
|
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Body
{
"skus": [
{
"sku": "string",
"warehouseId": 0,
"items": [
{
"count": 0,
"type": "FIT",
"updatedAt": "2022-12-29T18:02:01Z"
}
]
}
]
}
|
Name |
Type |
Description |
|
skus* |
StockDTO[] |
Данные об остатках товаров.
|
StockDTO
Информация об остатках одного товара на одном из складов.
|
Name |
Type |
Description |
|
sku* |
string |
Ваш SKU товара. |
|
warehouseId* |
integer<int64> |
Идентификатор склада. Узнать идентификатор склада вы можете в личном кабинете в разделе Логистика → Склады. Он указан в поле ID склада. Если вы работаете с общими остатками, вы можете посмотреть идентификатор склада в личном кабинете в разделе Настройки → Настройки API в блоке Обновление данных об остатках товаров или с помощью запроса GET businesses/{businessId}/warehouses. Если вы отвечаете на запрос Маркета, указывайте тот идентификатор, что пришел в запросе. |
|
items* |
Информация об остатках товара на данном складе.
|
StockItemDTO
Информация об остатках товара.
|
Name |
Type |
Description |
|
count* |
integer<int64> |
Количество доступного товара. |
|
type* |
Этот параметр пока не используется. Всегда передавайте одно значение — |
|
|
updatedAt* |
string<date-time> |
Дата и время последнего обновления информации об остатках указанного типа. Формат даты и времени: ISO 8601 со смещением относительно UTC. Например, |
StockType
Этот параметр пока не используется — всегда передавайте значение FIT.
FIT— значение, которое нужно передавать всегда.ACTUAL— значение, которое пока не используется.
|
Type |
Description |
|
Enum: |
Responses
200 OK
Пустой ответ
Body
{
"status": "OK"
}
|
Name |
Type |
Description |
|
status |
Тип ответа. |
ApiResponseStatusType
Тип ответа.
|
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 |
Список ошибок. |