Получение остатков товаров

POST /v1/product/stock/info

POST/v1/product/stock/info

Для фильтрации по товару обязательно указать product_id или offer_id (достаточно одного поля; оба вместе не обязательны).

Тело запроса

filter
object
Фильтр. Если поле фильтра не передано, равно null или передан пустой массив [], фильтрация по этому полю не применяется. При одновременном указании нескольких фильтров условия объединяются по AND.
Показать свойства
product_id
array
Фильтр по идентификаторам товара (опционально). Обязателен, если не передан offer_id; достаточно указать одно из полей product_id или offer_id.
offer_id
array
Фильтр по артикулам продавца (опционально). Обязателен, если не передан product_id; достаточно указать одно из полей product_id или offer_id.
location_id
array
Фильтр по идентификаторам склада (опционально).
is_archived
boolean
Фильтр по архиву: true — только архивные, false — только неархивные (опционально).
cursor
string
Курсор начала отсчёта.
limit
integer
Размер страницы. min = 1; max = 300; default = 100.

Успешный ответ

200A successful response.
application/json
object
stocks
array
Элементы списка. Остатки с недоступными или несуществующими product_id в ответ не возвращаются.
Идентификаторы offer_id и product_id используются с приоритезацией. Если заполнены оба идентификатора, то используется только offer_id.
Показать свойства
product_id
string
Идентификатор товара.
offer_id
string
Артикул продавца.
location_id
string
Идентификатор склада.
count
integer
Остаток, загруженный продавцом (последнее переданное значение).
available_count
integer
Доступный остаток, вычисленный витриной.
next_cursor
string
Курсор начала отсчёта.
total
integer
Общее количество записей.

Ошибки

400Некорректный запрос
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
defaultОшибка (неожиданная или прочие)
application/json
object
error_type
string
ERROR_TYPE_BAD_REQUEST — HTTP 400 (request-level); ERROR_TYPE_UNAUTHORIZED — 401; ERROR_TYPE_RATE_LIMIT — 429; ERROR_TYPE_INTERNAL — 500. Поэлементные/бизнес-ошибки сущности — в HTTP 200 errors/failed, не здесь.
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNALERROR_TYPE_BAD_REQUEST
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/product/stock/info
1curl https://api.omninet.ru/v1/product/stock/info \2  --request POST \3  --header 'Content-Type: application/json' \4  --data '{5  "filter": {6    "product_id": [7      "string"8    ],9    "offer_id": [10      "string"11    ],12    "location_id": [13      "string"14    ],15    "is_archived": true16  },17  "cursor": "string",18  "limit": 019}'
{
  "stocks": [
    {
      "product_id": "string",
      "offer_id": "string",
      "location_id": "string",
      "count": 0,
      "available_count": 0
    }
  ],
  "next_cursor": "string",
  "total": 0
}

A successful response.