Інтеграції / ERP / Lemonsoft
Посібник з інтеграції Lemonsoft для календарного планування виробництва в SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити Lemonsoft ERP до SkyPlanner APS. SkyPlanner обмінюється даними з Lemonsoft в обох напрямках через REST API Lemonsoft:
- До SkyPlanner надходять номери робіт (työnumero), виробничі етапи (työvaihe), верстати, структури виробів, матеріали та заплановані зміни.
- Для виробничих етапів у Lemonsoft оновлюються запланований час початку й завершення та вибраний верстат.
- Підтвердження операторів передаються назад як записи про виконання.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Kaskea Group використовує SkyPlanner із двосторонньою інтеграцією з Lemonsoft. Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Lemonsoft і підтримує її після запуску. Партнери та розробники також можуть створювати власні рішення на основі документованого REST API SkyPlanner (довідник API).
REST API Lemonsoft
Для інтеграції Lemonsoft надає API LemonRest, описаний у форматі Swagger 2.0, версія v1. Збірка “LemonRest 2026.10 release-2026.10.2” містить 422 шляхи. (Swagger)
- Базова URL-адреса залежить від середовища. Її можна знайти в розділі керування користувачами: перейдіть до керування середовищами й адресами служб та знайдіть поле Rest API. На платформі Azure від Lemonsoft базова адреса —
https://rest.lemon.fi. - Доступність. Для клієнтів платформного сервісу Lemonsoft (Alustapalvelu) REST API вже встановлені — потрібно лише надати права доступу. (джерело)
- Тестове середовище. Кінцевий замовник замовляє його через Lemonsoft Service Desk.
Окремий API обліку робочого часу Kellokortti для календарного планування не потрібен.
Автентифікація
LemonRest працює із сеансами:
- Запит
POST /api/auth/loginіз параметрами UserName, Password, Database та ApiKey повертаєsession_id. - Передавайте його в заголовку
Session-Idу кожному виклику. - Поновлюйте сеанс через
POST /api/auth/renew. Для перевірки працездатності використовуйтеGET /api/auth/alive.
POST /api/auth/login/token приймає Token замість імені користувача й пароля. Створіть окремого користувача для інтеграції з ключем API та лише тими правами, які потрібні для інтеграції. (джерело)
На боці SkyPlanner автентифікація в REST API відбувається за токеном API (SkyPlanner Settings > API). Документація доступна у Swagger/OpenAPI. Навчальний посібник з інтеграції покроково пояснює перші виклики.
Виявлення змін: дельта-запити
У LemonRest немає кінцевих точок для вебхуків або підписок. Зміни отримують за допомогою дельта-запиту:
GET /api/production/main_ws/changed?updated_after=...повертає виробничі завдання, змінені з часу попереднього запуску.- Додайте
optimization=true. Цей параметр з’явився у випуску 2026.6.3, щоб усунути залежність від журналу та прискорити запит. (примітки до випуску) GET /api/log/deletion_eventsвиявляє видалені виробничі завдання, щоб скасовані роботи вилучалися з графіка.
Опитуйте API кожні кілька хвилин. SkyPlanner надсилає вебхуки, коли змінюється стан або графік, тому зворотний запис запускається за подіями.
Зіставлення даних
| Об’єкт Lemonsoft (кінцева точка) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Tuote, product_code (/api/products) | Вироби та матеріали | Lemonsoft → SkyPlanner | Початкове завантаження, далі — у разі змін |
Tuoterakenne з рядками Työvaiheet (/api/products/structure, all_levels) | Структура виробу, складові вироби, технологічні операції з часом налагодження | Lemonsoft → SkyPlanner | Початкове завантаження, далі — у разі змін |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Робочі центри, групи робочих центрів | Lemonsoft → SkyPlanner | Початкове завантаження, надалі — зрідка |
Työnumero як ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Замовлення з термінами виконання та пріоритетом | Lemonsoft → SkyPlanner | Опитування щодо змін кожні кілька хвилин |
Työvaihe як ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Виробничі завдання (технологічні операції) за робочими центрами | Lemonsoft → SkyPlanner | Опитування щодо змін кожні кілька хвилин |
Потреба в компонентах (main_ws/{worknumber}/materials) | Потреби в матеріалах для кожного виробничого завдання | Lemonsoft → SkyPlanner | Разом із кожним виробничим завданням |
Заплановані зміни (/api/persons/plannedshifts) | Зміни, персонал | Lemonsoft → SkyPlanner | Щодня, або зміни ведуться в SkyPlanner |
Замовлення клієнта, пов’язане з номером роботи (/api/orders/work/{work_number}) | Відомості про клієнта та пріоритет | Lemonsoft → SkyPlanner | Разом із кожним виробничим завданням |
Поля start_time, end_time, machine_id об’єкта Työvaihe (PUT /api/production/workstage) | Заплановані початок, завершення та робочий центр | SkyPlanner → Lemonsoft | У разі зміни графіка, через вебхук SkyPlanner |
Запис про виконання (POST main_ws/sub_ws/completion_entry) | Підтвердження: кількість придатної та бракованої продукції, години, працівник | SkyPlanner → Lemonsoft | Для кожного підтвердження |
| Правила календарного планування, задані в SkyPlanner | Дозволені робочі центри для кожного виробничого завдання, матриця часу переналагодження, інструменти | Ведуться в SkyPlanner | Налаштовуються під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Отримайте верстати та їхні групи, структури виробів із виробничими етапами, а також типові технологічні операції. Зіставте кожен конкретний верстат із робочим центром SkyPlanner. Батьківські верстати (Isäkone) використовуйте лише для групування, оскільки вони підсумовують потужності дочірніх верстатів.
2. Синхронізація номерів робіт. Отримайте відкриті номери робіт разом з етапами через /api/production/workstage або main_ws/sub_ws, застосувавши фільтр за станом і посторінкове завантаження. Далі підтримуйте дані актуальними через main_ws/changed. Зіставляйте work_amount_left, а не work_amount, оскільки Lemonsoft планує за залишковою кількістю. Замовлення на закупівлю надають дані для планування в SkyPlanner з урахуванням матеріалів, тому етап очікує на дату постачання за замовленням.
3. Зворотний запис графіка. Для кожного етапу, який алгоритм розмістив або перемістив у графіку, SkyPlanner надсилає PUT /api/production/workstage із виробничим завданням та його sub_workstages. Кожен етап містить start_time, end_time, а в разі перенесення на альтернативний верстат — також machine_id.
4. Підтвердження з виробництва. Оператори підтверджують виконання робіт через SkyPlanner Mobile Confirmations або Production Timer. Кожне підтвердження надсилається до completion_entry з полями sub_workstage_id, person_number, done_amount, hours, failed_amount та job_done. Якщо на етапі витрачається матеріал, передавайте разом із підтвердженням material_consumptions, і Lemonsoft створить стандартний запис обліку виконання (valmistuskirjaus).
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Вироби, структури, виробничі етапи, кількості, стан виробничого завдання | Lemonsoft |
| Послідовність етапів, час початку й завершення, вибір верстата | SkyPlanner |
| Дозволені робочі центри для кожного виробничого завдання, матриця часу переналагодження, інструменти | SkyPlanner |
| Зміни та відсутність працівників | Одна система, обрана під час визначення обсягу |
| Облік виконання та складських операцій | Lemonsoft, на основі підтверджень зі SkyPlanner |
Основне джерело конфліктів — власне автоматичне планування Lemonsoft і дія оновлення: обидва механізми заново розміщують незаблоковані етапи. Поки за графік відповідає SkyPlanner, залишайте AUTOTIMING зі значенням 0. Якщо автоматичне планування залишається ввімкненим, установлюйте блокування графіка для кожного номера роботи, дані якого записуються назад: воно фіксує всі етапи цього номера. Самого Koneiden kapasiteetin lukitus недостатньо, оскільки автоматичне планування переносить незаблоковані виробничі завдання із заблокованого дня на інші дні. (джерело)
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від його початку. Перед цим ви можете протягом 30 днів безкоштовно випробувати систему на власних даних — номерах робіт, етапах і верстатах, експортованих до Excel.
- Визначення обсягу. Узгодьте таблицю зіставлення, правила відповідальності за дані та інтервал опитування.
- Доступ. Кінцевий замовник замовляє тестове середовище через Lemonsoft Service Desk та створює користувача для інтеграції і ключ API.
- Початкове завантаження. Верстати, групи, структури виробів і виробничі етапи.
- Синхронізація номерів робіт. Опитування щодо змін, події видалення та поновлення сеансу.
- Налаштування обмежень у SkyPlanner. Дозволені робочі центри для кожного виробничого завдання, матриця часу переналагодження та інструменти.
- Зворотний запис. Час початку й завершення етапів і записи про виконання, перевірені в тестовому середовищі.
- Паралельна робота та запуск. Порівняйте результати з поточною діаграмою Ганта, виправте основні дані, а потім увімкніть зворотний запис у робочому середовищі.
Що врахувати під час інтеграції з Lemonsoft
- Один верстат на етап. У Lemonsoft для кожного етапу вказується один верстат. Під час впровадження перелік верстатів, придатних для конкретного виробу, береться зі списку або властивостей виробу. Після цього SkyPlanner вибирає серед доступних варіантів.
- Добова потужність. Фіксована потужність задається як обсяг на добу, а відхилення не прив’язані до конкретного часу. Змоделюйте фактичні зміни в SkyPlanner або зчитайте заплановані зміни.
- Залишкова кількість. Налаштуйте зіставлення поля
work_amount_left. Налаштування STARTJOB_AUTOTIMENOW і JOBDONE_AUTOTIMENOW також змінюють розподіл навантаження в самому Lemonsoft. - Сеанси мають обмежений термін дії. Поновлюйте сеанс перед тривалою синхронізацією та передбачте обробку примусового повторного входу.
- Правила підтвердження. Перед записом перевіряйте кожне підтвердження на відповідність стану етапу та регулюйте частоту викликів під час їх масового надсилання.
- Два клієнти. LemonOnline і версія для Windows використовують спільну базу даних, тому інтеграція працює з обома.
- Великі структури. Для імпорту великих обсягів використовуйте
/api/async/product/structureразом із/api/async/status/{jobId}.
Інтеграція з Lemonsoft: хто її налаштовує та підтримує
Роботи охоплюють зіставлення даних із вашими верстатами, виробничими етапами та конфігурацією Lemonsoft. Також налаштовуються правила календарного планування, які зберігаються в SkyPlanner: дозволені робочі центри для кожного виробничого завдання, матриця часу переналагодження та інструменти.
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску. На кожному підприємстві Lemonsoft використовують по-своєму, і саме ці особливості враховуються під час налаштування.
- Ваш партнер Lemonsoft може долучитися. Він знає вашу конфігурацію та може взяти на себе налаштування користувача API, прав доступу й тестового середовища. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники також можуть розширювати інтеграцію через той самий документований REST API з токеном API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби.
Після підключення рушій Arcturus формує графік на основі актуальних даних за номерами робіт у Lemonsoft, а запланований час записується у виробничі етапи. Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; до тарифу входять 5 робочих центрів. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із вартістю тарифу, тож ви бачите повну суму ще до початку робіт.
Порівняння з власними засобами планування Lemonsoft наведено в матеріалі «Планування виробництва в Lemonsoft з урахуванням реальних потужностей обладнання та персоналу». Загальний огляд доступний на сторінці Lemonsoft, а інші системи — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
Lemonsoftдвостороння інтеграція зі SkyPlanner
Kaskea Group
Контрактне виробництво: обробка на верстатах із ЧПК, сталеві конструкції та складання
Виробництво планують у SkyPlanner, який має двосторонню інтеграцію з Lemonsoft.
Меншепростоїв через нестачу матеріалів
«Цінність SkyPlanner для нас у тому, що цей інструмент справді працює в щоденній роботі, особливо коли потрібно визначити дати постачання».
Tommi Männistö, керівник відділу планування виробництва
Eskomatic · Механічна обробка на замовлення
Автоматичне планування завантаження дає змогу точніше визначати дати постачання, а кількість зупинок виробництва через нестачу матеріалів різко скоротилася.
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
Поширені запитання
Чи є в Lemonsoft API для виробничих даних?
Так. LemonRest надає доступ до виробничих завдань і етапів, верстатів, структур виробів, матеріалів, змін та реєстрації виконання. Для клієнтів Alustapalvelu його вже встановлено; для роботи потрібні ключ API та права користувача.
Чи підтримує Lemonsoft вебхуки?
У LemonRest не зазначено кінцевих точок для вебхуків. Зміни зчитуються за допомогою запиту main_ws/changed, який повертає лише зміни, та подій видалення. Опитування виконується кожні кілька хвилин. Власні вебхуки SkyPlanner передають зміни графіка одразу після їх появи.
Як запланований час передається зі SkyPlanner у Lemonsoft?
За допомогою PUT /api/production/workstage, що оновлює час початку, час завершення та верстат для виробничого завдання і його етапів. Поки графіком керує SkyPlanner, тримайте автоматичне планування Lemonsoft вимкненим або блокуйте графік для кожного номера роботи, за яким виконується запис. Так час залишатиметься таким, як його встановив SkyPlanner.
Чи можна передавати підтвердження операторів зі SkyPlanner у Lemonsoft?
Так. Кожне підтвердження передається як запис про виконання із зазначенням кількості придатної та бракованої продукції, годин і працівника. У клієнтських проєктах це працює щодня.
Хто створює інтеграцію з Lemonsoft?
Команда SkyPlanner налаштовує двосторонню інтеграцію відповідно до вашої конфігурації Lemonsoft під час впровадження та підтримує її після запуску. Ваш партнер Lemonsoft або власні розробники також можуть створити інтеграцію за допомогою документованого REST API SkyPlanner. Для початку достатньо токена API.
Чи можна протестувати SkyPlanner до створення інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна працювати з кількістю робочих центрів до 20 та імпортувати дані з Lemonsoft у форматі Excel або CSV. Банківська картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
