Посібник з інтеграції Epicor Kinetic для календарного планування виробництва у SkyPlanner APS

Epicor зазначає: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Усі сервіси Kinetic, зокрема бізнес-об’єкти, процеси, звіти, BAQ та Epicor Functions, доступні через кінцеві точки REST.) Інтеграція для календарного планування спирається на чотири технології Epicor:

1. Kinetic REST API v2 (OData v4). Бізнес-об’єкти доступні як сервіси з іменами Erp.BO.<Name>Svc. Типовий шлях — /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 досі доступний, але вже застарілий, тому будуйте інтеграцію на v2. Уточніть набори сутностей і методи для своєї версії в REST Help за адресою /api/help/v2/.
2. Business Activity Queries (BAQ) через REST. BAQ доступний за адресою /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Це зручний спосіб отримувати дані для планування, об’єднуючи JobHead, JobOper, JobMtl, PartWhse і PORel за один виклик (приклад від спільноти).
3. Epicor Functions (EFx). Серверні функції, які можна викликати за адресою /api/v2/efx/{Company}/{Library}/{Function}. Epicor зазначає, що вони “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (можуть запускатися з різних точок входу, зокрема через BPM, REST-сервіси, за розкладом і за подіями застосунку).
4. Директиви BPM. Method Directives і Data Directives спрацьовують, коли змінюється виробниче завдання або технологічна операція, і можуть викликати функцію, яка надсилає дані назовні.

Для обміну файлами вхідний імпорт виконується через DMT, а вихідне вивантаження — через експорт BAQ. Epicor також пропонує Epicor Automation Studio, який описує як “a low-code app for integration-led automations” (low-code застосунок для автоматизації на основі інтеграцій). Не використовуйте прямий доступ до бази даних: REST, BAQ та функції працюють однаково в локальному розгортанні й у Kinetic Cloud.

Epicor не документує універсального API для вихідних вебхуків, тому зміни з Kinetic потрапляють до SkyPlanner одним із двох способів:

• За подіями. Директива BPM Data Directive для JobHead або JobOper викликає Epicor Function, яка надсилає змінене виробниче завдання до REST API SkyPlanner.
• Опитування за розкладом. BAQ із фільтром за датою зміни запускається кожні кілька хвилин або щогодини. Такий варіант простіше підтримувати й відновлювати після збоїв.

У зворотному напрямку SkyPlanner надсилає зміни стану та розкладу через свої вебхуки. Ваше проміжне ПЗ або кінцева точка EFx приймає їх і записує дані в Kinetic.

1. Початкове завантаження основних даних. Зчитайте номенклатуру, групи виробничих ресурсів, самі ресурси, їхні можливості, календарі та дані працівників. На основі ресурсів Kinetic створіть робочі центри SkyPlanner, а на основі груп ресурсів — групи робочих центрів. Великі обсяги даних зчитуйте посторінково за допомогою $top і $skip або завантажуйте масово через BAQ.

2. Синхронізація замовлень. Передавайте випущені та затверджені виробничі завдання разом з їхніми операціями й матеріалами. Отримуйте дерево завдання за допомогою GetDatasetForTree або BAQ, а не зчитуйте кожну сутність окремо. Незатверджені завдання MRP залишайте в Kinetic до їх затвердження. Одночасно зі зчитуванням складських залишків синхронізуйте відкриті графіки поставок за замовленнями на закупівлю та їхні терміни. SkyPlanner вважає замовлений матеріал доступним на дату поставки й оновлює залишки, коли замовлення на закупівлю отримує статус Delivered. Тому під час складання розкладу перевіряються як складські залишки, так і очікувані закупівлі.

3. Зворотний запис розкладу. Вебхук SkyPlanner надсилає плановий початок, завершення та робочий центр для кожної операції на кінцеву точку EFx (/api/v2/efx/{Company}/{Library}/{Function}). Функція записує дані через механізм календарного планування Kinetic — той самий бізнес-об’єкт, який забезпечує планування в Job Entry та на дошках планування (приклад від спільноти):

1. ScheduleEngine.GetNewParamsForJob формує набір даних виробничого завдання для механізму календарного планування.
2. Функція задає номер виробничого завдання, порядкові номери складальної одиниці та операції, а також планову дату й час початку, після чого викликає ScheduleEngine.MoveJobItem.
3. Якщо SkyPlanner призначив операцію іншому виробничому ресурсу в групі, ScheduleEngine.ChangeResource переносить її на цей ресурс. Сам по собі MoveJobItem залишає ресурс групи, заданий за замовчуванням.
4. Функція блокує розклад виробничого завдання (JobHead.SchedLocked, параметр Lock у Job Entry), завдяки чому Global Scheduling зберігає дати, визначені SkyPlanner.

Об’єднавши ці виклики в одну Epicor Function, ви забезпечите атомарний запис для кожного виробничого завдання й зможете додати власні перевірки. Якщо підприємство не хоче використовувати спеціально розроблену функцію, ту саму послідовність можна виконати прямими REST-викликами до Erp.BO.ScheduleEngineSvc. Ніколи не записуйте дані безпосередньо в ResourceTimeUsed або поля дат JobOper: це обхід механізму планування, через який розподіл ресурсів на дошках втрачає узгодженість.

4. Підтвердження виконання в цеху. Оператори реєструють роботу в SkyPlanner за допомогою Mobile Confirmations, Production Timer або Quick Log Mode. Кожен закритий запис обліку часу передається в Kinetic як запис трудовитрат через Erp.BO.LaborSvc: StartActivity і EndActivityByEmp — для роботи, що реєструється в реальному часі, або Labors з Update — для записів, внесених після виконання. Якщо на вашому підприємстві потрібне погодження, додайте submitForApproval до процесу обміну та області доступу.

5. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:

Для виробничих завдань, які планує SkyPlanner, увімкнено блокування розкладу, тому Global Scheduling не змінює їхні дати. Залиште планування в Kinetic для виробничих ресурсів, які не планує SkyPlanner.

Зазвичай впровадження завершується за кілька тижнів після початку роботи. Проєкт інтеграції з Kinetic охоплює:

1. 30-денне пробне використання на основі виробничих завдань, технологічних операцій і виробничих ресурсів, експортованих у CSV або Excel, ще до початку розробки.
2. Ключ API, область доступу, окремого користувача для інтеграції та BAQ, з яких інтеграція зчитує дані.
3. Зіставлення основних даних: виробничих можливостей, груп ресурсів, виробничих ресурсів, календарів і працівників із робочими центрами, групами, змінами та персоналом у SkyPlanner.
4. Початкове завантаження номенклатури, методів виготовлення (BOM і технологічних операцій) та виробничих ресурсів.
5. Синхронізація виробничих завдань і замовлень на закупівлю (терміни поставки з PORel), а також складських залишків із PartWhse.
6. Зворотний запис планових дат операцій через ScheduleEngineSvc (MoveJobItem, ChangeResource) в Epicor Function із блокуванням розкладу виробничого завдання.
7. Підтвердження виконання робіт у цеху передаються як записи трудовитрат через LaborSvc.
8. Тестування паралельно з поточним розкладом Kinetic, а потім запуск в експлуатацію.

Немає двох підприємств, які використовують Kinetic однаково. Технологічні маршрути на основі виробничих можливостей, календарі груп ресурсів, побудова BAQ, директиви BPM та методи зворотного запису для конкретних версій відрізняються на кожному майданчику. Від правильності їх налаштування залежить, чи довірятимуть планувальники розкладу, чи перероблятимуть його.

1. Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в експлуатацію. Команда зіставляє ваші виробничі ресурси, завдання та графіки поставок за замовленнями на закупівлю, налаштовує зчитування BAQ, тригери BPM і функцію зворотного запису. Вона з’єднує REST API та вебхуки SkyPlanner з Kinetic REST v2. Підтримка триває й тоді, коли змінюються ваші BAQ, BPM або версія Kinetic.
2. Ваш партнер Epicor. Партнери, які вже розробляють BAQ, BPM та Epicor Functions, можуть працювати з тим самим документованим REST API SkyPlanner. Він дає змогу читати й записувати замовлення, продукцію, матеріали, технологічні операції та записи робочого часу.
3. Ваші власні розробники. Внутрішні команди з досвідом роботи з Kinetic REST можуть створити інтеграцію безпосередньо або в Automation Studio, якщо ви його використовуєте. Для початку достатньо ключа API SkyPlanner (інструкція з інтеграції), а команда SkyPlanner допоможе за потреби. Документація продукту відкрита для всіх у розділі документації SkyPlanner.

Така сама схема з API та вебхуками вже працює в експлуатації з іншими ERP, наприклад у UTU. У Laboratory & Allied внутрішня ІТ-команда розробила інтеграцію із SAP Business One переважно власними силами за допомогою SkyPlanner.

Кожен варіант починається однаково: спершу скористайтеся 30-денним безкоштовним пробним періодом з імпортом CSV, перевірте розклад на практиці, а потім створюйте інтеграцію. Вартість — від 199 € на місяць за 5 робочих центрів, з щомісячною оплатою та можливістю скасування будь-коли. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із вартістю тарифного плану, тож ви бачите повну суму ще до початку роботи.