Інтеграції / ERP / SYSPRO
Посібник з інтеграції SYSPRO для календарного планування виробництва в SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити SYSPRO 8 до SkyPlanner APS. SkyPlanner обмінюється даними із SYSPRO в обох напрямках через власні інтерфейси SYSPRO:
- До SkyPlanner надходять виробничі завдання та їхні операції, Structures and Routings, робочі центри, верстати, Stock Codes, складські залишки й замовлення на закупівлю.
- Планові дати початку й завершення записуються назад у виробничі завдання.
- За вашим вибором записи часу операторів можна передавати назад як дані про трудовитрати.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації SYSPRO під час впровадження та підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися або самостійно створити інтеграцію на основі задокументованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції SYSPRO
SYSPRO пропонує зовнішній системі календарного планування два шляхи доступу до даних:
- e.net Solutions Business Objects. Виклик бізнес-логіки SYSPRO із зовнішніх систем: вхідні та вихідні дані у форматі XML. Є три групи: Query (наприклад, WIPQBL, WIP Balance Query), Transaction або Post (наприклад, WIPTJB, WIP Job Creation and Maintenance) та Setup для основних даних. Бізнес-об’єкти виконують ті самі перевірки, що й екранні форми SYSPRO, та зберігають сумісність між версіями. У посібнику SYSPRO з рекомендованих практик прямо сказано: “SYSPRO’s Business Objects are used to query and post data to SYSPRO.” (Бізнес-об’єкти SYSPRO використовуються для запитів і запису даних у SYSPRO.)
- SYSPRO OData Service (OData v4). Доступ через REST лише для читання до баз даних компанії та системи, а також до Business Activity Queries — SQL-подань, визначених у SYSPRO. Доступний починаючи з SYSPRO 8 2021 R2. Для SYSPRO Cloud ERP зазначено: “Syspro OData is the only mechanism available when applications need access to SYSPRO data.” (Syspro OData — єдиний доступний механізм доступу застосунків до даних SYSPRO.)
Бізнес-об’єкти викликаються через службу e.net Communications за допомогою SYSPRO WCF Service або SYSPRO Web Service.
Master Data Take On (IMPIMP) імпортує електронні таблиці через бізнес-об’єкти Setup, що зручно для одноразового завантаження основних даних. Підтримка SYSPRO Harmony завершується 31 грудня 2026 року, тому не створюйте на його основі нових рішень.
Автентифікація та ліцензування
- Вхід через e.net. Інтеграція входить у систему під обліковим записом SYSPRO Operator із зазначенням компанії та отримує GUID сеансу для подальших викликів.
- Ліцензування. Ваша ліцензія SYSPRO має надавати оператору доступ до функціональних областей бізнес-об’єктів, які він викликає.
- OData. Доступ здійснюється через HTTPS під обліковими записами операторів, налаштованими для OData.
На боці SkyPlanner автентифікація в REST API виконується за допомогою токена API (SkyPlanner Settings > API). API задокументовано у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші виклики.
Події та періодичне опитування
SYSPRO не надсилає вихідних вебхуків. Electronic Signature Transaction Setup може запускати тригери, як-от надсилання електронного листа або виконання VBScript, після успішної транзакції. Але SYSPRO зазначає: “It is not intended that triggers from e.net Business Objects fire VBScript triggers.” (Запуск тригерів VBScript із тригерів e.net Business Objects не передбачений.)
Тому дані із SYSPRO отримують шляхом періодичного опитування. Запити до бізнес-об’єктів або OData з фільтрами за відкритими виробничими завданнями й останніми змінами виявляють нові завдання. Частоту налаштовують для кожного підприємства: від опитування раз на кілька хвилин для виробничих завдань до щогодинного для складських залишків.
SkyPlanner надсилає вебхуки в разі зміни стану або розкладу, тому зворотний запис даних запускається подіями.
Зіставлення даних
| Об’єкт SYSPRO (інтерфейс) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
| Stock Codes, одиниці виміру (OData або бізнес-об’єкти Query) | Вироби та матеріали | SYSPRO → SkyPlanner | Початкове завантаження, далі — опитування |
| Structures (компоненти, умовні вироби, спільно вироблена продукція) | Структура виробу, складові вироби, матеріали для кожного виробу | SYSPRO → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Routings: робочий центр, час налагодження, виконання, очікування в черзі та переміщення, Maximum units | Етапи процесу з тривалістю, часом налагодження та завершальних робіт | SYSPRO → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Work Centers (кількість виробничих одиниць, потужність) та Machines | Робочі центри, групи робочих центрів, показники ефективності | SYSPRO → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Capacity Calendar, Shift Patterns | Зміни та неробочі дні | SYSPRO → SkyPlanner | Щодня або ведення робочих змін у SkyPlanner |
| Виробничі завдання й підзавдання (WipMaster), операції та матеріали завдань | Замовлення та виробничі завдання з термінами виконання й потребами в матеріалах | SYSPRO → SkyPlanner | Опитування раз на кілька хвилин |
| Наявні складські залишки за кожним Stock Code | Складські залишки | SYSPRO → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Замовлення на закупівлю з термінами поставки | Замовлення на закупівлю, очікувані матеріали за датами поставки | SYSPRO → SkyPlanner | Опитування щогодини або під час розрахунку розкладу |
| Планові дати початку й завершення виробничого завдання (WIPTJB, WIP Job Creation and Maintenance) | Плановий початок і завершення кожного виробничого завдання | SkyPlanner → SYSPRO | У разі зміни розкладу, через вебхук SkyPlanner |
| Labor Posting: час налагодження й виконання за операцією виробничого завдання, верстатом і працівником | Записи часу та підтвердження операторів | SkyPlanner → SYSPRO | За кожним підтвердженням або за зміну, якщо вибрано цю функцію |
| Job Receipts (бізнес-об’єкт WIP Job Receipts) | Виготовлена кількість | SkyPlanner → SYSPRO | За кожним підтвердженням, якщо вибрано цю функцію |
| Відсутнє в SYSPRO | Матриця часу переналагодження, інструменти як обмежені ресурси, альтернативні верстати та персонал | Ведеться у SkyPlanner | Налаштовується під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте Stock Codes, Structures and Routings, робочі центри, верстати й календарі через OData або бізнес-об’єкти Query. Ретельно продумайте відповідність робочих центрів ресурсам SkyPlanner: робочий центр із чотирма верстатами стає однією групою робочих центрів або чотирма робочими центрами.
2. Синхронізація виробничих завдань. Зчитайте активні виробничі завдання з їхніми операціями й матеріалами, а також відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки в замовленні на закупівлю та оновлює залишки, коли замовлення отримує статус Delivered.
Включайте до розкладу лише активні виробничі завдання. Запропоновані завдання залишаються у знімку MRP, доки MRP Job Review не перетворить їх на виробничі завдання.
3. Зворотний запис розкладу. Коли механізм планування розміщує або переносить виробниче завдання, вебхук SkyPlanner запускає запис через бізнес-об’єкт WIP Job Creation and Maintenance (WIPTJB). Так задаються планові дати початку й завершення завдання. Бізнес-об’єкт перевіряє зміну так само, як це робить Job Entry.
4. Підтвердження з цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи часу підтримують розклад в актуальному стані. Ви вирішуєте, чи передавати фактичний час назад у SYSPRO. Якщо так, час налагодження й виконання надходить до Labor Posting за кожною операцією виробничого завдання, а виготовлена кількість — до Job Receipts. Якщо ні, трудовитрати, як і раніше, вносять у SYSPRO.
5. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Stock Codes, Structures and Routings, кількості, статус виробничого завдання | SYSPRO |
| Послідовність операцій, час початку й завершення, призначення верстатів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів та операторів, альтернативні ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Трудовитрати, видача та оприбуткування матеріалів | SYSPRO: дані вносять безпосередньо або передають із записів часу SkyPlanner |
Визначте одну систему, яка записуватиме дати виробничих завдань. SkyPlanner не потребує модуля календарного планування SYSPRO, тож перебирає у Factory Scheduling, Visual APS або APS (Nexsys) функцію запису планових дат. Якщо один із цих модулів і далі оновлює планові дати, вимкніть це для завдань, які планує SkyPlanner. У Factory Scheduling відповідний параметр Job Entry має назву “Update planned dates to scheduled dates.” (Оновлювати планові дати відповідно до дат розкладу.)
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку підготовки до роботи. Перед цим перевірте розклад у межах 30-денного безкоштовного пробного періоду, використовуючи робочі центри, технологічні маршрути й відкриті виробничі завдання, експортовані із SYSPRO у CSV або Excel.
- Зіставлення даних. Узгодьте таблицю відповідностей, правила відповідальності за дані, частоту синхронізації та необхідність зворотного запису трудовитрат.
- Доступ до SYSPRO. Створіть обліковий запис оператора для інтеграції, перевірте ліцензії на бізнес-об’єкти та ввімкніть OData там, де він використовується. Спочатку протестуйте на копії компанії.
- Початкове завантаження. Stock Codes, Structures and Routings, робочі центри, верстати, календарі.
- Синхронізація виробничих завдань і замовлень на закупівлю. Опитування з фільтрами, посторінковим отриманням даних і повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або персонал.
- Зворотний запис розкладу. Запис через WIPTJB за вебхуками SkyPlanner, а також запис трудовитрат, якщо вибрано цю функцію.
- Паралельне тестування. Плануйте в SkyPlanner паралельно з використанням поточного плану, порівняйте дати та виправте основні дані.
- Запуск в експлуатацію. Увімкніть зворотний запис, коли дані узгоджені.
Що врахувати під час інтеграції із SYSPRO
- Виробничі завдання _TMP. Пробні розрахунки завантаження з урахуванням обмежень потужності в Job Entry можуть створювати завдання _TMP у WipMaster. Відсіюйте їх під час кожного зчитування.
- Розпочаті операції. Forward Finite Scheduling видає помилки для розпочатих операцій, які не вміщуються в розклад. Перед кожним розрахунком завантажуйте в SkyPlanner дані про перебіг операцій, щоб розклад враховував уже виконану роботу. Після цього Running Time Lock фіксує розклад на найближчі години.
- Одиниці часу в технологічних маршрутах. Для часу налагодження, виконання, очікування в черзі та переміщення потрібні правильні одиниці й база розрахунку. Час у черзі та час переміщення — це очікування, а не машинний час. Перетворюйте значення під час імпорту, інакше всі тривалості будуть неправильними.
- Операції субпідрядників. Offsite Days і Dock to Stock Days — це календарна тривалість, а не завантаження ваших потужностей. Моделюйте їх як етапи, що враховують лише час.
Хто налаштовує та підтримує інтеграцію із SYSPRO
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску в межах узгоджених бізнес-об’єктів і запитів OData. Кожне підприємство використовує SYSPRO по-своєму, і саме тут знання цих особливостей стає в пригоді.
- Ваш партнер SYSPRO може долучитися. Він знає вашу конфігурацію, налаштовані для вас форми та умови ліцензування й може разом із командою SkyPlanner налаштувати оператора та доступ через OData.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner, використовуючи токен API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Докладні відомості наведено в документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; до тарифу входять 5 робочих центрів. Вартість інтеграції розраховують заздалегідь разом із тарифним планом, з урахуванням ваших процесів і потреб. Перегляньте тарифи, сторінку про планування виробництва для SYSPRO з урахуванням реальних потужностей обладнання та персоналу, сторінку SYSPRO та розділ інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Калле Калліомякі, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Абдул Ручінга, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
98%надійності поставок — зростання з приблизно 50%
«SkyPlanner відіграє вирішальну роль у підтриманні надійності наших поставок».
Ганну Лахтінен, генеральний директор
KJH-Comp · Виготовлення деталей із листового металу та контрактне виробництво
Надійність поставок зросла з приблизно 50% до 98%, а календарним плануванням тепер займається один керівник замість двох.
99,2%надійності поставок
«Завдяки SkyPlanner ми краще бачимо вузькі місця, а управління виробництвом стало зрозумілішим».
Тоні Туорі, керівник виробництва
Piristeel · Системи безпеки для покрівель і водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування заощаджує до чотирьох годин робочого часу на день.
Поширені запитання
Чи є в SYSPRO API для виробничих завдань?
Так. e.net Solutions Business Objects дають змогу запитувати й записувати дані SYSPRO, зокрема через WIPTJB для створення та ведення виробничих завдань. Сервіс SYSPRO OData додатково надає доступ до таблиць і Business Activity Queries через RESTful лише для читання.
Чи підтримує SYSPRO вебхуки?
Вихідні вебхуки не підтримуються. Тригери в Electronic Signature Transaction Setup не призначені для спрацювання під час викликів бізнес-об’єктів, тому інтеграція опитує SYSPRO за розкладом, установленим для кожного заводу. Власні вебхуки SkyPlanner надсилають зміни виробничого графіка одразу після їх внесення.
Як заплановані дати передаються для запису в SYSPRO?
Через бізнес-об’єкт WIP Job Creation and Maintenance (WIPTJB), який задає заплановані дати початку й завершення виробничого завдання. SYSPRO перевіряє запис за тими самими правилами, що й у Job Entry.
Чи працює інтеграція з SYSPRO Cloud ERP?
Так. SkyPlanner читає дані Cloud ERP через сервіс SYSPRO OData, який SYSPRO називає єдиним способом доступу до даних у цьому середовищі. Під час визначення обсягу проєкту команда SkyPlanner разом із вами та вашим партнером SYSPRO налаштовує спосіб зворотного запису даних.
Що партнеру SYSPRO варто пропонувати: SYSPRO MOM Visual APS чи SkyPlanner?
SkyPlanner — якщо клієнт хоче за кілька тижнів отримати робочий виробничий графік, що враховує реальні потужності обладнання та персоналу. Visual APS входить до пакета SYSPRO MOM, має окрему ліцензію та встановлюється з підключенням до SYSPRO SQL Server, а користувачам MOM Workbench потрібні ліцензії на кожне користувацьке місце (довідка SYSPRO). SkyPlanner підключається через e.net Business Objects і OData, автоматично переплановує виробництво, планує переналагодження, використання інструментів, роботу бригад і потребу в матеріалах. Кількість користувачів необмежена, вартість — від 199 € на місяць.
Чи можна протестувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані із SYSPRO у форматі CSV або Excel. Кредитна картка не потрібна. Спробуйте безкоштовно або зв’яжіться з відділом продажів, щоб визначити обсяг інтеграції.
