SAP S/4HANA-integratiegids voor het inplannen van productie met SkyPlanner APS

S/4HANA biedt integratiemogelijkheden via vrijgegeven OData-services, die op de SAP Business Accelerator Hub (api.sap.com) staan. De integratie voor het productieschema gebruikt OData V2-services. IDocs en BAPIs bestaan nog steeds, maar deze gids gaat uit van de vrijgegeven OData-API’s.

Authenticatie per editie

• On-premise en Private Edition. De services worden in SAP Gateway geactiveerd met transactie /IWFND/MAINT_SERVICE. De integratiegebruiker heeft de bijbehorende autorisatieobjecten nodig, bijvoorbeeld C_AFRU_AWK voor terugmeldingen, C_AFKO_AWK voor de goederenbewegingsposities die daarbij worden geboekt en M_PLAF_ORG voor planorders.
• Public Edition. Services worden uitsluitend via communicatieafspraken beschikbaar gesteld. Volg de SAP-instructies voor het instellen van inkomende communicatie en maak in de app Communication Arrangements een communicatiegebruiker, een communicatiesysteem en een communicatieafspraak aan op basis van een SAP-communicatiescenario (SAP_COM_xxxx). Het scenario bepaalt welke services beschikbaar worden gesteld en welke authenticatiemethoden beschikbaar zijn:

– met tokens: bearer-flows via OAuth, SAML of OpenID Connect, met principal propagation naar een bedrijfsgebruiker – clientcertificaat – basisauthenticatie met een technische communicatiegebruiker

SAP raadt authenticatie met tokens of certificaten aan.

Aan de SkyPlanner-kant staat een REST API met JWT-authenticatie, gedocumenteerd in Swagger/OpenAPI (API-referentie). De middleware handelt dus aan de ene kant de SAP-authenticatie af en gebruikt aan de andere kant een JWT.

API’s voor het productieschema

Service	Gebruikte entiteiten en acties	Doel
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; acties ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Orders, bewerkingen, componenten, PRT’s, status en het terugschrijven van het productieschema
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Werkcentra, capaciteitscategorieën, intervallen en diensten
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Standaardbewerkingsvolgorden om te plannen voordat orders worden aangemaakt
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Productstructuur met meerdere niveaus
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materialen (in de API Product genoemd). SAP beveelt nu voor de meeste productentiteiten de API Product (Version 2) aan
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Resultaten van MRP Live vóór conversie
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Voorraad per vestiging en magazijnlocatie om de materiaalbeschikbaarheid te bepalen
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Openstaande inkooporders voor binnenkomend materiaal
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; acties GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Terugmeldingen en goederenbewegingen vanaf de productievloer

In de productieorder-API worden bewerkingen geïdentificeerd met de combinatie van OrderInternalBillOfOperations en OrderIntBillOfOperationsItem, niet met het bewerkingsnummer dat de planner ziet. De actie GetConfProposal van de terugmeldings-API gebruikt voor dezelfde bewerking OrderID en OrderOperation. Sla de interne sleutels en het bewerkingsnummer vanaf de eerste gegevensimport op in SkyPlanner.

Gebeurtenissen

S/4HANA genereert de business events Production Order Created en Production Order Changed met ManufacturingOrder, ProductionOrder, ProductionOrderType en ProductionPlant in de payload. De payload bevat alleen sleutels, dus de integratie leest de order en de bijbehorende bewerkingen opnieuw in. Het Changed-event wordt bij elke wijziging aan de order geactiveerd; pas daarom debouncing toe. In de andere richting versturen SkyPlanner-webhooks realtime meldingen wanneer het productieschema of de taakstatus verandert.

Beginnen met bestanden

Exporteer voor de proefperiode productieorders en werkcentra uit S/4HANA-lijstrapporten naar Excel of CSV en importeer ze in SkyPlanner. Zo toetst u het productieschema voordat iemand Gateway of communication arrangements hoeft in te richten.

1. Stamgegevens laden. Laad materialen, stuklijsten, werkcentra met hun capaciteitsintervallen en diensten, en bewerkingsvolgorden. Bepaal hierbij welk systeem leidend is voor de diensten. Een werkbare verdeling: de fabriekskalender blijft in S/4HANA, terwijl gedetailleerde dienstroosters, afwezigheid en overwerk in SkyPlanner staan. Daar passen planners ze dagelijks aan.

2. Ordersynchronisatie. Abonneer de integratie op Production Order Created/Changed, of vraag A_ProductionOrder_2 periodiek op aan de hand van het wijzigingstijdstip als er geen business events zijn ingesteld. Filter op vestiging, ordertype en status. Stuur orders door zodra ze worden aangemaakt, zodat SkyPlanner vooruit kan plannen. Geef ze in S/4HANA vrij (ReleaseOrder of ReleaseOperation) zodra SkyPlanner ze heeft ingepland.

3. Het productieschema terugschrijven. Wanneer een SkyPlanner-webhook een wijziging in het productieschema meldt, roept de integratie voor elke gewijzigde bewerking ScheduleProductionOrderOperation aan in API_PRODUCTION_ORDER_2_SRV. Daarbij worden de volgende gegevens verstuurd:

• ManufacturingOrder, OrderInternalBillOfOperations en OrderIntBillOfOperationsItem als sleutels
• OpSchedulingMode F (voorwaarts), met de door SkyPlanner bepaalde startdatum en starttijd in OpSchedldStartDate en OpSchedldStartTime
• OpSchedulingStatus DISP (toewijzen) en de verplichte OpSchedulingStrategy M
• de ETag in if-match

Alle bewerkingen van één order gaan in één change set, in de volgorde die SkyPlanner bepaalt. Zo plant S/4HANA de volledige order in met één aanroep. Mode K wordt nooit gebruikt: die behoudt de oorspronkelijke bewerkingsdatums en negeert de verstuurde datums.

SkyPlanner leidt de bewerkingsduur af van dezelfde standaardwaarden in de bewerkingsvolgorde en dezelfde capaciteitsformules voor werkcentra die S/4HANA gebruikt. De einddatum die S/4HANA op basis van de doorgestuurde startdatum berekent, sluit daardoor aan op het plan in SkyPlanner. Na elke change set leest de integratie de bewerkingen opnieuw uit en signaleert afwijkende datums. De planner ziet die vóór de volgende dienst.

4. Terugmeldingen vanaf de productievloer. Elke tijdregistratie uit Mobile Confirmations of de Production Timer wordt een terugmelding in S/4HANA. De webhook van SkyPlanner activeert een ProdnOrdConf2-boeking met de hoeveelheid goed product, uitval en activiteitstijden. De integratie roept eerst GetConfProposal aan, zodat S/4HANA hoeveelheden, activiteiten, datums en personeelsgegevens voorstelt. GetGdsMvtProposal stelt de goederenbewegingen voor.

Inkomend materiaal. Openstaande inkooporders worden meegenomen in de inkomende synchronisatie. SkyPlanner beschouwt besteld materiaal als beschikbaar op de verwachte leverdatum van de inkooporder. Taken die op ingekochte onderdelen wachten, worden ingepland op de dag waarop het materiaal aankomt. De huidige voorraadstand blokkeert ze dus niet.

S/4HANA blijft leidend voor ontvangsten: zodra een goederenontvangst wordt geboekt, stijgt de voorraad en daalt de openstaande hoeveelheid op de inkooporderregel. De volgende synchronisatie werkt de voorraad in SkyPlanner bij en geeft een volledig ontvangen inkooporder de status Delivered. Na een deelontvangst blijft de resterende hoeveelheid als inkomend gepland op de datum van de leveringsregel. Hoe SkyPlanner inkooporders verwerkt, staat in de SkyPlanner-documentatie.

5. Verantwoordelijkheden per systeem. S/4HANA is leidend voor hoeveelheden, stuklijsten, bewerkingsvolgorden, kostencalculatie en status. SkyPlanner is leidend voor de planningsvolgorde, de toewijzing aan werkcentra en de bewerkingsdatums. Laat nooit beide systemen hetzelfde veld schrijven. Als planners nog bewerkingen verplaatsen in het Capacity Scheduling Board, bepaal dan welke wijziging voorrang krijgt. Ofwel neemt de volgende ordersynchronisatie hun wijziging over in SkyPlanner, ofwel blijft dat werkcentrum buiten de scope van SkyPlanner.

• Terugschrijven gebeurt via een actieaanroep met een ETag. De gedocumenteerde manier om een bewerking in te plannen is ScheduleProductionOrderOperation, niet een PATCH op A_ProductionOrderOperation_2. Modus F plant voorwaarts vanaf een startmoment en B achterwaarts vanaf een eindmoment. K en S behouden de bestaande datums en negeren de datums die u verstuurt. De ETag in if-match wordt opgebouwd uit de LastChangeDateTime van de order (YYYYMMDDHHMMSS) en is dus na elke orderwijziging verouderd. Bouw de integratie zo dat deze vóór het schrijven opnieuw leest en een wachtrij voor nieuwe pogingen gebruikt.
• Capaciteit staat niet in de kopgegevens van het werkcentrum. De beschikbare capaciteit wordt bepaald door de capaciteitscategorie (001 machine, 002 arbeid), de fabriekskalender en de intervallen en diensten die daarvan afwijken. Capaciteitsformules zetten standaardwaarden uit de bewerkingsvolgorde om in de benodigde capaciteit voor instellen, bewerken en afbouwen. Lees A_WorkCenterCapacityInterval_2 en de dienstentiteiten uit en spreek af hoe de formules worden vertaald naar tijdsduren in SkyPlanner.
• Standaardwaarden moeten worden opgeschoond. Bewerkingsvolgorden die voor kostencalculatie worden bijgehouden, bevatten vaak gemiddelde insteltijden, of insteltijd die op de verkeerde capaciteitscategorie is geboekt.
• Voor terugmeldingen gelden strikte regels. SAP beveelt batchaanroepen aan voor massaboekingen. Een wijzigingsset wordt volledig verwerkt of helemaal niet: één ongeldige tijdmelding blokkeert dus de rest van die set. Annuleringen binnen een batch moeten in omgekeerde ConfirmationCount-volgorde worden uitgevoerd. U kunt geen verschillende terugmeldingstypen binnen één order combineren, geen goederenbewegingen zonder terugmelding boeken en geen bewerkingen terugmelden waarvan de triggerpunten een dialoogvenster vereisen.
• Controleer of PP/DS actief is. Embedded PP/DS vereist de Customizing-activiteit Activate Advanced Planning and Scheduling en SAP HANA integrated liveCache. SAP verkoopt dit als afzonderlijk product: SAP S/4HANA Manufacturing for planning and scheduling. Als het actief is, bepaalt u per materiaal welk systeem de planning uitvoert: materialen die zijn gemarkeerd voor geavanceerde planning vallen onder PP/DS. SAP vermeldt voor de API voor geplande orders ook: “Automatic integration to PP/DS is not enabled from this API.” (Automatische integratie is via deze API niet ingeschakeld.)
• Maateenheden. De eenheden voor bewerkingshoeveelheden, basishoeveelheden in bewerkingsvolgorden en bevestigingen kunnen verschillen. Reken expliciet om met de eenheid van de bewerking, niet met de basiseenheid van het materiaal.
• Verschillen tussen edities. SAP Learning laat zien hoe de klassieke CM21/CM22-planningstabel wordt vervangen door Manage Work Center Capacity, Capacity Scheduling Table en Capacity Scheduling Board. Public Edition biedt API’s alleen aan via communication scenarios. De beschikbare serviceversies kunnen afwijken van die in on-premise-installaties. De API voor bewerkingsvolgorden kan geen bewerkingsvolgorden verwijderen of materiaaltoewijzingen bijwerken. Tijdens de scopebepaling legt het SkyPlanner-team de serviceversies per klantsysteem vast aan de hand van de vermelding voor die release in de API Business Accelerator Hub.
• Beperkingen die niet in bewerkingsvolgorden staan. Leg volgordeafhankelijke omstellingen, conflicten rond gereedschappen en bewerkingen met meerdere operators vast in SkyPlanner, niet in de standaardwaarden van de bewerkingsvolgorde. De insteltijdmatrix bevat de omsteltijden per productpaar. Gereedschappen uit de PRTs van de order zijn beperkt beschikbaar en kunnen slechts op één werkcentrum tegelijk worden ingezet. Een bewerking kan meerdere mensen tegelijk vereisen.