Інтеграції / ERP / Exact
Посібник з інтеграції Exact Online для календарного планування виробництва у SkyPlanner APS
Цей посібник пояснює партнерам Exact та ІТ-командам, як підключити Exact Online Manufacturing до SkyPlanner APS. Обмін даними між SkyPlanner та Exact Online відбувається в обох напрямках:
- Через REST API Exact Online надходять виробничі замовлення, етапи технологічних маршрутів, плани потреб у матеріалах, робочі центри, технологічні операції та специфікації матеріалів.
- Надходять дані номенклатури, складські залишки, замовлення на закупівлю та замовлення клієнтів. Про зміни повідомляють вебхуки Exact Online.
- Заплановані дати початку й завершення передаються назад у кожен етап технологічного маршруту та у виробниче замовлення.
- Записи обліку часу операторів передаються як операції обліку часу, а кількість готової продукції — як надходження за виробничими замовленнями.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Exact Online та підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створити рішення на основі документованого REST API SkyPlanner (довідник API). Наприкінці наведено короткий розділ про Exact Globe+.
REST API Exact Online для виробництва
Exact Online надає доступ до даних через єдиний REST API, у якому ресурси згруповано за сервісами. Базовий шлях — /api/v1/{division}/<service>/<resource>, де division позначає компанію в Exact Online. У довіднику REST API для сервісу manufacturing наведено такі ресурси для календарного планування:
| Ресурс | Вміст | Методи |
|---|---|---|
manufacturing/ShopOrders | Номер виробничого замовлення, позиція номенклатури, PlannedQuantity, PlannedStartDate, PlannedDate, статус, ознака запуску у виробництво | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Етап технологічного маршруту для виробничого замовлення: технологічна операція, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Рядки матеріалів для виробничого замовлення | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Код, тип, виробнича дільниця, величина потужності, ставки | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Технологічні операції та робочі центри, на яких вони виконуються, час налагодження та виконання | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Версії BOM, компоненти та технологічний маршрут | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Години, зареєстровані за виробничим замовленням та етапом технологічного маршруту | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Кількість готової продукції, оприбуткованої за виробничим замовленням | GET, POST |
manufacturing/MaterialIssues | Матеріали, видані на виробниче замовлення | GET, POST |
manufacturing/ShopOrderPriorities | Режим пріоритету для виробничого замовлення | GET, PUT |
Ресурси інших сервісів:
| Ресурс | Вміст |
|---|---|
logistics/Items | Основні дані номенклатури |
inventory/ItemWarehouses | Залишки за позиціями номенклатури та складами |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Відкриті замовлення на закупівлю та дати надходження |
salesorder/SalesOrders, SalesOrderLines | Попит клієнтів та дати постачання |
Автентифікація та доступ
Exact Online використовує OAuth 2.0 зі схемою авторизації через код і токенами оновлення. Exact: “Before you can start integration with Exact Online, you must first register your app in the App Store.” (Перш ніж почати інтеграцію з Exact Online, потрібно зареєструвати застосунок в App Store.) (Довідка Exact Online) Для реєстрації застосунків потрібна передплата Exact Online Developer (Exact App Store).
- Інтеграцію реєструють як застосунок з URI перенаправлення.
- Користувач Exact Online із доступом до виробництва, складського обліку та закупівель одноразово надає згоду.
- Кожен запит містить
Authorization: Bearer <access_token>та ідентифікатор компанії у шляху. - Токени доступу оновлюють за допомогою токена оновлення. Exact обмежує частоту запитів нового токена, тому зберігайте токен у кеші до закінчення строку його дії.
Exact також обмежує кількість викликів за хвилину та за день для кожного застосунку й компанії та просить виконувати виклики послідовно, а не паралельно. Актуальні обмеження наведено у статті Exact про ліміти API. Інтеграція враховує ці вимоги: для вибіркового читання використовуються $filter та $select, а для масових змін — Sync API.
На боці SkyPlanner автентифікація в REST API відбувається за допомогою токена API в заголовку Authorization-Token (SkyPlanner Settings > API). API задокументовано у Swagger/OpenAPI. У покроковому посібнику з інтеграції описано перші виклики.
Вебхуки та періодичне опитування
Коли змінюються дані теми, на яку оформлено підписку, вебхуки Exact Online надсилають на вашу URL-адресу зворотного виклику POST-запит, підписаний хешем HMAC SHA256 (вебхуки). Серед тем — Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders та SalesOrderLines. Вони передають у SkyPlanner зміни запасів, закупівель і попиту одразу після їх виникнення.
Виробничі замовлення та етапи технологічних маршрутів зчитуються за розкладом. Фільтруйте ShopOrders і ShopOrderRoutingStepPlans за полем Modified, а для масового читання використовуйте Sync API (обмеження API).
SkyPlanner надсилає власні вебхуки, коли змінюється виробничий графік, тому зворотний запис в Exact Online виконується за подіями.
Зіставлення даних
| Ресурс Exact Online | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Items | Продукція та матеріали | Exact Online → SkyPlanner | Завантаження, далі — через вебхук |
BillOfMaterialVersions, BillOfMaterialMaterials | Структура виробу, напівфабрикати, матеріали для кожного виробу | Exact Online → SkyPlanner | У разі змін |
Workcenters, OperationResources | Робочі центри та їхні групи | Exact Online → SkyPlanner | Початкове завантаження |
Operations, BillOfMaterialRoutings | Етапи процесу з часом налагодження та виконання | Exact Online → SkyPlanner | У разі змін |
ShopOrders | Замовлення з кількістю та терміном виконання | Exact Online → SkyPlanner | Кожні кілька хвилин |
ShopOrderRoutingStepPlans | Виробничі завдання із зазначенням послідовності, робочого центру та годин налагодження й виконання | Exact Online → SkyPlanner | Кожні кілька хвилин |
ShopOrderMaterialPlans | Матеріали для кожного виробничого завдання | Exact Online → SkyPlanner | Кожні кілька хвилин |
ItemWarehouses, StockPosition | Складські залишки | Exact Online → SkyPlanner | Через вебхук |
PurchaseOrderLines | Замовлення на закупівлю з очікуваною датою постачання | Exact Online → SkyPlanner | Вебхук |
SalesOrderLines | Строки виконання та пріоритет замовлень клієнтів | Exact Online → SkyPlanner | Вебхук |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Заплановані початок, завершення та робочий центр для кожної операції | SkyPlanner → Exact Online | У разі змін, через вебхук |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Початок і завершення замовлення | SkyPlanner → Exact Online | У разі змін, через вебхук |
TimeTransactions (POST) | Записи обліку часу та підтвердження операторів | SkyPlanner → Exact Online | Після кожного підтвердження або за зміну |
ShopOrderReceipts (POST) | Кількість готової продукції на останній операції | SkyPlanner → Exact Online | Після кожного підтвердження |
| Не зберігаються в Exact Online | Матриця часу переналагодження, інструменти як обмежені виробничі ресурси, оператори для кожного виробничого завдання, альтернативні робочі центри, зміни | Ведуться в SkyPlanner | Початкове налаштування |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте Workcenters, Operations і OperationResources, а потім — номенклатуру та версії BOM з їхніми технологічними маршрутами. Робочий центр із трьома верстатами перетворюється на три робочі центри або одну групу робочих центрів. Зміни, відсутність працівників і понаднормову роботу налаштовують у SkyPlanner, оскільки робочий центр в Exact має лише одне значення потужності.
2. Синхронізація замовлень. Зчитайте відкриті ShopOrders разом із відповідними ShopOrderRoutingStepPlans і ShopOrderMaterialPlans, а також запаси та рядки замовлень на закупівлю. Під час побудови графіка перевіряються і наявні запаси, і очікувані закупівлі. MRP і далі надає рекомендації щодо замовлень в Exact Online, а SkyPlanner планує створені вами виробничі замовлення.
3. Зворотний запис графіка. Для кожної операції технологічного маршруту, яку рушій розмістив або перемістив у графіку, SkyPlanner надсилає PUT до ShopOrderRoutingStepPlans із полями PlannedStartDate, PlannedEndDate і Workcenter. Поля PlannedStartDate і PlannedDate виробничого замовлення відповідають першій та останній операціям. Кількості, плани потреб у матеріалах і розрахунок собівартості залишаються в Exact Online.
4. Підтвердження з виробничого цеху. Оператори реєструють виконану роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують графік в актуальному стані. Зареєстровані години передаються як TimeTransactions із прив’язкою до виробничого замовлення й операції технологічного маршруту — для налагодження або виконання. Остаточне підтвердження створює запис ShopOrderReceipts із кількістю готової продукції. Якщо ваше підприємство вже обліковує час у Shop Floor Control, виберіть один канал реєстрації.
5. Відповідальність за дані та правила вирішення конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, BOM, кількості у виробничих замовленнях, плани потреб у матеріалах, витрати | Exact Online |
| Послідовність операцій технологічного маршруту, час початку й завершення, призначення робочого центру | SkyPlanner |
| Матриця часу переналагодження, інструменти, оператори для кожного виробничого завдання, альтернативні виробничі ресурси, зміни | SkyPlanner |
| Записи обліку часу та оприбуткування готової продукції | Exact Online, дані надходять зі SkyPlanner |
Основне джерело конфліктів — ручне редагування дат. Якщо планувальники й далі змінюють дати виробничих замовлень в Exact Online, за дати відповідають одразу дві системи. Передайте керування датами операцій технологічного маршруту SkyPlanner. Завдяки Autopilot SkyPlanner автоматично перебудовує графік у разі змін на виробництві.
Типові етапи проєкту
Зазвичай впровадження завершується протягом кількох тижнів після початку налаштування. До цього перевірте графік упродовж 30-денного безкоштовного пробного періоду, використовуючи відкриті виробничі замовлення й операції технологічних маршрутів, експортовані у CSV або Excel. Далі проєкт проходить такі етапи:
- Визначення обсягу. Узгодьте редакцію, підрозділи, частоту синхронізації, канал обліку часу та порядок реєстрації оприбуткування готової продукції.
- Застосунок і згода. Зареєструйте застосунок, після чого користувач Exact Online надає згоду OAuth для кожного підрозділу.
- Початкове завантаження. Робочі центри, технологічні операції, номенклатура, версії BOM і технологічні маршрути.
- Синхронізація замовлень. Виробничі замовлення, плани операцій технологічних маршрутів і плани потреб у матеріалах — за розкладом; запаси й закупівлі — через вебхуки.
- Налаштування обмежень у SkyPlanner. Зміни, матриця часу переналагодження, інструменти, кількість операторів для кожного виробничого завдання та альтернативні верстати або працівники.
- Зворотний запис графіка. Передавання запланованих дат операцій технологічного маршруту до Exact Online, а потім — записів обліку часу й оприбуткування готової продукції.
- Паралельне тестування та запуск. Порівняйте дати з поточним планом, виправте основні дані, а потім увімкніть зворотний запис.
Що врахувати під час інтеграції з Exact Online
- Тривалість операцій технологічного маршруту. Значення
PlannedSetupHoursіPlannedRunHoursнадходять із технологічного маршруту BOM. Спочатку звірте їх із фактичною тривалістю виконання. - Групування робочих центрів. Exact зберігає одне значення потужності для кожного робочого центру. Визначте для кожного з них, чи буде він представлений одним робочим центром, кількома або групою.
- Календарі. Дані про зміни, свята й відсутність працівників зберігаються у SkyPlanner. Налаштуйте їх до побудови першого графіка.
- Ліміти викликів. Exact обмежує кількість викликів для кожного застосунку й компанії та вимагає виконувати їх послідовно. Використовуйте вебхуки там, де доступні відповідні теми,
$filterза полемModifiedі Sync API для масового зчитування. - Кілька підрозділів. Кожен підрозділ в Exact Online — це компанія з власним шляхом доступу й окремою згодою. Зіставте кожне підприємство з відповідним підрозділом.
- Замовлення, запущені у виробництво. Узгодьте, для яких статусів SkyPlanner може змінювати дати: для відкритих і запущених у виробництво замовлень чи лише для відкритих.
- Одна система відповідає за дати. Припиніть редагувати дати вручну в Exact Online, щойно керування датами операцій технологічного маршруту перейде до SkyPlanner.
Exact Globe+
Exact Globe+ — це ERP-система компанії Exact, яку продають і впроваджують партнери Exact Globe+. За словами Exact, вона «koppelt eenvoudig en snel met andere systemen» (легко й швидко з’єднується з іншими системами) (Exact Globe+). SkyPlanner так само планує виробничі замовлення Exact Globe+: отримує виробничі замовлення, технологічні маршрути, виробничі ресурси й запаси, а повертає заплановані дати та зареєстровані години. Ваш партнер Exact Globe+ і команда SkyPlanner узгоджують інтерфейс та об’єкти зворотного запису під час визначення обсягу проєкту.
Інтеграція з Exact Online: хто налаштовує та підтримує
- Команда SkyPlanner налаштовує інтеграцію на початковому етапі та підтримує її після запуску в експлуатацію.
- Ваш партнер Exact може долучитися. Він знає ваші редакції, підрозділи та налаштування виробництва.
- Ваші розробники можуть розширювати інтеграцію за допомогою документованого REST API SkyPlanner. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби.
Після підключення рушій Arcturus будує графік на основі актуальних виробничих замовлень Exact Online, а заплановані дати записуються для кожної операції технологічного маршруту. Вартість SkyPlanner починається від 199 € на місяць із щомісячною оплатою; до тарифу входять 5 робочих центрів. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із вартістю тарифу, тож ви бачите повну суму ще до початку роботи. Перегляньте ціни, можливості та порівняння з власними засобами планування Exact Online у матеріалі Планування виробництва в Exact Online з урахуванням реальних потужностей верстатів і персоналу. Загальний огляд наведено на сторінці Exact Online, а інші ERP — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
Менше зупинок через нестачу матеріалів
«Цінність SkyPlanner для нас у тому, що цей інструмент справді працює в щоденній роботі, особливо для визначення дат постачання».
Tommi Männistö, керівник відділу планування виробництва
Eskomatic · Механічна обробка на замовлення
Автоматичне планування завантаження дає змогу точніше визначати дати постачання, а кількість зупинок виробництва через нестачу матеріалів різко скоротилася.
1 000+ виробничих замовлень плануються автоматично
«Тепер ми зовсім інакше контролюємо виробництво, а наше розуміння потужностей вийшло на цілком інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся компанія бачить стан виробництва в реальному часі.
Поширені запитання
Чи містить API Exact Online виробничі замовлення та операції технологічних маршрутів?
Так. Виробничий сервіс містить ресурси ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations і BOM — усі вони доступні для читання й запису. Витрачений час реєструється через TimeTransactions, а кількість готової продукції — через ShopOrderReceipts.
Як планові дати записуються назад до Exact Online?
Для кожної технологічної операції, яку SkyPlanner розміщує або переносить у розкладі, він надсилає PUT-запит до ShopOrderRoutingStepPlans із полями PlannedStartDate, PlannedEndDate та Workcenter. Поля PlannedStartDate і PlannedDate виробничого замовлення оновлюються відповідно.
Хто розробляє інтеграцію з Exact Online?
Під час впровадження команда SkyPlanner налаштовує двосторонню інтеграцію відповідно до вашої конфігурації Exact Online та підтримує її після запуску. До роботи може долучитися ваш партнер Exact. Ваші розробники також можуть створити інтеграцію на основі задокументованого REST API SkyPlanner — для початку достатньо токена API.
Чи може Exact Online надсилати зміни в реальному часі?
Вебхуки Exact Online надсилають зміни щодо номенклатури, складських залишків, замовлень на закупівлю та замовлень на продаж. Дані виробничих замовлень і технологічних операцій зчитуються через короткі інтервали за допомогою запитів із фільтрами. У зворотному напрямку вебхуки SkyPlanner надсилають зміни розкладу одразу після їх внесення.
Чи можна випробувати SkyPlanner до розробки інтеграції?
Так. Безкоштовна 30-денна пробна версія підтримує до 20 робочих центрів та імпорт ваших виробничих замовлень із CSV або Excel. Кредитна картка не потрібна. Почніть пробний період або зверніться до відділу продажів для визначення обсягу інтеграції.
