С 31 декабря push-API методы будут недоступны. С 1 октября они могут работать нестабильно.

Пошаговая инструкция, как работать с остатками через API

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

Deprecated

Какой метод использовать вместо устаревшего

PUT v2/campaigns/{campaignId}/offers/stocks

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

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

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

В одном запросе приходит до 1 000 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[]

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

Min items: 1

Max items: 1

sku*

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

warehouseId*

Type: integer<int64>

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

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

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

StockItemDTO

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

Name

Description

count*

Type: integer<int64>

Количество доступного товара.

Min value: 0

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

No longer supported, please use an alternative and newer version.