Интеграция ERP и MES

Эта страница — для инженера интеграции, подключающего Scalarcut к ERP, MES или контроллеру раскроечного стола.

Документ Factory MBOM попадает в ваши системы двумя путями:

• Экспорт из планировщика — пользователь Enterprise планирует в планировщике и нажимает кнопку Factory MBOM, чтобы скачать JSON и CSV.
• HTTP API — ваше промежуточное ПО получает тот же документ через конечную точку с ключом.

Оба дают одну и ту же схему scalarcut.factory_bom.v1.1; приведённое ниже соответствие применимо к обоим.

Выберите JSON или CSV

• JSON — полный документ: заголовок, детали, рецепты, расходные материалы, итоги и опциональный geometry. Используйте его, когда ваше промежуточное ПО умеет принимать структурированный JSON.
• CSV — только список деталей: плоские колонки, которые можно сразу загрузить в раскроечный стол или импортировать в таблицу. Упаковка, идентификаторы, нормы и итоги в CSV отсутствуют.

Оба описывают одну и ту же карту резов; CSV — это потерянная проекция деталей JSON.

Сопоставление полей

Поле Factory MBOM	Типичная цель в ERP / MES
schema	Замок версии контракта (закрепите на scalarcut.factory_bom.v1.1)
scene_id / project_id	Ключ производственного заказа / наряда
surface_id	Зона или линия (wall-a…wall-d, floor)
group_id	Стабильный ключ маршрутизации группы реза
letter	Человекочитаемая легенда карты резов для цеха
sku	Справочник материалов / артикул
w_mm / h_mm	Размеры реза для раскроечного стола
cut_type	Стратегия резки / рабочий центр
qty	Количество для группы
fragile	Флаг контроля качества / ручной обработки
cre_recycled / cre_parent	Прослеживаемость переработки до исходной плитки
is_l_cut	Маршрутизация L-реза
rates	Константы формул расходных материалов
totals.cut_qty	Сверка с заголовком карты резов чертежа
totals.boxes_to_order	Коробки к закупке

Идемпотентные выборки

Конечная точка — это GET с ETag. Опрашивайте с If-None-Match, чтобы повторный запрос без изменений возвращал 304, а не переобрабатывал документ. При загрузке в очередь рассматривайте комбинацию scene_id/project_id + ETag как ключ идемпотентности.

Выборка, а не отправка

Есть два пути доставки. Пользователь может экспортировать документ кнопкой в шапке планировщика (скачивает JSON + CSV). Для автоматизации ваше промежуточное ПО может выбирать документ через HTTP API по требованию — в этом релизе вебхук-отправки нет. Настройте опрос в своём темпе и опирайтесь на ETag.

Хрупкие резы

Рез ниже порога хрупкости 50 мм помечается fragile: true. Направляйте такие на ручную обработку, а не на машину, которая их сломает. Sliver Guard уже пытается перепривязать раскладки, чтобы избежать их; флаг — это финальная страховка.

Расходные материалы

Клей, затирка и грунтовка всегда присутствуют в rates и totals Factory MBOM — это противоположность корзине виджета интернет-магазина, где расходные материалы — опциональная строка корзины. Сопоставьте rates с константами ваших формул один раз; документ несёт вычисленные кг/л, поэтому пересчитывать их не нужно.

Сверка

totals.cut_qty должен равняться сумме qty деталей. При приёме документа сверяйте totals.cut_qty с заголовком карты резов чертежа для той же сцены. Любое расхождение означает, что раскладка изменилась между экспортом и приёмом — выберите снова перед запуском в производство.

Получение проекта по идентификатору

Ваше промежуточное ПО выбирает проект по его scene_id (или project_id) вместе с вашим Enterprise Key. Запрос ограничен вашим предприятием, поэтому вы получаете только собственные проекты. «Гаражный» фикстур — это публичный образец для проб интеграторов и панели Try MBOM API, а не единственный документ, который отдаёт конечная точка.