Інтеграції / ERP / Katana
Посібник з інтеграції Katana для календарного планування виробництва у SkyPlanner APS
У цьому посібнику консультанти та ІТ-команди дізнаються, як підключити Katana Cloud Inventory (Katana MRP) до SkyPlanner APS. SkyPlanner обмінюється даними з Katana в обох напрямках через публічний Katana API:
- До SkyPlanner надходять виробничі замовлення, рядки технологічних операцій, рецептури виробів, технологічні операції, виробничі ресурси, дані про запаси та замовлення на закупівлю.
- Черговість виконання з розкладу передається назад на вкладку Schedule у Katana разом із кінцевим терміном виробництва для кожного виробничого замовлення.
- Статус технологічної операції та фактичний час передаються назад у рядки технологічних операцій.
- Вебхуки Katana повідомляють SkyPlanner про зміни, а вебхуки SkyPlanner передають зміни розкладу одразу після їх внесення.
Під час впровадження команда SkyPlanner налаштовує інтеграцію відповідно до вашої конфігурації Katana та підтримує її після запуску. Цей посібник призначений для консультантів і розробників, які хочуть долучитися до роботи або самостійно створювати рішення на основі документованого REST API SkyPlanner (довідник API).
Katana API
Katana — єдиний хмарний продукт із багатоклієнтською архітектурою, тому всі клієнти користуються тим самим API. Це REST API версії v1 за адресою https://api.katanamrp.com/v1; специфікація OpenAPI 3.0 доступна за адресою https://api.katanamrp.com/v1/openapi.json. Документацію розміщено в Katana Developer Hub.
Кінцеві точки, потрібні для календарного планування:
- Основні дані:
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows. - Замовлення:
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions. - Черговість:
/manufacturing_order_rerank. - Постачання та попит:
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows.
Кінцевої точки /resources немає. Виробничі ресурси представлені полями resource_id та resource_name у рядках технологічних операцій виробу та виробничого замовлення.
Автентифікація та обмеження
Для автентифікації використовується ключ API як bearer-токен: Authorization: Bearer <api key>. Створіть ключ у розділі Settings > API > Add new API key. (джерело)
Під час проєктування синхронізації потрібно врахувати такі обмеження:
- За замовчуванням API Katana дозволяє 60 запитів за 60 секунд (джерело)
- У разі перевищення ліміту API повертає код 429 із заголовком
Retry-After. ЗаголовокX-Ratelimit-Remainingпоказує, скільки запитів ще доступно. - Кінцеві точки списків повертають результати посторінково й підтримують фільтри за датою оновлення, тож обсяг змін для синхронізації залишається невеликим.
На боці SkyPlanner REST API використовує для автентифікації токен API (SkyPlanner Settings > API) і має документацію у Swagger/OpenAPI. У навчальному посібнику з інтеграції покроково описано перші виклики.
Вебхуки
Зареєструйте вебхук запитом POST /webhooks, указавши HTTPS-адресу та потрібні події. (джерело) Для календарного планування корисні такі події:
manufacturing_order.created,.updated,.deleted,.in_progress,.blocked,.donemanufacturing_order_operation_row.created,.updated,.in_progress,.paused,.completedcurrent_inventory.material_updated,.material_out_of_stockpurchase_order.*таpurchase_order_row.*, зокрема події отриманняproduct.*,product_recipe_row.*таsales_order.*
Повідомлення містять мінімум даних: тип ресурсу, дію та href. Одержувач завантажує повний об’єкт за адресою href. Кожне повідомлення містить заголовок x-sha2-signature (HMAC SHA-256) для перевірки. Ваша кінцева точка має відповісти кодом 20X протягом 10 секунд. Katana робить три повторні спроби: через 30 секунд, 2 хвилини та 15 хвилин.
Зіставлення даних
| Об’єкт Katana (кінцева точка) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Вироби, матеріали, варіанти (/products, /materials, /variants) | Продукція та матеріали | Katana → SkyPlanner | Початкове завантаження, далі — за вебхуком |
Рецептура виробу / BOM (/recipe_rows, /bom_rows) | Структура виробу, складові вироби | Katana → SkyPlanner | Початкове завантаження, далі — за вебхуком |
Технологічні операції (/product_operation_rows): тип, виробничий ресурс, час | Етапи процесу із тривалістю та часом налагодження | Katana → SkyPlanner | Початкове завантаження, далі — у разі змін |
Виробничі ресурси (resource_id, resource_name у рядках технологічних операцій) | Робочі центри, групи робочих центрів | Katana → SkyPlanner | Початкове завантаження та у разі появи нового виробничого ресурсу |
Виробниче замовлення з рядками технологічних операцій (/manufacturing_orders, /manufacturing_order_operation_rows) | Замовлення та виробничі завдання | Katana → SkyPlanner | У реальному часі через вебхук |
Компоненти виробничого замовлення (/manufacturing_order_recipe_rows) | Матеріали для кожного виробничого завдання | Katana → SkyPlanner | У реальному часі через вебхук |
Запаси, замовлення на закупівлю з датами надходження (/inventory, /purchase_order_rows) | Запаси та очікувані надходження матеріалів | Katana → SkyPlanner | У реальному часі через вебхук |
Поле delivery_date замовлення на продаж (/sales_orders) | Термін виконання замовлення, пріоритет клієнта | Katana → SkyPlanner | У реальному часі через вебхук |
Черговість виробничих замовлень (POST /manufacturing_order_rerank) | Черговість відкритих виробничих замовлень у розкладі | SkyPlanner → Katana | У разі зміни розкладу |
Поле production_deadline_date виробничого замовлення (PATCH /manufacturing_orders/{id}) | Заплановане завершення | SkyPlanner → Katana | У разі зміни розкладу |
Поля status, total_actual_time рядка технологічної операції (PATCH /manufacturing_order_operation_rows/{id}) | Mobile Confirmations, записи обліку часу | SkyPlanner → Katana | У міру реєстрації виконаної роботи |
| Відсутні в Katana | Зміни, відсутності працівників, матриця часу переналагодження, інструменти, кількість операторів, альтернативні робочі центри | Ведуться у SkyPlanner | Налаштовуються під час впровадження |
Схеми інтеграції
1. Початкове завантаження основних даних. Посторінково завантажте вироби, матеріали, варіанти, рядки рецептур і рядки технологічних операцій виробів, не перевищуючи ліміт запитів. Для кожного унікального виробничого ресурсу в рядках технологічних операцій створіть робочий центр SkyPlanner і зберігайте відповідність ключів 1:1. Задайте зміни, відпустки та понаднормову роботу для кожного робочого центру у SkyPlanner, оскільки в Katana немає календаря виробничих ресурсів.
2. Синхронізація замовлень. Підпишіться на події виробничих замовлень, рядків технологічних операцій, запасів і замовлень на закупівлю. Для кожної події завантажуйте об’єкт за його адресою href та оновлюйте виробниче завдання. SkyPlanner вважає замовлений матеріал доступним на дату постачання за замовленням на закупівлю й оновлює запаси після його отримання. Щонічне звіряння з фільтрами за датою оновлення дає змогу виявити всі пропущені події.
3. Зворотний запис розкладу. План передається до Katana двома викликами.
- POST
/manufacturing_order_rerank“moves one or more manufacturing orders to an exact place in the production schedule” (переміщує одне або кілька виробничих замовлень на визначене місце у виробничому розкладі). Один запит може містити до 250 відкритих виробничих замовлень, які розміщуються на початку, у кінці, перед або після заданого виробничого замовлення. (джерело) - PATCH
/manufacturing_orders/{id}задаєproduction_deadline_date. Katana приймає це значення лише тоді, коли автоматичний розрахунок кінцевого терміну для відповідного виробничого майданчика вимкнено. (джерело)
Зміна черговості впливає не лише на порядок у списку. У Katana “higher-priority MOs reserve required materials and subassemblies first” (виробничі замовлення з вищим пріоритетом першими резервують потрібні матеріали та складальні одиниці), тому черговість зі SkyPlanner також визначає, якому виробничому замовленню дістануться запаси в Katana.
4. Підтвердження з виробничого цеху. Оператори реєструють виконану роботу через SkyPlanner Mobile Confirmations, Production Timer або Quick Log Mode. SkyPlanner записує статус і фактичний час у рядок технологічної операції виробничого замовлення. Якщо підприємство натомість продовжує використовувати Katana Shop Floor App, SkyPlanner зчитує події рядків технологічних операцій. Виберіть один канал звітування для кожного підприємства.
5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:
| Дані | Відповідальна система |
|---|---|
| Вироби, рецептури, технологічні операції, запаси, закупівлі, замовлення на продаж | Katana |
| Послідовність технологічних операцій, час початку й завершення, робочий центр для кожної технологічної операції | SkyPlanner |
| Позиція виробничого замовлення на вкладці Schedule та кінцевий термін виробництва | SkyPlanner, із записом у Katana |
| Зміни, відсутності працівників, матриця часу переналагодження, інструменти, альтернативні виробничі ресурси | SkyPlanner |
| Статус технологічної операції та облікований час | Один канал, обраний під час визначення обсягу |
Типові етапи проєкту
Впровадження зазвичай завершується протягом кількох тижнів після початку роботи з командою SkyPlanner. Перед цим ви можете пройти 30-денний безкоштовний пробний період на власних даних, експортованих із Katana у CSV, наприклад зі списку Tasks на екрані Make.
Сам проєкт охоплює такі етапи:
- Тариф і ключ. Переконайтеся, що тариф Katana включає API та Manufacturing Management, і створіть ключ API.
- Режим визначення строків. Узгодьте вимкнення автоматичного визначення строків для виробничої локації, щоб строки виробництва визначав SkyPlanner.
- Зіставлення даних. Зафіксуйте таблицю відповідностей, ключі виробничих ресурсів, правила розподілу відповідальності за дані та канал передавання звітних даних.
- Початкове завантаження. Продукти, варіанти, рецептури, технологічні операції та виробничі ресурси.
- Синхронізація за подіями. Вебхуки для замовлень, технологічних операцій, запасів і замовлень на закупівлю, а також щонічне звіряння даних.
- Налаштування обмежень у SkyPlanner. Зміни, матриця часу переналагодження, інструменти, кількість операторів та альтернативні робочі центри.
- Зворотний запис. Зміна черговості та строки, а потім — статус і час технологічних операцій.
- Паралельне тестування та запуск. Порівняйте дати SkyPlanner із поточними датами на вкладці Schedule, виправте основні дані, а потім увімкніть зворотний запис.
Що врахувати під час інтеграції з Katana
- Режим визначення строків перезаписує дати. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Після ввімкнення автоматичного режиму всі строки, задані вручну, буде перезаписано без можливості відновлення.) Визначтеся з режимом один раз, на старті проєкту.
- Календаря виробничих ресурсів немає. Не визначайте зміни на основі єдиного значення Weekly throughput. Налаштуйте їх для кожного робочого центру в SkyPlanner.
- Виробничі ресурси є лише в рядках технологічних операцій. Не змінюйте назви виробничих ресурсів у Katana: вони слугують ключами для зіставлення з робочими центрами SkyPlanner.
- Одиниці часу.
planned_time_parameterзадається в секундах: на одиницю продукції для поштучних технологічних операцій і загалом для типів process, setup та fixed. Правильно зіставте тип, інакше тривалість буде завищена або занижена в стільки разів, скільки одиниць продукції. - Групи для виробництва на замовлення. Під час зміни черговості виробничі замовлення (MO), пов’язані з одним замовленням на продаж, залишаються разом, тому розміщуйте їх у розкладі як єдину групу.
- Логіка зміни черговості змінилася. Із 7 жовтня 2026 року кінцеві точки rerank розміщують замовлення точно у вказаних позиціях. Інтеграції, створені під попередню логіку, потрібно протестувати повторно. (джерело)
Інтеграція з Katana: хто її налаштовує та підтримує
Робота охоплює ваші виробничі ресурси, технологічні операції, потік замовлень і режим визначення строків. До налаштувань додають те, чого немає в Katana: зміни, матрицю часу переналагодження, інструменти, кількість операторів та альтернативні виробничі ресурси.
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску. Кожне підприємство по-своєму налаштовує виробничі ресурси й технологічні операції в Katana — саме ці особливості враховують під час налаштування інтеграції.
- Ваш консультант із Katana або партнер з інтеграції може розробити її. SkyPlanner надає REST API, документацію Swagger/OpenAPI та вебхуки.
- Ваші розробники можуть створювати власні рішення на цій основі за допомогою токена API. Для початку достатньо токена API, а команда SkyPlanner допоможе за потреби. Документація продукту, зокрема щодо замовлень на закупівлю та API продуктів і матеріалів, доступна в документації SkyPlanner.
Вартість SkyPlanner — від 199 € на місяць із щомісячною оплатою; включено 5 робочих центрів. Вартість інтеграції для ваших процесів і потреб розраховують заздалегідь разом із тарифом, тож ви знаєте повну суму ще до початку роботи. Перегляньте ціни, можливості та порівняння з власним календарним плануванням Katana у статті Планування виробництва з урахуванням реальних потужностей обладнання та персоналу в Katana. Загальний огляд наведено на сторінці Katana, а інші ERP — у розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до оптимізації виробництва в реальному часі».
Kalle Kalliomäki, фахівець із ланцюга постачання
UTU · Електрощити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга завдань надходить на лінію за лічені секунди.
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%».
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менш ніж 30 хвилин.
Меншезупинок через брак матеріалів
«Цінність SkyPlanner для нас у тому, що це інструмент, який працює в щоденній роботі, особливо коли потрібно визначати дати постачання».
Tommi Männistö, керівник відділу планування виробництва
Eskomatic · Механічна обробка на замовлення
Автоматичне планування завантаження дає змогу точніше визначати дати постачання, а кількість зупинок виробництва через брак матеріалів різко скоротилася.
1 000+виробничих замовлень плануються автоматично
«Ми контролюємо виробництво зовсім по-іншому, а наше розуміння виробничих потужностей вийшло на абсолютно інший рівень».
Hannu Ryynänen, генеральний директор
Mamec · Промислові змішувачі, насоси та високотехнологічне контрактне виробництво
Тисячі виробничих замовлень плануються автоматично, а вся організація бачить стан виробництва в реальному часі.
Поширені запитання
Чи є в Katana API і який тариф потрібен?
Так. Katana надає публічний REST API v1 зі специфікацією OpenAPI 3.0. На сторінці цін доступ до API зазначено для тарифів Free та Advantage. Для автентифікації використовується ключ API типу bearer із розділу Settings > API.
Чи може SkyPlanner записувати сформований розклад у Katana?
Так. Через /manufacturing_order_rerank SkyPlanner розставляє відкриті виробничі замовлення у своїй послідовності на вкладці Schedule в Katana та записує production_deadline_date для кожного виробничого замовлення (MO). Статус технологічної операції та фактичний час записуються в рядки операцій MO. Розклад із прив’язкою до часу для кожного робочого центру зберігається в SkyPlanner, де оператори працюють зі своїми чергами завдань.
Чи надсилає Katana зміни в реальному часі?
Так. Вебхуки Katana охоплюють виробничі замовлення, рядки технологічних операцій, запаси, замовлення на закупівлю та замовлення на продаж. SkyPlanner отримує кожен змінений об’єкт і щоночі звіряє дані, тож навіть у разі пропущеної події дані виробничого завдання обов’язково оновлюються.
Як виробничі ресурси Katana стають робочими центрами SkyPlanner?
Кожному унікальному виробничому ресурсу в рядках технологічних операцій Katana відповідає робочий центр SkyPlanner із ключем зіставлення 1:1. Зміни, відсутності та альтернативні робочі центри налаштовують уже в SkyPlanner.
Чи можна протестувати SkyPlanner до розробки інтеграції?
Так. Протягом 30-денного безкоштовного пробного періоду можна працювати з максимум 20 робочими центрами, імпортувавши CSV із Katana. Банківська картка не потрібна. Почніть пробний період або зверніться до відділу продажів, щоб визначити обсяг інтеграції.
