Інтеграції / ERP / Fulcrum
Посібник з інтеграції Fulcrum для календарного планування виробництва в SkyPlanner APS
Цей посібник пояснює консультантам та ІТ-командам, як підключити Fulcrum (Fulcrum Pro) до SkyPlanner APS. SkyPlanner обмінюється даними з Fulcrum в обох напрямках через Fulcrum Public API:
- До SkyPlanner надходять виробничі завдання з виробами для виготовлення та операціями, технологічні маршрути виробів, робочі центри, обладнання, зміни підрозділів, простої, складські залишки й замовлення на закупівлю.
- Заплановані початок і завершення та робочий центр записуються у власні поля кожної операції виробничого завдання.
- Відпрацьований операторами час і виготовлена кількість передаються назад до Fulcrum як записи таймерів та оновлення кількості.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Fulcrum і підтримує її після запуску. Цей посібник призначений для консультантів і розробників, які хочуть долучитися до роботи або самостійно створити рішення на основі документованого REST API SkyPlanner (довідник API).
Fulcrum Public API
Fulcrum — єдиний хмарний продукт із багатоклієнтською архітектурою, тож усі клієнти працюють з однаковим API. На порталі для розробників його описано як публічний API для “REST API calls directly into your Fulcrum site.” (викликів REST API безпосередньо до вашого середовища Fulcrum).
- Специфікація. OpenAPI “Fulcrum PublicAPI” v1 можна завантажити за адресою
https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum радить згенерувати на її основі типізований клієнт. На сторінці History наведено всі зміни з датами. - Хости. Для стандартних середовищ —
https://api.fulcrumpro.com. Середовища ITAR використовуютьapi.fulcrumpro.us, а запити з токенами ITAR до хоста .com отримують код 401. - Принцип роботи. Списки отримують через
POST .../listіз фільтром у тілі запиту, пагінацією черезSkipіTakeта сортуванням черезSort.Field/Sort.Dir. Багато об’єктів підтримують PUT, а виробничі завдання — також JSON Patch.
Кінцеві точки, які використовує інтеграція для календарного планування:
| Сфера | Кінцеві точки |
|---|---|
| Вироби й технологічні маршрути | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| Налаштування цеху | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| Виробничі завдання | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| Матеріали | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| Виробничий цех | /api/job-tracking-timers/start і /stop, /api/timers, .../operations/{operationId}/add-quantity-completed, .../complete |
На сторінці інтеграцій Fulcrum прямо сказано про необхідну роботу: “Every system is a little bit different and requires some configuration.” (Кожна система дещо відрізняється й потребує певного налаштування.) Саме це налаштування команда SkyPlanner бере на себе під час впровадження.
Автентифікація
Fulcrum використовує Bearer-токен у заголовку Authorization. “A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.” (Токен публічного API можна створити у вашому середовищі Fulcrum у розділі Business Setup -> System Data -> Public Api.) Кожен токен має назву, опис і дату завершення терміну дії. Ви можете створити стільки токенів, скільки потрібно, а для відкликання токена достатньо його видалити. Створіть окремий токен для інтеграції SkyPlanner і налаштуйте нагадування до завершення терміну його дії.
На боці SkyPlanner автентифікація в REST API виконується за допомогою API-токена в заголовку Authorization-Token (SkyPlanner Settings > API). API задокументовано у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково розглянуто перші виклики.
Події та опитування
Fulcrum підтримує вебхуки, які налаштовує адміністратор. Із вересня 2026 року робота вебхуків, що завершуються помилкою, призупиняється, а їхня працездатність перевіряється щодня замість нескінченних повторних спроб. В історії API наведено такі події, як PurchaseOrderUpdated та ItemUpdated.
Інтеграція зчитує дані з Fulcrum так:
- Кожні кілька хвилин запитує відкриті виробничі завдання зі статусами
scheduledтаinProgressі зhasIncompleteOperations: true. Саме такий фільтр рекомендує Fulcrum, щоб отримати дані, які відповідають його сторінці розкладу. - Зчитує замовлення на закупівлю та складські залишки перед кожним розрахунком розкладу або за вебхуком
PurchaseOrderUpdated, якщо його налаштовано. - Зчитує вироби, технологічні маршрути, обладнання та зміни в разі їх оновлення або щоночі.
У зворотному напрямку власні вебхуки SkyPlanner передають зміни розкладу одразу після їх внесення, тож зворотний запис працює на основі подій.
Зіставлення даних
| Об’єкт Fulcrum (кінцева точка) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Item, Materials (/api/items, /api/materials) | Продукція та матеріали | Fulcrum → SkyPlanner | Початкове завантаження, далі щоночі |
Вхідні вироби та матеріали технологічного маршруту (/routing/input-items, /input-materials) | Структура виробу, складові вироби, матеріали для кожного виробу | Fulcrum → SkyPlanner | Початкове завантаження, далі в разі змін |
Операції технологічного маршруту (/routing/operations): setupTime, laborTime, machineTime (фіксований або на одиницю), selectedEquipmentIds | Технологічні операції, час налагодження, тривалість, допустимі робочі центри | Fulcrum → SkyPlanner | Початкове завантаження, далі в разі змін |
Work Center (/api/work-centers) | Група робочих центрів | Fulcrum → SkyPlanner | Початкове завантаження, надалі зрідка |
Equipment (/api/equipment): unlimitedCapacity, canRunUnattended, status | Робочі центри, виробничі завдання для виконання партіями, робота без нагляду | Fulcrum → SkyPlanner | Початкове завантаження, статус — щодня |
Department Shifts (/api/department-shifts), Equipment Downtimes | Зміни та періоди недоступності | Fulcrum → SkyPlanner | Початкове завантаження, далі щодня |
Job та його операції (/api/jobs, .../items-to-make/{id}/operations): priority, productionDueDate, earliestStartDate, розрахункові показники | Замовлення та виробничі завдання | Fulcrum → SkyPlanner | Опитування кожні кілька хвилин |
| Inventory, Purchase Orders із датами Expected Receive | Складські залишки та очікувані надходження матеріалів | Fulcrum → SkyPlanner | Перед кожним розрахунком розкладу |
Поле customFields операції виробничого завдання (POST .../operations/{operationId}) | Заплановані початок і завершення, робочий центр | SkyPlanner → Fulcrum | У разі зміни розкладу, через вебхук SkyPlanner |
Поле customFields виробничого завдання (PUT /api/jobs/{jobId}/custom-fields) | Заплановане завершення виробничого завдання | SkyPlanner → Fulcrum | У разі зміни розкладу |
Таймери обліку виробничих завдань, /api/timers, add-quantity-completed, complete | Записи обліку часу, виготовлена кількість і кількість браку | SkyPlanner → Fulcrum | Коли оператори реєструють виконану роботу |
| Відсутні у Fulcrum | Конкретні оператори, матриця часу переналагодження, інструменти з обмеженою доступністю, альтернативні робочі центри | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
Сценарії інтеграції
1. Початкове завантаження основних даних. Завантажте вироби, матеріали, технологічні маршрути, робочі центри й обладнання, а потім — зміни підрозділів і простої. Кожен робочий центр Fulcrum стає групою робочих центрів SkyPlanner, до якої входить його обладнання. Обладнання, вибране для кожної операції технологічного маршруту, визначає допустимі робочі центри для неї. Обладнання з параметром Unlimited Capacity, як-от печі та фарбувальні камери, моделюється через виробничі завдання для виконання партіями.
2. Синхронізація замовлень. Зчитайте відкриті виробничі завдання з виробами для виготовлення та операціями, а також відкриті замовлення на закупівлю й складські залишки. SkyPlanner вважає замовлений матеріал доступним на дату поставки із замовлення на закупівлю та оновлює залишки, коли замовлення отримує статус Delivered. Під час кожного перепланування система перевіряє складські залишки й очікувані надходження за закупівлями.
3. Зворотний запис розкладу. Fulcrum самостійно обчислює scheduledStartUtc, scheduledEndUtc та scheduledEquipmentId і повертає їх лише для читання. Запит на оновлення операції приймає customFields. SkyPlanner записує заплановані початок і завершення та робочий центр у власні поля кожної операції виробничого завдання, а заплановане завершення завдання — у власне поле самого завдання. Відділи продажу й закупівель бачать дати SkyPlanner у виробничому завданні у Fulcrum.
4. Підтвердження з виробничого цеху. Оператори реєструють виконану роботу в SkyPlanner за допомогою Mobile Confirmations, Production Timer або Quick Log Mode. SkyPlanner передає час у Fulcrum через /api/job-tracking-timers/start і /stop або як завершений часовий інтервал через /api/timers. Дані про кількість передаються через add-quantity-completed, а підсумкова кількість з урахуванням браку — через complete. Калькуляція собівартості виробничих завдань у Fulcrum залишається актуальною.
5. Правила відповідальності за дані та розв’язання конфліктів. Планувальник Fulcrum “dictates the order of operations in Job Tracking.” (визначає послідовність технологічних операцій у Job Tracking). Тому для кожної технологічної операції виберіть один канал видачі завдань: чергу оператора в SkyPlanner або Fulcrum Job Tracking. Зафіксуйте правила до запуску в експлуатацію:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, технологічні маршрути, розрахункові показники, запаси, закупівлі, калькуляція собівартості | Fulcrum |
| Послідовність технологічних операцій, час початку й завершення, призначення робочих центрів | SkyPlanner |
| Оператори, матриця часу переналагодження, інструменти, альтернативні ресурси | SkyPlanner |
| Зміни та простої | Одна система, вибрана під час визначення обсягу проєкту |
| Зареєстрований час і кількість виготовленої продукції | SkyPlanner із передаванням у Fulcrum |
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від початку підключення. До цього ви можете пройти 30-денний безкоштовний пробний період на власних даних. Експортуйте номенклатуру, технологічні маршрути й відкриті виробничі завдання з таблиць Fulcrum у CSV, імпортуйте їх і перевірте розклад.
Сам проєкт охоплює такі етапи:
- Токен і обсяг інтеграції. Створіть токен Public API та погодьте користувацькі поля для зворотного запису.
- Зіставлення даних. Зафіксуйте таблицю відповідностей, правила відповідальності за дані та канал видачі завдань.
- Початкове завантаження. Номенклатура, матеріали, технологічні маршрути, робочі центри, обладнання, зміни, простої.
- Синхронізація замовлень і замовлень на закупівлю. Періодичне отримання змін у виробничих завданнях, а також даних про замовлення на закупівлю та запаси.
- Налаштування обмежень у SkyPlanner. Оператори та їхні зміни, матриця часу переналагодження, інструменти й альтернативні робочі центри.
- Зворотний запис. Користувацькі поля виробничих завдань і їхніх технологічних операцій.
- Передавання даних із виробничого цеху. Дані таймерів і кількість виготовленої продукції надходять у Fulcrum.
- Паралельне тестування та запуск в експлуатацію. Використовуйте SkyPlanner паралельно з розкладом Fulcrum, порівняйте дати, виправте основні дані, а потім перейдіть до видачі завдань за розкладом SkyPlanner.
Що врахувати під час інтеграції з Fulcrum
- Персонал враховується за чисельністю працівників у зміні. Параметр Max Equipment для зміни у Fulcrum “is usually determined by how many people you have working in a certain area at that time.” (зазвичай визначається кількістю працівників, які в цей час працюють на певній ділянці). Конкретних операторів та їхні зміни налаштовують у SkyPlanner. Імена можна отримати з даних користувачів у
/api/users. - Розклад складається для обладнання. Робочі центри Fulcrum — це групи взаємозамінного обладнання. Стежте за точністю вибору обладнання в технологічному маршруті: саме з цих варіантів рушій обиратиме альтернативи.
- Виробничі замовлення об’єднують завдання. Виробниче замовлення об’єднує технологічні операції кількох виробничих завдань, наприклад для спільного розкрою. Запуск таймера для згрупованої технологічної операції натомість запускає таймер виробничого замовлення, який охоплює всі технологічні операції завдань у групі.
- Обмеження таймерів. Часові інтервали, внесені заднім числом через
/api/timers, “may not be in the future, older than 30 days, or longer than 7 days.” (не можуть припадати на майбутнє або перевищувати зазначені межі давності чи тривалості). Передавайте дані про час у міру того, як оператори їх реєструють. - Формати часу відрізняються. Для змін використовується місцевий час у форматі HHmm, для простоїв і запланованих дат — UTC, а розрахункова тривалість технологічних операцій надходить у секундах.
- Оновлення обладнання замінює весь запис. Запит PUT для обладнання очищає всі поля, яких у ньому немає. SkyPlanner лише зчитує дані обладнання й ніколи їх не записує.
- Майданчики ITAR. Використовуйте хост
.usі токен ITAR.
Інтеграція з Fulcrum: хто налаштовує та підтримує
Робота охоплює зіставлення ваших підрозділів, робочих центрів, обладнання й технологічних маршрутів, а також налаштування обмежень, яких немає у Fulcrum: конкретних операторів, матриці часу переналагодження, інструментів та альтернативних ресурсів.
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску в експлуатацію. Кожне виробництво використовує Fulcrum по-своєму, і саме тут враховується цей практичний досвід.
- Ваш консультант із Fulcrum або партнер з інтеграції може реалізувати її. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники також можуть створювати власні рішення на цій основі. Для початку достатньо токена API, а команда SkyPlanner за потреби допоможе. Документацію продукту, зокрема щодо замовлень на закупівлю та API продукції й матеріалів, наведено в документації SkyPlanner.
Вартість SkyPlanner починається від 199 € на місяць із щомісячною оплатою та включає 5 робочих центрів. Вартість інтеграції розраховують заздалегідь з урахуванням ваших процесів і потреб та надають разом із вартістю тарифу, щоб ви знали повну суму до початку роботи. Перегляньте ціни, можливості та порівняння з власним планувальником Fulcrum у матеріалі Планування виробництва у Fulcrum з урахуванням реальних потужностей обладнання та персоналу. Огляд наведено на сторінці Fulcrum, а інші ERP — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюгів постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
99,2%надійність поставок
«SkyPlanner допоміг нам наочно бачити вузькі місця та зробив управління виробництвом зрозумілішим».
Toni Tuori, керівник виробництва
Piristeel · Системи безпеки покрівлі та водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування виробництва заощаджує до чотирьох годин робочого часу на день.
98%надійність поставок, зростання з приблизно 50%
«SkyPlanner відіграє вирішальну роль у підтриманні надійності наших поставок».
Hannu Lahtinen, керуючий директор
KJH-Comp · Вироби з листового металу та контрактне виробництво
Надійність поставок зросла з приблизно 50% до 98%, а для календарного планування виробництва тепер потрібен один керівник замість двох.
Поширені запитання
Чи має Fulcrum API?
Так. Fulcrum Public API — це REST API зі специфікацією OpenAPI v1. Для автентифікації використовується токен Bearer, створений у Business Setup > System Data > Public Api. Майданчики ITAR використовують окремий хост .us.
Чи може SkyPlanner передавати розклад у Fulcrum?
Так. Власні заплановані дати Fulcrum доступні лише для читання, тому SkyPlanner записує заплановані початок, завершення та робочий центр у користувацькі поля кожної технологічної операції виробничого завдання, а заплановане завершення — у саме завдання. Час роботи операторів і кількість виготовленої продукції передаються назад як записи таймерів та оновлення кількості.
Чи надсилає Fulcrum зміни в реальному часі?
У Fulcrum є вебхуки, які налаштовує адміністратор, зокрема для подій на кшталт PurchaseOrderUpdated. Дані про відкриті виробничі завдання запитуються кожні кілька хвилин із тим самим фільтром, який Fulcrum використовує на сторінці розкладу. Власні вебхуки SkyPlanner надсилають зміни розкладу відразу після їх виникнення.
Хто реалізує інтеграцію з Fulcrum?
Команда SkyPlanner налаштовує двосторонню інтеграцію під час підключення та підтримує її після запуску в експлуатацію. Ваш консультант із Fulcrum, партнер з інтеграції або ваші розробники також можуть створити рішення на основі документованого REST API SkyPlanner.
Чи можна протестувати SkyPlanner до створення інтеграції?
Так. Під час 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані з Fulcrum у форматі CSV. Банківська картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
