Integrazioni / ERP / Oracle Fusion Cloud
Guida all’integrazione di Oracle Fusion Cloud per la schedulazione della produzione con SkyPlanner APS
Questa guida all’integrazione di Oracle Fusion Cloud spiega a partner e team IT come collegare Oracle Fusion Cloud Manufacturing a SkyPlanner APS. SkyPlanner si integra con Oracle Fusion Cloud in entrambe le direzioni, utilizzando le risorse REST di Oracle:
- Vengono importati gli ordini di produzione con le relative operazioni, le definizioni di lavoro, i centri di lavoro, le risorse produttive, i calendari, gli articoli, le strutture articolo, le giacenze e gli ordini di acquisto.
- Le date pianificate di inizio e completamento vengono riportate su ciascuna operazione dell’ordine di produzione.
- Le conferme degli operatori vengono registrate in Oracle come transazioni delle operazioni e delle risorse.
- I webhook di SkyPlanner inviano le modifiche alla schedulazione nel momento in cui avvengono.
Durante l’avviamento, il team SkyPlanner configura l’integrazione in base al tuo ambiente Oracle Fusion Cloud e fornisce assistenza dopo la messa in produzione. Questa guida si rivolge ai partner e agli sviluppatori che vogliono partecipare al progetto o sviluppare autonomamente un’integrazione tramite la REST API documentata di SkyPlanner (documentazione API).
Le interfacce di integrazione di Oracle Fusion Cloud
Oracle Fusion Cloud offre a uno schedulatore esterno tre modalità di scambio dei dati:
- REST API per Oracle Fusion Cloud SCM. Il percorso di base è
/fscmRestApi/resources/11.13.18.05/. Le risorse utilizzate da uno schedulatore sonoworkOrders(con le risorse figlieWorkOrderOperation,WorkOrderOperationResourceeWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructureseinventoryOnhandBalances. Gli avanzamenti vengono registrati tramiteoperationTransactions,resourceTransactionsematerialTransactions. Gli ordini di acquisto provengono dapurchaseOrdersnella Procurement REST API. (Endpoint REST) - File-Based Data Import (FBDI). Il processo Import Work Orders crea o aggiorna gli ordini di produzione, con le relative operazioni e risorse, a partire da un modello. Import Work Order Resource Transactions carica invece le registrazioni delle risorse. Sulle tempistiche Oracle è chiara: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Questa opzione non è adatta all’importazione di dati di produzione in tempo reale.) (Fonte)
- Oracle Integration (OIC). La piattaforma di integrazione di Oracle gestisce i flussi tra Fusion e altri sistemi. Una ricetta di Oracle Integration intercetta l’evento Work Order Status Change in Oracle Fusion Cloud Manufacturing (fonte). Utilizzala se la tua azienda usa già OIC.
Per la schedulazione in tempo reale, REST è la modalità principale. FBDI è adatto al caricamento iniziale delle anagrafiche.
Autenticazione e accesso
- Sicurezza REST di Oracle. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (Le REST API di Fusion Applications utilizzano una policy di sicurezza globale di Oracle Web Services Manager (OWSM), denominata Multi Token Over SSL RESTful Service Policy.) Sono accettate l’autenticazione Basic su SSL e l’autenticazione basata su token, ad esempio un bearer token SAML 2.0. (Guida rapida)
- Utente di integrazione. Crea un utente Oracle dedicato all’integrazione, con ruoli che concedano i privilegi necessari per ordini di produzione, definizioni di lavoro, scorte e transazioni. Limita l’accesso alle organizzazioni produttive incluse nel perimetro del progetto.
- Paginazione. Oracle limita il numero di record restituiti da una singola chiamata SCM REST. Leggi quindi i dati usando
limiteoffsete applica filtri per organizzazione e stato (fonte)
Sul lato SkyPlanner, la REST API usa un token API nell’header Authorization-Token per l’autenticazione (SkyPlanner Settings > API) ed è documentata in Swagger/OpenAPI. Il tutorial di integrazione ti guida nelle prime chiamate.
Eventi e polling
Sul lato Oracle, i dati vengono letti tramite polling. Le query REST con filtri recuperano gli ordini di produzione nuovi e modificati, i passaggi allo stato rilasciato, le giacenze e gli ordini di acquisto. La frequenza viene definita per ogni stabilimento: da pochi minuti per gli ordini di produzione a un’ora per le scorte. Se utilizzi Oracle Integration, l’evento Work Order Status Change può attivare una lettura immediata.
SkyPlanner invia webhook quando cambia lo stato o la schedulazione: il flusso di scrittura verso Oracle è quindi basato su eventi.
Mappatura dei dati
| Oggetto Oracle Fusion Cloud (risorsa REST) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
Articoli (itemsV2), unità di misura | Prodotti e materiali | Oracle → SkyPlanner | Caricamento iniziale, poi polling |
Strutture articolo (itemStructures) | Struttura del prodotto, sottoprodotti, materiali per prodotto | Oracle → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Definizioni di lavoro (workDefinitions): operazioni, risorse delle operazioni, impiego, Basis Type | Fasi di processo con durate, tempi di attrezzaggio e disattrezzaggio | Oracle → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Centri di lavoro (workCenters), risorse produttive (productionResources) per attrezzature e manodopera | Centri di lavoro, gruppi di centri di lavoro, personale, efficienze | Oracle → SkyPlanner | Caricamento iniziale, raramente in seguito |
Calendari e turni (calendars, eccezioni ai turni) | Turni e giorni non lavorativi | Oracle → SkyPlanner | Ogni giorno, oppure gestione dei turni in SkyPlanner |
| Organizzazioni produttive | Gruppi di centri di lavoro per stabilimento | Oracle → SkyPlanner | Caricamento iniziale |
Ordini di produzione (workOrders, processWorkOrders) con WorkOrderOperation e WorkOrderOperationMaterial | Ordini e operazioni con scadenze e fabbisogni di materiali | Oracle → SkyPlanner | Polling ogni pochi minuti |
Giacenze (inventoryOnhandBalances) | Giacenze di magazzino | Oracle → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
Ordini di acquisto (purchaseOrders) con date di consegna confermate | Ordini di acquisto, materiali in arrivo per data di consegna | Oracle → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Inizio e fine pianificati per ogni operazione | SkyPlanner → Oracle | A ogni modifica della schedulazione, tramite webhook di SkyPlanner |
Date di WorkOrderOperationResource (PATCH) | Assegnazione delle risorse produttive per ogni operazione | SkyPlanner → Oracle | A ogni modifica della schedulazione, se previsto |
operationTransactions (POST) | Quantità completate per operazione | SkyPlanner → Oracle | A ogni conferma |
resourceTransactions (POST) | Registrazioni dei tempi: manodopera e tempo macchina | SkyPlanner → Oracle | A ogni conferma o per turno, se previsto |
| Non presente in Oracle Fusion Cloud | Matrice dei tempi di attrezzaggio, utensili come risorse a capacità finita, macchine e personale alternativi | Gestiti in SkyPlanner | Configurati durante l’avviamento |
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Leggi articoli, strutture articolo, definizioni di lavoro, centri di lavoro, risorse produttive e calendari tramite REST, oppure caricali una sola volta da estrazioni FBDI. Definisci con attenzione la mappatura dei centri di lavoro: un centro con quattro macchine associate alla stessa risorsa diventa un gruppo di centri di lavoro oppure quattro centri di lavoro. Ogni organizzazione produttiva diventa un gruppo di centri di lavoro, così tutti gli stabilimenti rientrano in un unico piano.
2. Sincronizzazione degli ordini di produzione. Leggere gli ordini di produzione rilasciati e non rilasciati, con le relative operazioni e i materiali, insieme agli ordini di acquisto aperti. SkyPlanner considera il materiale ordinato disponibile alla data di consegna dell’ordine di acquisto e aggiorna le giacenze quando l’ordine viene contrassegnato come Delivered.
Schedulare gli ordini di produzione, non gli ordini pianificati di Supply Planning. Gli ordini pianificati devono prima essere convertiti in ordini di produzione in Oracle.
3. Scrittura della schedulazione in Oracle. Quando il motore inserisce o sposta un’operazione, un webhook di SkyPlanner attiva una PATCH su workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} con PlannedStartDate e PlannedCompletionDate. Si applica la regola di Oracle: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (La data di inizio pianificata non deve precedere la data di inizio dell’ordine di produzione né essere successiva alla sua data di fine.) (fonte) Quindi, se la nuova schedulazione supera questi limiti, l’integrazione aggiorna tramite PATCH prima le date di testata dell’ordine di produzione, poi le operazioni.
4. Consuntivazione in reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer e le registrazioni dei tempi mantengono aggiornata la schedulazione. Le quantità completate vengono inviate a operationTransactions, mentre i tempi di manodopera e macchina vengono inviati a resourceTransactions. Se lo stabilimento registra già gli avanzamenti in Oracle, SkyPlanner li legge da lì.
5. Responsabilità sui dati e regole per i conflitti. Documentarle prima dell’avvio in produzione:
| Dati | Sistema responsabile |
|---|---|
| Articoli, strutture degli articoli, definizioni di lavorazione, quantità, stato degli ordini di produzione | Oracle Fusion Cloud |
| Sequenza delle operazioni, orari di inizio e completamento, assegnazione delle risorse produttive | SkyPlanner |
| Matrice dei tempi di attrezzaggio, requisiti di utensili e operatori, risorse produttive alternative | SkyPlanner |
| Turni e giorni non lavorativi | Un solo sistema, scelto durante la definizione del perimetro |
| Transazioni relative a risorse produttive, operazioni e materiali | Oracle, con inserimento diretto o invio dalle registrazioni dei tempi di SkyPlanner |
Scegliere un solo sistema per la scrittura delle date delle operazioni. SkyPlanner non richiede un’area di lavoro di schedulazione in Oracle e sostituisce quindi Production Scheduling nella scrittura delle date pianificate. Se Production Scheduling continua a rilasciare schedulazioni, mantenere separate le organizzazioni che gestisce da quelle schedulate da SkyPlanner.
Le fasi tipiche del progetto
L’implementazione si conclude normalmente nel giro di settimane dall’inizio dell’onboarding, anche nelle grandi aziende. Prima di questa fase, validare la schedulazione durante la prova gratuita di 30 giorni, utilizzando centri di lavoro, definizioni di lavorazione e ordini di produzione aperti esportati da Oracle in formato CSV o Excel.
- Mappatura. Definire la tabella di mappatura, le responsabilità sui dati, le organizzazioni incluse nel perimetro, le frequenze di sincronizzazione e se inviare le transazioni a Oracle.
- Accesso a Oracle. Creare l’utente di integrazione e i ruoli. Eseguire prima i test in un ambiente Oracle non di produzione.
- Caricamento iniziale. Articoli, strutture degli articoli, definizioni di lavorazione, centri di lavoro, risorse produttive e calendari.
- Sincronizzazione degli ordini di produzione e di acquisto. Polling con filtri, paginazione e tentativi automatici in caso di errore.
- Configurazione dei vincoli in SkyPlanner. Matrice dei tempi di attrezzaggio, utensili, numero di operatori per operazione e macchine o personale alternativi.
- Scrittura della schedulazione in Oracle. PATCH attivate dai webhook di SkyPlanner e invio delle transazioni, se previsto.
- Test in parallelo. Usare SkyPlanner in parallelo alla pianificazione attuale, confrontare le date e correggere le anagrafiche.
- Avvio in produzione. Attivare la scrittura in Oracle uno stabilimento alla volta, una volta verificata la corrispondenza dei dati.
Aspetti da prevedere nell’integrazione con Oracle Fusion Cloud
- Comportamento predefinito dello schedulatore. Il motore Oracle senza vincoli si attiva alla creazione e in occasione di “certain update actions.” (determinate azioni di aggiornamento). Verificare nel proprio ambiente quali aggiornamenti ricalcolano le date e fare in modo che SkyPlanner sia l’ultimo sistema a scrivere le date delle operazioni.
- Finestre temporali degli ordini di produzione. Le date delle operazioni devono rientrare tra le date di inizio e completamento dell’ordine di produzione. Aggiornare prima la testata tramite PATCH.
- Basis Type. L’utilizzo della risorsa produttiva è espresso per unità solo quando Basis Type è Variable. Con Fixed, il tempo è fisso per operazione. Eseguire la conversione durante l’importazione, altrimenti tutte le durate saranno errate.
- Produzione discreta e di processo. Gli stabilimenti con produzione discreta usano
workOrders, quelli con produzione di processoprocessWorkOrders. Mappare entrambi se si utilizzano entrambe le modalità. - Paginazione. Oracle limita il numero di record per chiamata REST. Paginare ogni query e filtrare per organizzazione e stato.
- Aggiornamenti trimestrali. Oracle aggiorna Fusion ogni trimestre. Fissare la versione REST nel percorso e ripetere i test dopo ogni aggiornamento.
- Regole sugli stati. Gli ordini di produzione in stato Pending Approval o chiusi non devono ricevere nuove date. Escluderli con un filtro in lettura.
Chi configura e supporta l’integrazione con Oracle Fusion Cloud
- Il team SkyPlanner configura l’integrazione durante l’onboarding e fornisce assistenza dopo l’avvio in produzione, per le risorse REST e le organizzazioni concordate. Ogni stabilimento utilizza Oracle Fusion Cloud in modo diverso: è qui che entra in gioco questa competenza.
- Il tuo partner Oracle può partecipare. Conosce le tue organizzazioni, i ruoli e le estensioni e può configurare l’utente di integrazione, i ruoli e gli eventuali flussi di Oracle Integration insieme al team SkyPlanner.
- I tuoi sviluppatori possono estendere l’integrazione utilizzando la REST API di SkyPlanner con un token API. Per iniziare basta un token API e il team SkyPlanner offre assistenza quando serve. Le istruzioni sono disponibili nella documentazione di integrazione di SkyPlanner.
SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. L’integrazione viene preventivata in anticipo in base ai tuoi processi e alle tue esigenze, insieme al piano scelto. Consulta i prezzi, la schedulazione della produzione a capacità finita con Oracle Fusion Cloud, la pagina Oracle Fusion Cloud e la panoramica delle integrazioni ERP. Usi NetSuite? Consulta la guida all’integrazione con NetSuite.
Recensioni di SkyPlanner da aziende manifatturiere
2 hrisparmiate ogni settimana
“Con SkyPlanner siamo passati dai fogli Excel per la pianificazione della produzione all’ottimizzazione della produzione in tempo reale.”
Kalle Kalliomäki, specialista della supply chain
UTU · Quadri e apparecchiature elettriche
La pianificazione della produzione fa risparmiare 2 ore di lavoro ogni settimana e una nuova coda di lavoro arriva in linea in pochi secondi.
+90%di efficienza produttiva
“L’efficienza in produzione è aumentata del 90%.”
Abdul Rucyinga, responsabile IT
Laboratory & Allied · Produzione farmaceutica
L’efficienza produttiva è aumentata del 90% e bastano meno di 30 minuti per ottenere un piano ottimizzato di tre mesi per tutti i centri di lavoro.
99,2%di affidabilità delle consegne
“SkyPlanner ci ha dato la visibilità necessaria per individuare i colli di bottiglia e ha reso più chiara la gestione della produzione.”
Toni Tuori, responsabile di produzione
Piristeel · Sistemi di sicurezza per tetti e di raccolta delle acque piovane
Quest’anno l’affidabilità delle consegne ha raggiunto il 99,2% e la schedulazione fa risparmiare fino a quattro ore di lavoro al giorno.
1,000 e oltreordini di produzione schedulati automaticamente
“Il nostro controllo sulla produzione è cambiato e la nostra conoscenza della capacità produttiva è a un livello completamente diverso.”
Hannu Ryynänen, amministratore delegato
Mamec · Miscelatori industriali, pompe e produzione conto terzi ad alta tecnologia
Migliaia di ordini di produzione vengono schedulati automaticamente, con una visione della produzione in tempo reale per tutta l’organizzazione.
Domande frequenti
Oracle Fusion Cloud dispone di un’API per gli ordini di produzione?
Sì. La REST API di Oracle Fusion Cloud SCM offre workOrders con risorse figlie per operazioni, risorse produttive e materiali, oltre a processWorkOrders per la produzione di processo. Supporta GET, POST e PATCH.
Come vengono scritte le date pianificate in Oracle Fusion Cloud?
Con una PATCH sulla risorsa figlia WorkOrderOperation dell’ordine di produzione, impostando PlannedStartDate e PlannedCompletionDate. Le date delle operazioni devono rientrare nelle date dell’ordine di produzione, quindi, quando necessario, si aggiorna prima la testata tramite PATCH.
Come arrivano a Oracle le consuntivazioni degli operatori?
Le quantità completate vengono inviate a operationTransactions, mentre i tempi di manodopera e macchina vengono inviati a resourceTransactions. Entrambe sono risorse REST di Fusion Manufacturing che supportano POST.
Oracle Fusion Cloud supporta i webhook?
Fusion pubblica eventi di business come Work Order Status Change, ai quali Oracle Integration può sottoscriversi. Senza Oracle Integration, l’integrazione interroga la REST API con una frequenza definita per ogni stabilimento. I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono.
Un partner Oracle dovrebbe proporre Oracle Production Scheduling o SkyPlanner?
SkyPlanner, quando il cliente vuole un’unica schedulazione della produzione a capacità finita per tutti gli stabilimenti, che si mantenga aggiornata automaticamente. Production Scheduling si abilita nell’offerta Supply Chain Planning, elabora la schedulazione per singola organizzazione di schedulazione e applica le regole di cambio produzione solo alle attrezzature a unità singola (documentazione Oracle). SkyPlanner si collega tramite la SCM REST API, ricalcola automaticamente la schedulazione, pianifica cambi produzione, utensili, squadre e materiali e include utenti illimitati, a partire da 199 € al mese.
È possibile provare SkyPlanner prima di realizzare l’integrazione?
Sì. La prova gratuita di 30 giorni supporta fino a 20 centri di lavoro con importazioni da Oracle in formato CSV o Excel, senza carta di credito. Inizia la prova oppure contatta il reparto commerciale per definire il perimetro dell’integrazione.