Інтеграції / ERP / Acumatica Cloud ERP
Посібник з інтеграції Acumatica для календарного планування виробництва зі SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити Acumatica Cloud ERP (Manufacturing Edition) до SkyPlanner APS. Обмін даними між SkyPlanner та Acumatica відбувається в обох напрямках:
- До SkyPlanner надходять виробничі замовлення з технологічними операціями, робочі центри, верстати, інструменти, зміни, складські номенклатурні позиції та замовлення на закупівлю.
- Заплановані дати початку й завершення записуються в технологічні операції виробничого замовлення, а саме замовлення фіксується.
- Записи робочого часу операторів повертаються як записи про трудовитрати та переміщення.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Acumatica та підтримує її після запуску в експлуатацію. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до інтеграції або самостійно створити рішення на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції Acumatica
Інтеграція працює через інтерфейси, які вже входять до складу Acumatica. У вашому екземплярі системи нічого встановлювати не потрібно.
- Контрактний REST API. Кінцеві точки мають версії, що відповідають випускам системи. Кінцева точка Manufacturing (наприклад, 26.200.001 для 2026 R2) надає доступ до
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryтаMaterialEntry. Кінцева точка Default охоплюєStockItem,PurchaseOrderтаSalesOrder. URL-адреси мають формат{instance}/entity/{Endpoint}/{version}/{Entity}. - Дії через ту саму кінцеву точку.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryтаReleaseMaterialEntryвиконують ту саму логіку, що й кнопки на екранах системи. - OData. Будь-який запит Generic Inquiry (SM208000) можна зробити доступним через OData. Generic Inquiry з незавершеними виробничими операціями та їхніми датами — найшвидший спосіб масового зчитування.
- Push-сповіщення (SM302000). Вони працюють на основі Generic Inquiry або вбудованого запиту й надсилають додані та видалені рядки на вказану вами URL-адресу.
- Сценарії імпорту та експорту з постачальниками даних CSV та Excel для масового завантаження.
Перелік сутностей і дій наведено на екрані Web Service Endpoints (SM207000) та в репозиторії REST-клієнта Acumatica.
Автентифікація та обмеження
Acumatica використовує OAuth 2.0 та OpenID Connect через клієнтські застосунки, зареєстровані на екрані Connected Applications (SM303010). У документації описано потоки Authorization Code, Implicit, Resource Owner Password Credentials та Hybrid. Для серверної інтеграції зареєструйте окремого користувача з ролями, що надають лише мінімально необхідні права. Використовуйте Authorization Code з токеном оновлення або Resource Owner Password Credentials.
Обмеження визначає ваша ліцензія: на екрані License Monitoring Console (SM604000) показано дозволену кількість запитів API за хвилину та користувачів API.
На стороні SkyPlanner REST API використовує для автентифікації токен API (SkyPlanner Settings > API) і має документацію у Swagger/OpenAPI. Перші виклики покроково описано в навчальному посібнику з інтеграції.
Зіставлення даних
| Об’єкт Acumatica (кінцева точка / форма) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Продукція та матеріали | Acumatica → SkyPlanner | Початкове завантаження, далі лише зміни |
BillOfMaterial (AM208000): матеріали, технологічні операції | Структура виробу, складові вироби, матеріали для кожного виробу | Acumatica → SkyPlanner | Початкове завантаження, далі в разі змін |
| Технологічні операції BOM: Setup, Run, Machine, Queue, Finish, Move Time | Етапи процесу з тривалістю виконання, підготовки та завершальних робіт | Acumatica → SkyPlanner | Початкове завантаження, далі в разі змін |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Робочі центри, їхні групи та коефіцієнти ефективності, альтернативні робочі центри | Acumatica → SkyPlanner | Початкове завантаження, надалі рідко |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Зміни та доступний робочий час персоналу | Acumatica → SkyPlanner | Щодня або зміни ведуться у SkyPlanner |
Tool (AM205500) | Інструменти як виробничі ресурси з обмеженою доступністю | Acumatica → SkyPlanner | Початкове завантаження |
ProductionOrder з OrderOperationDetail (Planned, Released, In Process) | Замовлення та завдання з термінами виконання, пріоритетом запуску й потребами в матеріалах | Acumatica → SkyPlanner | Push-сповіщення або опитування кожні кілька хвилин |
Рядки PurchaseOrder (Default) | Замовлення на закупівлю з очікуваною датою поставки | Acumatica → SkyPlanner | Опитування щогодини або під час запуску планування |
| Кількість запасів за номенклатурними позиціями на складах | Складські залишки | Acumatica → SkyPlanner | Опитування щогодини або під час запуску планування |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Заплановані початок, завершення та робочий центр для кожної технологічної операції | SkyPlanner → Acumatica | У разі зміни розкладу, через вебхук SkyPlanner |
Дія FirmProductionOrder | Захищає записані дати від змін з боку Acumatica APS | SkyPlanner → Acumatica | Після кожного зворотного запису |
LaborEntry, MoveEntry з діями проведення | Записи робочого часу, виготовлена кількість, підтвердження операторів | SkyPlanner → Acumatica | Після кожного підтвердження або за зміну |
| Відсутні в Acumatica | Матриця часу переналагодження, конкретні оператори, завдання для кількох операторів | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Спочатку зчитайте робочі центри, верстати, інструменти, зміни та календарі. Потім — складські номенклатурні позиції та специфікації матеріалів. Визначте, як зіставити робочий центр із кількома верстатами: як одну групу робочих центрів, де кожен верстат є окремим робочим центром, чи як один робочий центр. Поле Basis for Capacity в Acumatica підкаже, який підхід використовує підприємство.
2. Синхронізація замовлень. Зчитуйте виробничі замовлення з технологічними операціями із самого замовлення, а не з BOM. Операції копіюються в замовлення, і планувальники змінюють їх саме там. Налаштуйте push-сповіщення для Generic Inquiry з незавершеними замовленнями та операціями або періодично опитуйте цей запит. Також зчитуйте відкриті рядки замовлень на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки, зазначену в замовленні на закупівлю, та оновлює залишки, коли це замовлення отримує статус Delivered.
3. Зворотний запис розкладу. Для кожної технологічної операції, яку алгоритм запланував або переніс, SkyPlanner записує StartDate та EndDate в OrderOperationDetail. Якщо роботу перенесено на альтернативний робочий центр, записується також цей центр. Потім SkyPlanner викликає FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Під час планування виробничих замовлень з урахуванням реальної потужності обладнання та персоналу система не переплановує зафіксовані виробничі замовлення.) (джерело)
4. Підтвердження з виробничого цеху. Оператори реєструють виконану роботу через SkyPlanner Mobile Confirmations або Production Timer. Записи робочого часу перетворюються на документи LaborEntry (час і виготовлена кількість для кожної технологічної операції) або MoveEntry (лише кількість), які проводяться відповідною дією. Якщо у вашому цеху вже звітують в Acumatica через Labor (AM301000) або Shop Floor Kiosk, дані про виконання надходять у зворотному напрямку. Виберіть один канал — ніколи не використовуйте обидва.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Складські номенклатурні позиції, специфікації матеріалів, кількості, статуси замовлень, розрахунок собівартості | Acumatica |
| Послідовність технологічних операцій, час початку й завершення, призначення робочих центрів | SkyPlanner |
| Матриця часу переналагодження, інструменти, вимоги до операторів, альтернативні варіанти | SkyPlanner |
| Зміни та відсутність персоналу | Одна система, вибрана під час визначення обсягу проєкту |
| Облікові операції з трудовитрат і переміщень | Acumatica: записи проводяться на основі журналів робочого часу SkyPlanner або вводяться в цеху |
Основне джерело конфліктів — власна APS Acumatica. Rough Cut Planning або APS Maintenance Process можуть перерахувати дати замовлень, які запланував SkyPlanner. Фіксація кожного замовлення після запису його дат запобігає цьому. Також виключіть заплановані замовлення з розрахунків APS.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку підключення. Перед цим ви можете пройти 30-денний безкоштовний пробний період на власних даних. Експортуйте робочі центри та відкриті виробничі замовлення з їхніми технологічними операціями з Generic Inquiry в Excel, імпортуйте їх і перевірте розклад.
- Зіставлення даних. Узгодьте таблицю відповідності, правила відповідальності за дані, частоту синхронізації та канал передавання даних про трудовитрати.
- Доступ. Зареєструйте підключений застосунок, створіть користувача інтеграції та ролі й перевірте версію кінцевої точки у Web Service Endpoints. Почніть із тестового середовища.
- Початкове завантаження. Робочі центри, верстати, інструменти, зміни, складська номенклатура та специфікації матеріалів.
- Синхронізація замовлень. Виробничі замовлення, технологічні операції та замовлення на закупівлю — через push-сповіщення або періодичне опитування.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, конкретні оператори, завдання для кількох операторів та альтернативні варіанти виконання.
- Зворотний запис. Дати технологічних операцій, фіксація замовлень і записи про трудовитрати або переміщення.
- Паралельна робота. Порівняйте дати SkyPlanner з поточним планом і виправте основні дані.
- Запуск у роботу. Увімкніть зворотний запис, коли дані збігатимуться.
Що врахувати під час інтеграції з Acumatica
- Перевірте, який механізм APS увімкнено. Classic і Optimized зберігають налаштування окремо, і ввімкнути можна лише один із них. Перед першим зворотним записом перевірте Enable/Disable Features (CS100000).
- Зафіксуйте версію кінцевої точки. Версія є частиною URL. Оновлення системи додає нову версію, тому після кожного оновлення повторюйте тестування.
- Оновлення технологічних операцій. Деякі поля операцій доступні через REST лише для читання; статус замовлення також має значення. Перевірте послідовність зворотного запису для замовлень зі статусами Released та In Process у тестовому середовищі.
- Одиниці та поля часу. Час виконання задається на кількість Run Units, а машинний час — на кількість Machine Units. Час очікування та переміщення “affect the calculated schedule but do not occupy work center capacity.” (впливають на розрахований розклад, але не займають потужності робочого центру). Уважно виконуйте перерахунок під час імпорту.
- Оцінка забезпеченості матеріалами. Classic APS вимагає наявності всіх матеріалів у повному обсязі. SkyPlanner планує з урахуванням складських залишків і очікуваних надходжень за замовленнями на закупівлю та їхніх дат. Узгодьте, на результати якої системи орієнтуватимуться планувальники.
- Ліміти API. Кількість запитів на хвилину визначається ліцензією. Зчитуйте лише зміни та використовуйте push-сповіщення замість повного повторного завантаження.
Хто налаштовує та підтримує інтеграцію з Acumatica
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску. Кожне підприємство використовує Acumatica по-своєму, і саме тут потрібне знання цих особливостей.
- Ваш партнер Acumatica може долучитися. Партнер знає ваші доопрацювання, Generic Inquiries та ролі. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники також можуть створити інтеграцію через той самий REST API з токеном API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Саме цей шлях обрала Laboratory & Allied для SAP Business One: її внутрішня ІТ-команда створила інтеграцію переважно власними силами, за допомоги SkyPlanner.
Вартість SkyPlanner починається від 199 € на місяць із щомісячною оплатою; включено 5 робочих центрів. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із ціною тарифу, тож ви бачите повну вартість ще до початку роботи. Порівняння з власною APS Acumatica наведено в матеріалі «Планування виробництва в Acumatica з урахуванням реальних потужностей», загальний огляд — на сторінці Acumatica, а інші системи — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
1 000+виробничих завдань плануються автоматично
«Ми по-іншому контролюємо виробництво, а наше розуміння потужностей вийшло на зовсім інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих завдань плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
99,2%надійність поставок
«SkyPlanner дав змогу чітко бачити вузькі місця та зробив управління виробництвом зрозумілішим».
Toni Tuori, керівник виробництва
Piristeel · Системи безпеки покрівлі та водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування заощаджує до чотирьох годин робочого часу на день.
Поширені запитання
Чи надає API Acumatica доступ до виробничих замовлень?
Так. Кінцева точка Manufacturing у REST API на основі контрактів надає доступ до ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool, записів про трудовитрати й переміщення, а також до таких дій, як FirmProductionOrder.
Хто створює інтеграцію з Acumatica?
Команда SkyPlanner налаштовує двосторонню інтеграцію відповідно до вашої конфігурації Acumatica під час підключення та підтримує її після запуску. Ваш партнер Acumatica або власні розробники також можуть створити інтеграцію через задокументований REST API SkyPlanner — для початку достатньо токена API.
Чи потрібна Acumatica APS для цієї інтеграції?
Ні. Власний розрахунок Acumatica з урахуванням реальних потужностей виконується у формі Rough Cut Planning, а Classic APS планує замовлення з датою завершення пізніше ніж через 120 днів без обмеження потужностей (джерело). SkyPlanner самостійно формує детальний розклад з урахуванням реальних потужностей на основі виробничих замовлень, технологічних операцій, робочих центрів, верстатів та інструментів. Тому інтеграція працює незалежно від того, чи ввімкнено APS, яка, за словами Acumatica, “is subject to licensing” (підлягає ліцензуванню). Autopilot підтримує розклад в актуальному стані, а оператори реєструють виконану роботу через Mobile Confirmations.
Як запобігти перезаписуванню дат SkyPlanner системою Acumatica APS?
SkyPlanner фіксує кожне виробниче замовлення після запису дат його технологічних операцій. Планування Acumatica з урахуванням реальних потужностей не переплановує зафіксовані замовлення.
Чи може Acumatica надсилати зміни в реальному часі?
Так. Push-сповіщення (SM302000), налаштовані для Generic Inquiry, надсилають змінені рядки на URL одразу після зміни. Власні вебхуки SkyPlanner передають зміни розкладу у зворотному напрямку.
Яку автентифікацію слід використовувати для інтеграції?
OAuth 2.0 через клієнт, зареєстрований у Connected Applications (SM303010), з окремим користувачем інтеграції та ролями з мінімально необхідними правами. Схему автентифікації для вашого екземпляра системи узгоджують під час визначення обсягу робіт.
Чи можна протестувати SkyPlanner до створення інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані з Acumatica Generic Inquiry через Excel або CSV. Банківська картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
