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

Прогноз остатков раздела «План»

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

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

Расчетный остаток каждой позиции по периодам горизонта — та же сетка, что видит человек на вкладке «План». Дефицит читается сравнением projected_stock со safety_stock: период, в котором расчетный остаток опустился ниже страхового запаса, и есть нехватка. Что по этому поводу заказать, отвечает GET /api/external/v1/plan/replenishment.

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

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

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

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

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

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

    Период сетки: weekly (по умолчанию) или monthly

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

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

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

    Считать по одному месту хранения. Номер отдает GET /storage-places

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

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

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

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

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

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

Ответы

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