Інтеграції / ERP / proALPHA ERP
Посібник з інтеграції proALPHA зі SkyPlanner APS для календарного планування виробництва
У цьому посібнику партнери та ІТ-команди дізнаються, як підключити Proalpha ERP до SkyPlanner APS. Інтеграція SkyPlanner із Proalpha забезпечує обмін даними в обох напрямках:
- До SkyPlanner надходять дані про номенклатуру, виробничі замовлення з технологічними операціями, виробничі ресурси, календарі, запаси та замовлення на закупівлю.
- Заплановані початок і завершення кожної технологічної операції передаються назад через setWorkOrderOperationDates.
- Зміни виробничих ресурсів передаються назад через changeWorkOrderOperationResource.
- Підтвердження операторів передаються назад через operationDataEntry.
- Вебхуки SkyPlanner передають зміни розкладу відразу після їх внесення.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Proalpha та підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створити інтеграцію на основі задокументованого REST API SkyPlanner (довідник API).
Інтерфейси Proalpha
Proalpha ERP працює на Progress OpenEdge, а з виходом Release 9 платформу переведено на OpenEdge 12. (Proalpha) Для календарного планування важливі чотири інтерфейси.
- Proalpha ERP REST APIs. На загальнодоступному порталі API Proalpha наведено 108 специфікацій OpenAPI 3.0 для
api/web/v1. Ці інтерфейси використовуються для зворотного запису даних, а також для читання номенклатури та запасів. - Integration Workbench (INWB). За словами Proalpha, INWB “is a central platform which connects different IT systems, machines, sites” (є центральною платформою, що з’єднує різні ІТ-системи, машини та майданчики) і “converts the data into the format of the target system.” (перетворює дані у формат цільової системи). (Proalpha) Він приймає повідомлення pAX через
POST /api/web/v1/inwb/message. Використовуйте його для передавання виробничих замовлень із Proalpha та до Proalpha. - Proalpha Integration Platform. Цю платформу на базі n8n анонсовано у квітні 2026 року. Вона “will be available to customers either on-premises or in the cloud.” (буде доступна клієнтам для локального або хмарного розгортання). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (спиратиметься на еталонну архітектуру, орієнтовану на API, та інтерфейси REST). (Proalpha)
- EDI та експорт файлів. INWB обробляє галузеві формати файлів, а для пробного використання SkyPlanner достатньо експорту файлів.
Кінцеві точки для виробництва
| API Proalpha | Кінцева точка | Використання в інтеграції |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Заплановані початок і завершення кожної технологічної операції (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Виробничий ресурс, вибраний під час планування (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Підтвердження: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Номенклатура з полями partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Запаси за областями MRP |
Автентифікація
В опублікованих специфікаціях Proalpha використовується автентифікація HTTP Basic. Адреси кінцевих точок залежать від середовища: {schema}://{host}:{port}/api/web/v1/... на вашому сервері Proalpha або в Proalpha Cloud. Створіть окремого технічного користувача з правами лише на об’єкти з таблиці зіставлення. Разом з ІТ-командою сплануйте мережевий доступ із хмари SkyPlanner до цієї кінцевої точки.
На боці SkyPlanner для автентифікації в REST API використовується токен API (SkyPlanner Settings > API), а документація доступна у Swagger/OpenAPI. Для початку достатньо токена API. У посібнику з інтеграції покроково описано перші виклики.
Події та опитування
На порталі API Proalpha немає API для підписки на вебхуки. Зміни з Proalpha надходять через:
- потік повідомлень INWB, який передає нові та змінені виробничі замовлення разом із технологічними операціями
- робочий процес n8n на Proalpha Integration Platform
- опитування за розкладом Material API для отримання даних про запаси
SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тому зворотний запис у Proalpha відбувається за подіями.
Зіставлення даних
| Об’єкт або API Proalpha | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
| Part (Part API) | Продукція та матеріали | Proalpha → SkyPlanner | Початкове завантаження, потім у разі змін |
| Модель виробничого процесу продукту: process, activities; рядки BOM виробничого замовлення | Структура продукту, складові продукти, етапи процесу | Proalpha → SkyPlanner | Початкове завантаження, потім у разі змін |
| Виробниче замовлення (Fertigungsauftrag) з кількістю та терміном виконання | Замовлення та виробничі завдання з терміном виконання й пріоритетом | Proalpha → SkyPlanner | Надсилання через INWB або n8n чи кожні кілька хвилин |
| Технологічні операції виробничого замовлення: targetSetupTime, targetProcessTime, resource | Етапи процесу з часом налагодження та тривалістю | Proalpha → SkyPlanner | Разом із виробничим замовленням |
| Виробничі ресурси, групи ресурсів, альтернативні групи ресурсів | Робочі центри, групи робочих центрів, альтернативні робочі центри | Proalpha → SkyPlanner | Початкове завантаження |
| Блоки календаря виробничого ресурсу з полями intensity та overloadIntensity | Зміни та ефективність робочих центрів | Proalpha → SkyPlanner | Початкове завантаження; далі щодня або ведення у SkyPlanner |
| Запаси за областями MRP | Запаси матеріалів | Proalpha → SkyPlanner | Щогодини або перед кожним розрахунком розкладу |
| Замовлення на закупівлю з датою поставки | Очікувані матеріали на дату їх поставки | Proalpha → SkyPlanner | Щогодини або перед кожним розрахунком розкладу |
| setWorkOrderOperationDates | Початок і завершення кожної технологічної операції за розкладом | SkyPlanner → Proalpha | У разі зміни розкладу через вебхук SkyPlanner |
| changeWorkOrderOperationResource | Робочий центр, вибраний алгоритмом планування | SkyPlanner → Proalpha | У разі зміни розкладу |
| operationDataEntry (setup, process, combined) | Записи обліку часу та кількості з Mobile Confirmations | SkyPlanner → Proalpha | За кожним підтвердженням або за зміну |
| Правила календарного планування SkyPlanner | Матриця часу переналагодження, інструменти як обмежені виробничі ресурси, кількість операторів | Ведення у SkyPlanner | Налаштування під час впровадження |
Сценарії інтеграції
1. Початкове завантаження основних даних. Зчитайте номенклатуру через Part API та одноразово завантажте виробничі ресурси, групи ресурсів і календарі через INWB або експорт файлів. Ретельно зіставте кожен виробничий ресурс Proalpha з робочим центром SkyPlanner. Альтернативні групи ресурсів стають альтернативними робочими центрами.
2. Синхронізація замовлень. Потік повідомлень INWB або робочий процес n8n передає відкриті виробничі замовлення разом із технологічними операціями, плановим часом і виробничими ресурсами. Дані про запаси надходять із Material API для кожної області MRP, а відкриті замовлення на закупівлю — через INWB. SkyPlanner вважає замовлений матеріал доступним на дату поставки, зазначену в замовленні на закупівлю, й оновлює запаси, коли замовлення отримує статус Delivered.
3. Зворотний запис графіка. Для кожної технологічної операції, яку рушій запланував або переніс, інтеграція викликає setWorkOrderOperationDates, передаючи guid операції, час початку та завершення. Якщо рушій вибрав інший виробничий ресурс, після цього викликається changeWorkOrderOperationResource.
4. Підтвердження виконання в цеху. Оператори реєструють виконану роботу через SkyPlanner Mobile Confirmations або Production Timer. Записи обліку часу підтримують актуальність графіка й передаються до Proalpha через operationDataEntry. Якщо на вашому підприємстві вже використовують термінали PDC для підтвердження виконання, залиште один канал, щоб уникнути дублювання записів.
5. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, моделі процесів, кількості, статус виробничого замовлення | Proalpha |
| Послідовність технологічних операцій, час початку й завершення, призначення виробничих ресурсів | SkyPlanner |
| Матриця часу переналагодження, інструменти, кількість операторів | SkyPlanner |
| Зміни та відсутність працівників | Одна система, обрана під час визначення обсягу проєкту |
| Підтвердження виконання та облікові записи руху запасів | Proalpha, куди надходять записи обліку часу зі SkyPlanner або дані PDC |
Якщо Proalpha APS або Feinplanung активні, визначте, яка система відповідає за дати технологічних операцій. Якщо дві системи планування записують ті самі дати, вони перезаписуватимуть дані одна одної. З Autopilot SkyPlanner автоматично переплановує графік у разі змін на виробництві.
Типові етапи проєкту
Впровадження зазвичай завершується за кілька тижнів від початку підключення. Перед цим ви можете пройти 30-денний безкоштовний пробний період на власних даних. Експортуйте відкриті виробничі замовлення, технологічні операції та виробничі ресурси з Proalpha у CSV або Excel, імпортуйте їх і перевірте графік.
- Робоча сесія з узгодження відповідностей. Разом із вашим партнером Proalpha затвердьте таблицю відповідностей, правила відповідальності за дані, частоту синхронізації та канал підтвердження виконання.
- Налаштування інтерфейсів. Увімкніть REST API та потоки INWB, створіть технічного користувача й відкрийте мережевий доступ. Спочатку в тестовій системі, потім — у робочій.
- Початкове завантаження. Номенклатура, виробничі ресурси, групи ресурсів і календарі.
- Синхронізація виробничих замовлень, запасів і замовлень на закупівлю. Передавайте виробничі замовлення через INWB або n8n, а дані про запаси отримуйте періодичними запитами. Передбачте повторні спроби.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів та альтернативні робочі центри.
- Зворотний запис графіка. setWorkOrderOperationDates і changeWorkOrderOperationResource; на цьому етапі також додається operationDataEntry.
- Паралельна робота. Порівняйте дати зі SkyPlanner із поточним планом і виправте основні дані.
- Запуск в експлуатацію. Увімкніть зворотний запис, коли дані узгоджуватимуться.
Що врахувати під час інтеграції з Proalpha
- Немає об’єкта технологічного маршруту. Proalpha планує на основі моделей процесів для виробів. Інструменти, скопійовані з проєктів SAP або Business Central, шукають технологічні маршрути й не знаходять частину даних. Зчитуйте технологічні операції та рядки BOM із виробничого замовлення.
- Інтенсивність у календарі. Календарні блоки містять intensity та overloadIntensity. Зіставляйте їх зі змінами й показниками ефективності в SkyPlanner, а не просто копіюйте кількість годин.
- Одиниці вимірювання. Перевірте quantityUnitCode і з’ясуйте, чи плановий час налагодження задано на замовлення, чи на одиницю продукції. Неправильні одиниці спотворюють усі значення тривалості.
- Кінцеві точки на стороні замовника. Рівень REST працює на вашому сервері Proalpha. Від налаштування брандмауерів, портів і сертифікатів залежить дата початку проєкту, тому забезпечте доступ заздалегідь.
- Версія системи. Перш ніж затверджувати відповідності, уточніть у партнера, які REST API доступні у вашій версії Proalpha.
- Документація потребує входу. Онлайн-довідка Proalpha доступна через Documentation Portal. Уточнюйте назви полів у партнера, а не вгадуйте їх.
Інтеграція з Proalpha: хто налаштовує та підтримує
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску в експлуатацію. У кожній інсталяції Proalpha моделі побудовано по-своєму, і саме тут потрібні ці знання та досвід.
- Ваш партнер Proalpha може долучитися. Партнер знає ваші моделі процесів, потоки INWB і версію системи та може налаштувати доступ до API. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники можуть розвивати інтеграцію через той самий REST API з токеном API. За потреби команда SkyPlanner допоможе. Документація продукту відкрита для всіх у розділі документації SkyPlanner.
Вартість SkyPlanner починається від 199 € на місяць і включає 5 робочих центрів. Оплата щомісячна. Вартість інтеграції розраховують заздалегідь з урахуванням ваших процесів і потреб та надають разом із вартістю тарифного плану, тож ви бачите повну суму ще до початку роботи. Дізнайтеся, як Proalpha планує потужності, у статті Чи підтримує proALPHA планування виробництва з урахуванням реальних потужностей обладнання та персоналу?, перегляньте огляд на сторінці proALPHA, а інші системи — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Калле Калліомякі, фахівець із ланцюгів постачання
UTU · Електрощити та розподільне обладнання
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Абдул Руціїнга, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
99,2%надійності поставок
«Завдяки SkyPlanner ми краще бачимо вузькі місця, а управління виробництвом стало зрозумілішим».
Тоні Туорі, керівник виробництва
Piristeel · Системи безпеки для дахів і водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування заощаджує до чотирьох годин робочого часу на день.
Меншезупинок через нестачу матеріалів
«Цінність SkyPlanner для нас у тому, що це дієвий інструмент для щоденної роботи, особливо для визначення дат поставки».
Томмі Мянністе, керівник відділу планування виробництва
Eskomatic · Механічна обробка на замовлення
Автоматичне планування завантаження дає точніші дати поставки, а кількість зупинок виробництва через нестачу матеріалів різко скоротилася.
Поширені запитання
Які інтерфейси Proalpha використовує інтеграція?
REST API Proalpha — для даних про деталі й запаси та зворотного запису дат, виробничих ресурсів і підтверджень виконання. Потоки повідомлень INWB або Integration Platform на базі n8n передають виробничі замовлення разом із технологічними операціями. Для пробного періоду та масового завантаження використовують експорт у файли.
Куди в Proalpha записуються заплановані дати?
У технологічну операцію виробничого замовлення через setWorkOrderOperationDates із передаванням моментів початку та завершення. Якщо рушій переніс виробниче завдання на інший верстат, changeWorkOrderOperationResource оновлює виробничий ресурс.
Чи підтримує Proalpha вебхуки?
У Proalpha API Portal не зазначено API для підписки на вебхуки. Зміни надходять до SkyPlanner через потоки повідомлень INWB, робочі процеси n8n або періодичні запити. Власні вебхуки SkyPlanner забезпечують зворотний запис за подіями.
Чи можна передавати підтвердження виконання від операторів до Proalpha?
Так. Записи обліку часу зі SkyPlanner Mobile Confirmations передаються через operationDataEntry разом із кількістю, часом роботи працівника та часом використання виробничого ресурсу. Якщо також використовуються термінали PDC, залиште один канал підтвердження виконання.
Чи потрібен нам Proalpha APS і що робити, якщо ми вже його використовуємо?
Він вам не потрібен. SkyPlanner самостійно будує графік з урахуванням реальних потужностей обладнання та персоналу на основі ваших виробничих замовлень, технологічних операцій і виробничих ресурсів, а Autopilot підтримує його актуальність. Якщо Proalpha APS активний, під час визначення обсягу проєкту вирішіть, яка система відповідає за дати технологічних операцій. Тоді SkyPlanner записуватиме лише ті дати, за які відповідає, тож два плани ніколи не перезаписуватимуть один одного.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів, завантаживши ваші виробничі замовлення, експортовані у CSV або Excel. Кредитна картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
