Золотенков
Выпустить ключ

Остатки в разрезе партий

GET https://mrp.zolotenkov.ru/api/external/v1/batches

Требуемое право ключа: read:stock

Партии с номером, сроком годности и текущим остатком. Фильтр expires_before отвечает на вопрос «что просрочится в ближайший месяц», не обходя весь склад страницами: ?expires_before=2026-09-30.

По умолчанию отдаются только партии с ненулевым остатком — израсходованная партия остатком не является. Полную историю партий, включая расходованные, возвращает include_depleted=true.

Партии без срока годности (expiry_date: null) не попадают ни в expires_before, ни в expires_after: у них срока нет, и «истекающими» они не бывают.

Параметры запроса

  • limit целое число необязателен

    Сколько записей вернуть: от 1 до 200, по умолчанию 50

  • cursor строка необязателен

    Курсор из поля next_cursor предыдущего ответа. Без него чтение начинается сначала

  • item_id целое число необязателен

    Только партии этого товара — по всем его вариантам

  • item_variant_id целое число необязателен

    Только партии этого варианта. Номер варианта возвращает GET /products полем variants[].id

  • batch_number строка необязателен

    Точный номер партии

  • expires_before строка необязателен

    Срок годности не позже этой даты. Партии без срока годности в выборку не попадают

  • expires_after строка необязателен

    Срок годности не раньше этой даты. Партии без срока годности в выборку не попадают

  • include_depleted флаг необязателен

    Показать израсходованные партии с нулевым остатком. По умолчанию false

Ответы

  • 200 Страница партий с остатками и сроками годности
  • 400 Неразбираемое значение фильтра по дате или размера страницы
  • 401 Ключ не передан, недействителен или отозван
  • 403 У ключа нет права read:stock
  • 429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After