Інтеграції / ERP / Comarch ERP XL
Посібник з інтеграції Comarch ERP XL для календарного планування виробництва у SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити Comarch ERP XL до SkyPlanner APS. SkyPlanner обмінюється даними з Comarch ERP XL в обох напрямках через власні інтерфейси Comarch:
- До SkyPlanner надходять виробничі замовлення (zlecenia produkcyjne) з процесами й технологічними операціями, технології, робочі центри, виробничі ресурси, номенклатура, складські залишки та замовлення на закупівлю.
- Запланований час початку й завершення передається назад для кожної технологічної операції виробничого замовлення через XL API.
- За вашим вибором записи обліку часу операторів передаються назад як дані про виконання технологічних операцій.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Comarch ERP XL та підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно розробляти рішення на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції Comarch ERP XL
Comarch наводить три способи взаємодії з ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, пряме підключення до бази даних через SQL Client, REST API) (Comarch, переклад). Для системи календарного планування основну роботу виконують два з них:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Ці функції зібрано в бібліотеці CDN_API.DLL, яка встановлюється разом із системою Comarch ERP XL.) (Довідка Comarch, переклад) Зовнішня програма входить у систему через XLLogin, викликає функції в межах спільного сеансу та виходить через XLLogout. Кожна структура має поле Wersja, яке визначає версію набору параметрів для вашого випуску ERP XL.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 надає доступ до мікросервісів REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Кожен мікросервіс RestAPI надає власну інтерактивну документацію за адресою /swagger.) (Довідка Comarch, переклад)
Пряме підключення через SQL Client дає доступ до читання основних даних і замовлень із бази ERP XL за погодженням із вашою ІТ-командою та партнером Comarch.
Функції XL API для виробництва
Comarch документує такі виробничі функції (XL128):
| Сфера | Функція | Призначення |
|---|---|---|
| Технології | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Створення технології, технологічної операції, призначення робочого центру, матеріалу або продукції для операції |
| Виробничі замовлення | XLNoweZlecenieProd | Створення виробничого замовлення |
| Виробничі замовлення | XLZamknijZlecenieProd | Планує, переплановує, виконує розрахунок або закриває виробниче замовлення залежно від коду дії |
| Технологічні операції | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Додає технологічну операцію або виробничий ресурс до виробничого процесу |
| Розклад | XLDodajTerminDoProcesuProd | Додає часовий інтервал для технологічної операції: IdCzynnosci, TerminOd, TerminDo |
| Виконання | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Додає до замовлення запис про виконання технологічної операції, змінює фактично виконаний обсяг |
| Документи | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Формує документи RW і PW для виробничих об’єктів |
Автентифікація та доступ
- XL API. Інтеграція входить до бази даних від імені оператора ERP XL через XLLogin та отримує сеанс для подальших викликів. DLL працює на хості Windows зі встановленою ERP XL, тому служба зворотного запису працює у вашій мережі, поруч із ERP XL.
- REST API. Доступ налаштовується окремо для кожної інсталяції ERP XL Web; виклики кожного мікросервісу описано на його сторінці Swagger.
- Читання через SQL. Обліковий запис бази даних із правами лише на читання, погоджений вашою ІТ-командою.
На боці SkyPlanner для автентифікації в REST API використовується токен API в заголовку Authorization-Token (SkyPlanner Settings > API). Документація доступна у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші виклики.
Події та періодичне опитування
У перевіреній документації Comarch ERP XL вихідні вебхуки не описані. Власна APS-система Comarch завантажує дані, коли планувальник натискає «Aktualizuj dane z ERP» (оновити дані з ERP) (довідка Comarch APS).
Тому на боці ERP XL використовується періодичне опитування. Запити з фільтрами за відкритими виробничими замовленнями та останніми змінами виявляють нові завдання. Частоту налаштовують для кожного підприємства: від разу на кілька хвилин для виробничих замовлень до разу на годину для складських залишків.
SkyPlanner надсилає вебхуки в разі зміни стану або розкладу, тому зворотний запис запускається подіями.
Зіставлення даних
| Об’єкт Comarch ERP XL (інтерфейс) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
| Karty towarów, одиниці виміру (REST або читання через SQL) | Продукція та матеріали | ERP XL → SkyPlanner | Початкове завантаження, далі — періодичне опитування |
| Technologia: технологічні операції, матеріали, напівфабрикати та продукція для кожної операції | Структура виробу, підвироби, матеріали для кожного етапу процесу | ERP XL → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Технологічні операції Technologia: робочі центри, виробничі ресурси, часові параметри | Етапи процесу із тривалістю, часом налагодження та завершальних робіт | ERP XL → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Gniazda robocze та zasoby (верстати, інструменти, працівники) | Робочі центри, групи робочих центрів, інструменти, персонал | ERP XL → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Kalendarze i okresy, przestoje i awarie | Зміни, неробочий час і простої | ERP XL → SkyPlanner | Щодня або ведення окремого графіка змін у SkyPlanner |
| Zlecenia produkcyjne (ZP) з процесами, технологічними операціями, матеріалами, терміном виконання та пріоритетом | Замовлення та виробничі завдання з термінами виконання й потребами в матеріалах | ERP XL → SkyPlanner | Опитування кожні кілька хвилин |
| Залишки за складами | Складські залишки | ERP XL → SkyPlanner | Опитування щогодини або під час побудови розкладу |
| Zamówienia zakupu (ZZ) з датами поставки | Замовлення на закупівлю, очікувані надходження матеріалів за датами поставки | ERP XL → SkyPlanner | Опитування щогодини або під час побудови розкладу |
| Терміни технологічної операції: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Запланований початок і завершення кожного виробничого завдання | SkyPlanner → ERP XL | У разі зміни розкладу, через вебхук SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Записи обліку часу та підтвердження операторів | SkyPlanner → ERP XL | Для кожного підтвердження або кожної зміни, якщо вибрано цей варіант |
| Відсутнє в ERP XL | Матриця часу переналагодження, інструменти з урахуванням обмеженої доступності, завдання для кількох операторів, альтернативні верстати та працівники | Ведеться у SkyPlanner | Налаштовується під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте номенклатуру, технології, робочі центри, виробничі ресурси та календарі. Ретельно продумайте зіставлення робочих центрів у SkyPlanner: робочий центр із чотирма верстатами стає однією групою робочих центрів або чотирма робочими центрами. Інструменти з ресурсів ERP XL стають у SkyPlanner інструментами з обмеженою доступністю, а працівники — персоналом із робочими змінами.
2. Синхронізація замовлень. Зчитайте виробничі замовлення з їхніми технологічними операціями й матеріалами, а також відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки, зазначену в замовленні на закупівлю, та оновлює складські залишки, коли це замовлення отримує статус Delivered.
3. Зворотний запис розкладу. Коли рушій розміщує або переносить технологічну операцію, вебхук SkyPlanner запускає службу зворотного запису. Вона викликає XLDodajTerminDoProcesuProd зі значеннями TerminOd і TerminDo цієї операції. Так кожна операція ZP отримує заплановані в SkyPlanner час початку й завершення.
4. Підтвердження виконання в цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи часу підтримують актуальність розкладу. Ви вирішуєте, чи передавати фактичний час назад до ERP. Якщо так, служба додає записи про виконання через XLDodajRealizacjeOperacjiProd, а документи RW і PW формуються за вашими правилами ERP XL. Якщо на деяких робочих центрах ви використовуєте Comarch MES, залиште для кожної операції лише одне джерело звітних даних.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, технології, кількості, статус ZP, калькуляція собівартості | Comarch ERP XL |
| Послідовність технологічних операцій, час початку й завершення, призначення виробничих ресурсів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів і операторів, альтернативні виробничі ресурси | SkyPlanner |
| Зміни, календарі та простої | Одна система, обрана під час визначення обсягу проєкту |
| Записи про виконання, документи RW і PW | Comarch ERP XL: дані вводяться безпосередньо або передаються із записів часу SkyPlanner |
Оберіть одну систему, яка записуватиме дати технологічних операцій. Якщо автоматичне перепланування ERP XL або Comarch APS і далі записує строки в ті самі виробничі замовлення, вимкніть цю функцію для замовлень, які планує SkyPlanner.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку підключення. Перед цим перевірте розклад під час 30-денного безкоштовного пробного періоду: імпортуйте робочі центри, технології та відкриті виробничі замовлення, експортовані з ERP XL у CSV або Excel.
- Зіставлення даних. Узгодьте таблицю відповідності, правила відповідальності за дані, частоту синхронізації та те, чи передаватимуться назад записи про виконання.
- Доступ до ERP XL. Створіть обліковий запис оператора інтеграції, налаштуйте підключення для читання та розмістіть службу зворотного запису на хості зі встановленою ERP XL. Спочатку протестуйте все на копії бази даних.
- Початкове завантаження. Номенклатура, технології, робочі центри, виробничі ресурси, календарі.
- Синхронізація виробничих замовлень і замовлень на закупівлю. Періодичне опитування з фільтрами та повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або працівники.
- Зворотний запис розкладу. Виклики XLDodajTerminDoProcesuProd за вебхуками SkyPlanner, а також передавання записів про виконання, якщо ви це обрали.
- Паралельне тестування. Використовуйте SkyPlanner паралельно з поточним планом, порівнюйте дати й виправляйте основні дані.
- Запуск у роботу. Увімкніть зворотний запис, коли дані збігатимуться.
Що врахувати під час інтеграції з Comarch ERP XL
- Потужність, задана вручну. У ERP XL потужність робочого центру — це число, яке задає користувач, із допустимим завантаженням у %. SkyPlanner натомість розраховує потужність за фактичними змінами та виробничими ресурсами. Тому ретельно налаштуйте зміни, а відсотковий показник залиште осторонь.
- Необмежені виробничі ресурси. Для ресурсів із позначкою необмеженої потужності ERP XL пропускає перевірку зайнятості. Для кожного з них вирішіть, чи буде він у SkyPlanner робочим центром з обмеженою потужністю.
- Замовлення, запущені у виробництво. ERP XL не переплановує операції, запущені у виробництво, якщо не встановлено прапорець “Przesuń na zwolnionych”. Узгодьте, як дати зі SkyPlanner застосовуватимуться до таких замовлень, і використовуйте Running Time Lock, щоб зафіксувати розклад на найближчі години роботи.
- Версії структур. Структури XL API містять поле Wersja. Установіть у ньому значення, що відповідає вашій версії ERP XL, і повторюйте тестування після кожного щорічного оновлення.
- Польські одиниці вимірювання та час. Під час імпорту час технологічних операцій і календарні одиниці потрібно перетворювати точно, інакше всі значення тривалості будуть неправильними.
Хто налаштовує та підтримує інтеграцію з Comarch ERP XL
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску в межах узгоджених операцій читання та викликів XL API. Кожне підприємство використовує Comarch ERP XL по-своєму, і саме тут цей досвід стає в пригоді.
- Ваш партнер Comarch може долучитися. Він знає вашу конфігурацію, ліцензування та XL API й може разом із командою SkyPlanner налаштувати обліковий запис оператора, підключення для читання та хост служби зворотного запису.
- Ваші розробники можуть розширювати інтеграцію, використовуючи REST API SkyPlanner з API-токеном. Для початку достатньо API-токена, а команда SkyPlanner допоможе за потреби. Документація доступна в розділі документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць за 5 робочих центрів, з помісячною оплатою. Вартість інтеграції розраховують заздалегідь разом із тарифом, з урахуванням ваших процесів і потреб. Перегляньте ціни, сторінку про планування виробництва з урахуванням реальних потужностей верстатів і персоналу для Comarch ERP XL, сторінку Comarch ERP XL та розділ інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Зі SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
6 місяцівнаперед відділ продажів бачить вільні потужності
«SkyPlanner створює надійну основу для всього планування виробництва».
Anu Järvinen, керівниця виробництва
Fredman Operations · Пакувальний папір для контакту з харчовими продуктами
Відділ продажів бачить вільні потужності на шість місяців наперед, а відповіді на запити щодо зміни розкладу, які раніше потребували години або більше, тепер отримує за лічені секунди.
100%надійність поставок із 2021 року
«SkyPlanner дає нам змогу бачити виробничі потужності та робить планування передбачуваним».
Dan Berglund, COO/CFO
Opes Corporation · Хімічне та харчове виробництво
Надійність поставок становить 100% за весь час використання SkyPlanner — із 2021 року.
Поширені запитання
Чи має Comarch ERP XL API для виробничих замовлень?
Так. XL API (CDN_API.DLL) створює виробничі замовлення, планує та переплановує їх через XLZamknijZlecenieProd, додає дати технологічних операцій через XLDodajTerminDoProcesuProd і записує дані про виконання через XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web додає мікросервіси REST, описані у Swagger.
Як заплановані дати записуються назад у Comarch ERP XL?
Через XLDodajTerminDoProcesuProd, що додає діапазон дат (TerminOd, TerminDo) до кожної технологічної операції виробничого замовлення. Вебхук SkyPlanner запускає цей виклик щоразу, коли змінюється розклад.
Чи підтримує Comarch ERP XL вебхуки?
Вихідні вебхуки не задокументовані, тому інтеграція опитує ERP XL за графіком, установленим для кожного підприємства. Власні вебхуки SkyPlanner передають зміни розкладу одразу після їх виникнення.
Що партнеру Comarch пропонувати клієнтам: Comarch APS чи SkyPlanner?
SkyPlanner — якщо клієнт хоче за кілька тижнів отримати розклад, який враховує реальні потужності верстатів і персоналу та автоматично оновлюється. Comarch APS — окремий застосунок із власною базою даних PostgreSQL, інтегратором і ліцензійним ключем. Синхронізація відбувається, коли планувальник натискає кнопку, а час налагодження задається одним фіксованим значенням для кожної технологічної операції (довідка Comarch APS). SkyPlanner — хмарне програмне забезпечення за ціною від 199 € на місяць. Воно автоматично переплановує виробництво та планує переналагодження, інструменти, бригади й матеріали.
Чи можна протестувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані з ERP XL у форматі CSV або Excel. Кредитна картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
