Інтеграції / ERP / JobBOSS²
Посібник з інтеграції JobBOSS² для календарного планування виробництва у SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити JobBOSS² від ECI до SkyPlanner APS. SkyPlanner обмінюється даними з JobBOSS² в обох напрямках через власні API компанії ECI:
- До SkyPlanner надходять Orders і Order Line Items, Order Routings, Estimates, Routings і матеріали, Work Centers, Employees, Company Calendar, Job Requirements та позиції замовлень на закупівлю.
- Планові дати початку й завершення передаються назад для кожного кроку Order Routing.
- За вашим вибором записи обліку часу операторів можуть передаватися назад як Time Ticket Details.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації JobBOSS² та підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно розробляти рішення на основі документованого REST API SkyPlanner (довідник API). Одне підприємство у США, що виготовляє продукцію на замовлення, вже пішло саме цим шляхом:
Інтерфейси інтеграції JobBOSS²
ECI публікує API для своїх виробничих систем разом зі специфікаціями OpenAPI на сайті документації виробничих API ECI. Для календарного планування важливі два з них:
- JobBOSS² API (v1). API на основі REST і JSON, призначений саме для JobBOSS². Дає змогу читати й записувати замовлення, Order Line Items, Order Routings, Estimates, Routings, матеріали, Job Requirements, Work Centers, Company Calendar, Employees, замовлення на закупівлю, Time Tickets і Time Ticket Details. За повідомленням ECI, він “is currently only supported for JobBOSS² hosted (Cloud) customers.” (наразі підтримується лише для клієнтів хмарної версії JobBOSS²).
- ECI ERP API (v2.1). Універсальний REST API для Deacom, M1 і JobBOSS². У JobBOSS² він охоплює виробничі завдання, їхні операції та матеріали, деталі та їхні операції, робочі центри, позиції замовлень на закупівлю й рядки табелів обліку часу. ECI зазначає: “the actual ERP database could be a cloud hosted ERP or on premises install,” (база даних ERP може бути розміщена у хмарі або локально), тож для локальної версії JobBOSS² використовують саме цей API.
Обидва API працюють за однаковими правилами: використовують вирази фільтрації на кшталт lastModDate[gte]=, параметри fields= і sort=, а також посторінкову вибірку через take і skip. Типове значення take — 200. “All dates submitted to the API are assumed to be in UTC.” (Усі дати, передані до API, вважаються заданими в UTC.)
Для обох API діє правило ECI: “All APIs must be activated by ECI before use.” (Перед використанням усі API має активувати ECI.) Заздалегідь зверніться до свого менеджера в ECI.
Автентифікація та доступ
- Користувачі API. Для інтеграції використовується обліковий запис користувача API, створений у консолі ECI Integration Engine Management Console. Цей обліковий запис визначає, до якого продукту, клієнта й бази даних спрямовуються виклики.
- Облікові дані клієнта OAuth 2.0. Ідентифікатор і секрет клієнта використовуються для отримання токена через відповідну кінцеву точку Authentication API. Далі кожен виклик містить
Authorization: Bearer [token]. - Права доступу. Надайте користувачеві API доступ лише до ресурсів, потрібних за наведеною нижче таблицею зіставлення.
На боці SkyPlanner автентифікація в REST API виконується за допомогою токена API (SkyPlanner Settings > API). Документація доступна у форматі Swagger/OpenAPI. Навчальний посібник з інтеграції допоможе виконати перші виклики.
Події та періодичне опитування
У документації жодного з API ECI вебхуки не описані. Дані з JobBOSS² отримують періодичним опитуванням: Order Line Items, Order Routings і позиції замовлень на закупівлю фільтрують за lastModDate від часу останнього запуску, а сторінки вибірки задають через take і skip. Частоту визначають для кожного підприємства: від разу на кілька хвилин для виробничих завдань до разу на годину для складських залишків.
SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тому зворотний запис даних запускається подіями.
Зіставлення даних
| Об’єкт JobBOSS² (ресурс JobBOSS² API) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Estimates (/estimates), матеріали (/materials) | Вироби, матеріали, структура виробу | JobBOSS² → SkyPlanner | Початкове завантаження, далі — у разі змін |
Routings (/routings): робочий центр, час налагодження, час циклу, чисельність бригади, верстати для виробничого завдання | Технологічні операції з тривалістю та часом налагодження | JobBOSS² → SkyPlanner | Початкове завантаження, далі — у разі змін |
Work Centers (/work-centers): кількість годин у зміні, робота у змінах від 1 до 3, робочі дні | Робочі центри, групи робочих центрів, показники ефективності | JobBOSS² → SkyPlanner | Початкове завантаження, далі — зрідка |
Company Calendar (/company-calendars), Employees (/employees) | Зміни, неробочі дні, персонал | JobBOSS² → SkyPlanner | Щодня або ведення змін у SkyPlanner |
Orders і Order Line Items (/order-line-items): номер виробничого завдання, строк виконання, пріоритет, кількість до виготовлення | Замовлення зі строками виконання та пріоритетами | JobBOSS² → SkyPlanner | Опитування кожні кілька хвилин |
Order Routings (/order-routings): операції виробничого завдання, стан, залишок годин | Виробничі завдання для кожної технологічної операції | JobBOSS² → SkyPlanner | Опитування кожні кілька хвилин |
Job Requirements (/job-requirements), позиції замовлень на закупівлю (/purchase-order-line-items) | Потреби в матеріалах, замовлення на закупівлю за датами поставки | JobBOSS² → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
Поля Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Планові початок і завершення, верстат та оператор для кожної операції | SkyPlanner → JobBOSS² | У разі зміни розкладу, через вебхук SkyPlanner |
| Time Ticket Details (POST): виробниче завдання, операція, робочий центр, працівник, час налагодження, час циклу, кількість готових і забракованих одиниць, час початку й завершення | Записи обліку часу та підтвердження операторів | SkyPlanner → JobBOSS² | За кожним підтвердженням або за зміну, якщо цю функцію обрано |
| Відсутні в JobBOSS² | Матриця часу переналагодження, інструменти з урахуванням обмеженої доступності, альтернативні верстати та працівники | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
Для локальної версії JobBOSS² ті самі об’єкти зчитуються через ресурси ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers і /purchase-order-lines, а записи обліку часу передаються до /timecard-lines.
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте Estimates, Routings, матеріали, Work Centers, Company Calendar і Employees. Ретельно продумайте зіставлення робочих центрів: робочий центр із чотирма токарними верстатами перетворюється на одну групу робочих центрів або чотири робочі центри, щоб SkyPlanner визначав послідовність робіт для кожного верстата.
2. Синхронізація виробничих завдань. Зчитайте відкриті Order Line Items разом із відповідними Order Routings, Job Requirements і відкритими позиціями замовлень на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки за замовленням на закупівлю та оновлює складські залишки, коли замовлення отримує статус Delivered. Пропускайте призупинені та закриті виробничі завдання.
3. Зворотний запис розкладу. Коли механізм планування розміщує або переміщує операцію, вебхук SkyPlanner запускає запит PATCH до /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Він задає estimatedStartDate і estimatedEndDate в UTC, а також workCenter і employeeCode, якщо SkyPlanner переніс операцію на інший верстат або призначив її іншому працівникові. Дати записуються в операції виробничих завдань, які вже відображаються у Whiteboard, Planning Board і Scheduling Advisor.
4. Підтвердження з виробництва. Оператори реєструють виконану роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують актуальність розкладу. Ви обираєте, чи передавати фактичний час назад до JobBOSS². Якщо так, кожне підтвердження перетворюється на Time Ticket Detail із часом налагодження, часом циклу та кількістю одиниць. Якщо ні, дані й надалі збираються в JobBOSS², а SkyPlanner зчитує перебіг виконання з Order Routings.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Estimates, Routings, кількості, строки виконання, стан виробничого завдання | JobBOSS² |
| Послідовність операцій, час початку й завершення, верстат та оператор для кожної операції | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів та операторів, альтернативні виробничі ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Талони обліку часу, відпуск матеріалів, надходження, калькуляція собівартості | JobBOSS²: дані вводяться безпосередньо в ній або передаються із записів обліку часу SkyPlanner |
Визначте одну систему, яка записуватиме дати операцій виробничих завдань. Для завдань, які планує SkyPlanner, перепланування у Whiteboard більше не потрібне: планувальники переміщують роботи у SkyPlanner, а дати передаються до JobBOSS².
Типові етапи проєкту
Зазвичай впровадження завершується протягом кількох тижнів від його початку. Перед цим перевірте розклад у межах 30-денного безкоштовного пробного періоду, використовуючи Work Centers, технологічні маршрути й відкриті виробничі завдання, експортовані з JobBOSS² у форматі CSV або Excel.
- Зіставлення. Узгодьте таблицю зіставлення, правила відповідальності за дані, частоту синхронізації та те, чи передаватимуться талони обліку часу назад.
- Доступ через ECI. Попросіть ECI активувати JobBOSS² API або ERP API та створити користувача API. Якщо маєте тестову компанію в ізольованому середовищі, проведіть перевірку на її даних.
- Початкове завантаження. Estimates, Routings, Work Centers, календар і працівники.
- Синхронізація виробничих завдань і замовлень на закупівлю. Періодичне опитування з фільтрами
lastModDate, посторінковим отриманням даних і повторними спробами. - Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або працівники.
- Зворотний запис розкладу. Запити PATCH до Order Routing, ініційовані вебхуками SkyPlanner, а також запис Time Ticket Details, якщо це передбачено.
- Паралельне тестування. Використовуйте SkyPlanner паралельно з поточною дошкою планування, порівнюйте дати й виправляйте основні дані.
- Запуск у роботу. Увімкніть зворотний запис, щойно дані збігатимуться.
Що врахувати під час інтеграції з JobBOSS²
- Хостинг чи локальне розгортання. JobBOSS² API призначений для клієнтів, які користуються хостингом. Локальні інсталяції використовують ERP API з іншим переліком ресурсів. Визначте спосіб підключення на кроці 1.
- UTC скрізь. API читає й записує час у UTC. Перетворюйте його на місцевий час підприємства, інакше запланований початок о 7:00 відображатиметься з неправильним часом.
- Що стоїть за робочим центром. Робочим центром може бути верстат, група верстатів, виробнича комірка або працівники. Кількість верстатів і чисельність бригади для кожної операції технологічного маршруту вказують SkyPlanner, скільки виробничих ресурсів потребує ця операція.
- Послуги підрядників. Операції, для яких замість робочого центру вказано постачальника, впливають на час виконання замовлення, а не на завантаження ваших потужностей. Моделюйте їх як операції, що враховують лише тривалість.
- Суміщені операції та робота без оператора. Операції технологічного маршруту можуть мати ознаки суміщення в часі або виконання без оператора. Передавайте обидві ознаки, щоб робота без присутності персоналу планувалася правильно.
- Одиниці часу. Час налагодження й час циклу мають власні одиниці вимірювання, а час у черзі — це очікування, а не машинний час. Перетворюйте одиниці під час імпорту, інакше всі значення тривалості будуть неправильними.
- Посторінкове отримання даних. За замовчуванням сторінка містить 200 записів. Використовуйте посторінкове отримання для кожного читання.
Хто налаштовує та підтримує інтеграцію з JobBOSS²
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в межах узгодженого переліку ресурсів і правил опитування. Кожне підприємство використовує JobBOSS² по-своєму, і ці особливості враховуються в налаштуваннях.
- Ваш партнер JobBOSS² може долучитися. Він знає ваші налаштування й разом із командою SkyPlanner може узгодити з ECI активацію API та створення користувача API.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner за допомогою токена API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Докладні відомості містить документація з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць за 5 робочих центрів зі щомісячною оплатою. Вартість інтеграції розраховується заздалегідь разом із тарифним планом, з урахуванням ваших процесів і потреб. Перегляньте ціни, матеріал про планування виробництва з урахуванням реальних потужностей у JobBOSS², сторінку JobBOSS², можливості SkyPlanner та розділ інтеграцій з ERP.
Виробники, які користуються SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
1 000+ виробничих замовлень плануються автоматично
«Ми по-новому контролюємо виробництво, а наше розуміння виробничих потужностей вийшло на зовсім інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся компанія бачить стан виробництва в реальному часі.
98%надійності поставок порівняно з приблизно 50% раніше
«SkyPlanner відіграє вирішальну роль у підтриманні нашої надійності поставок».
Hannu Lahtinen, керівний директор
KJH-Comp · Виготовлення виробів із листового металу та контрактне виробництво
Надійність поставок зросла з приблизно 50% і сягала 98%, а календарним плануванням тепер займається один керівник замість двох.
Поширені запитання
Чи має JobBOSS² API?
Так. ECI публікує JobBOSS² API та незалежний від продукту ERP API. Обидва використовують REST і мають специфікації OpenAPI. Для клієнтів на хостингу JobBOSS² API читає й записує замовлення, Order Routings, Estimates, Work Centers, замовлення на закупівлю та Time Tickets.
Як інтеграція проходить автентифікацію в JobBOSS²?
За допомогою облікових даних клієнта OAuth 2.0. ECI активує API, у Integration Engine Management Console створюється користувач API, а кожен запит містить токен Bearer.
Чи підтримує JobBOSS² вебхуки?
У документації API ECI вебхуки не описані, тому інтеграція опитує JobBOSS² з фільтрами lastModDate за розкладом, установленим для конкретного підприємства. Власні вебхуки SkyPlanner передають зміни розкладу одразу після їх внесення.
Як заплановані дати повертаються до JobBOSS²?
Для кожної операції виробничого завдання окремо. SkyPlanner оновлює кожен Order Routing запитом PATCH із полями estimatedStartDate і estimatedEndDate, а також workCenter і employeeCode, якщо операцію перенесено на інший верстат або призначено іншому оператору.
Що партнеру JobBOSS² варто пропонувати: ECI APS чи SkyPlanner?
SkyPlanner — якщо клієнт хоче за кілька тижнів запустити планування виробництва з урахуванням реальної доступності кількох видів виробничих ресурсів. ECI APS — це окреме доповнення на базі LYNQ. SkyPlanner підключається через власний JobBOSS² API компанії ECI, враховує в плані переналагодження, бригади, пристосування й матеріали та автоматично переплановує виробництво. Вартість — від 199 € на місяць.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Протягом безкоштовного пробного періоду на 30 днів можна працювати з кількістю робочих центрів до 20 та імпортувати дані з JobBOSS² у форматі CSV або Excel. Кредитна картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
