Przewodnik po integracji SAP S/4HANA ze SkyPlanner APS do harmonogramowania produkcji

S/4HANA udostępnia interfejsy integracyjne w postaci opublikowanych usług OData, wymienionych w SAP Business Accelerator Hub (api.sap.com). Integracja obsługująca harmonogramowanie korzysta z usług OData V2. IDoc i BAPI nadal są dostępne, ale ten przewodnik opiera się na udostępnionych interfejsach API OData.

Uwierzytelnianie zależnie od edycji

• Wersja lokalna i Private Edition. Usługi aktywuje się w SAP Gateway za pomocą transakcji /IWFND/MAINT_SERVICE. Użytkownik integracyjny potrzebuje odpowiednich obiektów uprawnień, na przykład C_AFRU_AWK do potwierdzeń, C_AFKO_AWK do księgowanych wraz z nimi pozycji ruchów materiałowych oraz M_PLAF_ORG do zleceń planowanych.
• Public Edition. Usługi są udostępniane wyłącznie przez uzgodnienia komunikacyjne. Zgodnie z instrukcją SAP dotyczącą konfiguracji komunikacji przychodzącej w aplikacji Communication Arrangements należy utworzyć użytkownika komunikacyjnego, system komunikacyjny i uzgodnienie komunikacyjne na podstawie scenariusza komunikacyjnego SAP (SAP_COM_xxxx). Scenariusz określa, które usługi są udostępniane i jakie metody uwierzytelniania są dostępne:

– za pomocą tokenów: przepływy OAuth, SAML lub OpenID Connect z tokenem bearer i propagacją tożsamości do użytkownika biznesowego – certyfikat klienta – uwierzytelnianie podstawowe z użyciem technicznego użytkownika komunikacyjnego

SAP zaleca uwierzytelnianie za pomocą tokena lub certyfikatu.

Po stronie SkyPlanner działa REST API z uwierzytelnianiem JWT, opisane w Swagger/OpenAPI (dokumentacja API). Warstwa pośrednicząca obsługuje więc uwierzytelnianie SAP z jednej strony, a JWT z drugiej.

API do harmonogramowania produkcji

Usługa	Wykorzystywane encje i akcje	Zastosowanie
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2, A_ProductionOrderItem_2, A_ProductionOrderOperation_2, A_ProductionOrderComponent_2, A_ProductionOrderStatus_2, A_ProductionRsceTools_2; akcje ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Zlecenia, operacje, komponenty, środki pomocnicze produkcji (PRT), status, zapis zwrotny harmonogramu
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Gniazda produkcyjne, kategorie zdolności produkcyjnych, przedziały czasowe i zmiany robocze
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standardowe marszruty technologiczne do planowania przed utworzeniem zlecenia
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Wielopoziomowa struktura produktu
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiały (w API nazywane Product). SAP zaleca obecnie API Product (Version 2) dla większości encji produktów
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Wyniki MRP Live przed konwersją
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Zapasy według zakładu i składu magazynowego do określania dostępności materiałów
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Otwarte zamówienia zakupu na oczekiwane materiały
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; akcje GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Potwierdzenia i ruchy materiałowe z hali produkcyjnej

W API zleceń produkcyjnych operacje są identyfikowane przez połączenie OrderInternalBillOfOperations i OrderIntBillOfOperationsItem, a nie przez numer operacji widoczny dla planisty. Akcja GetConfProposal w API potwierdzeń odwołuje się do tej samej operacji za pomocą OrderID i OrderOperation. Już przy pierwszym załadowaniu danych zapisz w SkyPlanner zarówno klucze wewnętrzne, jak i numer operacji.

Zdarzenia

S/4HANA emituje zdarzenia biznesowe Production Order Created i Production Order Changed, których treść zawiera ManufacturingOrder, ProductionOrder, ProductionOrderType i ProductionPlant. Zdarzenie zawiera wyłącznie klucze, dlatego integracja ponownie odczytuje zlecenie i jego operacje. Zdarzenie Changed jest emitowane przy każdej zmianie zlecenia, więc zastosuj mechanizm debounce, aby grupować zdarzenia następujące krótko po sobie. W przeciwnym kierunku webhooki SkyPlanner wysyłają powiadomienia w czasie rzeczywistym o zmianie harmonogramu lub stanu operacji.

Na początek — pliki

Na potrzeby testów wyeksportuj zlecenia produkcyjne i gniazda produkcyjne z raportów listowych S/4HANA do plików Excel lub CSV i zaimportuj je do SkyPlanner. Pozwala to zweryfikować harmonogram przed rozpoczęciem prac nad Gateway lub konfiguracją komunikacji.

1. Wczytanie danych podstawowych. Wczytaj materiały, BOM, gniazda produkcyjne wraz z przedziałami dostępności zdolności produkcyjnych i zmianami oraz marszruty technologiczne. Na tym etapie ustal, który system zarządza zmianami roboczymi. Sprawdza się następujący podział: kalendarz zakładowy pozostaje w S/4HANA, a szczegółowe rozkłady zmian, nieobecności i nadgodziny są przechowywane w SkyPlanner, gdzie planiści codziennie je aktualizują.

2. Synchronizacja zleceń. Subskrybuj zdarzenia Production Order Created/Changed. Jeśli zdarzenia biznesowe nie są skonfigurowane, odpytuj A_ProductionOrder_2 według znacznika czasu zmiany. Filtruj według zakładu, typu zlecenia i statusu. Wysyłaj zlecenia od razu po utworzeniu, aby SkyPlanner mógł planować z wyprzedzeniem, a po ujęciu ich w harmonogramie SkyPlanner zwalniaj je w S/4HANA (ReleaseOrder lub ReleaseOperation).

3. Zapis zwrotny harmonogramu. Gdy webhook SkyPlanner zgłosi zmianę harmonogramu, integracja wywołuje ScheduleProductionOrderOperation w API_PRODUCTION_ORDER_2_SRV dla każdej zmienionej operacji. Przesyła przy tym:

• ManufacturingOrder, OrderInternalBillOfOperations i OrderIntBillOfOperationsItem jako klucze
• OpSchedulingMode o wartości F (planowanie w przód), z datą i godziną rozpoczęcia ze SkyPlanner w OpSchedldStartDate i OpSchedldStartTime
• OpSchedulingStatus o wartości DISP (przydzielenie do realizacji) oraz obowiązkowy parametr OpSchedulingStrategy o wartości M
• ETag w if-match

Wszystkie operacje jednego zlecenia trafiają do jednego zestawu zmian, w kolejności ustalonej w SkyPlanner. Dzięki temu S/4HANA rozplanowuje całe zlecenie w jednym wywołaniu. Tryb K nigdy nie jest używany: zachowuje pierwotne terminy operacji i ignoruje przesłane daty.

SkyPlanner oblicza czasy trwania operacji na podstawie tych samych wartości standardowych marszrut technologicznych i formuł zdolności produkcyjnych gniazd, z których korzysta S/4HANA. Dzięki temu termin zakończenia obliczony przez S/4HANA na podstawie przesłanego terminu rozpoczęcia jest zgodny z planem SkyPlanner. Po każdym zestawie zmian integracja ponownie odczytuje operacje i oznacza wszelkie rozbieżności w datach, a planista widzi je przed następną zmianą roboczą.

4. Potwierdzenia z hali produkcyjnej. Każdy wpis czasu pracy z Mobile Confirmations lub Production Timer staje się potwierdzeniem w S/4HANA. Webhook SkyPlanner uruchamia wysłanie żądania POST do ProdnOrdConf2 z ilością dobrą, brakami i czasami czynności. Integracja najpierw wywołuje GetConfProposal, aby S/4HANA zaproponował ilości, czynności, daty i dane personelu. GetGdsMvtProposal proponuje ruchy materiałowe.

Oczekiwane dostawy materiałów. Otwarte zamówienia zakupu są uwzględnione w synchronizacji danych do SkyPlanner. SkyPlanner traktuje zamówiony materiał jako dostępny w przewidywanym terminie dostawy podanym w zamówieniu zakupu. Zadania oczekujące na zakupione komponenty są planowane na dzień dostawy materiału — dzisiejszy stan magazynowy ich nie blokuje.

S/4HANA pozostaje systemem nadrzędnym dla przyjęć: po zaksięgowaniu przyjęcia towaru stan magazynowy rośnie, a ilość otwarta w pozycji zamówienia zakupu maleje. Następna synchronizacja aktualizuje stan magazynowy w SkyPlanner i nadaje w pełni zrealizowanemu zamówieniu status Delivered. Po częściowym przyjęciu pozostała ilość otwarta nadal jest traktowana jako oczekiwana dostawa z datą podaną w wierszu harmonogramu dostaw. Obsługę zamówień zakupu w SkyPlanner opisano w dokumentacji SkyPlanner.

5. Odpowiedzialność za dane. S/4HANA zarządza ilościami, BOM, marszrutami technologicznymi, kalkulacją kosztów i statusem. SkyPlanner zarządza kolejnością, przydziałem do stanowisk roboczych i terminami operacji. Nigdy nie pozwalaj obu systemom zapisywać danych w tym samym polu. Jeśli planiści nadal przesuwają operacje w Capacity Scheduling Board, ustal, które zmiany mają pierwszeństwo. Albo następna synchronizacja zleceń przeniesie ich zmiany do SkyPlanner, albo dane gniazdo produkcyjne pozostanie poza zakresem SkyPlanner.

• Zapis zwrotny wymaga wywołania akcji z ETag. Udokumentowanym sposobem harmonogramowania operacji jest ScheduleProductionOrderOperation, a nie żądanie PATCH do A_ProductionOrderOperation_2. Tryb F planuje w przód od daty rozpoczęcia, a B wstecz od daty zakończenia. Tryby K i S zachowują istniejące daty i ignorują daty przesłane przez integrację. ETag w if-match jest tworzony na podstawie LastChangeDateTime zlecenia (YYYYMMDDHHMMSS), więc każda zmiana zlecenia powoduje jego dezaktualizację. Wdróż odczyt przed zapisem i kolejkę ponownych prób.
• Zdolności produkcyjne nie są zapisane w nagłówku gniazda produkcyjnego. Dostępne zdolności produkcyjne wynikają z kategorii zdolności (001 maszyny, 002 pracownicy), kalendarza zakładowego oraz przedziałów czasowych i zmian roboczych, które mają pierwszeństwo przed kalendarzem. Formuły zdolności produkcyjnych przeliczają wartości standardowe z marszruty technologicznej na zapotrzebowanie związane z przygotowaniem, obróbką i zakończeniem operacji. Odczytuj A_WorkCenterCapacityInterval_2 oraz encje zmian roboczych i uzgodnij sposób przeliczania formuł na czasy trwania w SkyPlanner.
• Wartości standardowe wymagają uporządkowania. Marszruty technologiczne utrzymywane na potrzeby kalkulacji kosztów często zawierają uśrednione czasy przezbrojeń lub mają przezbrojenia przypisane do niewłaściwej kategorii zdolności produkcyjnych.
• Potwierdzenia podlegają ścisłym regułom. SAP zaleca wywołania wsadowe przy masowym księgowaniu. Każdy zestaw zmian jest wykonywany w całości albo wcale, więc jeden błędny raport czasu blokuje pozostałe pozycje tego zestawu. Anulowania w partii muszą być wykonywane w odwrotnej kolejności ConfirmationCount. Nie można łączyć różnych typów potwierdzeń w jednym zleceniu, księgować ruchów materiałowych bez potwierdzenia ani potwierdzać operacji, których punkty wyzwalania wymagają okna dialogowego.
• Sprawdź, czy PP/DS jest aktywne. Wbudowane PP/DS wymaga wykonania działania Customizing Activate Advanced Planning and Scheduling oraz SAP HANA integrated liveCache. SAP sprzedaje je jako osobny produkt: SAP S/4HANA Manufacturing for planning and scheduling. Jeśli jest aktywne, ustal dla każdego materiału, który system odpowiada za harmonogramowanie: materiały oznaczone do zaawansowanego planowania są harmonogramowane przez PP/DS. W odniesieniu do API zleceń planowanych SAP podaje również: „Automatic integration to PP/DS is not enabled from this API.” (W tym API automatyczna integracja z tym systemem nie jest włączona).
• Jednostki miary. Ilości operacji, ilości bazowe marszrut technologicznych i jednostki potwierdzeń mogą się różnić. Stosuj jawne przeliczenia na podstawie jednostki operacji, a nie podstawowej jednostki miary materiału.
• Różnice między edycjami. SAP Learning pokazuje, że klasyczną tablicę planistyczną CM21/CM22 zastępują Manage Work Center Capacity, Capacity Scheduling Table i Capacity Scheduling Board. Public Edition udostępnia API wyłącznie przez scenariusze komunikacyjne, a oferowane wersje usług mogą różnić się od wersji dostępnych w instalacjach lokalnych. API marszrut technologicznych nie pozwala usuwać marszrut ani aktualizować przypisań materiałów. Na etapie określania zakresu zespół SkyPlanner ustala konkretne wersje usług dla systemu każdego klienta na podstawie wpisu w API Business Accelerator Hub dla danego wydania.
• Ograniczenia, których nie opisują marszruty technologiczne. Przezbrojenia zależne od kolejności, konflikty dostępności narzędzi i operacje wymagające wielu operatorów uwzględniaj w SkyPlanner, a nie w wartościach standardowych marszrut. Macierz czasów przezbrojeń przechowuje czasy dla poszczególnych par produktów. Narzędzia z PRT zlecenia są zasobami o ograniczonej dostępności — mogą obsługiwać tylko jedno stanowisko robocze naraz. Operacja może natomiast wymagać kilku osób jednocześnie.