Посібник з інтеграції Sylob ERP для календарного планування виробництва у SkyPlanner APS

У документації Sylob описано два публічні REST API: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (ERP Sylob надає два типи публічних REST API, які також називають вебсервісами, для читання та запису даних.) (База знань Forterro)

1. API REST Système d’information (читання). Виконує збережений запит (requête), створений у розділі “Interroger le système d’information”. URL виклику цього запиту можна отримати через “Autres actions” > “Afficher le web service”. Він має вигляд /rest/query/{identifiantQuery}/resultat. Параметри задають обмеження кількості результатів, формат чисел, змінні запиту та структуру результату. За замовчуванням результати надходять у форматі XML, а із заголовком Accept: application/json — у форматі JSON. Цей API входить до складу ERP.
2. API REST Action (читання та запис). Виконує дію, визначену в розділі “Gérer les actions web service” — каталозі дій Sylob. Надає дві операції: GET /rest/v2/action/{code}/describe повертає схему даних дії, а POST /rest/v2/action/{code}/execute виконує її з тілом запиту у форматі JSON. Серед типів дій:

– Modification de données: змінює одне або кілька полів запису через механізм швидкого редагування Sylob. Describe надає перелік полів, доступних для редагування. – Message EDI: створює, змінює або видаляє записи через повідомлення EDI. – Scénario de saisie: виконує сценарій введення, послідовно проходячи запитання. Приклад із документації Sylob — “Déclarer un début ou une fin”, реєстрація початку або завершення технологічної операції (Sylob_Action_006). – Публікація, завантаження та вивантаження документів.

1. Повідомлення EDI. Механізм EDI у Sylob забезпечує експорт та імпорт. Стандартне повідомлення Sylob_Recup_Decl_Pro отримує звіти про виконання виробничих робіт. (Forterro)
2. Файли та ETL. Sylob ERP Cloud пропонує “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Інтеграцію файлів через SFTP для простого перенесення наявних інтеграцій.) (Sylob) Результати запитів також можна експортувати в Excel — це швидкий спосіб почати пробне використання SkyPlanner.

У публічній базі знань Sylob не описано підписки на вихідні вебхуки. Зміни надходять до SkyPlanner через опитування збережених запитів, які відбирають відкриті OF та нещодавні зміни. Частоту опитування задаєте ви.

Sylob захищає ERP від надмірного навантаження запитами. Починаючи з версії 2025.Q2, параметр компанії “Protection des API” вмикає обмеження частоти запитів для кожного користувача та посторінкове отримання великих результатів. Sylob повідомляє, що з версії 2026.Q2 цей захист діятиме систематично. Відповіді містять заголовки RateLimit, а виклик із перевищенням квоти повертає HTTP 429 Too Many Requests зі значенням Retry-After. (Forterro) Врахуйте це під час розроблення синхронізації: запитуйте лише зміни, отримуйте результати посторінково та збільшуйте паузу перед повторним викликом після відповіді 429.

Зі свого боку SkyPlanner надсилає вебхуки, коли змінюється стан або розклад, тож зворотний запис у Sylob запускається подіями.

1. Початкове завантаження основних даних. Створіть по одному збереженому запиту для кожного об’єкта (articles, nomenclatures, gammes, робочих центрів, працівників) і зчитайте дані через Système d’information API або одноразово завантажте їх з експорту Excel. Уважно зіставте робочі центри. Centre de charge у Sylob — це група ресурсів, тому центр із трьома верстатами зазвичай відповідає групі з трьох робочих центрів у SkyPlanner.

2. Синхронізація замовлень. Зчитуйте підтверджені OF з їхніми технологічними операціями, а також складські залишки та відкриті замовлення на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату постачання за замовленням на закупівлю й оновлює залишки, коли воно отримує статус Delivered. Тож під час розрахунку розкладу враховуються і наявні запаси, і очікувані закупівлі.

Включайте до розкладу підтверджені OF, а не пропозиції CBN. Пропозиції змінюються під час наступного розрахунку чистих потреб.

3. Зворотний запис розкладу. Для кожної технологічної операції, яку алгоритм розмістив або перемістив у розкладі, інтеграція викликає дію Modification de données для операції OF (Opération d’ordre de fabrication), передаючи заплановані початок, завершення та робочий центр. Дія використовує власну логіку швидкого редагування Sylob — ту саму, що й під час редагування операції планувальником. Describe повертає перелік доступних для редагування полів, тож інтеграція перевіряє дані для надсилання ще до першого виклику. Якщо користувач саме редагує запис, виклик завершується очікуваною помилкою; повторіть його під час наступної зміни.

4. Реєстрація виконання робіт у цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer. Початок і завершення передаються назад через сценарій “Déclarer un début ou une fin”. Записи обліку часу та кількості перетворюються на звіти про виконання робіт для тієї самої технологічної операції OF: час налагодження, час виконання, виготовлена кількість, брак і завершення операції. Якщо ваше підприємство вже реєструє ці дані через Sylob Apps або цехові термінали, залиште один канал реєстрації, щоб уникнути дублювання записів.

5. Відповідальність за дані та правила розв’язання конфліктів. Зафіксуйте їх до запуску:

SkyPlanner не потребує CADPLAN чи процедур планування Sylob з урахуванням доступних потужностей. Передайте SkyPlanner керування датами технологічних операцій: якщо дві системи планування записують ті самі дати, вони перезаписують дані одна одної. Коли датами керує SkyPlanner, Autopilot автоматично перебудовує графік після кожної суттєвої зміни, а нові дати передаються назад до Sylob.

• Ліцензія на Action API. Читання через збережені запити вже включено. Для запису через каталог дій потрібен модуль Sylob «Webservice» або ліцензія на API в MyForterro. Узгодьте це зі своїм представником Sylob до етапу зворотного запису.
• Запити визначають контракт інтеграції. Читання даних залежить від збережених запитів. Давайте їм зрозумілі назви, передавайте фільтри як змінні атрибути під час виконання та ведіть версії запитів разом із версіями інтеграції.
• Групи робочих центрів. Один робочий центр Sylob може містити кілька верстатів. Для кожного центру визначте, чи представлятиме його SkyPlanner як одну групу робочих центрів, чи як окремі верстати.
• Зворотне планування та розрахунок завантаження. Sylob планує у зворотному напрямку від дат потреби, а розрахунок завантаження, що запускається за розкладом, може переплановувати прострочені OF. Узгодьте, яка процедура, якщо така залишиться, матиме право записувати дати технологічних операцій після передавання керування ними до SkyPlanner.
• Одиниці вимірювання часу налагодження та виконання. Перед імпортом перевірте одиниці вимірювання й те, чи задано час налагодження на OF, чи на одиницю продукції. Неправильні одиниці спотворюють усі значення тривалості.
• Календарі. Тижневі графіки робочих центрів і винятки з них мають охоплювати весь горизонт планування, інакше потужності зникнуть із плану.
• Обмеження частоти запитів. Sylob обмежує кількість викликів на користувача й повертає великі результати посторінково. Інкрементальне опитування залишає значний запас до встановленого ліміту.
• CORS і браузери. На міжсерверні виклики обмеження CORS не поширюються. Для браузерних клієнтів на боці Sylob потрібно налаштувати дозволені джерела.