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

Выпуск за период

GET https://mrp.zolotenkov.ru/api/external/v1/reports/production-summary

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

Один запрос вместо постраничной вычитки производственных заказов: сколько выпущено, во сколько это обошлось и сколько это заняло, сложенное по товару и по периоду. В срез попадают завершенные заказы по дате завершения.

Числа совпадают с разделом «Аналитика - Производство - Обзор затрат» того же тенанта за тот же период.

Ручка отнесена к дорогим операциям: она обходит все заказы периода вместе с их материалами и операциями. У обхода есть предел времени: срез, не уложившийся в него, отвечает 400 с просьбой сузить выборку.

Право read:manufacturing вместе с этой ручкой отдает наружу себестоимость выпуска (materials_cost, unit_cost).

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

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

    Первый день периода, календарная дата 2026-01-01, зона Europe/Moscow

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

    Последний день периода, включительно. Период не длиннее 366 суток, считая обе границы

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

    Нарезка периода: month (по умолчанию), week, day или total — весь период одной строкой на товар

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

    Только заказы этой производственной площадки

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

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

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

    Только товары этой категории

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

    Тип производственного заказа, как он отдается в GET /manufacturing-orders

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

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

Ответы

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