Інтеграції / ERP / Divalto infinity
Посібник з інтеграції Divalto для календарного планування виробництва у SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити Divalto infinity до SkyPlanner APS. SkyPlanner обмінюється даними з Divalto в обох напрямках через власні REST-сервіси Divalto:
- До SkyPlanner надходять OF і séquences OF, gammes, nomenclatures, articles, centres de charge, postes de travail, ressources, opérateurs, outillages, дані про запаси та замовлення постачальникам.
- Планові дати початку й завершення передаються назад для кожного OF і séquence. Якщо роботу перенесено на альтернативний ресурс, також передається новий centre або poste.
- За вашим вибором назад також можна передавати відпрацьований операторами час і завершені цикли.
Інтерфейси інтеграції Divalto
На своїй API-платформі Divalto infinity надає зовнішній системі календарного планування три базові компоненти:
- RecordSql (вбудований REST). Читає таблиці Divalto через зареєстровані файли запитів (DHOQ). Цей механізм використовується для читання OF, séquences, gammes, articles, postes і даних про запаси. Після реєстрації нового запиту може минути до десяти хвилин, перш ніж він стане доступним (налаштування RecordSql у Divalto).
- WEBSERVICE_INFINITY (REST). Вебсервіси Divalto для бізнес-операцій. Тіло кожного виклику має формат JSON і містить дію WEB_SERVICE_INFINITY, токен доступу та рядок параметрів із бізнес-операцією, dossier і даними (формат виклику). До виробничих операцій належать create_dataxml (передавання файлу виробничому scrutateur), integration_dt (створення технічних даних: компонентів, séquences, ressources, outillages), запити щодо запасів і створення article (виробничі операції).
- Виробничий scrutateur. Це засіб моніторингу файлів у виробничому модулі Divalto, який імпортує XML-файли. create_dataxml передає йому файл у кодуванні base64. Серед типів імпорту — GG_DATES_ORDO для планових дат, GG_TEMPS_IMPORT для відпрацьованого часу, GG_FIN_DE_CYCLE для завершених циклів, CO_MES_IMPORT для даних MES і GG_COMPOSANT_OM для витрат компонентів (create_dataxml).
Платформа більше не підтримує SOAP-сервіс Divalto, тому будуйте інтеграцію лише на REST.
Автентифікація
- На боці Divalto. Інтеграція надсилає ім’я користувача та пароль облікового запису, створеного в DLMT, методом POST на кінцеву точку Authent/Auth API-шлюзу Divalto. У відповідь вона отримує токен доступу, який, за даними Divalto, діє сорок п’ять хвилин, тому конектор поновлює його за таймером. Токен передається в тілі JSON кожного виклику бізнес-операції, а не в HTTP-заголовку (автентифікація Divalto).
- На боці SkyPlanner. REST API використовує для автентифікації API-токен у заголовку Authorization-Token (SkyPlanner Settings > API). Документація доступна у Swagger/OpenAPI. У посібнику з інтеграції покроково описано перші виклики.
Події та опитування
Вебхуки Divalto працюють лише на вхід: зовнішня система викликає вебхук Divalto, щоб запустити процес. За даними Divalto, вебхук не призначений для повернення даних (вебхуки Divalto). Divalto не надсилає вихідних подій.
Тому дані з Divalto отримують шляхом опитування. Запити RecordSql із фільтрами за відкритими OF та нещодавніми змінами дають змогу отримувати нові виробничі завдання. Частоту налаштовують для кожного заводу: від разу на кілька хвилин для OF до разу на годину для запасів.
SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тому зворотний запис запускається подіями.
Зіставлення даних
| Об’єкт Divalto (інтерфейс) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
| Articles, характеристики article (RecordSql) | Продукція й матеріали, властивості продукції | Divalto → SkyPlanner | Початкове завантаження, далі — опитування |
| Nomenclatures (компоненти) | Структура виробу, складові вироби, матеріали для кожного виробу | Divalto → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Gammes: séquences, opérations standard, норми часу, ressources, outillages | Етапи процесу з тривалістю, часом налагодження й демонтажу, інструментами | Divalto → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Ateliers, centres de charge, postes de travail | Робочі центри, групи робочих центрів, показники ефективності | Divalto → SkyPlanner | Початкове завантаження, далі — зрідка |
| Opérateurs і habilitations | Персонал і робочі центри, на яких дозволено працювати | Divalto → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Календарі poste | Зміни та неробочі дні | Divalto → SkyPlanner | Щодня або окреме ведення змін у SkyPlanner |
| OF (BF) і séquences OF (BH) із термінами виконання та компонентами | Замовлення й виробничі завдання з термінами виконання та потребами в матеріалах | Divalto → SkyPlanner | Опитування кожні кілька хвилин |
| Запаси за article і складом | Складські залишки | Divalto → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Замовлення постачальникам із датами поставки | Замовлення на закупівлю, надходження матеріалів за датами поставки | Divalto → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| GG_DATES_ORDO: початок і завершення OF (BF.PLANDEBDH, BF.PLANFINDH), початок і завершення séquence (BH.PLANDEBDH, BH.PLANFINDH), CENTRE і POSTE | Планові початок і завершення кожного виробничого завдання та етапу, призначений робочий центр | SkyPlanner → Divalto | У разі зміни розкладу, через вебхук SkyPlanner |
| GG_TEMPS_IMPORT: час за кожною séquence | Записи обліку часу та підтвердження операторів | SkyPlanner → Divalto | Після кожного підтвердження або за кожну зміну, якщо обрано цю опцію |
| GG_FIN_DE_CYCLE: завершені цикли | Виготовлена кількість | SkyPlanner → Divalto | Після кожного підтвердження, якщо обрано цю опцію |
| Відсутні в Divalto | Матриця часу переналагодження, інструменти як ресурси з обмеженою доступністю, альтернативні верстати та працівники | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
Сценарії інтеграції
1. Початкове завантаження основних даних. Зареєструйте запити RecordSql і зчитайте articles, nomenclatures, gammes, centres de charge, postes, opérateurs, outillages та календарі. Уважно визначте відповідність centres у SkyPlanner: centre de charge із чотирма postes стає однією групою робочих центрів із чотирма робочими центрами.
2. Синхронізація OF. Зчитайте відкриті OF разом із їхніми séquences і компонентами, а також відкриті замовлення постачальникам. SkyPlanner вважає замовлений матеріал доступним на дату поставки замовлення на закупівлю та оновлює запаси, коли це замовлення отримує статус Delivered. Зчитуйте основний OF і його підпорядковані OF разом, оскільки Divalto перераховує дати лише для основного OF.
3. Зворотний запис розкладу. Коли механізм планування розміщує або переміщує виробниче завдання, вебхук SkyPlanner запускає виклик create_dataxml. Файл є документом GG_DATES_ORDO. Для кожного OF він містить dossier, підрозділ і номер OF, планові дати початку й завершення, а для кожної séquence — її номер, планові початок і завершення, а також centre і poste, якщо роботу перенесено на альтернативний ресурс (формат GG_DATES_ORDO). scrutateur Divalto імпортує ці дані в заголовок OF і рядки séquence.
4. Підтвердження з цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують актуальність розкладу. Ви вирішуєте, чи передавати час назад до Divalto. Якщо так, час передається у файлах GG_TEMPS_IMPORT, а завершені цикли — у файлах GG_FIN_DE_CYCLE. Якщо ні, час, як і раніше, вводиться в MES Divalto.
5. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Articles, nomenclatures, gammes, кількість і статус OF | Divalto |
| Порядок séquence, час початку й завершення, призначення poste | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів і операторів, альтернативні ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Відпрацьований час, витрати матеріалів і виконання | Divalto: дані вводяться безпосередньо або передаються із записів обліку часу SkyPlanner |
Визначте єдине джерело запису дат OF. SkyPlanner бере на себе запис планових дат замість Opcenter APS і ручного перепланування. Якщо ви використовуєте Opcenter APS, вимкніть імпорт із нього для OF, які планує SkyPlanner, оскільки обидві системи використовують GG_DATES_ORDO.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від початку робіт. Перед цим перевірте розклад у межах 30-денного безкоштовного пробного періоду, використовуючи postes, gammes і відкриті OF, експортовані з Divalto у CSV або Excel.
- Зіставлення даних. Затвердьте таблицю відповідностей, правила відповідальності за дані, частоту синхронізації та рішення щодо зворотного передавання часу.
- Доступ до Divalto. Створіть обліковий запис для інтеграції в DLMT, зареєструйте запити RecordSql та активуйте виробничий scrutateur. Спочатку перевірте все в тестовому середовищі.
- Початкове завантаження. Articles, nomenclatures, gammes, centres, postes, opérateurs, outillages, календарі.
- Синхронізація OF і замовлень постачальникам. Періодичне опитування з фільтрами, посторінковим отриманням даних і повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні postes або працівники.
- Зворотний запис графіка. Передавання GG_DATES_ORDO через create_dataxml за допомогою вебхуків SkyPlanner, а також передавання обліку часу, якщо це передбачено.
- Паралельне тестування. Використовуйте SkyPlanner паралельно з поточним планом, порівнюйте дати й виправляйте основні дані.
- Запуск в експлуатацію. Увімкніть зворотний запис, коли дані збігатимуться.
Що врахувати під час інтеграції з Divalto
- Налаштування scrutateur. Файли create_dataxml надходять лише тоді, коли виробничий scrutateur активний, а в досьє Production встановлено прапорець MES і задано шлях «Interfaces».
- Оновлення токена. Токен доступу Divalto має короткий строк дії (див. розділ «Автентифікація»). Оновлюйте його перед кожною серією викликів.
- Реєстрація запитів. Нові або змінені запити RecordSql активуються протягом кількох хвилин. Зареєструйте їх до початкового завантаження.
- Основний OF і підпорядковані OF. Divalto переплановує дати лише основного OF. Плануйте підпорядковані OF як складові вироби, щоб батьківське замовлення виконувалося лише після готовності його компонентів.
- Характеристики article. Divalto зберігає властивості article, потрібні для календарного планування, у десяти полях характеристик. Їх зручно зіставити з властивостями продукції в SkyPlanner для матриці часу переналагодження та параметра «Allow similarity».
Хто налаштовує та підтримує інтеграцію з Divalto
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в межах узгоджених запитів RecordSql і дій вебсервісів. Кожне підприємство використовує Divalto по-своєму, і саме тут ці знання стають у пригоді.
- Ваш партнер Divalto може долучитися. Він знає ваше досьє, доопрацювання та налаштування й може разом із командою SkyPlanner налаштувати обліковий запис DLMT, запити та scrutateur.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner за допомогою токена API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Докладніше — у документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою. У вартість входять 5 робочих центрів. Вартість інтеграції розраховуємо заздалегідь разом із вашим тарифним планом, з урахуванням ваших процесів і потреб. Перегляньте ціни, матеріал про планування виробництва з урахуванням реальних потужностей у Divalto, сторінку Divalto та розділ інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюгів постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менше ніж 30 хвилин.
100%надійність поставок із 2021 року
«SkyPlanner дає нам чітке уявлення про виробничі потужності та робить планування передбачуваним».
Dan Berglund, COO/CFO
Opes Corporation · Хімічне та харчове виробництво
Надійність поставок становить 100% протягом усього часу використання SkyPlanner — із 2021 року.
Меншезупинок через брак матеріалів
«Для нас цінність SkyPlanner у тому, що це інструмент, який працює в повсякденній роботі, особливо коли потрібно визначити дати поставок».
Tommi Männistö, керівник відділу планування виробництва
Eskomatic · Механічна обробка на замовлення
Автоматичне планування завантаження дає змогу точніше визначати дати поставок, а кількість зупинок виробництва через брак матеріалів різко скоротилася.
Часті запитання
Чи має Divalto API для виробничих замовлень?
Так. RecordSql зчитує OF, séquences та інші таблиці через REST, а сервіс WEBSERVICE_INFINITY виконує бізнес-дії для виробництва, зокрема create_dataxml та integration_dt.
Чи підтримує Divalto вебхуки?
Вебхуки Divalto працюють лише на вхід і не повертають даних. Інтеграція опитує Divalto через RecordSql за графіком, налаштованим для кожного підприємства, а власні вебхуки SkyPlanner передають зміни графіка одразу після їх внесення.
Як заплановані дати записуються в Divalto?
Через XML-файл GG_DATES_ORDO, надісланий за допомогою дії create_dataxml. Він містить заплановані дати початку й завершення для кожного OF та кожної séquence, а також новий centre або poste, якщо роботу перенесено. Файл імпортує виробничий scrutateur Divalto.
Чи потрібен Opcenter APS для інтеграції?
Ні. SkyPlanner самостійно планує виробництво з урахуванням реальних потужностей обладнання та персоналу й записує заплановані дати. Якщо зараз використовується Opcenter APS, SkyPlanner перебирає на себе роль єдиної системи, що записує дати OF.
Що партнеру Divalto варто пропонувати: Opcenter APS чи SkyPlanner?
SkyPlanner — якщо замовник хоче за кілька тижнів отримати виробничий графік, який враховує реальні потужності та автоматично оновлюється. Opcenter APS у Divalto працює, коли його запускає планувальник, і обмінюється файлами через папку Windows (документація Divalto). SkyPlanner підключається через REST-сервіси Divalto, автоматично переплановує виробництво, планує переналагодження, інструменти, бригади й матеріали та не обмежує кількість користувачів — від 199 € на місяць.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Безкоштовна 30-денна пробна версія підтримує до 20 робочих центрів та імпорт даних із Divalto у форматі CSV або Excel. Кредитна картка не потрібна. Почніть пробний період або зверніться до відділу продажів для визначення обсягу інтеграції.