Інтеграції / ERP / Sage 200
Посібник з інтеграції Sage 200 для календарного планування виробництва у SkyPlanner APS
Цей посібник з інтеграції Sage 200 пояснює бізнес-партнерам та ІТ-командам, як підключити Sage 200 Professional і його виробниче розширення до SkyPlanner APS. Інтеграція SkyPlanner із Sage 200 забезпечує обмін даними в обох напрямках:
- Через Sage 200 REST API надходять дані про продукцію, складські залишки, замовлення на закупівлю та замовлення на продаж.
- З виробничого розширення надходять виробничі замовлення, технологічні операції та дані про персонал і обладнання.
- Заплановані дати технологічних операцій передаються назад у виробничі замовлення.
- Записи часу роботи операторів передаються назад для обліку часу за кожною технологічною операцією.
Під час впровадження команда SkyPlanner налаштовує інтеграцію під вашу конфігурацію Sage 200, а після запуску підтримує її. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створювати рішення на основі документованого REST API SkyPlanner (довідник API).
Два джерела в одній системі Sage 200
На виробничому підприємстві система Sage 200 має два рівні, й інтеграція зчитує дані з обох.
1. Sage 200 REST API для комерційних і складських даних. За словами Sage, API “lets your application read and modify data in a Sage 200 site” (дає змогу вашому застосунку читати й змінювати дані в цій системі). Це охоплює клієнтів, постачальників, продукцію, замовлення на продаж і закупівлю та рахунки головної книги. У довіднику Sage 200 Professional (2025.02) ресурси згруповано в розділах Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP і Stock. Для календарного планування важливі такі ресурси:
| Ресурс | Які дані містить |
|---|---|
products | Код, назва, складська одиниця обліку, тип позиції BOM, нормативна собівартість |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Відкриті замовлення на закупівлю, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Попит клієнтів, requested_delivery_date, promised_delivery_date |
warehouses, units | Майданчики та одиниці вимірювання |
2. Виробниче розширення для роботи з виробничими замовленнями. У Sage 200 API немає кінцевих точок для виробничих замовлень, технологічних операцій чи виробничих ресурсів. Виробничі замовлення зберігаються в Sicon Works Order Processing, Cim200 або застарілому модулі Sage 200 Manufacturing. Інтеграція зчитує виробничі замовлення, технологічні операції та виробничі ресурси способом, який підтримує розширення. Цей спосіб узгоджують із вами та вашим партнером Sage 200 під час визначення обсягу проєкту.
Автентифікація та доступ
Sage 200 API “uses OAuth 2.0 with OpenID Connect” (використовує цей протокол разом з OpenID Connect) за схемою надання доступу через код авторизації. Вхід виконується через Sage ID.
- Приєднайтеся до Sage 200 API Developer Programme та подайте запит на облікові дані.
- Пов’яжіть Sage ID з користувачем Sage 200, який має доступ до компанії та функцій, потрібних для кінцевих точок, що ви використовуєте.
- Запросіть область доступу
offline_access, інакше токен оновлення не буде видано. - У кожному запиті до бази даних надсилайте
Authorization: Bearer <access_token>,X-SiteтаX-Company. Обидва ідентифікатори отримуйте через/sites.
Базова URL-адреса для Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. У запитах використовуються методи GET, POST, PUT і DELETE та параметри запитів OData: $filter, $select, $top, $skip, $orderby і $expand.
У Sage 200 Professional API вмикає постачальник послуг підтримки клієнта. За контрольним списком Sage він підтверджує, що “the API is enabled” (API увімкнено) і що “each required user has a Sage ID assigned.” (кожному користувачеві, якому потрібен доступ, призначено Sage ID). У Sage 200 Standard API увімкнено за замовчуванням.
Строки дії токенів потрібно враховувати під час проєктування. Токени доступу діють 8 годин. Токени оновлення діють від 1 до 90 днів, причому “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (Період оновлення відлічується від першого входу користувача, а не від останнього оновлення токена). Sage зазначає, що повторна автентифікація “is unavoidable” (неминуча). Передбачте сповіщення про необхідність повторної згоди до завершення цього періоду.
На боці SkyPlanner автентифікація REST API виконується за допомогою токена API (SkyPlanner Settings > API). Документація доступна у Swagger/OpenAPI. Перші виклики покроково описано в навчальному посібнику з інтеграції.
Виявлення змін
У довіднику Sage 200 API немає ресурсів для вебхуків чи підписок. Зміни виявляються періодичним опитуванням. Записи містять поля date_time_created і date_time_updated, тому під час кожного опитування дані фільтруються за date_time_updated за допомогою $filter, а посторінкове отримання виконується через $top і $skip.
Опитуйте виробничі замовлення кожні кілька хвилин, а складські залишки й рядки замовлень на закупівлю — щогодини. SkyPlanner надсилає вебхуки, коли графік змінюється, тож зворотний запис виконується за подіями.
Зіставлення даних
| Об’єкт Sage 200 (джерело) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
products, units (API) | Продукція та матеріали | Sage 200 → SkyPlanner | Завантаження, потім періодичне опитування |
| Компоненти BOM (розширення або модуль BOM) | Структура виробу, складові вироби, матеріали для кожного виробу | Sage 200 → SkyPlanner | У разі зміни |
| Персонал, обладнання та групи виробничих ресурсів (розширення) | Робочі центри, групи робочих центрів, персонал | Sage 200 → SkyPlanner | Початкове завантаження |
| Доступність виробничих ресурсів: зупинки, технічне обслуговування, відпустки (розширення) | Зміни, відсутності | Sage 200 → SkyPlanner | Щодня |
| Виробничі замовлення, їхні технологічні операції та час на кожну операцію (розширення) | Замовлення та виробничі завдання з етапами, тривалістю й термінами виконання | Sage 200 → SkyPlanner | Кожні кілька хвилин |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Терміни виконання замовлень клієнтів | Sage 200 → SkyPlanner | Періодичне опитування |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Складські залишки | Sage 200 → SkyPlanner | Щогодини |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Замовлення на закупівлю з очікуваною датою постачання | Sage 200 → SkyPlanner | Щогодини |
| Заплановані початок і завершення технологічної операції виробничого замовлення та призначений виробничий ресурс | Заплановані початок, завершення та робочий центр для кожної технологічної операції | SkyPlanner → Sage 200 | У разі зміни, через вебхук |
| Облік часу за технологічними операціями (розширення) | Записи часу та підтвердження операторів | SkyPlanner → Sage 200 | За кожним підтвердженням або за кожну зміну |
| Дані про обмеження у SkyPlanner | Матриця часу переналагодження, інструменти як виробничі ресурси з обмеженою доступністю, альтернативне обладнання та персонал | Ведуться у SkyPlanner | Під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Отримайте продукцію та одиниці вимірювання через API, а потім виробничі ресурси, їхні групи та технологічні операції BOM із розширення. Групу з трьох однакових верстатів можна представити як одну групу робочих центрів або три робочі центри.
2. Синхронізація замовлень. Зчитайте відкриті виробничі замовлення з їхніми технологічними операціями з розширення, а також відкриті pop_order_lines і warehouse_holdings через API. Під час побудови графіка перевіряються як складські залишки, так і очікувані закупівлі. MRP і далі пропонує виробничі замовлення в Sage 200, а SkyPlanner складає графік для тих, які ви створюєте.
3. Зворотний запис графіка. Для кожної технологічної операції, яку алгоритм розмістив у графіку або переніс, SkyPlanner передає назад у виробниче замовлення заплановані початок, завершення та виробничий ресурс. Розширення й далі самостійно веде облік кількостей, резервування та розрахунок собівартості.
4. Підтвердження з виробничого цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи часу підтримують актуальність графіка. Зареєстрований час передається назад і зараховується відповідній технологічній операції виробничого замовлення, тож розрахунок собівартості в Sage 200 враховує фактичні години.
Якщо ваше підприємство вже веде облік часу в Sicon Shop Floor Data Capture або Cim200 Shop Floor Data Capture, виберіть один канал реєстрації часу.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Продукція, BOM, кількості у виробничих замовленнях, резервування, витрати | Sage 200 і додатковий модуль |
| Послідовність технологічних операцій, час початку й завершення, призначення робочих центрів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів і операторів, альтернативні виробничі ресурси | SkyPlanner |
| Облік робочого часу | Sage 200 на основі записів обліку часу зі SkyPlanner |
Основне джерело конфліктів — графік завантаження потужностей. Якщо планувальники й далі перетягують виробничі замовлення або технологічні операції в Sicon Rough Cut Capacity Planning чи Cim200 Graphical Scheduler, дати визначають уже дві системи. Нехай дати технологічних операцій визначає SkyPlanner. Завдяки Autopilot SkyPlanner автоматично перебудовує графік у разі змін у виробництві.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку підключення. Перед цим перевірте графік у межах 30-денного безкоштовного пробного періоду, завантаживши відкриті виробничі замовлення з CSV або Excel. Далі проєкт проходить такі етапи:
- Визначення обсягу. Узгодьте додатковий модуль і його версію, способи зчитування виробничих замовлень і зворотного запису, частоту синхронізації та канал обліку робочого часу.
- Доступ до API. Постачальник послуг підтримки вмикає Sage 200 API, пов’язує Sage ID з користувачем Sage 200 і налаштовує доступ до компаній та функцій.
- Початкове завантаження. Продукція, одиниці виміру, виробничі ресурси та їхні групи, технологічні операції BOM і доступність.
- Синхронізація замовлень. Виробничі замовлення, рядки замовлень на закупівлю та складські залишки синхронізуються шляхом періодичного опитування; налаштовується сповіщення про необхідність повторної згоди.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів на виробниче завдання та альтернативні верстати або працівники.
- Зворотний запис графіка. Заплановані дати технологічних операцій передаються у виробничі замовлення; на цьому ж етапі додається облік робочого часу.
- Паралельне тестування та запуск. Порівняйте дати з поточним планом, виправте основні дані, а потім увімкніть зворотний запис.
Що врахувати під час інтеграції із Sage 200
- Застарілий модуль у новій версії. Починаючи із Sage 200 Professional 2025 R2, застарілий модуль Sage 200 Manufacturing використовувати не можна. Перш ніж налаштовувати будь-які зіставлення даних, уточніть, яке виробниче рішення працюватиме на момент запуску.
- Тривалість операцій на основі витрат. Sicon MRP оцінює витрати робочого й машинного часу за статтями витрат Sage 200 BOM. Спочатку звірте ці оцінки з фактичною тривалістю виконання.
- Розбіжності у статтях витрат. Sage попереджає: значення Nominal, Overhead Nominal та Overhead Recovery % у технологічних операціях BOM і статтях витрат мають збігатися, інакше “there will be cost discrepancies.” (виникнуть розбіжності у витратах).
- Строк поновлення. Максимальний строк у 90 днів відраховується від першого входу. Якщо згоду не надавати повторно, інтеграція зупинятиметься в той самий день кожного кварталу.
- Сайти з кількома компаніями. Один сайт може містити кілька компаній, тому в кожному запиті передавайте правильне значення
X-Company.
Інтеграція із Sage 200: хто налаштовує та підтримує
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску.
- Ваш бізнес-партнер Sage 200 може долучитися. Партнер знає ваш додатковий модуль і вмикає API у Sage 200 Professional.
- Ваші розробники також можуть розвивати інтеграцію через той самий документований REST API з токеном API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби.
Після підключення рушій Arcturus формує графік на основі актуальних виробничих замовлень Sage 200, а заплановані дати записуються в технологічні операції цих замовлень. Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; включено 5 робочих центрів. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із вартістю тарифу, тож повну суму ви знатимете ще до початку роботи. Перегляньте ціни, можливості та порівняння з власними засобами планування Sage 200 у матеріалі Планування виробництва в Sage 200 з урахуванням реальних потужностей обладнання та персоналу. Загальний огляд наведено на сторінці Sage 200, а інші ERP — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Калле Калліомякі, фахівець із ланцюгів постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
1 000+ виробничих замовлень плануються автоматично
«Ми зовсім інакше контролюємо виробництво, а наше розуміння виробничих потужностей вийшло на цілком інший рівень».
Ханну Рююнянен, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
Поширені запитання
Чи охоплює Sage 200 API виробничі замовлення?
Ні. Sage 200 Professional API охоплює продукцію, складські залишки, замовлення на продаж і закупівлю, фінанси тощо, але не має ресурсів для виробничих замовлень або технологічних операцій. Виробничі замовлення надходять із вашого додаткового виробничого модуля, наприклад Sicon Works Order Processing або Cim200, способом, узгодженим під час визначення обсягу.
Хто створює інтеграцію із Sage 200?
Команда SkyPlanner налаштовує двосторонню інтеграцію з вашою конфігурацією Sage 200 під час підключення та підтримує її після запуску. Ваш бізнес-партнер Sage 200 вмикає API й може долучитися до роботи. Ваші розробники також можуть створювати рішення на основі документованого REST API SkyPlanner — для початку достатньо токена API.
Чи може Sage 200 надсилати зміни в реальному часі?
Sage 200 API не підтримує вебхуки. Зміни складських залишків і замовлень на закупівлю перевіряються періодичними запитами за date_time_updated, а виробничі замовлення зчитуються з вашого додаткового модуля кожні кілька хвилин. У зворотному напрямку власні вебхуки SkyPlanner надсилають зміни графіка одразу після їх появи.
Чи можна протестувати SkyPlanner до створення інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати виробничі замовлення з CSV або Excel. Кредитна картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
