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

Інтеграція використовує два інтерфейси, які вже входять до Business Central:

1. API v2.0 для комерційних даних і даних про запаси. Через нього доступні items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers та employees. Виробничих сутностей у ньому немає, тому виробничі дані надходять через другий інтерфейс.
2. Вебслужби OData v4 для виробничих даних. Будь-яку сторінку Business Central можна опублікувати як вебслужбу OData v4 на сторінці Web Services. Виберіть тип об’єкта Page, ідентифікатор сторінки та назву служби, а потім установіть Published. Кінцева точка готова до роботи — без коду AL і без розгортання розширень. Для інтеграції публікуються стандартні сторінки випущених виробничих замовлень, Prod. Order Routing Lines, робочих центрів, верстатних центрів і технологічних маршрутів. Вони доступні за адресою /ODataV4/Company('{name}')/{ServiceName}.

Опубліковані сторінки підтримують читання й запис. Microsoft зазначає: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (якщо сторінку з можливістю редагування опубліковано як вебслужбу, дані її базової таблиці можна читати й змінювати викликом OData). Для оновлень використовується PATCH. Саме так заплановані дати повертаються до Business Central — через ту саму сторінку й ті самі перевірки, якими користується планувальник.

Не використовуйте SOAP. Microsoft оголосила вебслужби SOAP застарілими, а у хвилі випуску 2 за 2026 рік (v29) можливість публікувати сторінки інтерфейсу Microsoft як SOAP вилучено.

Business Central підтримує підписки на вебхуки через POST /api/v2.0/subscriptions для сутностей API v2.0, зокрема items та salesOrders. Правила такі:

• Для створення підписки потрібне підтвердження зв’язку: ваша кінцева точка має повернути validationToken зі статусом 200 OK.
• Термін дії підписок спливає через три дні. Поновлюйте їх через PATCH — при цьому процедура підтвердження підключення виконується знову.
• Сповіщення містять шлях до ресурсу, changeType і ваш clientState, а не повний запис. Сам запис потрібно прочитати окремо після отримання сповіщення.
• Сповіщення надходять із затримкою: Business Central online очікує 30 секунд після першої зміни. Якщо за цей час змінено понад 1 000 записів, для них надходить одне сповіщення collection.
• У хмарній версії дозволено не більше 200 підписок на вебхуки на середовище.

Виробничі замовлення, рядки технологічних маршрутів і замовлення на закупівлю зчитуються шляхом опитування кожні кілька хвилин — через опубліковані сторінки та purchaseOrders. Відбір лише відкритих замовлень і посторінкове зчитування дають змогу тримати кількість запитів значно нижче лімітів Business Central.

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

1. Початкове завантаження основних даних. Отримайте технологічні маршрути й виробничі BOM зі статусом Certified, робочі та машинні центри з опублікованих сторінок, а номенклатуру й одиниці виміру — через API v2.0. Продумайте відповідність кожного робочого або машинного центру робочому центру SkyPlanner: вирішіть, чи робочий центр із трьома машинними центрами стане однією групою робочих центрів, чи трьома окремими робочими центрами.

2. Синхронізація замовлень. Зчитуйте з опублікованих сторінок виробничі замовлення зі статусом Released (а також Firm Planned, якщо включаєте їх до розкладу) разом із рядками технологічних маршрутів і компонентами, а через API v2.0 — відкриті рядки замовлень на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки за замовленням на закупівлю й оновлює запаси, коли замовлення отримує статус Delivered. Тому під час складання розкладу враховуються як наявні запаси, так і очікувані закупівлі.

Ніколи не включайте до розкладу виробничі замовлення зі статусом Planned: за словами Microsoft, Business Central “deletes them the next time you run planning.” (видаляє їх під час наступного запуску планування). Planning Worksheet і далі формує пропозиції щодо постачання, а SkyPlanner складає розклад для підтверджених замовлень з урахуванням реальних потужностей.

3. Зворотний запис графіка. Стандартна сторінка Prod. Order Routing публікується як вебслужба OData v4. Для кожної технологічної операції, яку рушій розмістив або перемістив у графіку, SkyPlanner надсилає PATCH до відповідного рядка технологічного маршруту з ETag у If-Match. Запит задає Starting Date-Time та Ending Date-Time, а також Type і No., якщо операцію перенесено на альтернативний верстат.

PATCH запускає тригери сторінки й таблиці, тому Business Central перевіряє поля за власною логікою — так само, як коли планувальник редагує сторінку Prod. Order Routing. Відповідно оновлюються Starting Date-Time і Ending Date-Time у рядку виробничого замовлення. Кількості, статус і витрати залишаються під керуванням Business Central.

4. Підтвердження виконання в цеху. Оператори реєструють роботу через SkyPlanner Mobile Confirmations або Production Timer, а записи обліку часу підтримують розклад в актуальному стані. Звітувати про випуск у Business Central можна, як і раніше, через Production Journal або Output Journal.

Якщо ви хочете повністю автоматизувати проведення випуску й споживання матеріалів, додається стандартна сторінка API Business Central для проведення журналу випуску. Тоді SkyPlanner проводить час налагодження, час виконання та кількість випущеної продукції за кожною технологічною операцією. Проведення оновлює Capacity Ledger Entries, а випуск на останній операції технологічного маршруту додає продукцію до запасів.

Виберіть один канал проведення випуску. Проведення одночасно зі SkyPlanner і через Production Journal у Business Central призводить до дублювання записів.

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

Основне джерело конфліктів — дії Refresh і Replan у виробничих замовленнях. Microsoft зазначає: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Якщо перерахувати рядки виробничого замовлення дією Refresh, Business Central видалить наявні рядки й розрахує нові.) Replan також може змінити потребу в потужностях, а перерахунок компонентів “deletes previous changes in the components.” (видаляє попередні зміни в компонентах).

Вважайте оновлене замовлення новою версією: синхронізуйте його повторно й дайте SkyPlanner перебудувати розклад. З Autopilot SkyPlanner автоматично перебудовує розклад у разі змін у виробництві.

• Одиниці виміру в технологічних маршрутах. Setup Time задається на виробниче замовлення, Run Time — на одиницю виготовленої продукції; кожне поле має власний Unit of Measure Code. Wait Time і Move Time не займають потужності робочого центру. Якщо одиниця виміру робочого центру — Days, один день означає 24 години, а не восьмигодинну зміну. Перетворюйте одиниці під час імпорту, інакше всі значення тривалості будуть неправильними.
• Неактуальні календарі. Потужності з’являються лише після виконання Calculate Work Center Calendar для відповідного горизонту планування. Перед початковим завантаженням перевірте поле Calendar Entries Available Until.
• Приховані потужності машинних центрів. Якщо Consolidated Calendar вимкнено, планування враховує лише власні потужності робочого центру: “The machine center capacity is excluded.” (Потужності машинного центру не враховуються.) Зчитуйте потужності машинних центрів безпосередньо, а не покладайтеся на підсумкові значення робочого центру.
• Capacity та Efficiency. Business Central обчислює тривалість за формулою Run Time / Efficiency / Capacity, і розраховані записи календаря вже враховують обидва показники. Зіставляючи Efficiency з ефективністю робочого центру SkyPlanner, врахуйте цей показник один раз, а не двічі.
• Alternate Work Center має лише інформаційне призначення. За словами Microsoft, він “isn’t automatically included in planning processes.” (не включається автоматично до процесів планування). Явно задайте ці альтернативи як альтернативні робочі центри SkyPlanner.
• Обмеження інтенсивності запитів. В онлайн-версії ліміти діють для кожного користувача, а суб’єкт-служба рахується як один користувач: 6 000 запитів OData за ковзне 5-хвилинне вікно та 5 одночасних запитів. Розмір сторінки обмежено 20 000 записів, $batch — 100 операціями, а час очікування операції становить 8 хвилин. У разі перевищення інтенсивності запитів повертається 429. Замість повного перезавантаження даних використовуйте пакетні запити, посторінкове зчитування та опитування лише змінених даних.
• Ліцензування. Виробничі функції доступні лише в режимі Premium. Користувачі з Essentials не можуть увійти до компанії, для якої встановлено Premium.