Інтеграції / ERP / monday.com
Посібник з інтеграції monday.com для календарного планування виробництва зі SkyPlanner APS
У цьому посібнику пояснюємо партнерам та ІТ-командам, як підключити дошки monday.com до SkyPlanner APS. Інтеграція SkyPlanner з monday.com працює в обох напрямках:
- До SkyPlanner надходять елементи замовлень із даними про продукцію, кількість, термін виконання, пріоритет і статус.
- Заплановані початок і завершення записуються у стовпець Timeline, а робочий центр — в окремий стовпець.
- Дані про хід роботи операторів у виробничому цеху оновлюють стовпець Status.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію з вашими дошками та підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до роботи або самостійно створити інтеграцію на основі документованого REST API SkyPlanner (довідник API).
API платформи monday.com
monday.com надає єдиний GraphQL API за адресою POST https://api.monday.com/v2. Нові версії виходять щокварталу, а потрібну версію ви фіксуєте заголовком API-Version. Про виведення функцій з ужитку повідомляють щонайменше за шість місяців. (Версіонування API)
В інтеграції для календарного планування використовуються такі об’єкти:
- Boards і groups — дошки та групи, які часто відповідають етапам або тижням.
- Items і subitems — елементи та піделементи. Елемент зазвичай відповідає замовленню або виробничому завданню, а піделементи містять технологічні операції.
- Значення стовпців: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards і Mirror.
- Вебхуки для подій зміни даних.
Для читання використовується items_page, вкладений у дошку або групу. За замовчуванням сторінка містить 25 елементів, а “the maximum is 500.” (це максимальна кількість елементів). Читання продовжується за допомогою next_items_page, причому “each cursor will expire 60 minutes after the first request.” (кожен курсор втрачає чинність через зазначений час після першого запиту). Щоб читати лише відкриті замовлення, застосуйте фільтр query_params. (items_page)
Для запису використовуються create_item, create_subitem, change_column_value і change_multiple_column_values. Останній метод оновлює кілька стовпців одного елемента за один виклик — саме це потрібно для зворотного запису розкладу.
Для завантаження великих обсягів даних у версії API 2026-07 і новіших доступні ingest_items та backfill_items. Ви завантажуєте CSV за попередньо підписаною URL-адресою, а потім періодично запитуєте статус завдання. (Масовий імпорт)
Автентифікація
monday.com підтримує три типи токенів:
- Персональний API-токен. “Each token is unique to a user” (кожен токен унікальний для користувача) і має права доступу цього користувача. Підходить для перевірки концепції.
- Токен застосунку з визначеними областями доступу для інтеграційного застосунку.
- OAuth через
auth.monday.com/oauth2/authorizeі/oauth2/tokenз такими областями доступу, якboards:read,boards:write,webhooks:readіwebhooks:write.
Для робочого середовища використовуйте токен застосунку або OAuth. Персональний токен перестає працювати, коли його власник генерує новий. (Автентифікація)
На боці SkyPlanner REST API використовує API-токен для автентифікації (SkyPlanner Settings > API), а його документація доступна у Swagger/OpenAPI. Для початку достатньо API-токена, а покроковий посібник з інтеграції допоможе виконати перші виклики.
Вебхуки та звіряння даних
Створіть підписку за допомогою create_webhook(board_id, url, event, config). Для інтеграції календарного планування потрібні такі події:
create_itemіcreate_subitem— для нових замовлень і технологічних операцій.change_column_valueабоchange_specific_column_value— для змін терміну виконання, кількості чи пріоритету.change_status_column_value— для змін статусу, внесених користувачами.item_archived,item_deletedіitem_moved_to_specific_group— для скасованих або завершених замовлень.
Під час створення вебхука кінцева точка за URL-адресою отримувача має відповісти на перевірочний токен. Для невдалих доставок діє правило: “retry once a minute for 30 minutes,” (повторювати спроби щохвилини протягом зазначеного часу), після чого спроби припиняються. Тому інтеграція також періодично читає дані для звіряння через items_page, фільтруючи нещодавно оновлені елементи. (Вебхуки)
У зворотному напрямку SkyPlanner надсилає вебхуки, коли змінюється стан або розклад. Сервіс інтеграції отримує їх і записує нові дати в monday.com. Отже, зворотний запис запускається подіями.
Зіставлення даних
У monday.com немає стандартного об’єкта замовлення, тому відповідність ідентифікаторів стовпців налаштовується окремо для кожного облікового запису. Типова схема:
| Об’єкт monday.com | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
| Елемент на виробничій дошці: Name, Numbers (кількість), Date (термін виконання), Status або Dropdown (пріоритет) | Замовлення із зазначенням продукції, кількості, терміну виконання та пріоритету | monday.com → SkyPlanner | Вебхук під час створення та зміни, а також звіряння даних |
| Піделементи або елементи на дошці, пов’язаній через Connect Boards | Технологічні операції із зазначенням тривалості | monday.com → SkyPlanner | Разом із замовленням |
| Елементи на дошці продукції (Mirror для даних про продукцію) | Продукція та її структура | monday.com → SkyPlanner | Початкове завантаження, далі — у разі змін |
| Елементи на дошці запасів або матеріалів, якщо їх облік ведеться в monday.com | Матеріали та складські залишки | monday.com → SkyPlanner | Читання за розкладом |
| Елементи на дошці замовлень на закупівлю з очікуваною датою постачання | Матеріали, що очікуються та будуть доступні з дати постачання | monday.com → SkyPlanner | Вебхук або читання за розкладом |
| Користувачі та команди | Персонал, якщо планується робота операторів | monday.com → SkyPlanner | Початкове завантаження |
| Не зберігаються в monday.com | Робочі центри, зміни, матриця часу переналагодження, інструменти, альтернативні верстати | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
| Стовпець Timeline | Заплановані початок і завершення | SkyPlanner → monday.com | У разі зміни розкладу, через вебхук SkyPlanner |
| Стовпець Status, Dropdown або Text | Призначений робочий центр | SkyPlanner → monday.com | У разі зміни розкладу |
| Стовпець Status (наприклад, In production, Done) | Хід виконання виробничих завдань із Mobile Confirmations | SkyPlanner → monday.com | Після кожного підтвердження |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте продукцію, матеріали та відкриті замовлення через items_page. Створіть робочі центри, зміни й обмеження у SkyPlanner або імпортуйте їх з Excel. Заздалегідь визначте, де зберігатимуться технологічні операції: у піделементах чи на пов’язаній дошці.
2. Синхронізація замовлень. Вебхуки на виробничій дошці передають нові та змінені елементи у SkyPlanner як замовлення. Якщо ви ведете замовлення на закупівлю на дошці, SkyPlanner вважає замовлений матеріал доступним із дати постачання й оновлює залишки, коли замовленню присвоєно статус Delivered.
3. Зворотний запис розкладу. Для кожного замовлення, яке алгоритм розмістив або перемістив у розкладі, інтеграція викликає change_multiple_column_values. Вона записує заплановані початок і завершення у стовпець Timeline та заповнює стовпець робочого центру. Один виклик на елемент дає змогу обмежити кількість запитів.
4. Хід роботи у виробничому цеху. Оператори реєструють роботу через Mobile Confirmations, Production Timer або Quick Log Mode. Записи часу підтримують актуальність розкладу, а відповідна мітка Status передається назад на дошку. Так відділ продажів бачить хід виконання без додаткових запитів.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Замовлення, клієнт, кількість, термін виконання, пріоритет | monday.com |
| Послідовність технологічних операцій, початок і завершення, робочий центр | SkyPlanner |
| Зміни, переналагодження, інструменти, альтернативні верстати | SkyPlanner |
| Мітки Status, що показують хід виконання | SkyPlanner записує, monday.com відображає |
Основне джерело конфліктів — ручне редагування стовпця Timeline користувачами. Домовтеся, що в цей стовпець записує лише SkyPlanner, або трактуйте ручну зміну як запит, після якого SkyPlanner перепланує розклад. Autopilot автоматично переплановує розклад у разі змін на виробництві.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від його початку. Перед цим ви можете пройти 30-денний безкоштовний пробний період на власних даних: експортуйте виробничу дошку в Excel та імпортуйте її у SkyPlanner.
- Аналіз дошок. Зіставте дошки, групи, ідентифікатори стовпців і мітки статусів та перевірте тарифний план monday.com.
- Зіставлення та відповідальність за дані. Узгодьте таблицю відповідностей, правила відповідальності за дані та частоту синхронізації.
- Налаштування обмежень у SkyPlanner. Робочі центри, зміни, матриця часу переналагодження, інструменти й альтернативні верстати.
- Синхронізація замовлень. Вебхуки, зчитування даних для звірки та робота з токенами.
- Зворотний запис. Стовпці Timeline, робочого центру та статусу.
- Паралельне тестування. Запустіть SkyPlanner паралельно з поточною дошкою, порівняйте дати й виправте дані.
- Запуск у роботу. Увімкніть зворотний запис, коли дати збігатимуться.
Що врахувати під час інтеграції з monday.com
- У кожному обліковому записі замовлення організовано по-своєму. Окрема дошка для кожного клієнта, технологічні операції як елементи чи піделементи, верстати у стовпцях People або Status. Налаштовуйте зіставлення за ID стовпців для кожного облікового запису, ніколи — за назвами стовпців.
- Ліміти тарифних планів. Free, Basic і Standard дозволяють 1 000 викликів API на день, Pro — 10 000, а Enterprise — 25 000. Використовуйте вебхуки для відстеження змін і пакетний зворотний запис через
change_multiple_column_values. (ліміти запитів) - Кількість підключених дощок обмежена. Basic дозволяє одне підключення дошки, а Standard — п’ять, що обмежує кількість пов’язаних дощок технологічних операцій або продукції. (обмеження Connect Boards)
- Зафіксуйте версію API. Версії змінюються щокварталу. До версії 2026-04 стандартний запит boards не повертав багаторівневі дошки.
- Термін дії курсора. Курсор
items_pageдіє 60 хвилин. Тривалі процеси звірки мають коректно запускатися заново. - Обмеження вебхуків. URL може містити щонайбільше 255 символів, а повторні спроби припиняються через 30 хвилин. Обробник має бути ідемпотентним.
- Одиниці вимірювання та тривалість. Стовпці Numbers не містять одиниці вимірювання. До першого імпорту узгодьте, у чому вимірюється тривалість — у хвилинах чи годинах.
Інтеграція з monday.com: хто налаштовує та підтримує
Робота охоплює зіставлення ваших дощок і стовпців, а також налаштування обмежень, які не зберігаються в monday.com: робочих центрів, змін, матриці часу переналагодження, інструментів і альтернативних верстатів.
- Команда SkyPlanner налаштовує інтеграцію під час впровадження й підтримує її після запуску. Кожна компанія організовує дошки по-своєму, і саме тут стає в пригоді цей досвід.
- Ваш партнер monday.com може долучитися. Він знає ваші дошки й автоматизації та може перевірити зіставлення стовпців і налаштування токена.
- Ваші розробники можуть розвивати інтеграцію через задокументований REST API SkyPlanner, використовуючи токен API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Загальнодоступна документація продукту — у розділі документації SkyPlanner.
Вартість SkyPlanner починається від 199 € на місяць із щомісячною оплатою та включає 5 робочих центрів. Вартість інтеграції розраховують заздалегідь з урахуванням ваших процесів і потреб та надають разом із вартістю тарифного плану, тож ви знаєте повну суму до початку роботи. Порівняння з власними поданнями monday.com дивіться в матеріалі «Планування виробництва в monday.com з урахуванням реальних потужностей обладнання та персоналу». Загальний огляд доступний на сторінці monday.com, а інші системи — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а складання оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
6 місяцівнаперед відділ продажів бачить вільні потужності
«SkyPlanner забезпечує надійну основу для всього планування виробництва».
Anu Järvinen, керівниця виробництва
Fredman Operations · Пакувальний папір для контакту з харчовими продуктами
Відділ продажів бачить вільні потужності на шість місяців наперед, а на запити щодо зміни графіка тепер відповідають за лічені секунди, хоча раніше на це витрачали годину або більше.
Поширені запитання
Який API monday.com використовує інтеграція?
API платформи monday.com — GraphQL API за адресою api.monday.com/v2 із зафіксованою версією в заголовку API-Version. Для читання використовується items_page, для запису — change_multiple_column_values, а про зміни повідомляють вебхуки.
Що потрібно налаштувати в monday.com?
Доступ і два стовпці. Ваш адміністратор monday.com одноразово авторизує токен OAuth або застосунку з визначеними правами доступу, а на дошку додаються стовпець Timeline і стовпець робочого центру для зворотного запису. Ваші дошки й автоматизації залишаються без змін.
Який тарифний план monday.com нам потрібен?
Денні ліміти викликів API зростають залежно від тарифного плану: 1 000 на Standard і нижчих планах, 10 000 на Pro та 25 000 на Enterprise. Для двосторонньої синхронізації з частими змінами підійде Pro або Enterprise. Під час перевірки дощок команда SkyPlanner перевіряє ваш тарифний план та обсяги даних.
Чи може monday.com передавати зміни в реальному часі?
Так. Вебхуки спрацьовують під час створення елементів, зміни стовпців і статусів. Періодичне зчитування даних для звірки виявляє зміни, які не вдалося доставити протягом 30-хвилинного періоду повторних спроб monday.com.
Як заплановані дати записуються назад у monday.com?
Через change_multiple_column_values для кожного елемента. У стовпець Timeline записуються заплановані дати початку й завершення, а стовпці робочого центру та статусу оновлюються тим самим викликом.
Чи можна протестувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна працювати з даними вашої дошки, експортованими в Excel, і використовувати до 20 робочих центрів. Банківська картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
