Інтеграції / ERP / Visma L7
Посібник з інтеграції Visma L7 з APS для календарного планування виробництва
Цей посібник пояснює партнерам та ІТ-командам, як підключити Visma L7 до SkyPlanner APS. SkyPlanner обмінюється даними з Visma L7 в обох напрямках через Visma L7 REST API:
- До SkyPlanner надходять номери робіт (työnumero), етапи робіт (työnvaihe), виробничі ресурси, структури виробів, деталі, матеріали, складські залишки, рядки замовлень на продаж і закупівлю.
- Для кожної картки роботи через
PUT /manufphases/передаються назад призначений виробничий ресурс, дата початку, пріоритет, виконавець і години за кожен день. - Доступні потужності в календарі виробничих ресурсів синхронізуються через
POST /resourceupdates/. - Виробничі події, зареєстровані в чергах робіт L7, зчитуються через
GET /manufevents/. - Вебхуки SkyPlanner передають зміни розкладу відразу після їх внесення.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації L7 та підтримує її після запуску. Партнери й розробники також можуть створювати власні рішення на основі документованого REST API SkyPlanner (довідник API).
REST API Visma L7
Для інтеграції використовується Visma L7 – REST API. Його описано у форматі OpenAPI 3.0.3 із журналом змін (документація). API працює на Visma LTR.
- Базовий шлях —
/ltrws/REST/L7на вашому сервері LTR, розгорнутому локально або в хостинговому сервісі застосунків Visma. - Ліцензування. Кожна кінцева точка ліцензується окремо. Для запису розкладу через
PUT /manufphases/потрібна ліцензія L7RMFPP, а для оновлення потужностей — L7RMCAP. Для кінцевих точок читання також потрібні окремі ліцензії. - Посторінкове отримання даних. Для поділу списків на сторінки використовуються
pageSizeіrecAfter, а для фільтрації —queryKey1,queryKey2іqueryString.
Автентифікація
З кожним викликом L7 передаються два токени:
- hash визначає базу даних і компанію.
- token ідентифікує користувача API.
Ваш адміністратор LTR створює користувача API у Visma LTR, прив’язує його до компанії L7, призначає профілі та створює токен користувача (початок роботи). Використовуйте окремого користувача інтеграції лише з тими правами, які потрібні для її роботи.
На боці SkyPlanner автентифікація в REST API виконується за допомогою токена API, який передається в заголовку Authorization-Token. Створіть його в розділі Settings > API. У посібнику з інтеграції покроково описано перші виклики.
Виявлення змін: modifiedAfter
L7 REST API не підтримує вебхуки. Зміни зчитуються шляхом періодичного опитування:
- Увімкніть журналювання змін (DBLOG) у розділі обслуговування файлів L7 (Tiedostohuolto) для таблиць, які зчитує інтеграція, зокрема карток робіт і деталей.
- Викликайте кінцеві точки читання, задавши в
modifiedAfterчас останнього запуску. Видалені записи повертаються з позначкою про видалення, тому скасовані роботи вилучаються з розкладу. - Виконуйте опитування кожні кілька хвилин. SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тому зворотний запис відбувається за подіями.
Зіставлення даних
| Об’єкт Visma L7 (кінцева точка) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Tuote (GET /products/) | Продукція та матеріали | L7 → SkyPlanner | Початкове завантаження, далі — у разі змін |
Деталі за номером роботи (GET /manufcomponents/) | Складові вироби | L7 → SkyPlanner | Опитування з modifiedAfter |
Потреби в матеріалах (GET /manufmaterials/) | Потреби в матеріалах для кожного виробничого завдання | L7 → SkyPlanner | Опитування з modifiedAfter |
Дерево виробничих ресурсів (KRYH) із кількістю верстатів (GET /manufresources/) | Робочі центри та їхні групи | L7 → SkyPlanner | Початкове завантаження, надалі — зрідка |
Картка роботи (TSUUNR) для кожного етапу (GET /manufphases/) | Виробничі завдання (етапи процесу) для кожного робочого центру | L7 → SkyPlanner | Опитування кожні кілька хвилин |
Складські залишки (GET /stockbalances/) | Запаси | L7 → SkyPlanner | Періодичне опитування |
Рядки замовлень на закупівлю (GET /purchaserows/) | Замовлення на закупівлю з датами поставки | L7 → SkyPlanner | Періодичне опитування |
Замовлення на продаж та їхні рядки (GET /salesorders/, GET /salesrows/) | Терміни виконання, пріоритет клієнта | L7 → SkyPlanner | Періодичне опитування |
Виробничі події (GET /manufevents/) | Хід виконання кожного виробничого завдання | L7 → SkyPlanner | Періодичне опитування |
Поля картки роботи: resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Запланований робочий центр, початок, черговість і години за днями | SkyPlanner → L7 | У разі зміни розкладу, через вебхук SkyPlanner |
Доступні потужності в календарі виробничих ресурсів (POST /resourceupdates/) | Доступні потужності за змінами | SkyPlanner → L7 | У разі коригування робочих змін |
| Правила календарного планування, задані в SkyPlanner | Дозволені робочі центри, матриця часу переналагодження, інструменти, працівники | Ведуться в SkyPlanner | Налаштовуються під час впровадження |
Сценарії інтеграції
1. Початкове завантаження основних даних. Зчитайте дерево виробничих ресурсів і зіставте кожен верстат з окремим робочим центром SkyPlanner. Якщо один виробничий ресурс L7 охоплює кілька верстатів, створіть окремий робочий центр для кожного верстата та групу робочих центрів для цього ресурсу. Зчитайте вироби та їхні структури разом з етапами робіт.
2. Синхронізація робіт за номерами. Зчитайте відкриті картки робіт через GET /manufphases/, а потім підтримуйте їхню актуальність за допомогою modifiedAfter. Зчитайте деталі й потреби в матеріалах для кожного номера роботи, а також складські залишки та рядки замовлень на закупівлю, щоб етап очікував дати поставки, зазначеної у відповідному рядку закупівлі.
3. Зворотний запис розкладу. Для кожного етапу, який алгоритм запланував або переніс, SkyPlanner викликає PUT /manufphases/. Тіло запиту містить один запис workSheet на кожну картку роботи з такими полями:
number— картка роботи таresource— вибраний виробничий ресурсstartDateіpriority— щоб черги робіт L7 відображали черговість, визначену SkyPlannerperson— якщо заплановано конкретного оператораschedulingDays— заплановані години за датами
L7 зберігає без змін пріоритет, заданий зовнішньою системою (джерело), тому черговість у чергах робіт залишається незмінною.
4. Синхронізація потужностей. Коли в SkyPlanner змінюються робочі зміни, святкові дні або понаднормові години, POST /resourceupdates/ записує оновлені потужності в календар виробничих ресурсів L7. Після цього подання завантаження в L7 відповідають плану.
5. Хід робіт у цеху. Оператори й далі реєструють виконання в чергах робіт L7 та Visma LTR, а SkyPlanner зчитує події через GET /manufevents/. Оператори також можуть підтверджувати виконання робіт у SkyPlanner Mobile Confirmations. Autopilot переплановує розклад за даними з будь-якого з цих джерел, а наступний зворотний запис передає оновлені строки.
6. Правила відповідальності за дані та розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Вироби, структури, етапи робіт, кількості, стан роботи за номером | Visma L7 |
| Послідовність етапів, дати початку, години за днями, вибір виробничого ресурсу | SkyPlanner |
| Дозволені робочі центри, матриця часу переналагодження, інструменти, працівники | SkyPlanner |
| Робочі зміни та відсутності | SkyPlanner із записом у календар виробничих ресурсів L7 |
| Виробничі події та складські проведення | Черги робіт Visma L7 та LTR |
Основне джерело конфліктів — власне планування L7. Розрахунок потреб і детальне планування можуть повторно розміщувати в розкладі незаблоковані етапи. Використовуйте їх лише для матеріалів і резервування та не переплановуйте етапи, за які відповідає SkyPlanner.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку робіт. Перед цим ви можете скористатися 30-денним безкоштовним пробним періодом на власних даних: номерах робіт, етапах і виробничих ресурсах, експортованих в Excel.
- Визначення обсягу. Узгодьте таблицю зіставлення, правила відповідальності за дані та інтервал опитування.
- Доступ і ліцензії. Придбайте ліцензії на кінцеві точки REST, передбачені обсягом проєкту. Адміністратор LTR створює користувача API, hash і token — бажано спочатку в тестовій компанії.
- Журналювання змін. Увімкніть DBLOG для таблиць, які зчитуєте.
- Початкове завантаження. Виробничі ресурси, вироби, структури та етапи робіт.
- Синхронізація робіт за номерами. Опитування з modifiedAfter, обробка видалень і посторінкове отримання даних.
- Налаштування обмежень у SkyPlanner. Дозволені робочі центри, матриця часу переналагодження, інструменти та працівники.
- Зворотний запис. Перевірка
PUT /manufphases/іPOST /resourceupdates/у тестовій компанії. - Паралельна робота та запуск. Порівняйте результат із поточним планом, виправте основні дані, а потім увімкніть зворотний запис у робочому середовищі.
Що врахувати під час інтеграції з Visma L7
- Ліцензії на кожну кінцеву точку. Заздалегідь складіть перелік усіх кінцевих точок і придбайте для них ліцензії до початку тестування.
- Кількість верстатів. У L7 ресурс із кількома верстатами розподіляє роботу між ними (джерело). Розділіть його на робочі центри в SkyPlanner, а під час зворотного запису передавайте ресурс, який очікує L7.
- Години за днями. L7 зберігає план як кількість годин на кожну дату. SkyPlanner передає
schedulingDays, сума яких дорівнює тривалості етапу. - Виробничий календар. Заповнюйте його без прогалин, адже вони зміщують етапи на минулі дати (джерело).
- Замовлення на склад.
mainNumber,subNumber,rowNumberіnewQuantityвикористовуються лише для зміни кількості в замовленні на склад. Для замовлень клієнтів ці поля не передавайте. - Перехід на іншу ERP. Visma припинила розробку нових функцій L7, а використання продукту завершується наприкінці 2028 року (повідомлення Visma). Зберігайте правила календарного планування в SkyPlanner, а не в полях L7, щоб зберегти їх під час зміни ERP.
Інтеграція з Visma L7: хто її налаштовує та підтримує
Роботи охоплюють зіставлення даних із вашими виробничими ресурсами, етапами робіт і конфігурацією L7. Також налаштовуються правила календарного планування, які зберігаються в SkyPlanner: допустимі робочі центри, матриця часу переналагодження, інструменти та працівники.
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску. Кожне підприємство використовує L7 по-своєму, і ці особливості враховуються під час налаштування.
- Ваш партнер Visma може долучитися. Він знає вашу конфігурацію L7 і LTR та може подбати про користувача API, ліцензії й тестову компанію. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники також можуть розвивати інтеграцію через той самий документований REST API, використовуючи токен API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби.
Коли ви заміните L7, SkyPlanner підключиться до нової ERP зі збереженням налаштувань. Перегляньте сторінки Business Central, Visma Net, Lemonsoft, Monitor ERP та Odoo.
Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; включено 5 робочих центрів. Вартість інтеграції розраховується заздалегідь з урахуванням ваших процесів і потреб та надається разом із вартістю тарифу, тож ви знаєте повну суму ще до початку робіт.
Порівняння з власними засобами планування L7 наведено в статті Чи підтримує Visma L7 планування виробництва з урахуванням реальних потужностей обладнання та персоналу? Загальний огляд доступний на сторінці Visma L7, а інші системи — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
1 000+ виробничих замовлень плануються автоматично
«Тепер ми зовсім інакше контролюємо виробництво, а наше розуміння виробничих потужностей вийшло на цілком інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся компанія бачить стан виробництва в реальному часі.
98%надійність поставок, порівняно з приблизно 50% раніше
«SkyPlanner відіграє вирішальну роль у підтриманні нашої надійності поставок».
Hannu Lahtinen, керуючий директор
KJH-Comp · Виготовлення виробів із листового металу та контрактне виробництво
Надійність поставок зросла з приблизно 50%, сягнувши 98%, а для календарного планування тепер потрібен один керівник замість двох.
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюгів постачання
UTU · Електрощити та розподільні пристрої
На плануванні виробництва щотижня заощаджується 2 години робочого часу, а нова черга завдань надходить на лінію за лічені секунди.
+90%ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а складання оптимізованого плану на три місяці для всіх робочих центрів займає менше 30 хвилин.
Поширені запитання
Чи має Visma L7 API для виробничих даних?
Так. REST API Visma L7 на платформі Visma LTR надає доступ до етапів робіт, виробничих ресурсів, деталей, матеріалів, виробничих подій, продукції, складських залишків, рядків продажу та закупівель. Кожна кінцева точка ліцензується окремо, а адміністратор LTR створює користувача API та токени.
Як розклад передається зі SkyPlanner до Visma L7?
Через PUT /manufphases/, який оновлює ресурс, дату початку, пріоритет, працівника та заплановані години за датами в кожній робочій картці. POST /resourceupdates/ записує доступні потужності в календар ресурсу. L7 зберігає зовнішній пріоритет, тому черги завдань відповідають послідовності, визначеній SkyPlanner.
Чи підтримує Visma L7 вебхуки?
Вебхуки не задокументовані. Увімкніть журналювання змін для таблиць, охоплених інтеграцією, і виконуйте періодичні запити з modifiedAfter. Власні вебхуки SkyPlanner передають зміни розкладу одразу після їх внесення.
Яке програмне забезпечення для календарного планування інтегрується з Visma L7?
SkyPlanner APS забезпечує двосторонню інтеграцію з Visma L7 через REST API L7, а Visma вказує Skycode зі SkyPlanner на своїй сторінці інтеграцій L7. Команда SkyPlanner налаштовує інтеграцію під час впровадження.
Хто розробляє інтеграцію з Visma L7?
Команда SkyPlanner налаштовує двосторонню інтеграцію відповідно до вашої конфігурації L7 під час впровадження та підтримує її після запуску. Ваш партнер Visma або власні розробники також можуть створювати рішення на основі документованого REST API SkyPlanner. Для початку достатньо токена API.
Чи можемо ми протестувати SkyPlanner до розробки інтеграції?
Так. Безкоштовна пробна версія на 30 днів підтримує до 20 робочих центрів з імпортом даних із L7 через Excel або CSV. Кредитна картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
