Інтеграції / ERP / ProShop ERP
Посібник з інтеграції ProShop ERP для календарного планування виробництва у SkyPlanner APS
Цей посібник пояснює адміністраторам, консультантам та ІТ-командам, як підключити ProShop ERP до SkyPlanner APS. SkyPlanner обмінюється даними з ProShop в обох напрямках через власний API ProShop:
- До SkyPlanner надходять Work Orders з їхніми технологічними операціями, Parts, записи Work Order BOM, Work Cells, Users, Tools, Fixtures та Purchase Orders.
- Заплановані дати початку й завершення передаються назад у виробничі замовлення.
- За вашим вибором дані про час роботи операторів можна передавати назад у ProShop Time Tracking.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації ProShop і підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створити рішення на основі задокументованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції ProShop
ProShop пропонує зовнішній системі календарного планування два способи підключення, описані в документації для розробників API ProShop:
- ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (ProShop надає GraphQL API, доступний через HTTP(S).) Є одна кінцева точка: кожен виклик — це HTTP POST до
<proshop root>/api/graphqlзquery,variablesіoperationNameу тілі запиту у форматі JSON. Кожен модуль має запит із назвою в однині для отримання одного запису та запит із назвою в множині для отримання списків. Списки розбиваються на сторінки за допомогоюpageSize(за замовчуванням 20) іpageStart, повертаютьrecordsтаtotalRecordsі приймають аргументиfilterтаquery, що відповідають функції Advanced Search кожного модуля. Схема підтримує інтроспекцію. (Вступ до API ProShop) - Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Простий REST-інтерфейс дає зовнішнім інтеграціям змогу запитувати дані за довільний проміжок часу.) Викликайте
<proshop root>/recentlyupdatedrecordsз параметромstart(ISO 8601) та необов’язковимиendіfilterby, наприкладworkorders,workcells,purchaseorders,timetracking,deletions. Спочатку команда ProShop має ввімкнути індекс. (Recently Updated Records API)
Запис даних виконується через мутації GraphQL. Задокументований приклад — Time Tracking Login. Права на запис надаються окремо для кожного модуля через області доступу.
Автентифікація та області доступу
- Токен доступу в кожному виклику. Передавайте його як
Authorization: Bearer <token>або як параметр запитуtoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 і новіші версії). Системний адміністратор ProShop відкриває System Config > Manage Authorizations, створює Authorization із полями Name і Maximum Scope та встановлює прапорці Direct Login і Active. Значення Unique ID та Shared Secret використовуються як
client_idіclient_secret. Застосунок надсилає POST-запит ізgrant_type=client_credentialsдо<proshop root>/home/member/oauth/accesstokenй отримує токен Bearer зexpires_in. Токена оновлення немає, тож після закінчення строку дії запитуйте новий токен. (Процедура Client Credentials) - OAuth 2.0 Authorization Flow — для викликів, яким потрібен контекст користувача, як-от Time Tracking Login.
- Області доступу. Формат —
SCOPE_NAME:[{r|w|d|p}]: читання, запис, видалення та налаштування відповідно. Система календарного планування зазвичай запитуєworkorders:rw parts:r purchaseorders:r users:r tools:r, а також Time Tracking, якщо дані про час передаються назад. Починаючи з ProShop 5.1.9, “a scope grant request is now required on all connections to the API.” (Для всіх підключень до API тепер обов’язковий запит на надання області доступу.) (Області доступу авторизації) - Журнал аудиту. Для викликів з обліковими даними клієнта відображається назва застосунку, а не користувач.
На боці SkyPlanner автентифікація в REST API виконується за допомогою токена API в заголовку Authorization-Token (SkyPlanner Settings > API). Документація доступна у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково розглянуто перші виклики.
Події та опитування
У документації ProShop для розробників не описано вихідних вебхуків або підписок GraphQL. Дані з ProShop отримують шляхом опитування, а Recently Updated Records API зменшує витрати на нього: запитуйте все, що було створено, змінено або видалено з попереднього запуску, відфільтрувавши потрібні для графіка типи записів. Потім отримуйте змінені виробничі замовлення за номером через GraphQL. За інформацією ProShop, це швидше, ніж запит за lastModifiedTime.
Зазвичай виробничі замовлення та дані обліку часу опитують кожні п’ять хвилин, а деталі й замовлення на закупівлю — щогодини. SkyPlanner надсилає вебхуки в разі зміни стану або графіка, тому зворотний запис працює за подіями.
Зіставлення даних
| Об’єкт ProShop (API) | Об’єкт SkyPlanner | Напрямок | Частота |
|---|---|---|---|
Parts, COTS (область доступу GraphQL parts) | Вироби та матеріали | ProShop → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Записи Work Order BOM | Структура виробу, матеріали для кожного замовлення | ProShop → SkyPlanner | З кожним виробничим замовленням |
| Технологічні операції виробничого замовлення: виробнича комірка, розрахунковий час налагодження та циклу (цільові значення) | Етапи процесу з тривалістю, часом налагодження та завершальних робіт | ProShop → SkyPlanner | З кожним виробничим замовленням |
| Work Cells (верстат, верстак, обладнання) | Робочі центри, групи робочих центрів, показники ефективності | ProShop → SkyPlanner | Початкове завантаження, надалі — зрідка |
| Work Cells, закріплені за працівниками, Users | Персонал і призначення операторів | ProShop → SkyPlanner | Початкове завантаження, потім — у разі змін |
| Графіки виробничих комірок (доступні години, зміни) | Зміни та неробочі дні | ProShop → SkyPlanner | Щодня або ведення графіків змін у SkyPlanner |
| Work Orders (кількість, термін виконання, статус) | Замовлення та виробничі завдання з термінами виконання й пріоритетом | ProShop → SkyPlanner | Опитування кожні кілька хвилин |
| Tools, Toolpots, Fixtures, RTAs | Інструменти як спільні ресурси з обмеженою доступністю | ProShop → SkyPlanner | Початкове завантаження, потім — у разі змін |
| Purchase Orders з термінами поставки | Замовлення на закупівлю, очікувані надходження матеріалів за датами поставки | ProShop → SkyPlanner | Опитування щогодини або під час розрахунку графіка |
Заплановані початок і завершення виробничого замовлення (мутація GraphQL, workorders:w) | Заплановані початок і завершення кожного виробничого завдання | SkyPlanner → ProShop | У разі зміни графіка, через вебхук SkyPlanner |
| Time Tracking: час налагодження й виконання, кількість виготовлених деталей за кожною технологічною операцією виробничого замовлення | Записи обліку часу та підтвердження операторів | SkyPlanner → ProShop | За кожним підтвердженням або за зміну, якщо вибрано цей варіант |
| Відсутнє у ProShop | Матриця часу переналагодження, виробничі завдання для кількох операторів, альтернативні верстати та працівники | Ведеться у SkyPlanner | Налаштовується під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Отримуйте Parts, Work Cells, Users, Tools і Fixtures посторінково за допомогою запитів GraphQL із назвами в множині. Для першого завантаження задайте велике значення pageSize та повторюйте запити, орієнтуючись на totalRecords. Визначте правила зіставлення виробничих комірок: комірки, що відповідають верстатам, стають робочими центрами, а ті, що відповідають працівникам, — персоналом. Так одна технологічна операція може одночасно резервувати верстат і його оператора.
2. Синхронізація виробничих замовлень. Зчитуйте активні виробничі замовлення з їхніми технологічними операціями, цільовими значеннями часу та записами BOM, а також відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки, зазначену в замовленні на закупівлю, й оновлює запаси, коли це замовлення отримує статус Delivered. Зміни виявляються через Recently Updated Records з filterby=workorders,purchaseorders,deletions.
3. Зворотний запис графіка. Коли механізм планування розміщує або переміщує виробниче завдання, вебхук SkyPlanner запускає мутацію GraphQL, яка встановлює планові дати виробничого замовлення, використовуючи Authorization з workorders:w. Після цього прогноз своєчасного виконання та дати потреби в закупівлях у ProShop спираються на дати SkyPlanner.
4. Підтвердження з цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують графік в актуальному стані. Ви вирішуєте, чи передавати фактичний час назад у ProShop Time Tracking із прив’язкою до технологічної операції виробничого замовлення. Якщо ні, оператори, як і раніше, реєструють час у ProShop, а SkyPlanner зчитує його через timetracking.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Parts, технологічні операції, цільові значення часу, кількості, статус виробничого замовлення | ProShop |
| Послідовність технологічних операцій, час початку й завершення, призначення верстатів та операторів | SkyPlanner |
| Матриця часу переналагодження, вимоги до інструментів та операторів, альтернативні виробничі ресурси | SkyPlanner |
| Зміни та неробочі дні | Одна система, обрана під час визначення обсягу проєкту |
| Time Tracking, запаси, закупівлі, калькуляція собівартості виробничих завдань | ProShop: дані вводяться безпосередньо або передаються із записів обліку часу SkyPlanner |
Визначте одну систему, яка записуватиме дати виробничих замовлень. Щойно SkyPlanner починає планувати роботу виробничої комірки, планувальники припиняють змінювати порядок завдань цієї комірки у ProShop. Так два плани ніколи не суперечитимуть один одному.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від його початку. Перед цим перевірте графік упродовж 30-денного безкоштовного пробного періоду, використовуючи дані виробничих комірок, технологічних операцій і відкритих виробничих замовлень, експортовані з ProShop у CSV або Excel.
- Зіставлення даних. Узгодьте таблицю зіставлення, правила відповідальності за дані, частоту синхронізації та потребу у зворотному передаванні даних про час.
- Доступ до ProShop. Адміністратор створює Authorization з узгодженим значенням Maximum Scope і просить команду ProShop увімкнути Recently Updated Records.
- Початкове завантаження. Parts, Work Cells, Users, Tools, Fixtures, графіки виробничих комірок.
- Синхронізація виробничих замовлень і замовлень на закупівлю. Опитування змін із посторінковим отриманням даних і повторними спробами.
- Налаштування обмежень у SkyPlanner. Матриця часу переналагодження, інструменти, кількість операторів для кожної технологічної операції та альтернативні верстати або працівники.
- Зворотний запис графіка. Мутації, що запускаються вебхуками SkyPlanner, а також Time Tracking, якщо вибрано цей варіант.
- Паралельне тестування. Запустіть SkyPlanner паралельно з поточним графіком ProShop, порівняйте дати й скоригуйте нормативи часу.
- Запуск у роботу. Увімкніть зворотний запис, щойно дані збігатимуться.
Що врахувати під час інтеграції з ProShop
- Нормативи часу вирішують усе. ProShop розраховує тривалість на основі оцінок часу налагодження та циклу. Завантажуйте актуальні нормативи часу, а не початкову оцінку. Відокремлюйте час налагодження від часу виконання, щоб матриця часу переналагодження могла замінити єдине значення часу налагодження.
- Працівники як виробничі комірки. Виробнича комірка може представляти працівника. Зіставляйте такі комірки з персоналом у SkyPlanner, а не з верстатами, інакше кожен оператор стане окремим верстатом, що працює паралельно.
- Для Time Tracking потрібен користувач. Із квітня 2026 року мутація Time Tracking Login «requires user context» (потребує контексту користувача) і недоступна за авторизації через Client Credentials. Передавайте робочий час операторів через OAuth 2.0 Authorization Flow або залиште облік часу в ProShop і зчитуйте його звідти.
- Увімкніть індекс змін. Recently Updated Records працює лише після того, як команда ProShop увімкне цю функцію. Подайте запит на першому тижні.
- Записи з обмеженнями ITAR. ProShop фільтрує записи з обмеженнями ITAR для кожного підключення. Налаштування в Developer System Config визначає, чи повертатимуться вони як null, чи будуть вилучені з результату. Узгодьте, які виробничі замовлення будуть доступні інтеграції, і обробляйте значення null під час кожного зчитування.
- Обробка на стороні. Технологічні операції у підрядників потребують часу, але не займають ваші потужності. Моделюйте їх як етапи, для яких враховується лише тривалість.
Хто налаштовує та підтримує інтеграцію з ProShop
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску. Це охоплює узгоджені запити й мутації GraphQL, а також опитування щодо змін. Кожне підприємство використовує ProShop по-своєму, і під час цієї роботи враховують саме ці особливості.
- Ваш адміністратор або консультант ProShop бере участь у роботі. Він створює Authorization, задає області доступу, подає запит на індекс змін і знає, як у вас налаштовані виробничі комірки.
- Ваші розробники можуть розширювати інтеграцію через REST API SkyPlanner за допомогою токена API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Докладніше — у документації з інтеграції SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць за щомісячної оплати, у тариф входять 5 робочих центрів. Вартість інтеграції розраховують заздалегідь разом із тарифом, з урахуванням ваших процесів і потреб. Перегляньте ціни, сторінку планування виробництва для ProShop з урахуванням реальних потужностей обладнання та персоналу, сторінку ProShop ERP, можливості SkyPlanner та розділ інтеграцій з ERP.
Відгуки виробників про 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%, а календарним плануванням тепер займається один керівник замість двох.
1 000 і більше виробничих замовлень плануються автоматично
«Ми по-іншому контролюємо виробництво, а наше розуміння потужностей вийшло на зовсім інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
Поширені запитання
Чи має ProShop API?
Так. У ProShop є GraphQL API за адресою <proshop root>/api/graphql з автентифікацією через OAuth 2.0 або Basic Authentication та областями доступу до модулів. Кінцева точка REST Recently Updated Records повертає записи, створені, змінені або видалені за певний проміжок часу.
Чи підтримує ProShop вебхуки?
У документації ProShop для розробників вихідні вебхуки не описані. Інтеграція опитує Recently Updated Records API за графіком, установленим для конкретного підприємства. Власні вебхуки SkyPlanner передають зміни графіка одразу після їх виникнення.
Як оновлюються заплановані дати в ProShop?
Через мутацію GraphQL для виробничого замовлення, з використанням Authorization із правом запису в workorders. SkyPlanner запускає її через вебхук щоразу, коли змінюється графік.
Хто створює облікові дані для API ProShop?
Системний адміністратор ProShop у розділі System Config > Manage Authorizations. Direct Login вмикає сценарій Client Credentials, а Maximum Scope обмежує дані, які інтеграція може зчитувати й записувати.
Що консультанту ProShop варто пропонувати для календарного планування: ProShop чи SkyPlanner?
SkyPlanner — коли строки поставок клієнта залежать від послідовності виконання робіт. Графік ProShop показує пріоритети та прогнози своєчасного виконання для кожної виробничої комірки, а планувальники коригують пріоритети. SkyPlanner підключається через GraphQL API, автоматично оптимізує весь план, планує переналагодження, роботу операторів, використання інструментів і матеріалів. Кількість користувачів необмежена, вартість — від 199 € на місяць.
Чи можна протестувати SkyPlanner до створення інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна працювати з кількістю робочих центрів до 20 та імпортувати дані з ProShop у форматі CSV або Excel. Кредитна картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
