Інтеграції / ERP / Visma Net ERP
Посібник з інтеграції Visma Net для календарного планування виробництва в SkyPlanner APS
Цей посібник пояснює партнерам та ІТ-командам, як підключити Visma Net (Visma.net ERP) до SkyPlanner APS. SkyPlanner обмінюється даними з Visma Net в обох напрямках через Visma Net API:
- До SkyPlanner надходять Stock items, Kit specifications, замовлення на продаж, складські залишки та замовлення на закупівлю.
- На основі запланованих виробничих завдань створюються документи Kit assembly, які проводяться після завершення робіт.
- Відпрацьовані години операторів передаються назад як табелі Employee time card.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Visma Net і підтримує її після запуску. Цей посібник призначений для партнерів і розробників, які хочуть долучитися до робіт або самостійно створювати рішення на основі документованого REST API SkyPlanner (довідник API).
Інтерфейси інтеграції Visma Net
- Visma Net ERP API. REST API зі специфікацією OpenAPI, яка досі має назву “Visma.net ERP API v1”, і шляхами v1 та v2. Базова URL-адреса —
https://api.finance.visma.net. З 1 лютого 2026 року пропускну здатність старого доменуintegration.visma.netобмежено; домен виводять з експлуатації (повідомлення). - SalesOrder service v3 за адресою
https://salesorder.visma.net. Термін підтримки кінцевих точок v1 і v2 для замовлень на продаж завершено. - Вебхуки через Visma Developer Portal.
- Background API. Заголовок
erp-api-backgroundдає змогу ставити тривалі виклики в чергу, отримувати відповідь 202 з ідентифікатором завдання та сповіщення про готовність результату. - Сценарії імпорту та експорту у Visma Net з постачальниками даних CSV, Excel або SQL для разового завантаження основних даних.
В API немає кінцевих точок для виробничих замовлень, технологічних маршрутів чи робочих центрів, оскільки у Visma Net немає таких об’єктів. Дані для календарного планування отримують із позицій номенклатури, комплектів, замовлень і складських залишків:
GET /v1/inventory: складські та нескладські позиції, зокрема ознака комплекту й клас позиціїGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: рядки компонентів для кожної редакціїGET /v1/kitassembly: наявні документи складання комплектів із можливістю фільтрації за типом і статусом- SalesOrder service v3: попит із бажаними датами виконання та рядками замовлень
GET /v1/inventorysummary/{inventoryNumber}: фактичні та доступні залишки за складамиGET /v1/purchaseorderіGET /v2/PurchaseReceipt: очікувані поставки матеріалів та їх надходження
Усі кінцеві точки для отримання списків приймають lastModifiedDateTime разом із lastModifiedDateTimeCondition, а також pageNumber і pageSize. Завдяки цьому під час кожної синхронізації можна передавати лише зміни.
Автентифікація та обмеження
Visma Net використовує Visma Connect (OpenID Connect і OAuth 2.0):
- Зареєструйте Service Integration у Visma Developer Portal.
- Інтеграцію схвалює адміністратор тенанта Visma Net замовника.
- Запитуйте токени за схемою client credentials за адресою
https://connect.visma.com/connect/token, передаючиtenant_idта області доступу API, як-отvisma_api:read. Токени діють 3 600 секунд.
Ліміти запитів діють у межах фіксованого годинного вікна для кожної компанії та клієнта. Відповіді містять X-RateLimit-Limit, X-RateLimit-Remaining і X-RateLimit-Reset. У разі перевищення ліміту повертається код 429 із заголовком Retry-After (ліміти запитів). Заголовки ETag і If-Match захищають оновлення даних.
Партнери тестують інтеграцію на демонстраційній компанії в межах безплатної програми Visma Integrator Programme. На стороні SkyPlanner автентифікація в REST API відбувається за допомогою токена API (SkyPlanner Settings > API), а документація доступна у Swagger/OpenAPI. Навчальний посібник з інтеграції покроково пояснює перші виклики.
Події, вебхуки та опитування
Вебхуки Visma Developer Portal охоплюють події, важливі для календарного планування:
- Inventory Item Created, Updated і Changed
- Purchase Order Changed і Status Changed
- Sales Order Changed і Status Changed — публікація цих подій переходить до SalesOrderService
Для Kit assembly та Kit specifications подій немає. SkyPlanner отримує їх шляхом опитування з фільтрами lastModifiedDateTime. Складські залишки запитуються під час розрахунку графіка. У зворотному напрямку SkyPlanner надсилає вебхуки, коли змінюється стан або графік.
Зіставлення даних
| Об’єкт Visma Net (кінцева точка) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Продукція та матеріали | Visma Net → SkyPlanner | Початкове завантаження, потім вебхуки |
Kit specifications (/v1/KitSpecifications) | Структура виробу, матеріали для кожного виробу | Visma Net → SkyPlanner | Початкове завантаження, потім опитування |
| Sales orders (SalesOrder service v3) | Замовлення з термінами виконання та пріоритетом клієнта | Visma Net → SkyPlanner | Вебхук |
Kit assembly зі статусом On hold (/v1/kitassembly), якщо документи складання створюються у Visma Net | Виробничі завдання | Visma Net → SkyPlanner | Опитування |
Inventory summary (/v1/inventorysummary) | Залишки за складами | Visma Net → SkyPlanner | Опитування під час розрахунку графіка |
Purchase orders, purchase receipts (/v1/purchaseorder, /v2/PurchaseReceipt) | Очікувані матеріали з датою поставки; оновлення залишків після поставки за замовленням на закупівлю | Visma Net → SkyPlanner | Вебхук, потім зчитування |
| Відсутні у Visma Net | Технологічні операції, робочі центри, зміни, матриця часу переналагодження, інструменти, альтернативні ресурси | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
Створення та оновлення Kit assembly (POST/PUT /v1/kitassembly) | Заплановане виробниче завдання: позиція комплекту, кількість, планова дата завершення | SkyPlanner → Visma Net | У разі зміни графіка — через вебхук SkyPlanner |
Проведення Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Завершене виробниче завдання: випуск продукції та витрата компонентів | SkyPlanner → Visma Net | Після завершення |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, проведення) | Випуск продукції та витрата матеріалів, якщо комплекти не використовуються | SkyPlanner → Visma Net | Після завершення |
Employee time card (/v1/timeCard) | Зареєстровані години кожного оператора | SkyPlanner → Visma Net | Щотижня |
Схеми інтеграції
1. Початкове завантаження основних даних. Зчитайте складські позиції, класи позицій та останню редакцію Kit specification для кожного комплекту. Зіставте кожен рядок компонента з матеріалом у SkyPlanner. Потім створіть дані, яких немає у Visma Net: робочі центри, зміни, технологічні операції з часом підготовки й виконання, матрицю часу переналагодження та вимоги до інструментів. Імпортуйте їх у форматі CSV або Excel. Це найбільша частина проєкту.
2. Синхронізація замовлень. Виберіть одну модель формування попиту:
- На основі замовлень на продаж. Відкриті рядки замовлень на продаж для комплектів стають замовленнями у SkyPlanner, а бажана дата виконання — терміном виконання.
- На основі документів складання. Документи Kit assembly, створені у Visma Net зі статусом On hold, стають виробничими завданнями у SkyPlanner.
Відкриті замовлення на закупівлю надходять разом із датами. SkyPlanner вважає замовлений матеріал доступним на дату поставки за замовленням на закупівлю та оновлює залишки, коли замовлення отримує статус Delivered. Разом зі зведенням складських залишків ці дані дають змогу під час розрахунку графіка перевіряти як наявні запаси, так і очікувані закупівлі.
3. Зворотний запис графіка. У моделі на основі замовлень на продаж SkyPlanner створює Kit assembly типу Production для кожного запланованого виробничого завдання. Система задає позицію комплекту, редакцію, склад, кількість і компоненти та пов’язує документ складання з рядком замовлення на продаж. Датою складання є планова дата завершення. Коли Autopilot переносить завдання, виклик PUT оновлює дату до проведення документа.
У Kit assembly є одне поле Date, тому час виконання окремих операцій залишається у SkyPlanner, а Visma Net отримує дату, важливу для продажів та обліку запасів.
4. Підтвердження виконання робіт у цеху. Оператори реєструють роботу через Mobile Confirmations або Production Timer, а записи часу підтримують графік в актуальному стані. Після завершення останньої операції SkyPlanner викликає дію проведення для Kit assembly. Проведення відображає випуск продукції та витрату компонентів, після чого формується пакет проводок головної книги. Години підсумовуються в щотижневих табелях Employee time card або в операціях за проєктами, якщо роботи виконуються в межах проєктів.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Номенклатура, Kit specifications, замовлення на продаж, замовлення на закупівлю, складські залишки, собівартість | Visma Net |
| Технологічні операції, робочі центри, зміни, переналагодження, інструменти | SkyPlanner |
| Послідовність виробничих завдань, час початку й завершення, призначення робочого центру | SkyPlanner |
| Дата Kit assembly до проведення | SkyPlanner |
| Проведені Kit assemblies і табелі обліку робочого часу | Visma Net, проведення зі SkyPlanner |
Зміна Kit specification створює нову редакцію. Повторно зчитайте останню редакцію та оновіть зіставлення, оскільки для виготовлення можна використовувати лише останню редакцію. Зміни компонентів, внесені вручну в документ складання, залишаються чинними у Visma Net, тому SkyPlanner повторно зчитує цей документ перед проведенням.
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів від початку підключення. До цього ви можете скористатися 30-денним безкоштовним пробним періодом на власних даних: їх вивантажують за сценарієм експорту Visma Net та імпортують у форматі CSV або Excel.
- Визначення обсягу. Зафіксуйте модель попиту, таблицю зіставлення, правила відповідальності за дані та ціль зворотного запису (Kit assembly або документи надходження запасів).
- Налаштування Visma Connect. Зареєструйте Service Integration та отримайте схвалення адміністратора тенанта. Спочатку проведіть тестування в демонстраційній компанії.
- Виробнича модель. Робочі центри, зміни, технологічні операції, переналагодження та інструменти у SkyPlanner.
- Початкове завантаження. Складська номенклатура, класи номенклатури, Kit specifications, склади, складські залишки.
- Синхронізація замовлень на продаж і закупівлю. Вебхуки для замовлень на продаж, замовлень на закупівлю та номенклатури; періодичне опитування для комплектів і складських залишків. На цьому ж етапі налаштовують оновлення токенів та обробку відповідей 429.
- Зворотний запис. Створення, оновлення та проведення Kit assembly, а також передавання табелів обліку робочого часу.
- Паралельне тестування. Складіть графік у SkyPlanner паралельно з поточним планом і порівняйте дати.
- Запуск у роботу. Увімкніть зворотний запис, коли дані збігатимуться.
Що врахувати під час інтеграції з Visma Net
- Технологічних маршрутів для імпорту немає. Усі технологічні операції, час переналагодження та виконання задаються у SkyPlanner. Оцініть обсяг робіт і визначте відповідального.
- Advanced logistics. Для Kit assembly потрібна група Advanced logistics. Якщо ви використовуєте Standard logistics, проводьте випуск продукції через Inventory receipt та Inventory issue.
- Заблоковані редакції. Редакцію Kit specification, яку вже використали, не можна редагувати. Для виготовлення можна використовувати лише останню редакцію.
- Одиниці виміру. Kit assembly має власну одиницю виміру. Під час імпорту узгодьте її з кількостями у SkyPlanner.
- Опитування без подій. Для комплектів немає вебхуків. Завантажуйте лише зміни за
lastModifiedDateTime, а не всі дані заново, щоб не перевищувати погодинний ліміт запитів. - Актуальні кінцеві точки. Використовуйте для розробки лише
api.finance.visma.netта SalesOrder service v3. - Схвалення адміністратора тенанта. Автентифікація за обліковими даними клієнта не працюватиме, доки адміністратор тенанта не схвалить застосунок. Заплануйте цей крок заздалегідь.
- Щотижневі табелі обліку робочого часу. Для табелів потрібен Advanced financials; табелі ведуться за тижнями. Підсумовуйте години операторів за тиждень або записуйте їх у транзакції проєкту.
Хто налаштовує та підтримує інтеграцію з Visma Net
- Команда SkyPlanner налаштовує інтеграцію під час підключення та підтримує її після запуску. Це охоплює налаштування на боці SkyPlanner, виробничу модель, якої немає у Visma Net, та узгоджені виклики API Visma Net. Кожне підприємство використовує Visma Net по-своєму, і ці особливості враховуються в налаштуванні.
- Ваш партнер із Visma Net може долучитися. Visma постачає Visma Net через сертифікованих партнерів Visma. Вони знають вашу конфігурацію та можуть перевірити зіставлення даних і застосунок Visma Connect. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники можуть створити інтеграцію самостійно за допомогою того самого документованого REST API та токена API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Загальнодоступна документація — у розділі документації SkyPlanner.
Після підключення рушій Arcturus складає графік за актуальними замовленнями Visma Net, а виконані роботи повертаються у Visma Net як проведені Kit assemblies. Вартість — від 199 € на місяць із щомісячною оплатою; включено 5 робочих центрів. Вартість інтеграції розраховують заздалегідь з урахуванням ваших процесів і потреб та надають разом із вартістю тарифного плану, тож повна сума відома ще до початку роботи.
Перегляньте ціни та дізнайтеся, навіщо Visma Net потрібна система календарного планування, у матеріалі «Планування виробництва у Visma Net з урахуванням реальних потужностей обладнання та персоналу». Загальний огляд є на сторінці Visma Net, а інші ERP — у розділі інтеграцій з 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%, а календарним плануванням тепер займається один керівник замість двох.
6 місяцівнаперед відділ продажів бачить вільні потужності
«SkyPlanner дає надійну основу для всього планування виробництва».
Anu Järvinen, керівниця виробництва
Fredman Operations · Папір для пакування харчових продуктів
Відділ продажів бачить вільні потужності на шість місяців наперед. Відповіді на запити щодо зміни графіка, які раніше займали годину або більше, тепер надають за лічені секунди.
Поширені запитання
Чи є в API Visma Net виробничі замовлення?
Ні. У Visma Net немає об’єктів виробничих замовлень, технологічних маршрутів або робочих центрів, тому їх немає і в API. Виробничим документом є Kit assembly за адресою /v1/kitassembly, а технологічні маршрути та робочі центри зберігаються у SkyPlanner.
Яку автентифікацію використовує інтеграція?
Visma Connect із потоком OAuth 2.0 client credentials та реєстрацією як Service Integration у Visma Developer Portal. Інтеграцію схвалює адміністратор тенанта, а токени діють одну годину.
Чи може Visma Net надсилати зміни в реальному часі?
Для номенклатури, замовлень на продаж і замовлень на закупівлю — так, через вебхуки Visma Developer Portal. Для Kit assemblies та Kit specifications подій немає, тому зміни отримують шляхом інкрементального опитування. Власні вебхуки SkyPlanner надсилають зміни графіка одразу після їх внесення.
Як дані про завершене виробництво передаються назад у Visma Net?
SkyPlanner створює Kit assembly для кожного запланованого виробничого завдання, оновлює дату цього документа та викликає дію release після завершення завдання. Проведення відображає випуск продукції та споживання компонентів. Якщо комплекти не використовуються, те саме виконують Inventory receipt та Inventory issue.
Чи можна протестувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна використовувати до 20 робочих центрів та імпортувати дані з Visma Net у форматі CSV або Excel. Кредитна картка не потрібна. Спробуйте безкоштовно або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
