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

Дефициты и рекомендации к пополнению

GET https://mrp.zolotenkov.ru/api/external/v1/plan/replenishment

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

Перечень позиций, которых не хватит в горизонте планирования, и что по каждой сделать: заказать поставщику (buy), выпустить (make) или переместить с другого склада (transfer). Тот же расчет, что показывает вкладка «Пополнение» раздела «План»: интегратору не нужно считать дефицит заново по остаткам и заказам.

Позиция, у которой хватает всего, строкой не приходит. Строка с recommended_qty равным нулю — дефицит, уже покрытый открытым заказом; заказывать по ней ничего не надо, но и исчезать она не должна.

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

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

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

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

    all (по умолчанию), products — только изделия, materials — только материалы

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

    Сколько недель вперед считать: от 1 до 52

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

    Только дефициты этого места хранения

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

    Только позиции этой категории

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

    Подстрока названия или артикула, без учета регистра

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

    Подстрока названия поставщика: чем заказать у одного контрагента одной поставкой

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

    Учитывать статистический прогноз спроса по истории отгрузок. По умолчанию true

Ответы

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