Інтеграції / ERP / HELIOS
Посібник з інтеграції HELIOS для календарного планування виробництва у SkyPlanner APS
Цей посібник з інтеграції HELIOS пояснює партнерам та ІТ-командам, як підключити HELIOS iNuvio та HELIOS Nephrite до SkyPlanner APS. SkyPlanner забезпечує двосторонній обмін даними з HELIOS через власні інтерфейси HELIOS:
- До SkyPlanner надходять виробничі замовлення (výrobní příkazy) з їхніми технологічними операціями, виготовлювані деталі, специфікації складу виробів (BOM), технологічні маршрути, робочі місця, верстати, професії, персонал, складські запаси та замовлення на закупівлю.
- Планові дати початку та завершення передаються назад у виробничі замовлення.
- За вашим вибором записи обліку часу операторів можуть передаватися назад як записи про виконання технологічних операцій (evidence výrobních operací).
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації HELIOS і підтримує її після запуску в експлуатацію. Цей посібник призначений для партнерів і розробників HELIOS, які хочуть долучитися до роботи або самостійно розробляти інтеграцію на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco описує його як окрему частину HELIOS iNuvio, яка надає доступ через REST API до функціональних розділів HELIOS iNuvio (довідка Helios Inuvio Server). Він входить до дистрибутива iNuvio, а специфікацію OpenAPI опубліковано у форматах Rapidoc і Redoc. API працює з табличними оглядами HELIOS (browses), кожен з яких має власний ID та права доступу:
- GET /browses/list і GET /browses/meta повертають перелік доступних оглядів та їхніх стовпців.
- /browses/data зчитує рядки огляду, а також записує їх, якщо огляд дозволяє створення, оновлення та видалення.
- /api/v1/actions/meta і /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} запускають зовнішні дії в огляді. Наразі підтримуються зовнішні дії типів Procedure, Browse і Plugin.
Планувальник використовує виробничі огляди, що містять план виробництва (výrobní plán), виробничі замовлення (výrobní příkazy), деталі виробничих замовлень, матеріали й напівфабрикати для виробництва, професії, персонал, попередні налаштування технологічних операцій маршруту та записи про їх виконання. Так само доступні складські запаси, надходження, відпуск зі складу та оформлені замовлення на закупівлю (vydané objednávky).
HELIOS Nephrite REST API. У плані розвитку Nephrite передбачено розробку REST API (план розвитку HELIOS Nephrite). Під час визначення обсягу проєкту команда SkyPlanner разом із вами та вашим партнером HELIOS уточнює кінцеві точки Nephrite для вашої інсталяції. Описані нижче потоки даних залишаються незмінними.
Excel і CSV. Кожен огляд HELIOS можна експортувати до Microsoft Office. Цього достатньо для пробного завантаження даних.
Автентифікація та ліцензування
- Два способи автентифікації. iNuvio пропонує старіший власний API автентифікації (/api/token) та новіший API OAuth2 на основі RFC 6749 (/oauth/token, /oauth/revoke). Токени оновлюються через POST /oauth/token або GET /api/token.
- Ліцензування. Сам Helios Inuvio Server безкоштовний, а REST API потребує ліцензії. Починаючи з версії 3.0.2026.0301, системний API та API функціональних розділів об’єднано в єдиний Inuvio REST API, а доступ до API більше не обмежується кількістю користувачів.
- Права доступу. Користувачу інтеграції потрібні права на читання виробничих і складських оглядів та на запуск узгоджених зовнішніх дій.
На боці SkyPlanner для автентифікації в REST API використовується токен API в заголовку Authorization-Token (SkyPlanner Settings > API). Документація доступна у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші виклики.
Події та періодичне опитування
SkyPlanner зчитує дані з HELIOS за розкладом. Виклики /browses/data з фільтрами за відкритими виробничими замовленнями й останніми змінами дають змогу отримувати нові завдання. Частоту задають для кожного підприємства: від опитування кожні кілька хвилин для виробничих замовлень до щогодинного — для складських запасів.
SkyPlanner надсилає вебхуки при зміні стану або графіка, тому зворотний запис даних запускається подіями.
Зіставлення даних
| Об’єкт HELIOS (огляд) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
| Картки номенклатури та виготовлювані деталі (vyráběné dílce), одиниці виміру | Вироби та матеріали | HELIOS → SkyPlanner | Початкове завантаження, далі — періодичне опитування |
| Специфікації складу виробів (BOM) (kusovník, kusovníkové vazby) з датами дії | Структура виробу, складові вироби, матеріали для кожного виробу | HELIOS → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Технологічні маршрути (technologický postup): технологічна операція, робоче місце, час підготовки верстата й оператора, штучний час, завершальний час, міжопераційний час | Етапи процесу з тривалістю, часом підготовки та завершальних робіт | HELIOS → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Робочі місця (pracoviště), верстати (stroje), альтернативні робочі місця | Робочі центри, групи робочих центрів, альтернативні робочі центри | HELIOS → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Професії (výrobní profese), персонал (výrobní personální zdroje) | Персонал і кількість операторів для кожного виробничого завдання | HELIOS → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Календарі планування (plánovací kalendáře) | Зміни та неробочі дні | HELIOS → SkyPlanner | Щодня або окреме ведення змін у SkyPlanner |
| Виробничі замовлення (výrobní příkazy), їхні деталі й технологічні операції, матеріали для виробництва | Замовлення та виробничі завдання зі строками виконання й потребами в матеріалах | HELIOS → SkyPlanner | Опитування кожні кілька хвилин |
| Складські запаси (stav skladu) | Складські залишки | HELIOS → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Оформлені замовлення на закупівлю (vydané objednávky) з датами поставки | Замовлення на закупівлю, очікувані надходження матеріалів за датами поставки | HELIOS → SkyPlanner | Опитування щогодини або під час розрахунку графіка |
| Плановий початок і завершення кожної технологічної операції виробничого замовлення (зовнішня дія) | Плановий початок і завершення кожного виробничого завдання | SkyPlanner → HELIOS | При зміні графіка, через вебхук SkyPlanner |
| Записи про виконання технологічних операцій (evidence výrobních operací) | Записи обліку часу та підтвердження операторів | SkyPlanner → HELIOS | Після кожного підтвердження або за кожну зміну, якщо передавання ввімкнено |
| Відсутнє в HELIOS | Матриця часу переналагодження, інструменти як обмежені виробничі ресурси, виробничі завдання для кількох операторів | Ведеться у SkyPlanner | Налаштовується під час впровадження |
Сценарії інтеграції
1. Початкове завантаження основних даних. Зчитайте з оглядів TPV виготовлювані деталі, специфікації складу виробів (BOM), технологічні маршрути, робочі місця, верстати, професії, персонал і календарі. Кожен виробничий ресурс HELIOS має ознаку включення до планування виробничих потужностей, тому визначте для кожного ресурсу, чи плануватиме його SkyPlanner. Робоче місце з чотирма верстатами стає однією групою робочих центрів або чотирма робочими центрами.
2. Синхронізація замовлень. Зчитайте виробничі замовлення з їхніми деталями, технологічними операціями та матеріалами, а також оформлені замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки із замовлення на закупівлю та оновлює складські залишки, коли це замовлення отримує статус Delivered. Плануйте виробничі замовлення, випущені у виробництво. Планові обсяги виробництва залишаються в плані HELIOS, доки на них не створять виробничі замовлення.
3. Зворотний запис графіка. Коли механізм планування розміщує або переміщує виробниче завдання, вебхук SkyPlanner через /api/v1/actions/execute запускає зовнішню дію в огляді виробничих замовлень. Ця дія — процедура HELIOS, узгоджена під час визначення обсягу проєкту. Вона задає плановий початок і завершення технологічної операції замовлення. HELIOS перевіряє зміну за власною логікою.
4. Підтвердження виконання в цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують актуальність графіка. Ви вирішуєте, чи передавати фактичний час назад у HELIOS. Якщо так, зовнішня дія зберігає його в записах про виконання кожної технологічної операції замовлення. Якщо ні, оператори й далі звітують через термінали HELIOS, а SkyPlanner зчитує ці записи.
5. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, специфікації складу виробів (BOM), технологічні маршрути, кількості, статус замовлення | HELIOS |
| Послідовність операцій, час початку й завершення, призначення верстатів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів та операторів, альтернативні ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Записи про виконання технологічних операцій, відпуск і надходження матеріалів | HELIOS: введення безпосередньо в системі або передавання із записів обліку часу SkyPlanner |
Визначте одну систему, яка записуватиме дати замовлень. Якщо функція планування виробничих потужностей HELIOS або Nephrite APS досі записує дати, вимкніть цю можливість для замовлень, які планує SkyPlanner, або використовуйте план HELIOS лише як тестовий.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від початку робіт. Перед цим перевірте графік у межах 30-денного безкоштовного пробного періоду, використовуючи робочі місця, технологічні маршрути та відкриті виробничі замовлення, експортовані з HELIOS у CSV або Excel.
- Зіставлення даних. Зафіксуйте таблицю зіставлення, правила відповідальності за дані, частоту синхронізації та рішення щодо зворотного запису даних про виконання технологічних операцій.
- Доступ до HELIOS. Налаштуйте Helios Inuvio Server, користувача інтеграції, облікові дані OAuth2 та ліцензування REST API. Спочатку проведіть тестування на копії бази даних.
- Початкове завантаження. Виготовлювані деталі, специфікації складу виробів (BOM), технологічні маршрути, робочі місця, верстати, професії, календарі.
- Синхронізація виробничих замовлень і замовлень на закупівлю. Опитування з фільтрами, посторінковим отриманням даних і повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або персонал.
- Зворотний запис графіка. Створіть і перевірте зовнішні дії для планових дат, а якщо вирішено передавати записи про виконання технологічних операцій — також для цих записів.
- Паралельне тестування. Плануйте в SkyPlanner, водночас продовжуючи працювати за поточним планом. Порівнюйте дати й виправляйте основні дані.
- Запуск в експлуатацію. Увімкніть зворотний запис, коли дані узгоджені.
Що врахувати під час інтеграції з HELIOS
- Ознаки участі в плануванні. Лише виробничі ресурси, позначені для планування виробничих потужностей, мають достовірні дані про потужність. Перед першим завантаженням перевірте ці ознаки для робочих місць, верстатів, професій і субпідрядних робіт.
- Одиниці часу. Підготовчий, штучний і завершальний час можуть бути задані в годинах, хвилинах або секундах. Перетворіть одиниці під час імпорту, інакше всі значення тривалості будуть неправильними.
- Міжопераційний час. Постійний міжопераційний час — це очікування між технологічними операціями, а не час роботи обладнання. Моделюйте його як очікування, а не як завантаження потужностей.
- Субпідрядні операції (kooperace). Час транспортування враховується в обидва боки. Моделюйте субпідрядні роботи як етапи, для яких враховується лише тривалість.
- Огляди з можливістю запису. Усі огляди підтримують читання, але лише деякі — створення, оновлення та видалення. Запит GET /browses/list із фільтром browseCreateImplemented=1 показує, які саме. Огляди виробничих замовлень доступні лише для читання, тому заплановані дати передаються назад через узгоджену зовнішню дію.
Хто налаштовує та підтримує інтеграцію з HELIOS
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в межах узгоджених оглядів і зовнішніх дій. Кожне підприємство використовує HELIOS по-своєму, і ці особливості враховуються в роботі.
- Ваш партнер HELIOS може долучитися. Партнер знає вашу інсталяцію, спеціально розроблені процедури та умови ліцензування й може налаштувати Helios Inuvio Server і зовнішні дії разом із командою SkyPlanner.
- Ваші розробники можуть розвивати інтеграцію через REST API SkyPlanner, використовуючи токен API. Щоб почати, достатньо токена API, а команда SkyPlanner допоможе за потреби. Документація доступна в розділі документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць за щомісячної оплати, з 5 робочими центрами в комплекті. Вартість інтеграції визначається заздалегідь разом із тарифним планом, з урахуванням ваших процесів і потреб. Перегляньте ціни, матеріал про планування виробництва з HELIOS з урахуванням реальних потужностей обладнання та персоналу, сторінку HELIOS та розділ інтеграцій з ERP. Основи викладено в матеріалі про календарне планування виробництва.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менше ніж 30 хвилин.
1 000+виробничих замовлень плануються автоматично
«Ми тепер зовсім інакше контролюємо виробництво, а наше розуміння виробничих потужностей вийшло на абсолютно інший рівень».
Ганну Рююнянен, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся компанія бачить стан виробництва в реальному часі.
100%надійності поставок із 2021 року
«SkyPlanner дає нам чітке уявлення про виробничі потужності та робить планування передбачуваним».
Дан Берглунд, COO/CFO
Opes Corporation · Хімічне та харчове виробництво
Надійність поставок становить 100% протягом усього часу використання SkyPlanner — із 2021 року.
Поширені запитання
Чи має HELIOS API для виробничих замовлень?
Так. Helios Inuvio Server надає REST-доступ до оглядів HELIOS iNuvio, зокрема до виробничого плану, виробничих замовлень, деталей замовлень, матеріалів для виробництва та записів технологічних операцій. Для HELIOS Nephrite команда SkyPlanner разом із вами та вашим партнером HELIOS визначає спосіб інтеграції для вашої інсталяції під час визначення обсягу впровадження.
Як SkyPlanner отримує зміни з HELIOS?
SkyPlanner опитує огляди HELIOS за розкладом, установленим для кожного підприємства, відбираючи відкриті виробничі замовлення та останні зміни. Власні вебхуки SkyPlanner передають зміни графіка одразу після їх появи.
Як заплановані дати повертаються в HELIOS?
Через зовнішню дію в огляді виробничих замовлень, яка запускається за допомогою /api/v1/actions/execute. Ця дія — процедура HELIOS, узгоджена під час визначення обсягу, тому HELIOS застосовує власну логіку до кожної отриманої дати.
Яку автентифікацію використовує Inuvio REST API?
OAuth2 відповідно до RFC 6749 через /oauth/token або старіший власний механізм через /api/token. Власний API SkyPlanner використовує токен API в заголовку Authorization-Token.
Що партнеру HELIOS варто пропонувати: HELIOS APS чи SkyPlanner?
SkyPlanner — якщо план клієнта часто змінюється й має враховувати реальні обмеження виробничих потужностей. У HELIOS планування ґрунтується на розрахунках для одного активного плану. Щоб дотриматися запланованих дат, система може перейти в режим планування без обмежень потужностей, а розв’язання конфліктів залишає планувальнику (довідка HELIOS). SkyPlanner підключається через REST API, автоматично переплановує виробництво, планує переналагодження, використання інструментів, роботу бригад і потреби в матеріалах та не обмежує кількість користувачів — від 199 € на місяць.
Чи можна протестувати SkyPlanner до створення інтеграції?
Так. Безкоштовна 30-денна пробна версія підтримує до 20 робочих центрів з імпортом даних із HELIOS у форматі CSV або Excel. Банківська картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
