Guida all’integrazione di SAP S/4HANA con SkyPlanner APS per la schedulazione della produzione

S/4HANA mette a disposizione le proprie interfacce di integrazione sotto forma di servizi OData rilasciati, elencati nel SAP Business Accelerator Hub (api.sap.com). L’integrazione per la schedulazione si basa sui servizi OData V2. IDoc e BAPI esistono ancora, ma questa guida utilizza le API OData rilasciate.

Autenticazione per edizione

• On-premise e Private Edition. I servizi si attivano in SAP Gateway con la transazione /IWFND/MAINT_SERVICE. L’utente di integrazione deve disporre degli oggetti di autorizzazione corrispondenti, ad esempio C_AFRU_AWK per le conferme, C_AFKO_AWK per le posizioni dei movimenti merci registrati con le conferme e M_PLAF_ORG per gli ordini pianificati.
• Public Edition. I servizi vengono esposti solo tramite accordi di comunicazione. Seguendo la procedura SAP per configurare la comunicazione in entrata, si creano un utente di comunicazione, un sistema di comunicazione e un accordo di comunicazione nell’app Communication Arrangements, sulla base di uno scenario di comunicazione SAP (SAP_COM_xxxx). Lo scenario definisce quali servizi vengono esposti e quali metodi di autenticazione sono disponibili:

– basata su token: flussi bearer OAuth, SAML o OpenID Connect, con propagazione dell’identità a un utente aziendale – certificato client – autenticazione di base con un utente tecnico di comunicazione

SAP consiglia l’autenticazione tramite token o certificato.

Sul lato SkyPlanner è disponibile un’API REST con autenticazione JWT, documentata in Swagger/OpenAPI (riferimento API). Il middleware gestisce quindi l’autenticazione SAP da un lato e un JWT dall’altro.

API per la schedulazione della produzione

Servizio	Entità e azioni utilizzate	Finalità
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; azioni ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Ordini, operazioni, componenti, PRT, stato, scrittura della schedulazione in SAP
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Centri di lavoro, categorie di capacità, intervalli e turni
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Cicli di lavorazione standard per pianificare prima della creazione degli ordini
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Struttura di prodotto multilivello
API_PRODUCT_SRV (Product Master A2X)	A_Product	Materiali (denominati Product nell’API). SAP ora consiglia l’API Product (Version 2) per la maggior parte delle entità di prodotto
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Risultati di MRP Live prima della conversione
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Giacenze per divisione e magazzino, per la disponibilità dei materiali
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Ordini di acquisto aperti per i materiali in arrivo
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; azioni GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Conferme e movimenti merci dal reparto produttivo

Nell’API degli ordini di produzione, le operazioni sono identificate dalla combinazione di OrderInternalBillOfOperations e OrderIntBillOfOperationsItem, non dal numero dell’operazione visualizzato dal pianificatore. L’azione GetConfProposal dell’API delle conferme identifica la stessa operazione tramite OrderID e OrderOperation. Memorizzare in SkyPlanner sia le chiavi interne sia il numero dell’operazione fin dal primo caricamento.

Eventi

S/4HANA genera gli eventi di business Production Order Created e Production Order Changed, con ManufacturingOrder, ProductionOrder, ProductionOrderType e ProductionPlant nel payload. Il payload contiene solo le chiavi, quindi l’integrazione rilegge l’ordine e le relative operazioni. L’evento Changed scatta a ogni modifica dell’ordine: occorre quindi applicare un meccanismo di debounce. Nella direzione opposta, i webhook di SkyPlanner inviano notifiche in tempo reale quando cambia la schedulazione o lo stato di un’operazione.

Iniziare con i file

Per la prova, esporta gli ordini di produzione e i centri di lavoro dai report elenco di S/4HANA in Excel o CSV e importali in SkyPlanner. In questo modo puoi verificare la schedulazione prima di intervenire su Gateway o sugli accordi di comunicazione.

1. Caricamento delle anagrafiche. Carica materiali, distinte base, centri di lavoro con i relativi intervalli di capacità e turni, e cicli di lavorazione. In questa fase decidi quale sistema gestisce i turni. Una ripartizione efficace è mantenere il calendario di fabbrica in S/4HANA e gestire in SkyPlanner gli schemi dettagliati dei turni, le assenze e gli straordinari, che i pianificatori modificano ogni giorno.

2. Sincronizzazione degli ordini. Sottoscrivere gli eventi Production Order Created/Changed oppure, se gli eventi di business non sono configurati, interrogare periodicamente A_ProductionOrder_2 in base al timestamp di modifica. Filtrare per divisione, tipo di ordine e stato. Inviare gli ordini alla creazione, così SkyPlanner può pianificare in anticipo, e rilasciarli in S/4HANA (ReleaseOrder o ReleaseOperation) una volta che SkyPlanner li ha schedulati.

3. Scrittura della schedulazione in SAP. Quando un webhook di SkyPlanner segnala una modifica alla schedulazione, l’integrazione chiama ScheduleProductionOrderOperation in API_PRODUCTION_ORDER_2_SRV per ogni operazione modificata. Invia:

• ManufacturingOrder, OrderInternalBillOfOperations e OrderIntBillOfOperationsItem come chiavi
• OpSchedulingMode F (in avanti), con la data e l’ora di inizio definite da SkyPlanner in OpSchedldStartDate e OpSchedldStartTime
• OpSchedulingStatus DISP (assegnazione) e il parametro obbligatorio OpSchedulingStrategy M
• l’ETag in if-match

Tutte le operazioni di un ordine vengono inserite in un unico change set, nella sequenza definita da SkyPlanner, così S/4HANA programma tutte le operazioni dell’ordine con una sola chiamata. La modalità K non viene mai usata: mantiene le date originali delle operazioni e ignora quelle inviate.

SkyPlanner ricava la durata delle operazioni dagli stessi valori standard dei cicli di lavorazione e dalle stesse formule di capacità dei centri di lavoro usati da S/4HANA. La data di fine che S/4HANA calcola a partire dalla data di inizio trasmessa risulta quindi allineata al piano di SkyPlanner. Dopo ogni change set, l’integrazione rilegge le operazioni e segnala eventuali date discordanti, che il pianificatore può vedere prima del turno successivo.

4. Conferme dal reparto produttivo. Ogni registrazione dei tempi proveniente da Mobile Confirmations o Production Timer diventa una conferma in S/4HANA. Il webhook di SkyPlanner attiva un invio POST a ProdnOrdConf2 con quantità buona, scarti e tempi delle attività. L’integrazione chiama prima GetConfProposal, così S/4HANA propone quantità, attività, date e dati del personale. GetGdsMvtProposal propone i movimenti merci.

Materiali in arrivo. Gli ordini di acquisto aperti fanno parte della sincronizzazione in ingresso. SkyPlanner considera il materiale ordinato disponibile alla data di consegna prevista nell’ordine di acquisto. Le lavorazioni in attesa di componenti acquistati vengono schedulate per il giorno di arrivo del materiale, senza essere bloccate dalla giacenza attuale.

S/4HANA rimane il sistema di riferimento per i ricevimenti: quando viene registrata un’entrata merci, la giacenza aumenta e la quantità aperta della posizione dell’ordine di acquisto diminuisce. La sincronizzazione successiva aggiorna le giacenze in SkyPlanner e assegna lo stato Delivered a un ordine di acquisto ricevuto per intero; dopo un ricevimento parziale, la quantità ancora aperta resta in arrivo alla data della relativa riga di consegna. La gestione degli ordini di acquisto in SkyPlanner è descritta nella documentazione di SkyPlanner.

5. Responsabilità sui dati. S/4HANA gestisce quantità, distinta base, ciclo di lavorazione, calcolo dei costi e stato. SkyPlanner gestisce sequenza, assegnazione ai centri di lavoro e date delle operazioni. Non consentire mai a entrambi i sistemi di scrivere nello stesso campo. Se i pianificatori continuano a spostare le operazioni nel Capacity Scheduling Board, decidi quale sistema ha la precedenza. O la sincronizzazione successiva degli ordini importa la modifica in SkyPlanner, oppure quel centro di lavoro resta fuori dal perimetro di SkyPlanner.

• La scrittura in SAP richiede la chiamata a un’azione con un ETag. Il metodo documentato per schedulare un’operazione è ScheduleProductionOrderOperation, non un PATCH su A_ProductionOrderOperation_2. La modalità F schedula in avanti da una data di inizio e la modalità B a ritroso da una data di fine, mentre K e S mantengono le date esistenti e ignorano quelle inviate. L’ETag in if-match viene costruito a partire da LastChangeDateTime dell’ordine (YYYYMMDDHHMMSS), quindi qualsiasi modifica all’ordine lo rende obsoleto. Prevedere una lettura prima della scrittura e una coda per i tentativi successivi.
• La capacità non si trova nella testata del centro di lavoro. La capacità disponibile dipende dalla categoria di capacità (001 macchina, 002 manodopera), dal calendario di fabbrica e dagli intervalli e dai turni che ne sostituiscono le impostazioni. Le formule di capacità convertono i valori standard del ciclo di lavorazione in fabbisogni di attrezzaggio, lavorazione e smontaggio. Leggere A_WorkCenterCapacityInterval_2 e le entità dei turni, e concordare come tradurre le formule in durate in SkyPlanner.
• I valori standard vanno ripuliti. I cicli di lavorazione mantenuti ai fini del calcolo dei costi riportano spesso tempi medi di attrezzaggio, oppure tempi di attrezzaggio imputati alla categoria di capacità sbagliata.
• Le conferme seguono regole rigorose. SAP consiglia le chiamate batch per le registrazioni massive. Ogni change set viene eseguito interamente oppure non viene eseguito affatto: basta quindi una conferma tempi errata per bloccare tutte le altre del set. Gli annullamenti in un batch devono essere eseguiti in ordine inverso di ConfirmationCount. Non è possibile combinare tipi di conferma diversi per lo stesso ordine, registrare movimenti merci senza una conferma o confermare operazioni i cui punti di attivazione richiedono una finestra di dialogo.
• Verifica se PP/DS è attivo. PP/DS integrato richiede l’attività di Customizing Activate Advanced Planning and Scheduling e SAP HANA integrated liveCache. SAP lo vende come prodotto separato, SAP S/4HANA Manufacturing for planning and scheduling. Dove è attivo, decidi per ogni materiale quale sistema esegue la schedulazione: i materiali contrassegnati per la pianificazione avanzata sono di competenza di PP/DS. Per l’API degli ordini pianificati, SAP precisa inoltre: “Automatic integration to PP/DS is not enabled from this API.” (Questa API non abilita l’integrazione automatica con tale soluzione.)
• Unità di misura. Le quantità delle operazioni, le quantità base dei cicli di lavorazione e le unità delle conferme possono differire. Esegui una conversione esplicita usando l’unità dell’operazione, non l’unità di misura base del materiale.
• Differenze tra edizioni. SAP Learning mostra come la classica tabella di pianificazione CM21/CM22 venga sostituita da Manage Work Center Capacity, Capacity Scheduling Table e Capacity Scheduling Board. Public Edition espone le API solo tramite scenari di comunicazione e le versioni dei servizi disponibili possono differire da quelle on-premise. L’API dei cicli di lavorazione non può eliminare cicli né aggiornare le assegnazioni dei materiali. Durante la definizione del perimetro, il team SkyPlanner fissa le versioni dei servizi per il sistema di ciascun cliente, facendo riferimento alla voce dell’API Business Accelerator Hub relativa a quella release.
• Vincoli non contenuti nei cicli di lavorazione. Gestisci in SkyPlanner i cambi produzione dipendenti dalla sequenza, i conflitti nell’uso degli utensili e le operazioni con più operatori, anziché inserirli nei valori standard dei cicli di lavorazione. La matrice dei tempi di attrezzaggio contiene i tempi di cambio produzione per ogni coppia di prodotti. Gli utensili indicati nei PRT dell’ordine sono risorse a capacità finita, utilizzabili su un solo centro di lavoro alla volta, e un’operazione può richiedere più persone contemporaneamente.