Veiledning for SAP S/4HANA-integrasjon med SkyPlanner APS for produksjonsplanlegging

S/4HANA gjør integrasjon tilgjengelig gjennom publiserte OData-tjenester, som er oppført på SAP Business Accelerator Hub (api.sap.com). Integrasjonen for produksjonsplanlegging bruker OData V2-tjenester. IDocs og BAPIs finnes fortsatt, men denne veiledningen bruker de publiserte OData-API-ene.

Autentisering etter utgave

• Lokal installasjon og Private Edition. Tjenestene aktiveres i SAP Gateway med transaksjonen /IWFND/MAINT_SERVICE. Integrasjonsbrukeren trenger de tilhørende autorisasjonsobjektene, for eksempel C_AFRU_AWK for tilbakemeldinger, C_AFKO_AWK for varebevegelsespostene som bokføres sammen med dem, og M_PLAF_ORG for planordrer.
• Public Edition. Tjenester gjøres bare tilgjengelige gjennom kommunikasjonsoppsett. Følg SAPs veiledning for oppsett av innkommende kommunikasjon, og opprett en kommunikasjonsbruker, et kommunikasjonssystem og et kommunikasjonsoppsett i appen Communication Arrangements, basert på et SAP-kommunikasjonsscenario (SAP_COM_xxxx). Scenarioet definerer hvilke tjenester som gjøres tilgjengelige, og hvilke autentiseringsmetoder som kan brukes:

– tokenbasert: bearer-flyter med OAuth, SAML eller OpenID Connect, med videreføring av identitet til en forretningsbruker – klientsertifikat – grunnleggende autentisering med en teknisk kommunikasjonsbruker

SAP anbefaler autentisering med token eller sertifikat.

På SkyPlanner-siden brukes et REST API med JWT-autentisering, dokumentert i Swagger/OpenAPI (API-referanse). Mellomvaren håndterer dermed SAP-autentisering på den ene siden og JWT på den andre.

API-er for produksjonsplanlegging

Tjeneste	Entiteter og handlinger som brukes	Formål
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; handlingene ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Ordrer, operasjoner, komponenter, PRT-er, status og tilbakeskriving av produksjonsplanen
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Arbeidssentre, kapasitetskategorier, intervaller og skift
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standard produksjonsruter for planlegging før ordrer opprettes
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Produktstruktur med flere nivåer
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materialer (kalt Product i API-et). SAP anbefaler nå API-et Product (Version 2) for de fleste produktentiteter
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Resultater fra MRP Live før konvertering
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Lagerbeholdning per fabrikk og lagersted for å fastslå materialtilgjengelighet
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Åpne innkjøpsordrer for innkommende materialer
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; handlingene GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Tilbakemeldinger og varebevegelser fra produksjonsgulvet

I API-et for produksjonsordrer identifiseres operasjoner med nøklene OrderInternalBillOfOperations og OrderIntBillOfOperationsItem, ikke med operasjonsnummeret planleggeren ser. I tilbakemeldings-API-et bruker GetConfProposal derimot OrderID og OrderOperation til å identifisere den samme operasjonen. Lagre både de interne nøklene og operasjonsnummeret i SkyPlanner fra første innlasting.

Hendelser

S/4HANA utløser forretningshendelsene Production Order Created og Production Order Changed med ManufacturingOrder, ProductionOrder, ProductionOrderType og ProductionPlant i meldingsinnholdet. Meldingen inneholder bare nøkler, så integrasjonen leser inn ordren og operasjonene på nytt. Changed-hendelsen utløses ved hver endring i ordren, så samle opp tett påfølgende hendelser før de behandles. I motsatt retning sender SkyPlanner-webhooks varsler i sanntid når produksjonsplanen eller jobbstatusen endres.

Start med filer

I prøveperioden eksporterer dere produksjonsordrer og arbeidssentre fra listerapporter i S/4HANA til Excel eller CSV og importerer dem i SkyPlanner. Da får dere bekreftet at planen fungerer før noen gjør endringer i Gateway eller kommunikasjonsoppsettet.

1. Innlasting av grunndata. Last inn materialer, BOM-er, arbeidssentre med kapasitetsintervaller og skift samt produksjonsruter. Avgjør her hvilket system som skal eie skiftene. En fordeling som fungerer: Fabrikkalenderen blir i S/4HANA, mens detaljerte skiftmønstre, fravær og overtid håndteres i SkyPlanner, der planleggerne endrer dem daglig.

2. Ordresynkronisering. Abonner på Production Order Created/Changed, eller bruk polling av A_ProductionOrder_2 etter endringstidsstempel der forretningshendelser ikke er satt opp. Filtrer på fabrikk, ordretype og status. Send ordrer når de opprettes, slik at SkyPlanner kan planlegge fremover, og frigi dem i S/4HANA (ReleaseOrder eller ReleaseOperation) når SkyPlanner har lagt dem inn i produksjonsplanen.

3. Tilbakeskriving av produksjonsplanen. Når en SkyPlanner-webhook melder om en endring i produksjonsplanen, kaller integrasjonen ScheduleProductionOrderOperation i API_PRODUCTION_ORDER_2_SRV for hver endrede operasjon. Den sender:

• ManufacturingOrder, OrderInternalBillOfOperations og OrderIntBillOfOperationsItem som nøkler
• OpSchedulingMode F (forover), med startdato og starttid fra SkyPlanner i OpSchedldStartDate og OpSchedldStartTime
• OpSchedulingStatus DISP (disponering) og det obligatoriske feltet OpSchedulingStrategy med verdien M
• ETag i if-match

Alle operasjonene i én ordre sendes i ett endringssett, i rekkefølgen fra SkyPlanner. Dermed fastsetter S/4HANA hele planen for ordren i ett kall. Mode K brukes aldri: Den beholder de opprinnelige operasjonsdatoene og ignorerer datoene som sendes inn.

SkyPlanner beregner operasjonenes varighet ut fra de samme standardverdiene i produksjonsrutene og kapasitetsformlene for arbeidssentrene som S/4HANA bruker. Sluttdatoen S/4HANA beregner fra den innsendte startdatoen, samsvarer derfor med planen i SkyPlanner. Etter hvert endringssett leser integrasjonen operasjonene på nytt og markerer eventuelle datoavvik, slik at planleggeren ser dem før neste skift.

4. Tilbakemeldinger fra produksjonsgulvet. Hver tidsregistrering fra Mobile Confirmations eller Production Timer blir en tilbakemelding i S/4HANA. En webhook fra SkyPlanner utløser en POST til ProdnOrdConf2 med godkjent mengde, vrak og aktivitetstider. Integrasjonen kaller først GetConfProposal, slik at S/4HANA foreslår mengder, aktiviteter, datoer og personaldata. GetGdsMvtProposal foreslår varebevegelsene.

Innkommende materialer. Åpne innkjøpsordrer inngår i synkroniseringen inn til SkyPlanner. SkyPlanner regner bestilt materiale som tilgjengelig på forventet leveringsdato i innkjøpsordren. Jobber som venter på innkjøpte komponenter, planlegges til dagen materialet ankommer, i stedet for å bli blokkert av dagens lagerbeholdning.

S/4HANA forblir fasit for varemottak: Når et varemottak bokføres, øker lagerbeholdningen, og den åpne mengden på innkjøpsordrelinjen reduseres. Neste synkronisering oppdaterer lagerbeholdningen i SkyPlanner og setter en fullt mottatt innkjøpsordre til Delivered. Etter et delmottak står den resterende åpne mengden fortsatt som innkommende på datoen for leveringsplanlinjen. Håndtering av innkjøpsordrer i SkyPlanner er beskrevet i SkyPlanner-dokumentasjonen.

5. Regler for dataeierskap. S/4HANA eier mengder, BOM, produksjonsrute, kostnadsberegning og status. SkyPlanner eier rekkefølge, tildeling av arbeidsstasjon og operasjonsdatoer. La aldri begge skrive til samme felt. Hvis planleggerne fortsatt flytter operasjoner i Capacity Scheduling Board, må dere avgjøre hva som har forrang. Enten overføres endringen deres til SkyPlanner ved neste ordresynkronisering, eller så holdes det aktuelle arbeidssenteret utenfor SkyPlanner.

• Tilbakeskriving krever et handlingskall med en ETag. Den dokumenterte måten å tidfeste en operasjon på er ScheduleProductionOrderOperation, ikke en PATCH mot A_ProductionOrderOperation_2. Modus F planlegger forover fra en start, og B bakover fra en slutt, mens K og S beholder eksisterende datoer og ignorerer datoene du sender. ETag i if-match bygges fra ordrens LastChangeDateTime (YYYYMMDDHHMMSS), så enhver endring i ordren gjør den utdatert. Bygg inn lesing før skriving og en kø for nye forsøk.
• Kapasiteten ligger ikke i arbeidssenterets toppdata. Tilgjengelig kapasitet bestemmes av kapasitetskategorien (001 maskin, 002 personell), fabrikkalenderen og intervallene og skiftene som overstyrer den. Kapasitetsformlene omregner standardverdiene i produksjonsruten til kapasitetsbehov for klargjøring, bearbeiding og nedrigging. Les A_WorkCenterCapacityInterval_2 og skiftentitetene, og avtal hvordan formlene skal omregnes til varigheter i SkyPlanner.
• Standardverdiene må ryddes opp i. Produksjonsruter som vedlikeholdes for kostnadsberegning, inneholder ofte gjennomsnittlige omstillingstider, eller omstilling registrert på feil kapasitetskategori.
• Reglene for tilbakemeldinger er strenge. SAP anbefaler batchkall ved massebokføring. Et endringssett behandles etter alt-eller-ingenting-prinsippet, så én ugyldig tidsregistrering blokkerer resten av settet. Annulleringer i en batch må kjøres i omvendt ConfirmationCount-rekkefølge. Du kan ikke blande tilbakemeldingstyper på én ordre, bokføre varebevegelser uten en tilbakemelding eller melde tilbake operasjoner der utløserpunktene krever en dialogboks.
• Kontroller om PP/DS er aktivt. Innebygd PP/DS krever Customizing-aktiviteten Activate Advanced Planning and Scheduling og SAP HANA integrated liveCache. SAP selger det som et eget produkt, SAP S/4HANA Manufacturing for planning and scheduling. Der det er aktivt, må dere avgjøre hvilket system som planlegger hvert materiale: Materialer merket for avansert planlegging tilhører PP/DS. SAP sier også følgende om API-et for planordrer: «Automatic integration to PP/DS is not enabled from this API.» (Automatisk integrasjon med dette systemet er ikke aktivert fra dette API-et.)
• Måleenheter. Operasjonsmengder, basismengder i produksjonsruter og enheter for tilbakemelding kan være ulike. Gjør en eksplisitt omregning med operasjonens enhet, ikke materialets basisenhet.
• Forskjeller mellom utgaver. SAP Learning viser at den klassiske planleggingstabellen CM21/CM22 erstattes av Manage Work Center Capacity, Capacity Scheduling Table og Capacity Scheduling Board. Public Edition gjør API-er tilgjengelige bare gjennom kommunikasjonsscenarioer, og tjenesteversjonene kan avvike fra dem som tilbys ved lokal installasjon. API-et for produksjonsruter kan ikke slette produksjonsruter eller oppdatere materialtilordninger. Under avklaringen fastsetter SkyPlanner-teamet tjenesteversjonene for hvert kundesystem ut fra oppføringen for den aktuelle versjonen i API Business Accelerator Hub.
• Begrensninger som ikke ligger i produksjonsrutene. Håndter rekkefølgeavhengige omstillinger, verktøykonflikter og operasjoner med flere operatører i SkyPlanner, ikke i standardverdiene for produksjonsrutene. Omstillingstidsmatrisen inneholder omstillingstider for hvert produktpar. Verktøy fra ordrens PRT-er er begrensede ressurser som bare kan brukes ved én arbeidsstasjon om gangen, og en operasjon kan kreve flere personer samtidig.