Guide till SAP S/4HANA-integration för produktionsplanering med SkyPlanner APS

S/4HANA tillhandahåller integrationsgränssnitt som publicerade OData-tjänster, listade på SAP Business Accelerator Hub (api.sap.com). Integrationen för produktionsplanering använder OData V2-tjänster. IDocs och BAPIs finns fortfarande, men den här guiden använder de publicerade OData-API:erna.

Autentisering per utgåva

• Lokal installation och Private Edition. Tjänsterna aktiveras i SAP Gateway med transaktionen /IWFND/MAINT_SERVICE. Integrationsanvändaren behöver motsvarande behörighetsobjekt, till exempel C_AFRU_AWK för återrapporteringar, C_AFKO_AWK för de materialrörelseposter som bokförs tillsammans med dem och M_PLAF_ORG för planorder.
• Public Edition. Tjänsterna exponeras endast via kommunikationsarrangemang. Följ SAP:s anvisningar för inkommande kommunikation och skapa en kommunikationsanvändare, ett kommunikationssystem och ett kommunikationsarrangemang i appen Communication Arrangements, utifrån ett kommunikationsscenario från SAP (SAP_COM_xxxx). Scenariot styr vilka tjänster som exponeras och vilka autentiseringsmetoder som är tillgängliga:

– tokenbaserad: bearer-flöden med OAuth, SAML eller OpenID Connect, med vidareförmedling av identiteten till en verksamhetsanvändare – klientcertifikat – grundläggande autentisering med en teknisk kommunikationsanvändare

SAP rekommenderar autentisering med token eller certifikat.

På SkyPlanner-sidan finns ett REST API med JWT-autentisering, dokumenterat i Swagger/OpenAPI (API-referens). Mellanprogramvaran hanterar därför SAP-autentisering på ena sidan och en JWT på den andra.

API:er för produktionsplanering

Tjänst	Entiteter och åtgärder som används	Syfte
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; åtgärderna ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Order, operationer, komponenter, produktionsresurser/verktyg (PRT), status och återföring av produktionsplanen
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Produktionsgrupper, kapacitetskategorier, intervall och skift
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standardoperationsföljder för planering innan order skapas
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Produktstruktur i flera nivåer
API_PRODUCT_SRV (Product Master A2X)	A_Product	Material (kallas Product i API:et). SAP rekommenderar nu API:et Product (Version 2) för de flesta produktentiteter
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Resultat från MRP Live före konvertering
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Lagersaldo per fabrik och lagerställe för materialtillgänglighet
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Öppna inköpsorder för inkommande material
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; åtgärderna GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Återrapporteringar och materialrörelser från produktionsgolvet

I API:et för produktionsorder identifieras operationer med OrderInternalBillOfOperations tillsammans med OrderIntBillOfOperationsItem, inte med det operationsnummer som planeraren ser. Återrapporterings-API:ets GetConfProposal använder OrderID och OrderOperation för att identifiera samma operation. Lagra både de interna nycklarna och operationsnumret i SkyPlanner redan vid den första inläsningen.

Händelser

S/4HANA genererar affärshändelserna Production Order Created och Production Order Changed med ManufacturingOrder, ProductionOrder, ProductionOrderType och ProductionPlant i meddelandet. Meddelandet innehåller bara nycklar, så integrationen läser in ordern och dess operationer på nytt. Händelsen Changed utlöses vid varje ändring av ordern, så använd debounce för att samla tätt följande händelser. I andra riktningen skickar SkyPlanners webhooks meddelanden i realtid när produktionsplanen eller en operations status ändras.

Börja med filer

Under provperioden exporterar ni tillverkningsorder och produktionsgrupper från listrapporter i S/4HANA till Excel eller CSV och importerar dem till SkyPlanner. Då kan ni verifiera planen innan någon gör ändringar i Gateway eller kommunikationsuppläggen.

1. Inläsning av grunddata. Läs in material, BOM, produktionsgrupper med kapacitetsintervall och skift samt operationsföljder. Bestäm redan här vilket system som ska styra skiften. En fördelning som fungerar är att fabrikskalendern ligger kvar i S/4HANA, medan detaljerade skiftscheman, frånvaro och övertid hanteras i SkyPlanner, där planerarna ändrar dem dagligen.

2. Ordersynkronisering. Prenumerera på Production Order Created/Changed, eller polla A_ProductionOrder_2 utifrån ändringens tidsstämpel där affärshändelser inte har konfigurerats. Filtrera på fabrik, ordertyp och status. Skicka order när de skapas så att SkyPlanner kan planera i förväg. Frisläpp dem sedan i S/4HANA (ReleaseOrder eller ReleaseOperation) när SkyPlanner har planerat in dem.

3. Återföring av produktionsplanen. När en webhook från SkyPlanner rapporterar att produktionsplanen har ändrats anropar integrationen ScheduleProductionOrderOperation i API_PRODUCTION_ORDER_2_SRV för varje ändrad operation. Följande skickas:

• ManufacturingOrder, OrderInternalBillOfOperations och OrderIntBillOfOperationsItem som nycklar
• OpSchedulingMode F (framåt), med startdatum och starttid från SkyPlanner i OpSchedldStartDate och OpSchedldStartTime
• OpSchedulingStatus DISP (dispatch) och det obligatoriska värdet M för OpSchedulingStrategy
• ETag-värdet i if-match

Alla operationer för en order skickas i en och samma ändringsuppsättning, i den ordning som SkyPlanner har lagt dem. Då kan S/4HANA lägga ut hela orderplanen i ett enda anrop. Läge K används aldrig: det behåller operationernas ursprungliga datum och ignorerar de datum som skickas.

SkyPlanner beräknar operationernas varaktighet utifrån samma standardvärden i operationsföljden och samma kapacitetsformler för produktionsgrupperna som S/4HANA använder. Slutdatumet som S/4HANA beräknar utifrån den överförda starttiden stämmer därför med planen i SkyPlanner. Efter varje ändringsuppsättning läser integrationen in operationerna igen och flaggar alla datum som avviker, så att planeraren ser dem före nästa skift.

4. Återrapportering från produktionsgolvet. Varje tidsregistrering från Mobile Confirmations eller Production Timer blir en återrapportering i S/4HANA. SkyPlanners webhook utlöser en postning till ProdnOrdConf2 med godkänd kvantitet, kassation och aktivitetstider. Integrationen anropar först GetConfProposal, så att S/4HANA föreslår kvantiteter, aktiviteter, datum och personaluppgifter. GetGdsMvtProposal föreslår materialrörelserna.

Inkommande material. Öppna inköpsorder ingår i synkroniseringen till SkyPlanner. SkyPlanner betraktar beställt material som tillgängligt på inköpsorderns förväntade leveransdatum. Jobb som väntar på inköpta komponenter planeras till den dag materialet kommer, i stället för att blockeras av dagens lagersaldo.

S/4HANA förblir det styrande systemet för inleveranser: när en varumottagning bokförs ökar lagersaldot och den öppna kvantiteten på inköpsorderraden minskar. Nästa synkronisering uppdaterar lagersaldot i SkyPlanner och markerar en fullt inlevererad inköpsorder som Delivered. Efter en delleverans ligger den återstående öppna kvantiteten kvar som inkommande på leveransplanradens datum. SkyPlanners hantering av inköpsorder beskrivs i SkyPlanners dokumentation.

5. Regler för dataansvar. S/4HANA styr kvantiteter, BOM, operationsföljder, kostnadskalkyler och status. SkyPlanner styr sekvens, tilldelning av produktionsgrupp och operationsdatum. Låt aldrig båda systemen skriva till samma fält. Om planerarna fortfarande flyttar operationer i Capacity Scheduling Board måste ni bestämma vad som ska ha företräde. Antingen förs ändringen över till SkyPlanner vid nästa ordersynkronisering, eller så hålls den produktionsgruppen utanför SkyPlanners planering.

• Återföringen görs med ett åtgärdsanrop och en ETag. Det dokumenterade sättet att planera in en operation är ScheduleProductionOrderOperation, inte ett PATCH-anrop till A_ProductionOrderOperation_2. Läge F planerar framåt från en starttid och B bakåt från en sluttid, medan K och S behåller befintliga datum och ignorerar dina. ETag-värdet i if-match byggs från orderns LastChangeDateTime (YYYYMMDDHHMMSS), så varje ändring av ordern gör det inaktuellt. Bygg in läsning före skrivning och en kö för återförsök.
• Kapaciteten finns inte i produktionsgruppens huvudpost. Den tillgängliga kapaciteten hämtas från kapacitetskategorin (001 maskin, 002 personal), fabrikskalendern samt de intervall och skift som åsidosätter kalendern. Kapacitetsformler omvandlar operationsföljdens standardvärden till kapacitetsbehov för ställ, bearbetning och avrustning. Läs A_WorkCenterCapacityInterval_2 och skiftentiteterna, och kom överens om hur formlerna ska omvandlas till varaktigheter i SkyPlanner.
• Standardvärden behöver ses över. Operationsföljder som underhålls för kostnadskalkylering innehåller ofta genomsnittliga ställtider, eller ställtid som har registrerats på fel kapacitetskategori.
• Reglerna för återrapportering är strikta. SAP rekommenderar batchanrop vid massbokföring. En ändringsuppsättning behandlas enligt principen allt eller inget, så en felaktig tidsrapport blockerar resten av uppsättningen. Annulleringar i en batch måste köras i omvänd ConfirmationCount-ordning. Du kan inte blanda återrapporteringstyper på samma order, bokföra materialrörelser utan en återrapportering eller återrapportera operationer vars utlösningspunkter kräver en dialogruta.
• Kontrollera om PP/DS är aktivt. Inbyggd PP/DS kräver Customizing-aktiviteten Activate Advanced Planning and Scheduling och SAP HANA integrated liveCache. SAP säljer det som en separat produkt, SAP S/4HANA Manufacturing for planning and scheduling. Där det är aktivt måste ni bestämma vilket system som planerar varje material: material som är markerade för avancerad planering hör till PP/DS. SAP anger också följande för API:et för planorder: ”Automatic integration to PP/DS is not enabled from this API.” (Automatisk integration dit är inte aktiverad via detta API.)
• Måttenheter. Operationskvantiteter, baskvantiteter i operationsföljder och enheter för återrapportering kan skilja sig åt. Gör en uttrycklig omräkning med operationens enhet, inte materialets basenhet.
• Skillnader mellan utgåvor. SAP Learning visar hur den klassiska planeringstavlan CM21/CM22 ersätts av Manage Work Center Capacity, Capacity Scheduling Table och Capacity Scheduling Board. Public Edition tillhandahåller endast API:er via kommunikationsscenarier, och de tjänsteversioner som erbjuds kan skilja sig från dem i en lokal installation. API:et för operationsföljder kan inte ta bort operationsföljder eller uppdatera materialtilldelningar. Under kartläggningen fastställer SkyPlanner-teamet tjänsteversionerna för varje kundsystem utifrån posten för den aktuella versionen i API Business Accelerator Hub.
• Begränsningar som operationsföljderna inte beskriver. Hantera sekvensberoende omställningar, verktygskonflikter och operationer med flera operatörer i SkyPlanner, inte i operationsföljdernas standardvärden. Ställtidsmatrisen innehåller omställningstider per produktpar. Verktyg från orderns PRT:er är begränsade resurser som kan användas av en produktionsgrupp åt gången, och en operation kan kräva flera personer samtidigt.