Przewodnik po integracji Business Central ze SkyPlanner APS do harmonogramowania produkcji

Integracja korzysta z dwóch interfejsów dostępnych standardowo w Business Central:

1. API v2.0 do danych handlowych i magazynowych. Udostępnia items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers i employees. Nie zawiera encji produkcyjnych, więc dane produkcyjne są pobierane przez drugi interfejs.
2. Usługi sieciowe OData v4 do obsługi produkcji. Dowolną stronę Business Central można opublikować jako usługę sieciową OData v4 na stronie Web Services. Wybierz typ obiektu Page, identyfikator strony i nazwę usługi, a następnie zaznacz Published. Punkt końcowy jest już aktywny — bez kodu AL i bez wdrażania rozszerzenia. Integracja publikuje standardowe strony zwolnionych zleceń produkcyjnych, Prod. Order Routing Lines, gniazd produkcyjnych, stanowisk maszynowych i marszrut technologicznych, dostępne pod adresem /ODataV4/Company('{name}')/{ServiceName}.

Opublikowane strony umożliwiają odczyt i zapis. Jak podaje 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,” (jeśli edytowalna strona jest udostępniona jako usługa internetowa, wywołanie OData pozwala odczytywać i modyfikować dane w powiązanej tabeli). Do aktualizacji służy PATCH. W ten sposób planowane terminy wracają do Business Central — przez tę samą stronę i z taką samą walidacją, z jakiej korzysta planista.

Nie korzystaj z SOAP. Microsoft oznaczył usługi internetowe SOAP jako przestarzałe, a możliwość publikowania stron interfejsu użytkownika firmy Microsoft jako usług SOAP zostaje usunięta w 2026 release wave 2 (v29).

Business Central obsługuje subskrypcje webhooków przez POST /api/v2.0/subscriptions dla encji API v2.0, takich jak items i salesOrders. Obowiązują następujące zasady:

• Utworzenie subskrypcji wymaga uzgodnienia połączenia: Twój punkt końcowy musi zwrócić validationToken z kodem 200 OK.
• Subskrypcje wygasają po trzech dniach. Odnów je przez PATCH — procedura uzgadniania połączenia zostanie przeprowadzona ponownie.
• Powiadomienia zawierają ścieżkę zasobu, changeType i Twój clientState, a nie cały rekord. Rekord odczytujesz osobno po otrzymaniu powiadomienia.
• Powiadomienia są wysyłane z opóźnieniem: Business Central online czeka 30 sekund od pierwszej zmiany. Jeśli w tym czasie zmieni się ponad 1 000 rekordów, otrzymasz jedno powiadomienie collection.
• W środowisku online obowiązuje limit 200 subskrypcji webhooków na środowisko.

Zlecenia produkcyjne, wiersze marszrut technologicznych i zamówienia zakupu są odczytywane co kilka minut z opublikowanych stron oraz z purchaseOrders. Filtrowanie do otwartych zleceń i zamówień oraz stronicowanie pozwalają utrzymać liczbę żądań znacznie poniżej limitów Business Central.

SkyPlanner wysyła webhooki przy zmianach stanu lub harmonogramu, więc zapis zwrotny jest sterowany zdarzeniami.

1. Początkowe wczytanie danych podstawowych. Pobierz z opublikowanych stron marszruty technologiczne i produkcyjne BOM-y o statusie Certified oraz gniazda produkcyjne i stanowiska maszynowe, a z API v2.0 — zapasy i jednostki miary. Świadomie przyporządkuj każde gniazdo produkcyjne lub stanowisko maszynowe do stanowiska roboczego w SkyPlanner: zdecyduj, czy gniazdo z trzema stanowiskami maszynowymi ma odpowiadać jednej grupie stanowisk roboczych, czy trzem stanowiskom roboczym.

2. Synchronizacja zleceń. Z opublikowanych stron odczytuj zlecenia produkcyjne o statusie Released (oraz Firm Planned, jeśli je harmonogramujesz) wraz z wierszami marszruty i komponentami. Z API v2.0 pobieraj otwarte wiersze zamówień zakupu. SkyPlanner uznaje zamówiony materiał za dostępny w terminie dostawy zamówienia zakupu i aktualizuje stan magazynowy po oznaczeniu zamówienia jako Delivered. Dzięki temu harmonogram uwzględnia zarówno zapasy, jak i oczekiwane dostawy zakupowe.

Nigdy nie harmonogramuj zleceń produkcyjnych o statusie Planned. Jak podaje Microsoft, Business Central „deletes them the next time you run planning.” (usuwa je przy następnym uruchomieniu planowania). Planning Worksheet nadal proponuje zaopatrzenie, a SkyPlanner harmonogramuje zatwierdzone zlecenia z uwzględnieniem rzeczywistych zdolności produkcyjnych.

3. Zapis harmonogramu w Business Central. Standardowa strona Prod. Order Routing jest publikowana jako usługa sieciowa OData v4. Gdy silnik umieści operację w harmonogramie lub ją przesunie, SkyPlanner wysyła żądanie PATCH do odpowiedniego wiersza marszruty technologicznej, z tagiem ETag w If-Match. Ustawia pola Starting Date-Time i Ending Date-Time, a także Type i No., jeśli operacja została przeniesiona na alternatywną maszynę.

PATCH uruchamia wyzwalacze strony i tabeli, więc Business Central sprawdza pola według własnej logiki — dokładnie tak samo, jak podczas edycji strony Prod. Order Routing przez planistę. Odpowiednio aktualizowane są pola Starting i Ending Date-Time w wierszu zlecenia produkcyjnego. Ilości, status i koszty pozostają w Business Central.

4. Meldunki z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer, a rejestry czasu pracy zapewniają aktualność harmonogramu. Produkcję można nadal raportować w Business Central przez Production Journal lub Output Journal.

Jeśli chcesz w pełni automatycznie księgować produkcję i zużycie, dodawana jest standardowa strona API Business Central do księgowania dziennika produkcji. SkyPlanner księguje wtedy czas przezbrojenia, czas wykonania i wyprodukowaną ilość dla każdej operacji. Księgowanie aktualizuje Capacity Ledger Entries, a zaraportowanie produkcji na ostatniej operacji marszruty zwiększa stan magazynowy zapasu.

Wybierz jeden kanał księgowania produkcji. Księgowanie jednocześnie ze SkyPlanner i z Production Journal w Business Central powoduje powielanie zapisów.

5. Odpowiedzialność za dane i zasady rozwiązywania konfliktów. Spisz je przed uruchomieniem produkcyjnym:

Głównym źródłem konfliktów są akcje Refresh i Replan na zleceniach produkcyjnych. Microsoft podaje: „If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Użycie akcji Refresh do ponownego obliczenia wierszy zlecenia produkcyjnego powoduje usunięcie istniejących wierszy i obliczenie nowych przez Business Central). Replan może również zmienić zapotrzebowanie na zdolności produkcyjne, a ponowne obliczenie komponentów „deletes previous changes in the components.” (usuwa wcześniejsze zmiany w komponentach).

Traktuj odświeżone zlecenie jako nową wersję, zsynchronizuj je ponownie i pozwól SkyPlanner przeliczyć harmonogram. Dzięki Autopilot SkyPlanner automatycznie przelicza harmonogram po zmianach w produkcji.

• Jednostki w marszrutach. Setup Time dotyczy całego zlecenia produkcyjnego, a Run Time — pojedynczej wyprodukowanej sztuki. Każde z tych pól ma własny Unit of Measure Code. Wait Time i Move Time nie obciążają zdolności produkcyjnych gniazda. Jeśli jednostką gniazda jest Days, jeden dzień oznacza 24 godziny, a nie ośmiogodzinną zmianę. Przelicz jednostki podczas importu — inaczej wszystkie czasy trwania będą błędne.
• Nieaktualne kalendarze. Zdolności produkcyjne są dostępne dopiero po uruchomieniu Calculate Work Center Calendar dla danego horyzontu. Przed początkowym wczytaniem danych sprawdź pole Calendar Entries Available Until.
• Niewidoczne zdolności stanowisk maszynowych. Gdy Consolidated Calendar jest wyłączone, planowanie uwzględnia tylko własne zdolności gniazda produkcyjnego: „The machine center capacity is excluded.” (Zdolności stanowiska maszynowego są pomijane). Odczytuj zdolności stanowisk maszynowych bezpośrednio, zamiast polegać na sumach dla gniazda.
• Capacity i Efficiency. Business Central oblicza czas trwania według wzoru Run Time / Efficiency / Capacity, a obliczone zapisy kalendarza uwzględniają już oba te parametry. Mapuj Efficiency na wydajność stanowiska roboczego w SkyPlanner tylko raz, nie dwukrotnie.
• Alternate Work Center ma charakter informacyjny. Jak podaje Microsoft, „isn’t automatically included in planning processes.” (nie jest automatycznie uwzględniane w procesach planowania). Jawnie odwzoruj alternatywne zasoby jako alternatywne stanowiska robocze w SkyPlanner.
• Ograniczanie liczby żądań. Limity w wersji online obowiązują na użytkownika, a jednostka usługi jest liczona jako jeden użytkownik: 6 000 żądań OData w ruchomym oknie 5-minutowym i 5 żądań jednoczesnych. Maksymalny rozmiar strony to 20 000 rekordów, a $batch może zawierać do 100 operacji. Limit czasu operacji wynosi 8 minut. Przekroczenie limitu liczby żądań powoduje zwrócenie kodu 429. Zamiast ponownie pobierać pełny zestaw danych, grupuj żądania, stosuj stronicowanie i odczytuj tylko zmiany.
• Licencjonowanie. Funkcje produkcyjne są dostępne tylko w wariancie Premium. Użytkownicy z licencją Essentials nie mogą zalogować się do firmy z ustawionym wariantem Premium.