Інтеграції / ERP / Sage 100
Посібник з інтеграції Sage 100 для календарного планування виробництва у SkyPlanner APS
Цей посібник з інтеграції Sage 100 пояснює партнерам Sage та ІТ-командам, як підключити Sage 100 до SkyPlanner APS. Він охоплює обидва продукти з цією назвою: Sage 100 із модулем Production Management у США та Канаді й Sage 100 із модулем Sage 100 Produktion у Німеччині та Австрії. SkyPlanner обмінюється даними із Sage 100 в обох напрямках:
- До SkyPlanner надходять виробничі наряди або Fertigungsaufträge з їхніми етапами або Arbeitsgänge, а також робочі центри, номенклатура, складські залишки й замовлення на закупівлю.
- Заплановані дати передаються назад для кожного етапу або Arbeitsgang.
- Записи часу операторів передаються назад як записи трудовитрат (US) або Rückmeldungen (DE).
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Sage 100 і підтримує її після запуску в експлуатацію. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створити інтеграцію на основі задокументованого REST API SkyPlanner (довідник API).
Sage 100 для США: інтерфейси інтеграції
Американська версія Sage 100 працює локально у редакціях Standard, Advanced або Premium. Її інтерфейси інтеграції розміщені на сервері Sage 100.
Business Object Interface (BOI).
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).” (Інтерфейс Business Objects Interface дає стороннім розробникам із необхідними навичками доступ до програм і застосунків цієї системи через Component Object Model (COM).) (Довідка Sage 100) Портал Sage для розробників називає його “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.” (Внутрішній рівень API цієї системи, що надає доступ до тієї самої логіки, яку використовує сам застосунок.) (developer.sage.com) Запис даних здійснюється через BOI: кожна операція створення чи оновлення проходить ті самі перевірки, що й дії користувача в Sage 100.
ODBC.
Драйвер ProvideX ODBC зчитує таблиці Sage 100 для звітності та масового читання даних. У редакції Advanced доступний клієнт-серверний драйвер ODBC. Інтеграція використовує ODBC для масового зчитування виробничих нарядів, номенклатури й замовлень на закупівлю, а BOI — для запису.
Visual Integrator (VI).
Завдання імпорту й експорту VI передають дані між Sage 100 та файлами або джерелами ODBC. Sage зазначає: “One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.” (Одна з найпотужніших можливостей модуля Visual Integrator — прямий імпорт даних із джерела ODBC та експорт до нього.) (Джерело) VI входить до пакета Essentials і підходить для обміну через файли.
eBusiness Web Services працює через SOAP та охоплює “the Sage 100 sales order, customer, and customer contact entities.” (Сутності замовлень на продаж, клієнтів і контактних осіб клієнтів у цій системі.) (Джерело) Через цей сервіс можна передавати замовлення на продаж, а виробничі дані передаються через BOI та ODBC.
Інтеграція працює разом із Sage 100 під обліковим записом користувача Sage 100, який має права на всі потрібні їй операції в Production Management, Inventory та Purchase Order. Вихідні дані передаються до REST API SkyPlanner через HTTPS.
Sage 100 для Німеччини: інтерфейси інтеграції
Німецька версія Sage 100 працює на Microsoft SQL Server — локально або у хмарному варіанті. За словами Sage, можна “Partnerlösungen via API-Schnittstelle ergänzen” (додавати партнерські рішення через інтерфейс API) (Sage 100). Виробничі доповнення, наведені в каталозі Sage, побудовані на Sage AppDesigner та бізнес-об’єктах Sage 100.
Інтеграція використовує той самий підхід, що й партнерські рішення Sage: зчитує Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel та Bestellungen із бази даних Sage 100 на SQL Server. Дати Arbeitsgang і Rückmeldungen передаються назад через механізм запису, який ваш партнер Sage та команда SkyPlanner узгоджують під час визначення обсягу проєкту. Так записи виконуються за власною логікою Sage 100. Ваш партнер Sage підтверджує версію (наприклад, 9.0) та налаштування доступу.
Автентифікація та доступ
| Сторона інтеграції | Спосіб автентифікації |
|---|---|
| Sage 100 для США, BOI | Сеанс користувача Sage 100 на сервері Sage 100 із рольовими правами на кожну використовувану операцію |
| Sage 100 для США, ODBC | DSN у середовищі встановлення Sage 100, доступ для читання |
| Sage 100 для Німеччини | Обліковий запис користувача Sage 100 для зворотного запису та доступ до SQL Server для читання, узгоджені з вашим партнером Sage |
| SkyPlanner | Токен API у заголовку Authorization-Token, створений у SkyPlanner у розділі Settings > API |
REST API SkyPlanner задокументовано у Swagger/OpenAPI. Навчальний посібник з інтеграції покроково пояснює перші виклики.
Виявлення змін
Зміни в Sage 100 виявляються під час зчитування за розкладом. Зчитуйте відкриті виробничі наряди або Fertigungsaufträge з короткими інтервалами, а складські залишки та замовлення на закупівлю — щогодини. Застосовуйте фільтри за статусом і датами змін, щоб щоразу передавати лише змінені дані.
Коли розклад змінюється, SkyPlanner надсилає вебхуки, тож зворотний запис у Sage 100 запускається за подіями.
Зіставлення даних
| Sage 100 (US) | Sage 100 (DE) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|---|
| Item | Artikel | Продукція та матеріали | Sage 100 → SkyPlanner | Початкове завантаження, потім щодня |
| Bill of Materials, матеріали шаблону | Stückliste у Ressourcenliste | Структура виробу, складові вироби, матеріали для кожного виробу | Sage 100 → SkyPlanner | У разі змін |
| Робочий центр: працівники або верстати, години роботи за днями тижня, періоди зупинки | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Робочі центри, групи робочих центрів, персонал, зміни | Sage 100 → SkyPlanner | Початкове завантаження |
| Етапи шаблону виробничого наряду, коди видів робіт | Arbeitsplan, Arbeitsgänge з Rüst- та Stückzeiten | Етапи процесу з часом налагодження та виконання | Sage 100 → SkyPlanner | У разі змін |
| Виробничий наряд з етапами та терміном виконання | Fertigungsauftrag з Arbeitsgänge, Liefertermin | Замовлення та виробничі завдання з термінами виконання | Sage 100 → SkyPlanner | Зчитування з короткими інтервалами |
| Кількість запасів на кожному складі | Lagerbestand | Складські залишки | Sage 100 → SkyPlanner | Щогодини |
| Рядки замовлень на закупівлю, потрібні дати поставки | Bestellungen, Liefertermine | Замовлення на закупівлю з очікуваною датою поставки | Sage 100 → SkyPlanner | Щогодини |
| Рядки замовлень на продаж, обіцяні дати поставки | Kundenaufträge | Терміни виконання замовлень клієнтів, пріоритет клієнта | Sage 100 → SkyPlanner | Зчитування з короткими інтервалами |
| Дати етапів виробничого наряду (BOI) | Arbeitsgang-Termine | Заплановані початок, завершення та робочий центр для кожного етапу | SkyPlanner → Sage 100 | У разі змін, через вебхук |
| Labor Entry, завершення виробничого наряду (BOI) | Rückmeldung: Zeiten, Mengen | Записи часу та підтвердження операторів | SkyPlanner → Sage 100 | Після кожного підтвердження або за зміну |
| Не зберігається в Sage 100 | Не зберігається в Sage 100 | Матриця часу налагодження, інструменти як обмежені ресурси, оператори для кожного виробничого завдання, альтернативні робочі центри | Ведеться у SkyPlanner | Під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Спочатку завантажте номенклатуру й робочі центри, а потім шаблони або Arbeitspläne з їхніми етапами. Робочий центр американської версії із трьома верстатами та двома операторами перетворюється у SkyPlanner на три робочі центри, групу робочих центрів і двох працівників. Кожен із них отримує власну часову шкалу.
2. Синхронізація замовлень. Зчитуйте відкриті виробничі наряди або Fertigungsaufträge з їхніми етапами, а також складські залишки й відкриті замовлення на закупівлю. Перш ніж розмістити виробниче завдання в розкладі, SkyPlanner перевіряє і залишки, і очікувані поставки. Sage 100 і далі пропонує роботи, а SkyPlanner складає розклад для замовлень, які ви запускаєте у виробництво.
3. Зворотний запис розкладу. Для кожного етапу, який механізм планування розмістив або переніс, SkyPlanner надсилає заплановані початок, завершення та робочий центр. В американській версії Sage 100 інтеграція оновлює дати етапів виробничого наряду через BOI. У німецькій версії Sage 100 вона оновлює дати Arbeitsgang через механізм, узгоджений під час визначення обсягу проєкту. Облік кількостей, резервування та розрахунок собівартості залишаються в Sage 100.
4. Підтвердження з виробництва. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи часу підтримують актуальність розкладу. В американській версії Sage 100 зареєстрований час стає записом Labor Entry для відповідного етапу виробничого наряду, а остаточне підтвердження закриває наряд. У німецькій версії Sage 100 він перетворюється на Rückmeldung із часом і кількостями. Якщо на вашому підприємстві час уже реєструють у Betriebsdatenerfassung або застосунку зі штрихкодами, виберіть один канал реєстрації.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, специфікації матеріалів, шаблони, обсяги замовлень, витрати | Sage 100 |
| Послідовність операцій, час початку й завершення, призначення робочих центрів | SkyPlanner |
| Матриця часу переналагодження, інструменти, оператори для кожного виробничого завдання, альтернативні ресурси | SkyPlanner |
| Labor і Rückmeldungen | Sage 100, куди надходять записи обліку часу зі SkyPlanner |
Основне джерело конфліктів — друга система календарного планування. Якщо планувальники й далі запускають Enhanced Scheduling в американській версії Sage 100 або перетягують завдання на Plantafel у німецькій версії Sage 100, дати визначають одразу дві системи. Залиште визначення дат операцій за SkyPlanner. Завдяки Autopilot SkyPlanner автоматично перебудовує графік, коли у виробництві відбуваються зміни.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку підключення. Перед цим перевірте графік упродовж 30-денного безкоштовного пробного періоду, імпортувавши відкриті виробничі наряди або Fertigungsaufträge з CSV чи Excel. Далі проєкт проходить такі етапи:
- Визначення обсягу. Узгодьте продукт (американська чи німецька версія Sage 100), версію та спосіб розгортання, способи читання й запису даних, частоту синхронізації та канал обліку часу.
- Доступ. Ваш партнер Sage налаштовує користувача Sage 100, його права та доступ до бази даних.
- Початкове завантаження. Номенклатура, робочі центри, шаблони або Arbeitspläne, специфікації матеріалів і зміни.
- Синхронізація замовлень. Виробничі наряди або Fertigungsaufträge, замовлення на закупівлю та складські залишки синхронізуються за розкладом.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати чи працівники.
- Зворотний запис графіка. Передавання планових дат операцій до Sage 100, а потім — даних обліку праці та Rückmeldungen.
- Паралельне тестування та запуск в експлуатацію. Порівняйте дати з поточним планом, виправте основні дані, а потім увімкніть зворотний запис.
Що врахувати під час інтеграції із Sage 100
- Уточніть, яку саме Sage 100 ви використовуєте. Американська й німецька версії Sage 100 мають різні моделі даних та інтерфейси. Назвіть продукт і версію під час першої розмови щодо визначення обсягу.
- Робочі центри, що об’єднують кілька верстатів. В американській версії робочий центр — це одна одиниця потужності, що охоплює “one or more persons or machines” (одного чи більше працівників або верстатів). Для кожного такого центру визначте, чи буде він представлений у SkyPlanner як один робочий центр, кілька робочих центрів або група.
- Час налагодження та виконання. Шаблони й Arbeitspläne містять тривалість операцій, яку SkyPlanner використовує для побудови графіка. Перед запуском в експлуатацію звірте ці дані з фактичною тривалістю виконання.
- Календарі. Робочі центри в американській версії містять години роботи за днями тижня та періоди, коли вони не працюють. Завантажте їх як зміни SkyPlanner, а потім додайте у SkyPlanner зміни й відсутності кожного оператора.
- Одиниці вимірювання. Операції можуть обліковуватися поштучно, за партіями або за годинами. Зіставте одиниці вимірювання для кожної операції.
- Права BOI. BOI дотримується рольової моделі доступу Sage 100. Відсутність права на завдання блокує запис. Перевірте кожну операцію запису під обліковим записом користувача інтеграції.
- Одна система визначає дати. Щойно визначення дат переходить до SkyPlanner, вимкніть паралельні запуски календарного планування та припиніть переміщення завдань на Plantafel.
Хто налаштовує та підтримує інтеграцію із Sage 100
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску в експлуатацію.
- Ваш партнер Sage може долучитися. Партнер знає вашу версію Sage 100, налаштовує користувачів і права та підтверджує доступ до бази даних.
- Ваші розробники можуть розширювати інтеграцію за допомогою документованого REST API SkyPlanner. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби.
Після підключення рушій Arcturus будує графік на основі актуальних замовлень Sage 100, а кожна операція отримує планові дати. Вартість SkyPlanner — від 199 € на місяць із 5 робочими центрами та щомісячною оплатою. Вартість інтеграції розраховують заздалегідь відповідно до ваших процесів і потреб та вказують разом із вартістю тарифного плану, тож ви бачите повну вартість до початку роботи. Перегляньте ціни, функції та порівняння з власними засобами планування Sage 100 у матеріалі Планування виробництва з урахуванням реальних потужностей у Sage 100. Загальний огляд наведено на сторінці Sage 100. Окремі посібники для Sage 200 та Sage X3 доступні зі сторінок Sage 200 і Sage X3, а інші ERP представлені в розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
6 місяцівнаперед відділ продажів бачить вільні потужності
«SkyPlanner створює надійну основу для всього планування виробництва».
Ану Ярвінен, керівниця виробництва
Fredman Operations · Папір для пакування харчових продуктів
Відділ продажів бачить вільні потужності на шість місяців наперед, а на запити щодо змін графіка, які раніше потребували години чи більше, тепер відповідають за секунди.
100%надійність поставок із 2021 року
«SkyPlanner дає нам змогу бачити доступні потужності та робить планування передбачуваним».
Дан Берглунд, COO/CFO
Opes Corporation · Хімічне та харчове виробництво
Надійність поставок становить 100% протягом усього часу використання SkyPlanner — із 2021 року.
Поширені запитання
Чи має Sage 100 REST API для виробничих нарядів?
Американська версія Sage 100 надає доступ до бізнес-логіки через Business Object Interface, використовує ODBC для читання та Visual Integrator для завдань обробки файлів. SkyPlanner читає виробничі наряди через ODBC і BOI, а записує дати операцій і дані обліку праці через BOI. Дані німецької версії Sage 100 читаються з її бази SQL Server, а спосіб зворотного запису узгоджується з вашим партнером Sage під час визначення обсягу.
Хто розробляє інтеграцію із Sage 100?
Команда SkyPlanner налаштовує двосторонню інтеграцію з вашою конфігурацією Sage 100 під час підключення та підтримує її після запуску в експлуатацію. Ваш партнер Sage налаштовує користувачів, права й доступ до бази даних і може долучитися до робіт. Ваші розробники також можуть створювати рішення на основі документованого REST API SkyPlanner — для початку достатньо токена API.
Як планові дати записуються назад у Sage 100?
В американській версії Sage 100 інтеграція оновлює планові дати кожної операції виробничого наряду через BOI та створює записи Labor Entry на основі обліку часу операторів. У німецькій версії Sage 100 вона оновлює дати Arbeitsgang для кожного Fertigungsauftrag і реєструє Rückmeldungen способом запису, який ваш партнер Sage і команда SkyPlanner узгодили під час визначення обсягу.
Чи може Sage 100 передавати зміни в реальному часі?
SkyPlanner отримує зміни із Sage 100, читаючи дані за розкладом: відкриті замовлення — з короткими інтервалами, складські залишки й замовлення на закупівлю — щогодини. У зворотному напрямку вебхуки SkyPlanner передають зміни графіка відразу після їх внесення.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати виробничі наряди або Fertigungsaufträge з CSV чи Excel. Банківська картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
