Інтеграції / ERP / Sage X3
Посібник з інтеграції Sage X3 зі SkyPlanner APS для календарного планування виробництва
Цей посібник пояснює партнерам Sage та ІТ-командам, як підключити Sage X3 до SkyPlanner APS. У ньому розглянуто, які інтерфейси X3 використовувати, які об’єкти містять потрібні дані та де виникають проблеми в проєктах. SkyPlanner забезпечує двосторонню інтеграцію як із хмарною, так і з локальною версією Sage X3:
- До SkyPlanner надходять виробничі замовлення, технологічні операції та маршрути, робочі центри, календарі, складські залишки й відкриті замовлення на закупівлю.
- Заплановані дати технологічних операцій і робочі центри записуються назад у виробничі замовлення (GESMFG).
- Записи робочого часу операторів передаються до обліку виробництва (GESMTK).
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації X3, а після запуску в експлуатацію забезпечує її підтримку.
Якщо ви ще вирішуєте, чи потрібен X3 окремий інструмент планування виробництва, який враховує реальні потужності обладнання та доступність персоналу, спершу прочитайте Чи є в Sage X3 планування виробництва? Огляд продукту наведено на сторінці SkyPlanner APS для Sage X3, а інформацію про інші ERP — у розділі інтеграцій з ERP.
Місце SkyPlanner в ІТ-середовищі X3
Стандартний інструмент календарного планування Sage X3 (FUNMAUTJ) визначає послідовність технологічних операцій за даними технологічних маршрутів, але планує кожне виробниче замовлення окремо. У посібнику служби підтримки Sage UK прямо зазначено: “does not delay or stagger work orders based on overall resource load.” (не відкладає виробничі замовлення й не розподіляє їх у часі з урахуванням загального завантаження виробничих ресурсів). Планування виробництва з урахуванням доступних потужностей — це окремий рівень, для якого Sage пропонує два варіанти:
- Production Scheduler (код активності POPS) — лише для локального розгортання.
- Універсальний інтерфейс Finite scheduler (код активності GFS), який з’єднує хмарну або локальну версію X3 із Sage X3 Web Scheduling чи планувальником від незалежного постачальника ПЗ.
SkyPlanner виконує цю роль як зовнішній хмарний планувальник, що працює через стандартні API X3, тому однаково підтримує хмарну й локальну версії X3. MRP (FUNMRP), як і раніше, формує пропозиції щодо виробничих замовлень і замовлень на закупівлю. SkyPlanner визначає послідовність підтверджених і планових виробничих замовлень з урахуванням реальних потужностей.
Варіанти інтеграції із Sage X3
Спосіб інтеграції залежить від моделі розгортання. Хмарна версія Sage X3 не надає стороннім застосункам доступу ані до файлової системи застосунку, ані до бази даних, тому інтеграція працює через API або розміщений на сервері сервіс передавання файлів. Локальне розгортання також дає змогу безпосередньо імпортувати файли та використовувати проміжні таблиці в базі даних X3.
| Варіант | Опис | Автентифікація | Для чого використовувати |
|---|---|---|---|
| GraphQL API (Sage X3 Web API) | За визначенням Sage, “technology of choice” (пріоритетна технологія) для API X3; розвивається без поділу на версії | JWT (HS256), підписаний за допомогою Secret із Connected application; Client ID як iss, URL як aud; окремий користувач Syracuse | Продукція, майданчики, закупівлі, запаси; вузли виробничих даних, якщо вони доступні |
| REST api1 | REST на основі представлень: .../api1/x3/$$prod/<FOLDER>.<ENTITY>?representation=<REP>.$query | Автентифікація Syracuse | Сутності, недоступні через GraphQL |
| Вебсервіси SOAP для об’єктів | Об’єкти, опубліковані у Web services (GESAWE); використовуються поля екранної форми об’єкта; читання, збереження, зміна | OAuth2 для пулів з’єднань Syracuse | Зворотний запис у Work order (GESMFG), Production tracking (GESMTK) |
| SOAP Template Services | Шаблони імпорту й експорту через SOAP за допомогою AOWSIMPORT та AOWSEXPORT | OAuth2; X3 не дозволяє базову автентифікацію для SOAP | Запуск шаблонів із проміжного ПЗ |
| Шаблони імпорту й експорту | Файли для пакетної обробки за шаблонами | Файлова система (локальне розгортання) або хостинговий сервіс передавання файлів (хмара) | Початкове завантаження даних, нічна масова синхронізація |
| Sync API (Cloud BI) | Лише у хмарі: інкрементальне вивантаження лише для читання та потік NDJSON; надається за запитом через вашого представника Sage ISV | Токен Bearer та окремий X-API-KEY для кожного тенанта | Читання великих обсягів змін у хмарі |
Для GraphQL у локальному розгортанні потрібно додати "bearer" до масиву session.auth у файлі nodelocal.js. У Sage X3 SaaS автентифікацію підключених застосунків увімкнено за замовчуванням. У Sage X3 Cloud підключений застосунок не може використовувати користувача admin: натомість створіть користувача Syracuse з автентифікацією Standard.
Які інтерфейси використовувати для різних потоків даних
- Продукція, майданчики, закупівлі та складські залишки: GraphQL, як в офіційних прикладах Sage.
- Виробничі замовлення, технологічні операції, технологічні маршрути та робочі центри: представлення REST api1 або шаблони експорту, які запускаються через AOWSEXPORT. У версіях, де схема GraphQL надає доступ до виробничої предметної області (
xtremX3Manufacturing), інтеграція читає ті самі дані через GraphQL. - Запис дат технологічних операцій і робочих центрів назад у X3: SOAP-вебсервіс Work order (GESMFG), операція modify. Запасний варіант — шаблон імпорту через AOWSIMPORT.
- Облік виробництва: SOAP-вебсервіс Production tracking (GESMTK), операція save.
Ця схема працює як у хмарній, так і в локальній версії X3, оскільки не потребує прямого доступу до файлової системи чи бази даних. У X3 нічого встановлювати не потрібно: інтеграція використовує підключений застосунок, користувача Syracuse та вебсервіси, опубліковані в GESAWE.
Події: передбачте періодичне опитування
У відкритій документації Sage для розробників X3 не описано функцій вихідних вебхуків або бізнес-подій. Налаштування “Callback URL”, додане у 2024 R1, використовується Mobile Automation і Web Scheduling для викликів SOAP-вебсервісів. Це не універсальна система подій. Виявляйте зміни, зчитуючи дані за розкладом: через запити GraphQL, курсор часових позначок Sync API у хмарній версії або періодичний експорт за шаблонами.
Зіставлення даних Sage X3 і SkyPlanner
| Об’єкт Sage X3 (таблиця, функція) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
| Продукція, ITMMASTER | Продукція | X3 → SkyPlanner | Початкове завантаження, далі — за розкладом |
| Виробнича BOM (GESBODP) | Багаторівнева структура виробу, матеріали | X3 → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Технологічний маршрут (GESROU): OPENUM, робочий центр WST, SETTIM, OPETIM, одиниця часу TIMUOMCOD | Технологічні операції з часом налагодження та виконання | X3 → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Робочий центр (GESMWS, WORKSTATIO): WST, WSTTYP, WSTNBR, EFF, SHR, альтернативні центри із зазначенням пріоритету | Робочий центр, ефективність, альтернативи | X3 → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Група робочих центрів (WCR) | Групи робочих центрів | X3 → SkyPlanner | Початкове завантаження |
| Тижнева структура (TWD), розклади робочого часу, таблиця змін потужностей, DEFDIH | Зміни, понаднормові зміни, відсутності | X3 → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Виробничі замовлення: MFGHEAD, MFGOPE, з продукцією та матеріалами | Замовлення, матеріали, технологічні операції | X3 → SkyPlanner | Опитування кожні 5–15 хв |
| Складські залишки за майданчиками | Складські залишки | X3 → SkyPlanner | Періодичне опитування |
| Замовлення на закупівлю (POH): відкриті рядки, очікувана дата надходження | Надходження матеріалів з очікуваною датою поставки | X3 → SkyPlanner | Опитування кожні 5–15 хв |
| Вкладка Operations у GESMFG: Start OPESTR, End OPEEND, робочий центр | Заплановані початок і завершення, вибраний робочий центр | SkyPlanner → X3 | У разі зміни графіка (вебхук) |
| Облік виробництва (GESMTK): час технологічних операцій, кількості, облік матеріалів, звітність про випуск продукції | Записи робочого часу, кількості, витрати матеріалів | SkyPlanner → X3 | За кожного підтвердження (вебхук) |
Підтверджені виробничі замовлення завантажуйте завжди. Планові завантажуйте, якщо планувальники хочуть бачити їх на діаграмі Gantt як попереднє завантаження потужностей. Пропозиції залишаються в MRP, доки їх не перетворять на виробничі замовлення.
Схеми інтеграції
1. Початкове завантаження основних даних. Спершу завантажте робочі центри й календарі, а потім — продукцію, BOM і технологічні маршрути, оскільки маршрути містять посилання на робочі центри.
2. Синхронізація замовлень. Періодично опитуйте MFGHEAD і MFGOPE, щоб отримувати нові та змінені виробничі замовлення. Кожен рядок MFGOPE зіставте з технологічною операцією SkyPlanner на робочому центрі, визначеному кодом WST. З такою самою періодичністю синхронізуйте відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки за замовленням на закупівлю та оновлює складські залишки, коли це замовлення отримує статус Delivered. Так перевірка забезпеченості матеріалами враховує і складські залишки, і очікувані надходження.
3. Запис графіка назад у X3. Вебхук SkyPlanner спрацьовує, коли змінюється графік. Інтеграція викликає операцію modify об’єкта Work order (GESMFG), опублікованого як SOAP-вебсервіс у GESAWE. Для кожної зміненої технологічної операції оновлюються Start (OPESTR), End (OPEEND) і робочий центр. Для пакетного оновлення ці самі поля передаються через шаблон імпорту виробничих замовлень за допомогою AOWSIMPORT. Записуйте лише дати й робочі центри — ніколи не змінюйте кількості, рядки BOM або технологічні маршрути.
4. Повернення даних про вибраний верстат. Якщо робочі центри зіставлено один до одного, вибраний алгоритмом альтернативний верстат передається назад як робочий центр технологічної операції. Отже, X3 фіксує верстат, який фактично виконує виробниче завдання. Якщо робочий центр X3 представляє групу верстатів, у черзі оператора відображається конкретний верстат. До X3 передається робочий центр групи разом із запланованими датами.
5. Підтвердження виконання з виробничого цеху. Оператори реєструють виконану роботу через Mobile Confirmations або Production Timer. Інтеграція передає кожне підтвердження через операцію save об’єкта Production tracking (GESMTK): час і кількість — до обліку технологічних операцій, а також витрати матеріалів, якщо ви ведете їх облік там. X3 приймає записи виробничого обліку лише для виробничих замовлень зі статусом Firm. Компоненти мають бути в наявності, якщо тільки в налаштуваннях продукції для майданчика не вибрано Release if shortage (MFGSHTCOD).
6. Надійна синхронізація. Використовуйте ID запису робочого часу SkyPlanner як ключ для кожного передавання облікових даних і зберігайте номер створеного запису обліку X3. Це запобігає дублюванню записів у разі повторного надходження вебхука. Під час наступного опитування видаляйте з графіка виробничі замовлення, закриті або скасовані в X3. Реєструйте відхилені виклики разом із повідомленням про помилку X3 замість того, щоб повторювати їх наосліп. Поки X3 недоступна, ставте зміни в чергу, щоб після відновлення доступу передати їх у належному порядку.
7. Розподіл відповідальності за дані. X3 визначає, що виготовляти: продукцію, кількість, BOM, технологічний маршрут і майданчик. SkyPlanner визначає, коли й де: послідовність, робочий центр, час початку та завершення. Узгодьте, що планувальники більше не переплановуватимуть замовлення, якими керує SkyPlanner, у Planning workbench і не запускатимуть для них FUNMAUTJ. Інакше їхні зміни буде перезаписано під час наступного запису даних назад у X3.
Типові етапи проєкту
Зазвичай впровадження завершується протягом кількох тижнів від початку роботи. Проєкт інтеграції із Sage X3 охоплює такі етапи:
- Тестування на власних даних. Експортуйте робочі центри, технологічні маршрути та поточний стан відкритих виробничих замовлень за допомогою шаблонів експорту X3 або Excel та імпортуйте їх у форматі CSV. Налаштуйте зміни, коефіцієнти ефективності й пріоритети так, щоб діаграма Gantt відображала реальну ситуацію.
- Зіставлення основних даних. Зіставте робочі центри GESMWS із робочими центрами SkyPlanner, операції GESROU — з технологічними операціями, одиниці часу й тижневі структури — зі змінами. Водночас усуньте помилки: операції маршрутів без робочих центрів, дні без розкладів робочого часу та неправильні одиниці часу.
- Початкове завантаження. Продукція, виробничі специфікації BOM, технологічні маршрути й робочі центри, а потім календарі.
- Синхронізація замовлень і замовлень на закупівлю. Підключений застосунок, користувач Syracuse, запити GraphQL або експорт за шаблонами, а також завдання періодичного опитування для отримання виробничих замовлень, запасів і відкритих замовлень на закупівлю.
- Зворотний запис графіка. SOAP-вебсервіс Work order, опублікований у GESAWE, з обробкою помилок і веденням журналу.
- Підтвердження з виробничого цеху. Дані Mobile Confirmations передаються в X3 через вебсервіс Production tracking (GESMTK).
- Тестування паралельно з поточним планом. Перед переходом планувальники порівнюють обидва плани.
- Запуск в експлуатацію. Вимкніть ручне перепланування в X3 для замовлень, якими керує SkyPlanner.
Підводні камені Sage X3
- Пропозиції — це не виробничі замовлення. Пропозиції MRP не мають рядків технологічних операцій MFGOPE, доки їх не перетворено на планові або затверджені виробничі замовлення. Тому включайте до графіка перетворені замовлення, а не пропозиції.
- Прогалини в календарях. Для робочого дня без розкладу часу застосовується типова схема DEFDIH. Якщо день не заповнено й типової схеми немає, дати та завантаження розраховуються неправильно. Перед експортом календарів призначте розклад часу кожному робочому дню в кожній тижневій структурі.
- Застарілі дані завантаження за періодами. Після зміни потужностей або календаря наявні дані завантаження X3 за періодами не оновлюються, доки ви не виконаєте перепланування та не запустите Recalculate loads (FUNMIWL). Не перевіряйте результати SkyPlanner за застарілими даними Loads inquiry (CONSMWK).
- No. of resources означає чисельність бригади. WSTNBR — це кількість ресурсів, потрібних для технологічної операції на робочому центрі, наприклад троє працівників на робочому центрі з ручною працею. Зіставте це поле з кількістю операторів на робочому центрі SkyPlanner: система планує одночасну роботу кількох людей над одним виробничим завданням. На майданчиках, де використовували розширений інтерфейс GFS, це поле має значення 1 відповідно до вимог Sage. Тому перевірте, де зберігається фактична чисельність бригади.
- Технологічні операції маршруту без робочого центру неможливо призначити робочому центру SkyPlanner. На етапі зіставлення такі операції позначаються.
- Одиниці часу й альтернативні робочі центри. Тривалості в технологічному маршруті мають власну одиницю часу (TIMUOMCOD), а альтернативні робочі центри — пріоритет. Явно задайте відповідності для обох параметрів і повторюйте перевірку зіставлення після кожного оновлення X3.
- Заблоковані замовлення. Якщо на майданчику також використовували Production Scheduler, передані туди замовлення мають статус Being optimized. Їх не можна змінювати, доки вони не будуть вилучені з планування (PSOPTFREE). Зніміть це блокування перед переходом.
Хто налаштовує інтеграцію із Sage X3
Роботи охоплюють зіставлення ваших папок X3, правил побудови технологічних маршрутів, структур робочих центрів та індивідуальних доробок із даними SkyPlanner. Також враховуються обмеження, які X3 не зберігає як дані для календарного планування: матриця часу переналагодження, інструменти, кількість операторів та альтернативні виробничі ресурси.
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску. Кожен завод використовує X3 по-своєму, і саме тут цей досвід стає в пригоді. Команда підключає вашу кінцеву точку X3 у хмарі або локально, перевіряє основні дані на етапі зіставлення та реєструє відхилені X3 запити для подальшого опрацювання. Від першого дня за інтеграцію є чітко визначений відповідальний, а вам не потрібен штатний розробник інтеграцій.
- Ваш партнер Sage може долучитися. Він знає ваші папки, коди активності та індивідуальні доробки й може разом із командою перевірити підключений застосунок, користувача Syracuse та публікації GESAWE.
- Ваші розробники можуть розширювати інтеграцію. REST API SkyPlanner дає змогу читати й записувати замовлення, продукцію, матеріали, етапи процесу та записи обліку часу. Він використовує автентифікацію JWT і має документацію Swagger/OpenAPI (довідник API). Для початку достатньо ключа API, а посібник з інтеграції покроково пояснює перші виклики. За потреби команда SkyPlanner допомагає. Документація SkyPlanner охоплює продукцію та матеріали, а також замовлення на закупівлю. У Laboratory & Allied штатна ІТ-команда підключила SkyPlanner до SAP Business One переважно власними силами, за допомоги SkyPlanner.
Чому команди, які працюють з X3, обирають SkyPlanner для календарного планування
Обирайте SkyPlanner, якщо хочете запустити систему за кілька тижнів, а не після багатомісячного проєкту впровадження APS.
Обирайте SkyPlanner, якщо хочете почати календарне планування ще до завершення інтеграції.
Під час пробного періоду планувальники складають графіки на основі CSV, поки налаштовується читання даних з X3 і зворотний запис. Після запуску інтеграція замінює імпорт файлів.
Обирайте SkyPlanner, якщо вам потрібна інтеграція з мінімальною інфраструктурою.
Вебхуки передають зміни графіка й статусів у реальному часі, тому проміжне ПЗ опитує лише X3. Рушій Arcturus AI будує графік за секунди, а Autopilot автоматично переплановує його, коли на виробництві відбуваються зміни.
Обирайте SkyPlanner, якщо дані X3 мають стати основою моделі реальних виробничих обмежень.
Чисельність бригади відображається як кілька операторів на одному робочому центрі, а робочі центри для заміни — як альтернативні верстати. Матриця часу переналагодження враховує переходи між виробами залежно від їхньої послідовності. Доступність інструментів обмежена, тому оснащення, яке використовується на одному верстаті, ніколи не резервується на іншому одночасно.
Обирайте SkyPlanner, якщо облік виробництва має починатися безпосередньо в цеху.
Оператори реєструють виконану роботу на телефоні або планшеті за допомогою Mobile Confirmations, Production Timer і Quick Log Mode. Ті самі записи обліку часу передаються в X3 як дані виробничого обліку.
Вартість починається від 199 € на місяць за щомісячної оплати, з 5 робочими центрами в комплекті. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із вартістю тарифу. Так ви бачите повну суму ще до початку роботи. Перегляньте ціни та можливості або розпочніть 30-денний безкоштовний пробний період із підтримкою до 20 робочих центрів без банківської картки.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
98%надійності поставок проти приблизно 50% раніше
«SkyPlanner відіграє вирішальну роль у підтриманні надійності наших поставок».
Hannu Lahtinen, керуючий директор
KJH-Comp · Вироби з листового металу та контрактне виробництво
Надійність поставок зросла з приблизно 50% аж до 98%, а для календарного планування тепер потрібен один майстер замість двох.
99,2%надійності поставок
«SkyPlanner зробив вузькі місця видимими, а управління виробництвом — зрозумілішим».
Toni Tuori, керівник виробництва
Piristeel · Системи безпеки покрівлі та водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування заощаджує до чотирьох годин робочого часу на день.
Поширені запитання
Як SkyPlanner APS інтегрується із Sage X3?
Обмін двосторонній: через GraphQL, REST api1, вебсервіси SOAP і шаблони. До SkyPlanner надходять виробничі замовлення, технологічні маршрути й робочі центри. Планові дати технологічних операцій та зареєстровані години передаються назад за допомогою вебхуків у міру зміни графіка. Команда SkyPlanner налаштовує інтеграцію під час впровадження, або ваш партнер Sage X3 чи розробники створюють її на основі REST API SkyPlanner.
Як дати технологічних операцій записуються назад у Sage X3?
Через об’єкт Work order (GESMFG), опублікований як вебсервіс SOAP у функції Web services (GESAWE). Його операція modify оновлює Start (OPESTR), End (OPEEND) і робочий центр для кожної технологічної операції. Для пакетних оновлень шаблон імпорту виробничих замовлень запускається через AOWSIMPORT. Години й кількості передаються через об’єкт Production tracking (GESMTK).
Що використовувати: GraphQL чи вебсервіси SOAP?
Обидва варіанти — кожен там, де він найсильніший. GraphQL — це рекомендований Sage API для читання даних про продукцію, майданчики, закупівлі та запаси як у хмарі, так і в локальній інсталяції. Об’єктні вебсервіси SOAP записують графік і дані виробничого обліку, а SOAP Template Services запускають шаблони імпорту й експорту для масового завантаження.
Як уникнути дублювання записів або втрати змін?
Використовуйте ID запису обліку часу SkyPlanner як ключ кожного запису Production tracking і зберігайте номер запису виробничого обліку, який повертає X3. Так повторний вебхук буде розпізнано й пропущено. Поки X3 недоступна, ставте зміни в чергу, а після відновлення доступу передавайте їх послідовно. Реєструйте відхилені запити разом із повідомленням про помилку X3 — наприклад, спробу записати виробничий облік для замовлення, яке не має статусу Firm.
Чи потрібні для SkyPlanner коди активності POPS або GFS?
Ні. Ці коди активують власний Production Scheduler від Sage та універсальний інтерфейс до Web Scheduling. SkyPlanner читає виробничі замовлення через GraphQL, REST api1 або шаблони, а записує дані назад через вебсервіси SOAP Work order і Production tracking.
Як SkyPlanner отримує нові виробничі замовлення із Sage X3?
Інтеграція часто опитує X3, зчитуючи дані через GraphQL, REST api1 або експорт за шаблонами; у хмарному середовищі також можна використовувати Sync API. У зворотному напрямку вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Чи можна протестувати роботу з даними Sage X3, перш ніж починати розробку?
Так. Під час 30-денного пробного періоду імпортуйте CSV-файли з експортованими даними робочих центрів, технологічних маршрутів і відкритих виробничих замовлень. Щоб визначити обсяг робіт з інтеграції з X3, зверніться до відділу продажів.
