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

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

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

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

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

Request

POST

/stocks

Body

application/json
{
    "warehouseId": 0,
    "skus": [
        "string"
    ]
}

Name

Description

warehouseId*

Type: number<int64>

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

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

skus*

Type: string[]

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

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

sku*

Type: string

Ваш SKU товара.


Min length: 1
Max length: 80
Pattern: ^[0-9a-zа-яА-ЯA-ZёËëЁ.,\\\/()\[\]\-=_]{1,80}$

warehouseId*

Type: integer<int64>

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

Узнать идентификатор склада вы можете в кабинете в разделе Логистика → Склады. Он указан в поле ID склада.

Если вы работаете с общими остатками, вы можете получить идентификатор склада с помощью запроса GET businesses/{businessId}/warehouses или посмотреть его в кабинете — в левом нижнем углу нажмите на название своего бизнеса, перейдите на страницу Настройки API во вкладку Получение запросов от МаркетаОбновление данных об остатках товаров.

Если вы отвечаете на запрос Маркета, указывайте тот идентификатор, что пришел в запросе.

items*

Type: StockItemDTO[]

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


Max items: 1
Min items: 1

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