Інтеграції / ERP / Senior ERP
Посібник з інтеграції Senior ERP зі SkyPlanner APS для календарного планування виробництва
Цей посібник пояснює партнерам та ІТ-командам, як підключити Senior ERP від Senior Sistemas (Gestão Empresarial | ERP XT із Senior X) до SkyPlanner APS. SkyPlanner обмінюється даними із Senior ERP в обох напрямках через власні інтерфейси Senior:
- До SkyPlanner надходять виробничі замовлення (OP) з їхніми етапами, технологічні маршрути (roteiros), виробничі ресурси та центри виробничих ресурсів, SKU, структури виробів, складські залишки й замовлення на закупівлю.
- До OP повертаються заплановані початок і завершення кожного етапу та вибраний для нього виробничий ресурс.
- За вашим вибором записи обліку часу операторів передаються назад як apontamentos de produção.
- Senior X Events Hub сповіщає SkyPlanner про зміну статусу етапу OP, а вебхуки SkyPlanner передають зміни в розкладі одразу після їх внесення.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Senior ERP і підтримує її після запуску в експлуатацію. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створити рішення на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції Senior ERP
ERP XT — гібридна система. У документації Senior зазначено, що Gestão Empresarial XT “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (стає гібридною системою: локальною системою з інтеграцією хмарних рішень) (документація Senior, у перекладі). Система календарного планування використовує три інтерфейси Senior:
- Вебсервіси G5 (SOAP). Працюють на вашому сервері Senior, а їхні назви відповідають модулям (com.senior.g5.co.<module>…). Кожен публікується у трьох варіантах WSDL: sapiens_Sync, sapiens_Async і sapiens_Scheduled. Серед виробничих сервісів є com.senior.g5.co.mpr.pcp.ordemproducao, який “calls the same production order generation routine” (викликає ту саму процедуру формування виробничих замовлень), що й екран ERP (документація Senior, у перекладі), а також сервіси для виробів (com.senior.g5.co.ger.cad.produto) та обліку виконання виробництва.
- REST API Senior X Platform за адресою api.senior.com.br — для предметних областей ERP, які Senior надає через Senior X, зокрема виробів і замовлень на продаж (документація Senior).
- Вебхуки Events Hub. Створюються в Senior X у розділі Tecnologia > Customização > Events Hub > Webhooks. Модуль Manufacturing публікує подію erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus, коли змінюється статус етапу OP (документація Senior).
Автентифікація та доступ
- Senior X Platform. Для входу інтеграція надсилає POST-запит на platform.senior.com.br за шляхом /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, указуючи користувача у форматі user@tenant. Відповідь містить токен доступу Bearer і токен оновлення. Для входу з ключами застосунку використовується loginWithKey (access key, secret, tenant). REST-запити містять заголовок authorization і заголовок client_id, що ідентифікує підключений застосунок, зареєстрований на порталі Senior API та прив’язаний до ролі в ERP.
- Вебсервіси G5. Запити містять параметри користувача, пароля та шифрування. Якщо використовується токен Senior X, він замінює пароль (документація Senior).
- Права доступу. Створіть окремого користувача Senior для інтеграції з доступом до даних PCP, конструкторсько-технологічних даних, складських залишків і закупівель, які вона читає та записує.
На боці SkyPlanner REST API використовує для автентифікації токен API в заголовку Authorization-Token (SkyPlanner Settings > API). API задокументовано у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші запити.
Події та опитування
Events Hub охоплює події в цеху: коли змінюється статус етапу OP, SkyPlanner отримує вебхук і оновлює розклад. Решта даних зчитується шляхом періодичного опитування. Запити з фільтрами за підтвердженими й дозволеними до виконання OP та останніми змінами дають змогу виявляти нові роботи. Частоту визначають для кожного підприємства: від разу на кілька хвилин для OP до разу на годину для складських залишків.
SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тому зворотний запис запускається за подіями.
Зіставлення даних
| Об’єкт Senior ERP (інтерфейс) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
| SKU: produto та derivação, одиниці виміру (вебсервіси G5 або сутності Senior X) | Продукція та матеріали | Senior → SkyPlanner | Початкове завантаження, далі — опитування |
| Структура виробу (engenharia do SKU) | Структура виробу, складові вироби, матеріали для кожного виробу | Senior → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Roteiro з етапами estágios: послідовність, залежність від попереднього етапу | Послідовність технологічних операцій | Senior → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Робочі центри, тривалість операцій, час налагодження та завершальних робіт, коефіцієнти ефективності | Senior → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Centro de recurso | Групи робочих центрів | Senior → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Calendário: Feriados, виробничий календар за змінами | Зміни та неробочі дні | Senior → SkyPlanner | Щодня або окреме ведення робочих змін у SkyPlanner |
| Ordens de produção (Firme, Liberada) з етапами та матеріалами | Замовлення та виробничі завдання з термінами виконання й потребами в матеріалах | Senior → SkyPlanner | Опитування кожні кілька хвилин |
| Статус етапу OP (Events Hub orderProductionStageChangeStatus) | Хід виконання виробничого завдання | Senior → SkyPlanner | У реальному часі через вебхук |
| Estoque за кожним SKU | Складські залишки | Senior → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Ordens de compra з датами постачання | Замовлення на закупівлю, надходження матеріалів за датами постачання | Senior → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Етап OP: заплановані початок і завершення, виробничий ресурс | Заплановані початок і завершення кожного виробничого завдання, призначений робочий центр | SkyPlanner → Senior | У разі зміни розкладу через вебхук SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, дата й час початку та завершення | Записи обліку часу та підтвердження операторів | SkyPlanner → Senior | За кожним підтвердженням або за зміну, якщо вибрано цю можливість |
| Відсутнє в Senior ERP | Матриця часу переналагодження, інструменти як ресурси з обмеженою доступністю, виробничі завдання для кількох операторів, альтернативні верстати та персонал | Ведеться у SkyPlanner | Налаштовується під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте SKU, структури виробів, roteiros, recursos, centros de recurso та виробничий календар. Продумайте зіставлення центрів виробничих ресурсів: centro de recurso з чотирма верстатами перетворюється на одну групу робочих центрів або чотири робочі центри. Враховуйте Fator de carga або в коефіцієнті ефективності робочого центру SkyPlanner, або в налаштуваннях робочих змін, але не обома способами одночасно.
2. Синхронізація OP. Зчитайте OP у статусах Firme і Liberada разом з етапами та матеріалами, а також відкриті замовлення на закупівлю. MRP ще може змінити або видалити OP у статусі Planejada, тому включайте їх у розклад лише тоді, коли потрібно бачити план на перспективу. SkyPlanner вважає замовлений матеріал доступним на дату постачання із замовлення на закупівлю та оновлює складські залишки, коли це замовлення отримує статус Delivered.
3. Зворотний запис розкладу. Коли алгоритм розміщує або переносить етап у розкладі, вебхук SkyPlanner запускає зворотний запис. Він задає заплановані початок і завершення кожного етапу OP та вибраний для нього виробничий ресурс — ті самі поля, які планувальник редагує в Programação de produção. Конкретний вебсервіс команда SkyPlanner узгоджує з вами та вашим партнером Senior під час визначення обсягу проєкту.
4. Підтвердження з цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують розклад в актуальному стані. Ви вирішуєте, чи передавати фактичний час назад до Senior. Якщо так, кожне підтвердження стає записом apontamento de produção для етапу OP із кількістю виготовленої продукції, браку та часом початку й завершення. Senior приймає звіти про виконання виробництва лише для OP у статусі Liberada або Andamento. Якщо ви реєструєте виконання через Fábrica ao Vivo, SkyPlanner натомість зчитує хід робіт через Events Hub.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| SKU, структури виробів, roteiros, кількості та статус OP | Senior ERP |
| Послідовність етапів, час початку й завершення, призначення виробничих ресурсів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів та операторів, альтернативні виробничі ресурси | SkyPlanner |
| Виробничий календар і зміни | Одна система, вибрана під час визначення обсягу проєкту |
| Apontamentos, рух запасів, калькулювання собівартості | Senior ERP: дані вводяться в ній або передаються із записів обліку часу SkyPlanner |
Виберіть одну систему для запису дат етапів. Якщо планувальники й далі визначають послідовність тих самих OP у Programação de produção або на діаграмі Ганта, узгодьте, якими OP керує SkyPlanner.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку роботи. Перед цим перевірте розклад у межах 30-денного безкоштовного пробного періоду, використовуючи виробничі ресурси, roteiros і відкриті OP, експортовані із Senior у CSV або Excel.
- Зіставлення даних. Зафіксуйте таблицю зіставлення, правила відповідальності за дані, частоту синхронізації та рішення щодо зворотного запису apontamentos.
- Доступ до Senior. Створіть користувача для інтеграції, зареєструйте застосунок на порталі Senior API та ввімкніть вебсервіси G5 і вебхук Events Hub. Спочатку проведіть перевірку на тестовій базі.
- Початкове завантаження. SKU, структури виробів, roteiros, recursos, centros de recurso, календар.
- Синхронізація OP і замовлень на закупівлю. Опитування з фільтрами та повторними спробами, а також вебхук статусу етапу.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або працівники.
- Зворотний запис розкладу. Дати етапів і виробничі ресурси з вебхуків SkyPlanner, а також apontamentos, якщо вибрано цю можливість.
- Паралельне тестування. Використовуйте SkyPlanner паралельно з поточним планом, порівнюйте дати та виправляйте основні дані.
- Запуск в експлуатацію. Увімкніть зворотний запис, коли дані узгоджено.
Що врахувати під час інтеграції із Senior ERP
- Чотири норми часу для виробничого ресурсу. Recurso містить час обробки, налагодження, завантаження й розвантаження та переміщення. Час завантаження й переміщення може стосуватися допоміжних робіт, а не роботи верстата. Визначте для кожного виробничого ресурсу, як зіставляти ці значення, інакше всі розрахунки тривалості будуть неправильними.
- Одне значення часу налагодження на виробничий ресурс. Tempo setup у Senior — це єдине значення. Під час впровадження створіть у SkyPlanner матрицю часу переналагодження на основі фактичних переходів між роботами.
- Варіанти виробу. SKU у Senior складається з виробу та derivação, причому roteiros можуть відрізнятися для кожного варіанта. Додайте код derivação до ключів виробів у SkyPlanner.
- Статуси OP. Звіти про виконання виробництва приймаються лише для OP у статусах Liberada та Andamento. Змінюйте статуси в Senior, а SkyPlanner відстежуватиме ці зміни через Events Hub.
- Гібридне розгортання. Вебсервіси G5 працюють на вашому сервері Senior, а Events Hub — у Senior X. Передбачте мережевий доступ до обох середовищ.
- Формат чисел. Вебсервіси Senior відхиляють числа з роздільниками тисяч і вимагають кому як десятковий роздільник. Надсилайте числа в цьому форматі.
Хто налаштовує та підтримує інтеграцію із Senior ERP
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в експлуатацію. Це охоплює узгоджені вебсервіси, API Senior X і вебхуки Events Hub. Кожен завод використовує Senior ERP по-своєму, і під час інтеграції ми враховуємо ці особливості.
- Ваш партнер Senior може долучитися до роботи. Він знає вашу конфігурацію, доопрацювання та умови ліцензування й разом із командою SkyPlanner може налаштувати обліковий запис для інтеграції, реєстрацію на порталі API та вебсервіси.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner за допомогою токена API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Докладні відомості наведено в документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; у ціну входять 5 робочих центрів. Вартість інтеграції розраховується заздалегідь разом із вашим тарифним планом, з урахуванням ваших процесів і потреб. Перегляньте ціни, матеріал про планування виробництва із Senior ERP з урахуванням реальних потужностей обладнання та персоналу, сторінку Senior ERP та розділ інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
На плануванні виробництва щотижня заощаджують 2 години робочого часу, а нова черга завдань надходить на лінію за лічені секунди.
+90%зростання ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
1 000 і більше виробничих замовлень плануються автоматично
«Ми тепер зовсім інакше контролюємо виробництво, а наше розуміння виробничих потужностей вийшло на цілком інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
Меншезупинок через нестачу матеріалів
«Для нас цінність SkyPlanner у тому, що це інструмент, який працює в щоденній роботі, особливо коли потрібно визначити дати поставок».
Tommi Männistö, керівник відділу планування виробництва
Eskomatic · Механічна обробка на замовлення
Автоматичне планування завантаження дає змогу точніше визначати дати поставок, а кількість зупинок виробництва через нестачу матеріалів різко скоротилася.
Поширені запитання
Чи є в Senior ERP API для виробничих замовлень?
Так. Вебсервіс G5 com.senior.g5.co.mpr.pcp.ordemproducao створює OP за тією самою процедурою, що й в інтерфейсі ERP, а інші сервіси G5 забезпечують роботу з продукцією та виробничою звітністю. Senior X Platform додає REST API з автентифікацією за токеном Bearer і вебхуки Events Hub.
Чи підтримує Senior ERP вебхуки?
Так. Senior X Events Hub надсилає вебхуки, зокрема orderProductionStageChangeStatus у разі зміни статусу етапу OP. SkyPlanner використовує його, щоб відстежувати хід робіт у цеху в реальному часі, а через власні вебхуки передає зміни розкладу назад.
Як заплановані дати записуються назад у Senior ERP?
SkyPlanner задає заплановані початок і завершення кожного етапу OP та вибраний для нього виробничий ресурс — ті самі поля, які планувальник редагує в Programação de produção. Щоразу, коли розклад змінюється, вебхук SkyPlanner запускає зворотний запис даних. Для цього використовується маршрут, який команда SkyPlanner налаштовує для вашої інсталяції Senior під час визначення обсягу робіт на етапі впровадження.
Чи працює інтеграція із Senior X та ERP XT?
Так. ERP XT працює на вашому сервері та використовує хмарні сервіси Senior X. Інтеграція використовує вебсервіси G5 на сервері, а також API Senior X і Events Hub у хмарі.
Чи можна протестувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані із Senior у форматі CSV або Excel. Кредитна картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг робіт з інтеграції.
