Запрос информации об остатках
Запрашивает у магазина актуальную информацию об остатках товаров.
Запросы про каждый склад приходят приблизительно раз в час.
Отвечать нужно за 27 секунд. Если не успеть, Маркет пришлет запрос повторно. После нескольких безответных попыток передача остатков через POST stocks выключится.
В одном запросе приходит до 1000 SKU. Если товаров на складе больше, запросы с разными товарами приходят одновременно.
Request
POST
/stocks
Body
{
"warehouseId": 0,
"skus": [
"string"
]
}
Name |
Type |
Description |
warehouseId* |
number<int64> |
Идентификатор склада. В ответе магазина должен быть указан тот же идентификатор. |
skus* |
string[] |
Список ваших SKU товаров, для которых нужно передать информацию об остатках. |
Responses
200 OK
В ответе вам нужно передать Маркету актуальные остатки для всех запрошенных товаров.
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 склада. Если вы работаете с общими остатками, вы можете получить идентификатор склада с помощью запроса GET businesses/{businessId}/warehouses или посмотреть его в кабинете — в левом нижнем углу нажмите на название своего бизнеса, перейдите на страницу Настройки API во вкладку Получение запросов от Маркета → Обновление данных об остатках товаров. Если вы отвечаете на запрос Маркета, указывайте тот идентификатор, что пришел в запросе. |
items* |
Информация об остатках товара на данном складе.
|
StockItemDTO
Информация об остатках товара.
Name |
Type |
Description |
count* |
integer<int64> |
Количество доступного товара. |
type* |
Этот параметр пока не используется. Всегда передавайте одно значение —
|
|
updatedAt* |
string<date-time> |
Дата и время последнего обновления информации об остатках указанного типа. Формат даты и времени: ISO 8601 со смещением относительно UTC. Например, |
StockType
Этот параметр пока не используется — всегда передавайте значение FIT
.
FIT
— значение, которое нужно передавать всегда.ACTUAL
— значение, которое пока не используется.
Type |
Description |
Enum: |