Інтеграції / ERP / SAP Business One
Посібник з інтеграції SAP Business One зі SkyPlanner APS для календарного планування виробництва
Цей посібник пояснює партнерам SAP Business One та ІТ-командам, як підключити B1 до SkyPlanner APS. У ньому розглянуто, які API використовувати, які об’єкти й куди передаються та де виникають проблеми в проєктах B1. SkyPlanner обмінюється даними із SAP Business One в обох напрямках через Service Layer:
- До SkyPlanner надходять виробничі замовлення, етапи технологічних маршрутів, виробничі ресурси, номенклатура та замовлення на закупівлю.
- Заплановані дати початку й завершення передаються до B1 і записуються у виробничі замовлення.
- Записи обліку часу операторів проводяться як Receipt and Issue for Production.
- Вебхуки SkyPlanner передають зміни графіка одразу, щойно вони відбуваються.
Номенклатура, BOM, виробничі замовлення, запаси та фінанси залишаються в SAP Business One, а ваш виробничий модуль працює без змін. Команда SkyPlanner налаштовує інтеграцію зі стандартними об’єктами B1 під час впровадження та підтримує її після запуску. У кожної компанії своя база даних з особливостями етапів технологічних маршрутів, груп ресурсів, користувацьких полів і доповнень. Саме ці відмінності враховуються під час налаштування зіставлень.
Laboratory & Allied використовує SkyPlanner із SAP Business One на HANA. Бізнес-обґрунтування наведено на сторінці календарного планування виробництва для SAP Business One.
Варіанти інтеграції із SAP Business One
SAP Business One пропонує три інтерфейси інтеграції. Для хмарної системи календарного планування типовим вибором є Service Layer.
| Варіант | Що це | Придатність для інтеграції з APS |
|---|---|---|
| Service Layer | API REST/OData. /b1s/v1 використовує OData v3, а /b1s/v2 — OData v4. Працює у версії SAP Business One для SAP HANA, а починаючи з 10.0 PL01 — і на Microsoft SQL Server. | Основний спосіб інтеграції. HTTP, JSON, доступ із хмарного сервісу. |
| DI API | Бібліотека COM для Windows. Виробничі замовлення представлені об’єктом ProductionOrders і зберігаються в таблиці OWOR (тип об’єкта 202). | Для застарілого або локально розгорнутого проміжного ПЗ. Потрібен хост із Windows. |
| Integration Framework (B1if) | Проміжне ПЗ від SAP для сценаріїв обміну на рівні документів. | Доцільний варіант, якщо партнер уже використовує сценарії B1if. |
Автентифікація
Service Layer використовує сеансову автентифікацію. Надішліть POST /b1s/v1/Login із CompanyDB, UserName і Password, щоб отримати cookie B1SESSION (а в конфігураціях із балансуванням навантаження — також необов’язковий ROUTEID). За замовчуванням SessionTimeout становить 30 хвилин бездіяльності. Після завершення циклу синхронізації явно викликайте Logout. Створіть окремого користувача B1 для інтеграції, щоб кожну зміну, записану зі SkyPlanner, можна було відстежити в журналі змін.
Сутності Service Layer для календарного планування виробництва
| Дані | Сутність Service Layer |
|---|---|
| Номенклатура й дані для планування | Items |
| Специфікації матеріалів і етапи технологічного маршруту | ProductTrees (Lines, Stages) |
| Обладнання, персонал та інші виробничі ресурси | Resources, ResourceGroups |
| Виробничі замовлення | ProductionOrders (Lines, Stages) |
| Залишки за складами | Дані про запаси з Items, Warehouses |
| Відкриті замовлення на закупівлю й дати поставки | PurchaseOrders (DocumentLines: кількість, що залишилася до поставки, ShipDate) |
| Надходження товарів за замовленнями на закупівлю | PurchaseDeliveryNotes (Goods Receipt PO, тип об’єкта 20) |
| Відпуск у виробництво | InventoryGenExits |
| Надходження з виробництва | InventoryGenEntries |
| Налаштування вебхуків | EventSubscriptions, EventNotifications |
За замовчуванням сторінка містить 20 записів. Збільште її розмір за допомогою заголовка Prefer: odata.maxpagesize (або параметра PageSize у b1s.conf) і переходьте за odata.nextLink. Використовуйте $expand, щоб отримувати рядки й етапи виробничого замовлення одним викликом, а для масового зворотного запису — пакетні запити.
Події та вебхуки
Починаючи із SAP Business One 10.0 FP 2602, Service Layer підтримує вебхуки. За замовчуванням їх вимкнено. Увімкніть їх окремо для кожної компанії через CompanyService_UpdateAdminInfo (EnableWebhook = tYES). Потім надішліть POST EventSubscriptions із трьома складовими:
- адреса
WebhookURL - тип автентифікації
AuthenticationType: None, Basic, HMAC або OAuth; за замовчуванням — HMAC - колекція
EventCollectionіз бізнес-об’єктами й типами транзакцій
Адреса WebhookURL має використовувати HTTPS із сертифікатом, що відповідає імені хоста. EventSubscriptionsService_GetEventCatalog повертає перелік подій, на які можна підписатися. Служба Webhook Messenger Service має бути запущена.
У старіших версіях використовуйте опитування за розкладом (див. нижче застереження щодо UpdateDate). SBO_SP_TransactionNotification — це обробник перевірок на рівні бази даних, а не канал доставки подій.
Зіставлення даних: із SAP Business One до SkyPlanner
| SAP Business One (Service Layer) | Об’єкт SkyPlanner | Напрямок | Періодичність |
|---|---|---|---|
Items (номенклатура власного виробництва, Procurement Method) | Продукція | B1 → SkyPlanner | Початкове завантаження, далі за розкладом |
Рядки Lines у ProductTrees (рядки номенклатури) | Матеріали для продукції | B1 → SkyPlanner | Початкове завантаження, далі в разі змін |
Етапи Stages і рядки ресурсів у ProductTrees | Технологічні операції та час виконання | B1 → SkyPlanner | Початкове завантаження, далі в разі змін |
Resources (Machine, Labor, Other) | Робочі центри й персонал | B1 → SkyPlanner | Початкове завантаження, надалі зміни рідкісні |
ResourceGroups | Групи робочих центрів | B1 → SkyPlanner | Початкове завантаження |
ProductionOrders (Planned, Released) | Замовлення й виробничі завдання | B1 → SkyPlanner | Вебхук (FP 2602+) або опитування кожні кілька хвилин |
Етапи Stages у ProductionOrders | Етапи виробничого завдання та їхня послідовність | B1 → SkyPlanner | Разом із замовленням |
Залишки Items за складами Warehouses | Запаси матеріалів | B1 → SkyPlanner | За розкладом, наприклад щогодини |
Відкриті рядки PurchaseOrders (тип об’єкта 22) з датою поставки | Замовлення на закупівлю / очікувані матеріали з плановою датою поставки | B1 → SkyPlanner | За розкладом, наприклад щогодини |
Рядки PurchaseDeliveryNotes (Goods Receipt PO) зі значенням BaseType 22 | Отримана кількість у рядку замовлення на закупівлю й оновлені залишки | B1 → SkyPlanner | За розкладом, наприклад щогодини |
| Заплановані початок і завершення | PATCH ProductionOrders({DocEntry}): StartDate, DueDate, а в рядку ресурсу — StartDate і EndDate | SkyPlanner → B1 | Вебхук SkyPlanner у разі зміни розкладу |
| Зареєстровані кількості | InventoryGenEntries (надходження з виробництва) | SkyPlanner → B1 | Під час підтвердження або пакетно |
| Зареєстровані години й витрати матеріалів | InventoryGenExits (відпуск у виробництво) | SkyPlanner → B1 | Під час підтвердження або пакетно |
Календарі змін, персонал і відсутності ведуться в SkyPlanner. Показники добової потужності B1 не передаються під час обміну даними (див. перше застереження нижче).
Схеми інтеграції
1. Початкове завантаження основних даних. Отримайте Resources, ResourceGroups, Items зі значенням Make у полі Procurement Method, а також їхні ProductTrees з етапами. Зіставте кожен ресурс обладнання з робочим центром SkyPlanner. Перед першою синхронізацією замовлень перегляньте список разом із планувальниками.
2. Синхронізація замовлень. Зчитайте ProductionOrders у статусах Planned і Released, використовуючи $expand для рядків і етапів. Виробничі замовлення B1 містять етапи технологічного маршруту з BOM, проте планувальники можуть змінювати замовлення після створення. Використовуйте етапи із замовлення, а не з BOM. Одне виробниче замовлення призначене для виготовлення одного продукту, тому для багаторівневого виробу потрібне окреме виробниче замовлення на кожному рівні. Зв’яжіть їх, щоб SkyPlanner планував виготовлення напівфабрикатів раніше за виріб вищого рівня.
Також синхронізуйте відкриті рядки PurchaseOrders, кількість, що залишилася до поставки, і дату поставки з кінцевими точками SkyPlanner для замовлень на закупівлю. SkyPlanner вважає замовлений матеріал доступним на дату поставки, зазначену в замовленні на закупівлю. У B1 рух запасів відбувається під час проведення документа Goods Receipt PO (PurchaseDeliveryNotes). Інтеграція зчитує ці надходження, позначає отриману кількість у SkyPlanner як поставлену, а решту залишає відкритою. Часткові надходження враховуються лише один раз, а перевірка забезпеченості матеріалами охоплює і складські залишки, і очікувані поставки.
3. Зворотний запис розкладу. Вебхуки SkyPlanner спрацьовують у разі зміни розкладу. Інтеграція надсилає PATCH /b1s/v1/ProductionOrders({DocEntry}) з новими значеннями StartDate і DueDate, а також StartDate і EndDate у рядках ресурсів замовлення (ProductionOrderLines), щоб кожен етап містив свій запланований часовий інтервал. Тіло запиту містить лише поля, за які відповідає SkyPlanner, а кілька замовлень передаються одним запитом $batch. Після цього користувачі B1 бачать заплановані дати у виробничому замовленні й у вікні Resource Capacity. У системах, де Service Layer недоступний, таке саме оновлення виконує локальна служба через об’єкт ProductionOrders у DI API (GetByKey, установлення дат, Update).
4. Підтвердження виконання в цеху. Оператори реєструють роботу в SkyPlanner за допомогою Mobile Confirmations або Production Timer. Кожен запис часу перетворюється на POST /b1s/v1/InventoryGenEntries для кількості готової продукції (надходження з виробництва) і POST /b1s/v1/InventoryGenExits для компонентів і часу виробничих ресурсів (відпуск у виробництво).
Кожен рядок документа містить BaseType 202 і BaseEntry зі значенням DocEntry виробничого замовлення; рядки відпуску додатково містять BaseLine відповідного рядка компонента або ресурсу. Часткові кількості проводяться в міру реєстрації, для номенклатури з партійним або серійним обліком указуються номери партій і серійні номери. Замовлення має бути у статусі Released.
Ідентифікатор запису обліку часу SkyPlanner зберігається в документі B1, тому повторна обробка події ніколи не створює дубль проведення. Якщо проведення не вдалося, система повторює спробу й повідомляє про помилку, а не відкидає запис.
5. Відповідальність за дані та правила розв’язання конфліктів. Узгодьте їх до початку розробки:
- B1 відповідає за номенклатуру, BOM, кількості, склади та створення замовлень.
- SkyPlanner відповідає за послідовність робіт, час початку й завершення та призначення робочих центрів.
- Якщо дати замовлення змінено в обох системах, пріоритет мають результати наступного розрахунку SkyPlanner, якщо тільки планувальники не зафіксували виробниче завдання в SkyPlanner.
- Коли замовлення в B1 отримує статус Closed або Cancelled, відповідне виробниче завдання видаляється з графіка.
Що входить до проєкту
Зазвичай впровадження завершується протягом кількох тижнів після початку роботи. До цього ви можете пройти 30-денний безкоштовний пробний період на власних даних. Експортуйте номенклатуру, виробничі ресурси та відкриті виробничі замовлення з B1 у CSV або Excel і завантажте їх через функцію імпорту даних SkyPlanner. Планувальники побачать реальний графік ще до того, як хтось почне писати код інтеграції.
Типовий проєкт інтеграції із SAP Business One включає:
- Зіставлення основних даних. Ресурси та групи ресурсів B1 зіставляються з робочими центрами, етапи технологічних маршрутів — з операціями, номенклатура типу Make — з продукцією.
- Початкове завантаження. Номенклатура, Product Trees з етапами та рядками номенклатури, виробничі ресурси й залишки за складами.
- Синхронізація виробничих замовлень і замовлень на закупівлю. Відкриті виробничі замовлення з рядками та етапами, а також відкриті замовлення на закупівлю з датами поставки.
- Зворотний запис розкладу. Заплановані дати початку й завершення передаються в
ProductionOrders. - Підтвердження виконання робіт у цеху. Проведення Receipt and Issue for Production на основі записів обліку часу SkyPlanner.
- Тестування паралельно з поточним плануванням. Планувальники порівнюють графік SkyPlanner із результатами свого нинішнього планування.
- Запуск у роботу. Графік SkyPlanner стає основним виробничим планом.
Упорядковані дані про виробничі ресурси й етапи технологічних маршрутів у B1 скорочують роботу зі зіставлення. У Laboratory & Allied інтеграція була однією з найлегших частин проєкту. Власна ІТ-команда здебільшого самостійно виконала інтеграцію із SAP Business One на HANA. Команда SkyPlanner долучалася до найскладніших випадків, наприклад коли продукція об’єднується в ході багатоетапних процесів.
Підводні камені SAP Business One
Добова потужність — це не модель робочих змін.
B1 зберігає Daily Internal Capacity і Single Run Capacity для кожного виробничого ресурсу на кожен день (“These capacities are defined on a daily basis,” («Ці потужності визначаються на кожен день»), як зазначено в SAP Learning). У посібнику SAP сказано, що розрахунок Required Days виходить із припущення “a single production order can be produced on a single machine” («одне виробниче замовлення може бути виконане на одному верстаті») (практичний посібник SAP). Не переносьте ці показники в планування виробництва як реальну доступну потужність обладнання та персоналу. Налаштуйте зміни, персонал та ефективність робочих центрів у SkyPlanner.
Технологічний маршрут міститься в BOM.
Окремого довідника технологічних маршрутів немає. Послідовність визначається рядками Route Stage у Product Tree, а Waiting Days вводяться вручну. Зчитуйте Stages із ProductTrees і ProductionOrders та перевіряйте, чи кожен рядок ресурсу належить до етапу. Замовлення без етапів не дають планувальнику послідовності технологічних операцій.
Кількості в рядках ресурсів потрібно перераховувати.
Quantity у рядку BOM — це кількість, потрібна для випуску обсягу, зазначеного в заголовку BOM, а не однієї одиниці. Additional Quantity додається до планового часу “regardless of the quantity of the parent item produced” («незалежно від кількості виготовленої батьківської номенклатурної позиції») (практичний посібник SAP). Враховуйте її як фіксований час на замовлення, подібно до часу налагодження. Перш ніж визначати час обробки одиниці, поділіть кількість із рядка на кількість із заголовка. Інакше тривалість кожного виробничого завдання буде завищена або занижена у відповідну кількість разів.
Основні дані виробничих ресурсів рідко бувають упорядкованими.
Ресурси мають тип Machine, Labor або Other. Верстати можна пов’язувати з основними засобами, а трудові ресурси — з працівниками. Ресурс також може мати пов’язану нескладську номенклатурну позицію для його закупівлі або продажу. Проте це не показує, які ресурси є реальними верстатами, для яких можна планувати роботу. Упорядкуйте групи ресурсів і усуньте дублікати, перш ніж формувати з них список робочих центрів.
Правила обліку запасів можуть блокувати підтвердження.
Надходження й відпуск оформлюються складськими документами. Типові помилки — плутанина між InventoryGenEntries і InventoryGenExits, відсутність номерів партій або серійних номерів для номенклатури з відповідним обліком, а також проведення за замовленням у статусі Planned.
Сеанси та посторінкове отримання даних.
Після завершення сеансу повертається повідомлення «Invalid session or session already timeout.» (Недійсний сеанс або час його дії вже минув). У разі цієї помилки виконайте вхід повторно. Якщо синхронізація ігнорує odata.nextLink, стандартний розмір сторінки у 20 записів непомітно обмежує обсяг отриманих даних.
UpdateDate не містить часу.
У таблиці OWOR поле UpdateDate містить дату, а час оновлення зберігається окремо в UpdateTS. Опитування з фільтром лише за UpdateDate щоразу отримуватиме всі замовлення, змінені сьогодні. Поєднуйте обидва поля або усувайте дублікати на своєму боці.
Вебхуки доставляються щонайменше один раз.
Webhook Messenger повторює невдалу доставку до п’яти разів (через 2, 4, 8, 16 і 32 секунди), після чого позначає її як невдалу. Повторні спроби можуть створювати дублікати, а порядок гарантовано лише в межах однієї компанії. Забезпечте ідемпотентність обробників за ідентифікатором події та виконуйте щоночі опитування для звіряння даних.
Хто налаштовує інтеграцію із SAP Business One
Робота охоплює зіставлення ваших етапів технологічних маршрутів, виробничих ресурсів і налаштувань B1, а також урахування обмежень, яких B1 не враховує в графіку: матриці часу налагодження, інструментів, кількості операторів та альтернативних виробничих ресурсів.
- Команда SkyPlanner налаштовує інтеграцію під час впровадження та підтримує її після запуску. Кожна компанія використовує B1 по-своєму, і саме тут команда застосовує свій досвід. Це стандартний варіант.
- Ваш партнер SAP Business One може долучитися. Партнери, які знають базу даних вашої компанії, доповнення та користувацькі поля, можуть розробити інтеграцію на основі Service Layer і REST API SkyPlanner (довідник API).
- Ваші розробники можуть створити інтеграцію самостійно. REST API SkyPlanner дає змогу читати й записувати замовлення, продукцію, матеріали, операції, замовлення на закупівлю та записи обліку часу. Він використовує автентифікацію за токеном JWT bearer і описаний у Swagger/OpenAPI. Відкрита документація доступна в документації SkyPlanner. Вебхуки передають зміни графіка та статусів у реальному часі. Для початку розробки потрібен лише ключ API SkyPlanner (посібник з інтеграції), а команда SkyPlanner допомагає за потреби. Саме цей шлях обрала власна ІТ-команда Laboratory & Allied.
Спочатку перевірте графік протягом 30-денного безкоштовного пробного періоду, щоб почати інтеграцію з графіком, який уже відповідає умовам вашого виробництва.
Чому технічні команди обирають SkyPlanner для B1
- Обирайте SkyPlanner, якщо вам потрібна невелика інтеграція з чітко визначеними межами. До SkyPlanner надходять стандартні об’єкти B1 (виробничі замовлення, Product Trees, Resources, Items), а назад передаються дати та Issue and Receipt from Production. Без змін у виробничому модулі B1 та без міграції даних.
- Обирайте SkyPlanner, якщо проєкт має довести свою цінність на ранньому етапі. Протягом 30-денного безкоштовного пробного періоду ви працюєте з експортованими CSV-даними та щонайбільше 20 робочими центрами. Банківська картка не потрібна. Компанія бачить власний графік ще до початку інтеграції.
- Обирайте SkyPlanner, якщо графік має враховувати реальні обмеження. Час переналагодження, спільні інструменти, виробничі завдання з кількома операторами, альтернативні виробничі ресурси, запаси та відкриті замовлення на закупівлю — усе це моделюється в SkyPlanner. Інтеграція лише передає дані B1.
- Обирайте SkyPlanner, якщо хочете мати єдину систему для планувальників і операторів. Рушій Arcturus будує графік за секунди, а Autopilot автоматично переплановує його, коли на виробництві відбуваються зміни. Оператори реєструють виконану роботу з телефона або планшета, а інтеграція записує ці підтвердження назад у B1.
- Обирайте SkyPlanner, якщо витрати мають бути передбачуваними. Вартість — від 199 € на місяць із 5 робочими центрами. Оплата щомісячна, скасувати підписку можна будь-коли. Вартість інтеграції розраховується заздалегідь відповідно до ваших процесів і потреб та надається разом із вартістю тарифного плану. Тож повну суму ви знаєте ще до початку роботи.
Про те, чого бракує для планування, читайте в статті про планування виробництва для SAP Business One. Тут ідеться про планування, за якого графік узгоджується з реально доступними потужностями обладнання та робочим часом персоналу. Інформацію про інші ERP знайдете в розділі інтеграцій з ERP.
Відгуки виробників про SkyPlanner
+90%до ефективності виробництва
«Ефективність виробництва зросла на 90%.»
Abdul Rucyinga, керівник ІТ-відділу
Laboratory & Allied · Фармацевтичне виробництво
Ефективність виробництва зросла на 90%, а створення оптимізованого плану на три місяці для всіх робочих центрів займає менше ніж 30 хвилин.
2 годекономії щотижня
«Завдяки SkyPlanner ми перейшли від планування виробництва в таблицях Excel до його оптимізації в реальному часі.»
Kalle Kalliomäki, фахівець із ланцюгів постачання
UTU · Електричні щити та розподільні пристрої
Планування виробництва заощаджує 2 години робочого часу щотижня, а нова черга виробничих завдань надходить на лінію за секунди.
6 місяцівнаперед відділ продажів бачить вільні потужності
«SkyPlanner створює надійну основу для всього планування виробництва».
Ану Ярвінен, керівниця виробництва
Fredman Operations · Пакувальний папір для контакту з харчовими продуктами
Відділ продажів бачить вільні потужності на шість місяців наперед, а відповіді на запити щодо зміни графіка, які раніше потребували години чи більше, тепер отримує за секунди.
99,2%надійність поставок
«Завдяки SkyPlanner стало легше виявляти вузькі місця, а управління виробництвом стало зрозумілішим».
Тоні Туорі, керівник виробництва
Piristeel · Системи безпеки для покрівель і водостічні системи
Цього року надійність поставок досягла 99,2%, а календарне планування заощаджує до чотирьох годин робочого часу на день.
Поширені запитання
Хто розробляє інтеграцію із SAP Business One?
Команда SkyPlanner налаштовує двосторонню інтеграцію під час впровадження та підтримує її після запуску. До SkyPlanner надходять виробничі замовлення, етапи технологічних маршрутів, виробничі ресурси, замовлення на закупівлю та надходження товарів. Назад передаються дати з графіка та документи Issue and Receipt from Production. Ваш партнер B1 або власні розробники також можуть створити інтеграцію на основі Service Layer і REST API SkyPlanner — для початку достатньо ключа API.
Скільки часу займає впровадження SkyPlanner із SAP Business One?
Зазвичай впровадження завершується протягом кількох тижнів від початку роботи. Команда налаштовує відповідність виробничих ресурсів та етапів технологічних маршрутів, підключає виробничі замовлення й замовлення на закупівлю та перед запуском перевіряє графік, порівнюючи його з вашим поточним планом.
Service Layer чи DI API?
Для нових інтеграцій — Service Layer. Він працює через HTTP, підтримує HANA та SQL Server і підходить для хмарної системи календарного планування. Використовуйте DI API лише там, де на нього вже спирається наявне проміжне ПЗ.
Чи потрібна версія SAP Business One 10.0 FP 2602?
Лише для вебхуків. У попередніх версіях 10.0 інтеграція працює через періодичне опитування за розкладом.
Як у SAP Business One записуються дати, визначені під час календарного планування?
Через PATCH /b1s/v1/ProductionOrders({DocEntry}): у замовленні встановлюються StartDate і DueDate, а в його рядках ресурсів — StartDate і EndDate. Оновлення запускає вебхук SkyPlanner про зміну розкладу. Випуск продукції й час передаються назад як InventoryGenEntries і InventoryGenExits, пов’язані із замовленням через BaseType 202 і BaseEntry.
Чи потрібне нам виробниче доповнення для B1?
Ні. Інтеграція працює лише зі стандартними об’єктами B1: виробничими замовленнями, Product Trees, Resources, Items, замовленнями на закупівлю та складськими документами. Жодні дані не переносяться до нової моделі виробничих даних.
Чи можна випробувати SkyPlanner на наших даних B1 до інтеграції?
Так. Протягом 30-денного пробного періоду можна працювати з кількістю робочих центрів до 20 та імпортувати дані з CSV або Excel. Банківська картка не потрібна. Почніть безкоштовний пробний період або обговоріть із відділом продажів вашу конфігурацію B1.
