С 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.5,
  "skus": [
    "example"
  ]
}

Name

Description

skus

Type: string[]

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

Example
[
  "example"
]

warehouseId

Type: number

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

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

Responses

200 OK

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

Body

application/json
{
  "skus": [
    {
      "sku": "example",
      "warehouseId": 0,
      "items": [
        {
          "count": 0,
          "type": "FIT",
          "updatedAt": "2025-01-01T00:00:00Z"
        }
      ]
    }
  ]
}

Name

Description

skus

Type: StockDTO[]

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

Example
[
  {
    "sku": "example",
    "warehouseId": 0,
    "items": [
      {
        "count": 0,
        "type": "FIT",
        "updatedAt": "2025-01-01T00:00:00Z"
      }
    ]
  }
]

ShopSku

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

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

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

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

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

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

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

Type: string

Min length: 1

Max length: 255

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

Example: example

StockType

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

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

Type: string

Enum: FIT, ACTUAL

StockItemDTO

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

Name

Description

count

Type: integer

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

Min value: 0

Max value: 2000000000

type

Type: StockType

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

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

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

Enum: FIT, ACTUAL

updatedAt

Type: string<date-time>

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

Формат даты и времени: ISO 8601 со смещением относительно UTC. Например, 2017-11-21T00:42:42+03:00.

Example: 2025-01-01T00:00:00Z
Example
{
  "count": 0,
  "type": "FIT",
  "updatedAt": "2025-01-01T00:00:00Z"
}

StockDTO

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

Name

Description

items

Type: StockItemDTO[]

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

Min items: 1

Max items: 1

Example
[
  {
    "count": 0,
    "type": "FIT",
    "updatedAt": "2025-01-01T00:00:00Z"
  }
]

sku

Type: ShopSku

Ваш SKU товара.

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

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

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

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

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

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

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

Min length: 1

Max length: 255

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

Example: example

warehouseId

Type: integer

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

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

Если вы отвечаете на запрос Маркета, указывайте тот идентификатор, что пришел в запросе.
Example
{
  "sku": "example",
  "warehouseId": 0,
  "items": [
    {
      "count": 0,
      "type": "FIT",
      "updatedAt": "2025-01-01T00:00:00Z"
    }
  ]
}

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