Запрос информации об остатках

Запрашивает у магазина актуальную информацию об остатках товаров.

Запросы про каждый склад приходят приблизительно раз в час.

Отвечать нужно за 27 секунд. Если не успеть, Маркет пришлет запрос повторно. После нескольких безответных попыток передача остатков через POST stocks выключится.

В одном запросе приходит до 1000 SKU. Если товаров на складе больше, запросы с разными товарами приходят одновременно.

Request

POST

/stocks

Body

application/json

{
    "warehouseId": 0,
    "skus": [
        "string"
    ]
}

Name

Description

skus*

Type: string[]

Список ваших SKU товаров, для которых нужно передать информацию об остатках.

warehouseId*

Type: number<int64>

Идентификатор склада.

В ответе магазина должен быть указан тот же идентификатор.

Responses

200 OK

В ответе вам нужно передать Маркету актуальные остатки для всех запрошенных товаров.

Body

application/json

{
    "skus": [
        {
            "sku": "string",
            "warehouseId": 0,
            "items": [
                {
                    "count": 0,
                    "type": "FIT",
                    "updatedAt": "2022-12-29T18:02:01Z"
                }
            ]
        }
    ]
}

Name

Description

skus*

Type: StockDTO[]

Информация об остатках товаров, указанных в запросе Маркета.
Информация об остатках одного товара на одном из складов.

StockDTO

Информация об остатках одного товара на одном из складов.

Name	Description
items*	Type: StockItemDTO[] Информация об остатках товара на данном складе. Информация об остатках товара. Max items: `1` Min items: `1`
sku*	Type: string Ваш SKU товара. Min length: `1` Max length: `255` Pattern: `^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
warehouseId*	Type: integer<int64> Идентификатор склада. Узнать идентификатор склада вы можете в кабинете в разделе Логистика → Склады. Он указан в поле ID склада. Если вы работаете с общими остатками, вы можете получить идентификатор склада с помощью запроса GET businesses/{businessId}/warehouses или посмотреть его в кабинете — в левом нижнем углу нажмите на название своего бизнеса, перейдите на страницу Модули и API во вкладку Получение запросов от Маркета → Обновление данных об остатках товаров. Если вы отвечаете на запрос Маркета, указывайте тот идентификатор, что пришел в запросе.

StockItemDTO

Информация об остатках товара.

Name	Description
count*	Type: integer<int64> Количество доступного товара. Max value: `2000000000`
type*	Type: StockType Этот параметр пока не используется. Всегда передавайте одно значение — `FIT`. Enum: `FIT`, `ACTUAL`
updatedAt*	Type: string<date-time> Дата и время последнего обновления информации об остатках указанного типа. Формат даты и времени: ISO 8601 со смещением относительно UTC. Например, `2017-11-21T00:42:42+03:00`.

StockType

Этот параметр пока не используется — всегда передавайте значение FIT.

FIT — значение, которое нужно передавать всегда.
ACTUAL — значение, которое пока не используется.

Type	Description
StockType	Enum: `FIT`, `ACTUAL`

Была ли статья полезна?

Уведомление об отмене заказа покупателем (DBS)