SAP S/4HANA integrációs útmutató a SkyPlanner APS gyártásütemezéséhez

Az S/4HANA kiadott OData-szolgáltatásokon keresztül biztosít integrációs hozzáférést; ezek az SAP Business Accelerator Hub (api.sap.com) oldalán találhatók. Az ütemezési integráció OData V2 szolgáltatásokra épül. Az IDoc és a BAPI továbbra is elérhető, de ez az útmutató a kiadott OData API-kat használja.

Hitelesítés kiadásonként

• Helyszíni telepítés és Private Edition. A szolgáltatásokat az SAP Gateway rendszerben, a /IWFND/MAINT_SERVICE tranzakcióval kell aktiválni. Az integrációs felhasználónak rendelkeznie kell a megfelelő jogosultsági objektumokkal: például C_AFRU_AWK a visszajelentésekhez, C_AFKO_AWK az ezekkel együtt könyvelt anyagmozgási tételekhez és M_PLAF_ORG a tervrendelésekhez.
• Public Edition. A szolgáltatások csak kommunikációs megállapodásokon keresztül érhetők el. Az SAP bejövő kommunikációra vonatkozó beállítási útmutatója alapján hozzon létre egy kommunikációs felhasználót, egy kommunikációs rendszert és egy kommunikációs megállapodást a Communication Arrangements alkalmazásban, egy SAP kommunikációs forgatókönyvre (SAP_COM_xxxx) építve. A forgatókönyv határozza meg, mely szolgáltatások érhetők el, és milyen hitelesítési módok használhatók:

– tokenalapú: OAuth, SAML vagy OpenID Connect szerinti hitelesítés bearer tokennel, az identitás üzleti felhasználóhoz történő továbbításával – ügyféltanúsítvány – alapszintű hitelesítés technikai kommunikációs felhasználóval

Az SAP token- vagy tanúsítványalapú hitelesítést javasol.

A SkyPlanner oldalán egy JWT-hitelesítést használó REST API áll rendelkezésre, Swagger/OpenAPI dokumentációval (API-referencia). A köztes réteg így az egyik oldalon az SAP-hitelesítést, a másikon a JWT-t kezeli.

API-k a gyártásütemezéshez

Szolgáltatás	Használt entitások és akciók	Rendeltetés
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; akciók: ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Rendelések, műveletek, komponensek, PRT-k, státusz, az ütemterv visszaírása
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Munkaállomások, kapacitáskategóriák, időintervallumok és műszakok
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standard technológiai útvonalak a rendelések létrehozását megelőző tervezéshez
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Többszintű termékstruktúra
API_PRODUCT_SRV (Product Master A2X)	A_Product	Anyagok (az API-ban Product néven). Az SAP a legtöbb termékentitáshoz már a Product (Version 2) API-t ajánlja
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Az MRP Live eredménye az átalakítás előtt
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Készlet gyáranként és raktárhelyenként, az anyagok rendelkezésre állásának meghatározásához
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	A beérkező anyagok nyitott beszerzési rendelései
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; akciók: GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Üzemi visszajelentések és anyagmozgások

A gyártási rendelés API-jában a műveleteket az OrderInternalBillOfOperations és az OrderIntBillOfOperationsItem együttesen azonosítja, nem a tervező által látott műveletszám. A visszajelentési API GetConfProposal akciója ugyanezt a műveletet az OrderID és az OrderOperation alapján éri el. A belső kulcsokat és a műveletszámot már az első betöltéstől kezdve tárolja a SkyPlanner rendszerben.

Események

Az S/4HANA Production Order Created és Production Order Changed üzleti eseményeket generál, amelyek adattartalmában a ManufacturingOrder, a ProductionOrder, a ProductionOrderType és a ProductionPlant szerepel. Az esemény csak kulcsokat tartalmaz, ezért az integráció újra beolvassa a rendelést és a műveleteit. A Changed esemény a rendelés minden módosításakor kiváltódik, ezért alkalmazzon debounce-kezelést. A másik irányban a SkyPlanner webhookjai valós időben küldenek értesítést az ütemterv vagy a gyártási feladat állapotának változásakor.

Kezdés fájlos adatátvitellel

A próba során exportálja a gyártási rendeléseket és a munkaállomásokat az S/4HANA listariportjaiból Excel- vagy CSV-fájlba, majd importálja őket a SkyPlannerbe. Így még azelőtt ellenőrizhető az ütemterv, hogy bárki hozzányúlna a Gateway vagy a kommunikáció beállításaihoz.

1. Törzsadatok betöltése. Töltse be az anyagokat, darabjegyzékeket, a munkaállomásokat a kapacitásintervallumaikkal és műszakjaikkal együtt, valamint a technológiai útvonalakat. Ekkor döntse el, melyik rendszer kezeli a műszakokat. Egy működő felosztás: az üzemi naptár az S/4HANA rendszerben marad, a részletes műszakbeosztások, távollétek és túlórák pedig a SkyPlannerbe kerülnek, ahol a tervezők naponta módosítják őket.

2. Rendelések szinkronizálása. Iratkozzon fel a Production Order Created/Changed eseményekre, vagy ahol nincsenek beállítva üzleti események, kérdezze le rendszeresen az A_ProductionOrder_2 entitást a módosítás időbélyege alapján. Szűrjön gyárra, rendeléstípusra és státuszra. A rendeléseket már létrehozásukkor küldje át, hogy a SkyPlanner előre tudjon tervezni, és miután a SkyPlanner ütemezte őket, engedélyezze őket az S/4HANA rendszerben (ReleaseOrder vagy ReleaseOperation).

3. Az ütemterv visszaírása. Amikor egy SkyPlanner-webhook az ütemterv változását jelzi, az integráció minden módosult művelethez meghívja az API_PRODUCTION_ORDER_2_SRV API ScheduleProductionOrderOperation akcióját. A következőket küldi el:

• kulcsként a ManufacturingOrder, az OrderInternalBillOfOperations és az OrderIntBillOfOperationsItem értékét
• az OpSchedulingMode mezőben F (előre ütemezés), a SkyPlanner szerinti kezdési dátummal és idővel az OpSchedldStartDate és az OpSchedldStartTime mezőben
• az OpSchedulingStatus mezőben DISP (kiosztás), a kötelező OpSchedulingStrategy mezőben pedig M
• az ETag értékét az if-match fejlécben

Egy rendelés összes művelete egyetlen változáscsomagba kerül, a SkyPlannerben meghatározott sorrendben, így az S/4HANA egyetlen hívással ütemezi be a rendelés teljes tervét. A K módot soha nem használjuk: ez megtartja a műveletek eredeti időpontjait, és figyelmen kívül hagyja az elküldött időpontokat.

A SkyPlanner a technológiai útvonalak ugyanazon normaértékei és a munkaállomások ugyanazon kapacitásképletei alapján számítja ki a műveletek időtartamát, mint az S/4HANA. Az S/4HANA által az átvett kezdési időpontból számított befejezés így összhangban lesz a SkyPlanner ütemtervével. Az integráció minden változáscsomag után újra beolvassa a műveleteket, és megjelöli az eltérő időpontokat, így a tervező még a következő műszak előtt látja az eltéréseket.

4. Üzemi visszajelentések. A Mobile Confirmations vagy a Production Timer minden időbejegyzéséből S/4HANA-visszajelentés lesz. A SkyPlanner webhookja egy ProdnOrdConf2 POST-kérést vált ki, amely tartalmazza a jó mennyiséget, a selejtet és a tevékenységidőket. Az integráció először a GetConfProposal akciót hívja meg, így az S/4HANA javaslatot ad a mennyiségekre, tevékenységekre, dátumokra és személyzeti adatokra. Az anyagmozgásokra a GetGdsMvtProposal ad javaslatot.

Beérkező anyagok. A nyitott beszerzési rendelések is részei a bejövő szinkronizálásnak. A SkyPlanner a megrendelt anyagot a beszerzési rendelés várható szállítási napjától tekinti elérhetőnek. A vásárolt alkatrészekre váró feladatokat az anyag beérkezésének napjára ütemezi; ezt a jelenlegi készletszint nem akadályozza meg.

Az árubeérkezések hiteles nyilvántartása továbbra is az S/4HANA rendszerben marad: az árubeérkezés könyvelésekor nő a készlet, és csökken a beszerzési rendelés tételének nyitott mennyisége. A következő szinkronizálás frissíti a SkyPlanner készletadatait, és a teljes egészében beérkezett beszerzési rendelést Delivered állapotúra állítja. Részleges beérkezés után a fennmaradó nyitott mennyiség továbbra is várható beérkezésként szerepel, a szállítási ütemezés sorában megadott dátummal. A beszerzési rendelések SkyPlannerben történő kezelését a SkyPlanner dokumentációja ismerteti.

5. Adatgazdai szabályok. Az S/4HANA kezeli a mennyiségeket, a darabjegyzéket, a technológiai útvonalat, a költségszámítást és az állapotot. A SkyPlanner határozza meg a sorrendet, a munkaállomásokhoz rendelést és a műveletek időpontjait. Soha ne engedje, hogy mindkét rendszer ugyanazt a mezőt írja. Ha a tervezők továbbra is áthelyeznek műveleteket a Capacity Scheduling Board felületén, döntse el, melyik módosítás élvez elsőbbséget. Vagy a következő rendelésszinkronizálás viszi át a módosításukat a SkyPlannerbe, vagy az adott munkaállomás kimarad a SkyPlanner hatóköréből.

• A visszaírás ETag-et használó akcióhívás. Egy művelet ütemezésének dokumentált módja a ScheduleProductionOrderOperation, nem pedig az A_ProductionOrderOperation_2 entitásra küldött PATCH-kérés. Az F mód a kezdéstől előre, a B mód a befejezéstől visszafelé ütemez, míg a K és az S megtartja a meglévő dátumokat, és figyelmen kívül hagyja az Ön által küldötteket. Az if-match fejléc ETag-je a rendelés LastChangeDateTime értékéből (YYYYMMDDHHMMSS) készül, ezért a rendelés bármely módosítása elavulttá teszi. Építsen be írás előtti beolvasást és az újrapróbálkozásokat kezelő várólistát.
• A kapacitás nem a munkaállomás fejlécében található. A rendelkezésre álló kapacitást a kapacitáskategória (001 gép, 002 munkaerő), a gyári naptár, valamint az azt felülíró időintervallumok és műszakok határozzák meg. A kapacitásképletek a technológiai útvonal standard értékeiből számítják ki az előkészítés, a megmunkálás és a lezárás kapacitásigényét. Olvassa be az A_WorkCenterCapacityInterval_2 entitás és a műszakentitások adatait, és egyeztesse, hogyan számítják ki a képletek alapján a SkyPlannerben használt időtartamokat.
• A normaértékeket rendbe kell tenni. A költségszámításhoz karbantartott technológiai útvonalak gyakran átlagolt előkészítési időket tartalmaznak, vagy az előkészítést rossz kapacitáskategóriához rendelik.
• A visszajelentési szabályok szigorúak. Tömeges könyveléshez az SAP kötegelt hívásokat ajánl. Egy módosításkészlet vagy teljes egészében végrehajtódik, vagy egyáltalán nem, így egyetlen hibás időjegy blokkolja a készlet többi elemét is. A kötegen belüli sztornózásokat a ConfirmationCount szerinti fordított sorrendben kell végrehajtani. Egy rendelésen belül nem keverhetők a visszajelentéstípusok, nem könyvelhető anyagmozgás visszajelentés nélkül, és nem jelenthetők vissza olyan műveletek, amelyek kapcsolópontjai párbeszédablakot igényelnek.
• Ellenőrizze, hogy aktív-e a PP/DS. A beágyazott PP/DS használatához szükség van az Activate Advanced Planning and Scheduling Customizing-tevékenységre és az SAP HANA integrated liveCache-re. Az SAP ezt külön termékként értékesíti, SAP S/4HANA Manufacturing for planning and scheduling néven. Ahol aktív, anyagonként döntse el, melyik rendszer ütemez: az emelt szintű tervezésre megjelölt anyagok a PP/DS-hez tartoznak. A tervezett rendelések API-járól az SAP azt is kijelenti: “Automatic integration to PP/DS is not enabled from this API.” (Ezen az API-n keresztül nincs engedélyezve az automatikus integráció ehhez a tervezőrendszerhez.)
• Mértékegységek. A műveleti mennyiségek, a technológiai útvonal alapmennyiségei és a visszajelentések mértékegységei eltérhetnek. Az átváltást kifejezetten a művelet mértékegysége alapján végezze, ne az anyag alap-mértékegysége alapján.
• Kiadások közötti eltérések. Az SAP Learning bemutatja, hogyan váltja fel a klasszikus CM21/CM22 tervezőtáblát a Manage Work Center Capacity, a Capacity Scheduling Table és a Capacity Scheduling Board. A Public Edition kizárólag kommunikációs forgatókönyveken keresztül tesz elérhetővé API-kat, és az általa kínált szolgáltatásverziók eltérhetnek a helyben telepített változatéitól. A technológiai útvonalak API-ja nem tud útvonalakat törölni vagy anyag-hozzárendeléseket frissíteni. A SkyPlanner csapata a felmérés során ügyfélrendszerenként rögzíti a szolgáltatásverziókat, az API Business Accelerator Hub adott kiadáshoz tartozó bejegyzése alapján.
• A technológiai útvonalakban nem szereplő korlátok. A sorrendfüggő átállásokat, a szerszámütközéseket és a több gépkezelőt igénylő műveleteket a SkyPlannerben kezelje, ne a technológiai útvonal normaértékeiben. Az előkészítési idők mátrixa termékpáronként tartalmazza az átállási időket. A rendelés PRT-i között szereplő szerszámok korlátozott erőforrások: egyszerre csak egy munkaállomáson használhatók, egy művelethez pedig több emberre is szükség lehet egyidejűleg.