Золотенков

Движения остатка

GET https://mrp.zolotenkov.ru/api/external/v1/stock-movements

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

История движений остатка с фильтрами по изделию, месту хранения, виду документа и дате.

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

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

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

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

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

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

    Только движения этого изделия

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

    Только движения этого варианта изделия

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

    Только движения по этому месту хранения

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

    Каким документом вызвано движение

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

    Движения не раньше даты: date >= значение. ISO-8601 — дата 2026-08-01 (начало суток UTC) либо момент 2026-08-01T00:00:00Z

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

    Движения раньше даты: date < значение. ISO-8601 — дата 2026-08-01 (начало суток UTC) либо момент 2026-08-01T00:00:00Z

Ответы

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