Guida all’integrazione di Sage X3 con SkyPlanner APS per la schedulazione della produzione

La modalità di integrazione dipende dal modello di distribuzione. Sage X3 in cloud non espone alle applicazioni di terze parti né il file system dell’applicazione né il database: l’integrazione avviene quindi tramite API o trasferimento di file su un servizio ospitato. La versione on-premises consente anche l’importazione diretta di file e l’uso di tabelle di staging nel database X3.

Per usare GraphQL on-premises occorre aggiungere "bearer" all’array session.auth in nodelocal.js. Su Sage X3 SaaS, l’autenticazione delle app connesse è abilitata per impostazione predefinita. Su Sage X3 Cloud, l’app connessa non può usare l’utente admin: occorre invece creare un utente Syracuse con autenticazione Standard.

Quale interfaccia usare per ciascun flusso

• Prodotti, siti, acquisti e giacenze: GraphQL, come negli esempi ufficiali di Sage.
• Ordini di produzione, operazioni, cicli di lavorazione e centri di lavoro: rappresentazioni REST api1 o modelli di esportazione eseguiti tramite AOWSEXPORT. Nelle versioni in cui lo schema GraphQL espone il dominio di produzione (xtremX3Manufacturing), l’integrazione legge gli stessi dati tramite GraphQL.
• Invio a X3 delle date delle operazioni e dei centri di lavoro: servizio web SOAP Work order (GESMFG), operazione modify. In alternativa: modello di importazione tramite AOWSIMPORT.
• Avanzamento di produzione: servizio web SOAP Production tracking (GESMTK), operazione save.

La stessa architettura funziona con X3 in cloud e on-premises, perché non richiede alcun accesso diretto al file system o al database. Non si installa nulla in X3: l’integrazione utilizza un’applicazione connessa, un utente Syracuse e servizi web pubblicati in GESAWE.

Eventi: prevedere il polling

La documentazione pubblica di Sage X3 per gli sviluppatori non descrive funzionalità di webhook in uscita o di eventi di business. L’impostazione “Callback URL”, aggiunta in 2024 R1, serve a Mobile Automation e Web Scheduling quando chiamano i servizi web SOAP. Non è un sistema generico di gestione degli eventi. Rilevate le modifiche con letture programmate: query GraphQL, il cursore temporale della Sync API in cloud o esportazioni periodiche tramite modelli.

1. Caricamento iniziale delle anagrafiche. Caricate prima i centri di lavoro e i calendari, poi i prodotti, le distinte base e i cicli di lavorazione, perché questi ultimi fanno riferimento ai centri di lavoro.

2. Sincronizzazione degli ordini. Interrogate periodicamente MFGHEAD e MFGOPE per rilevare gli ordini di produzione nuovi e modificati. Associate ogni riga MFGOPE a una fase di lavorazione di SkyPlanner sul centro di lavoro identificato dal relativo codice WST. Sincronizzate gli ordini di acquisto aperti con la stessa frequenza. SkyPlanner considera il materiale ordinato disponibile alla data di consegna dell’ordine di acquisto e aggiorna le giacenze quando l’ordine passa allo stato Delivered. I controlli sui materiali coprono così sia le giacenze sia le forniture in arrivo.

3. Riscrittura della schedulazione in X3. Il webhook di SkyPlanner si attiva quando cambia la schedulazione. L’integrazione chiama l’operazione modify dell’oggetto Work order (GESMFG), pubblicato come servizio web SOAP in GESAWE. Aggiorna Start (OPESTR), End (OPEEND) e il centro di lavoro di ogni operazione modificata. Per gli aggiornamenti in batch, gli stessi campi vengono trasmessi tramite un modello di importazione degli ordini di produzione attraverso AOWSIMPORT. Scrivete solo date e centri di lavoro, mai quantità, righe di distinta base o cicli di lavorazione.

4. Scelta della macchina e restituzione a X3. Con una mappatura uno a uno dei centri di lavoro, la macchina scelta dal motore tra le alternative viene restituita come centro di lavoro dell’operazione. X3 registra così la macchina che esegue effettivamente l’operazione. Quando un centro di lavoro X3 rappresenta un gruppo di macchine, la coda dell’operatore mostra la singola macchina. X3 riceve invece il centro di lavoro del gruppo insieme alle date schedulate.

5. Conferme dal reparto produttivo. Gli operatori registrano il lavoro con Mobile Confirmations o Production Timer. L’integrazione invia ogni conferma tramite l’operazione save dell’oggetto Production tracking (GESMTK), registrando nell’avanzamento delle operazioni il tempo e la quantità e, se lo rilevate in quella sede, anche il consumo dei materiali. X3 accetta avanzamenti solo per ordini di produzione con stato Firm e i componenti devono essere disponibili, a meno che nell’anagrafica prodotto-sito non sia selezionata l’opzione Release if shortage (MFGSHTCOD).

6. Sincronizzazione affidabile. Usate l’ID della registrazione dei tempi di SkyPlanner come chiave per ogni invio di avanzamento e memorizzate il numero di avanzamento generato in X3, in modo che un webhook ripetuto non crei mai una doppia registrazione. Al polling successivo, rimuovete dalla schedulazione gli ordini di produzione chiusi o annullati in X3. Registrate le chiamate rifiutate insieme al messaggio di errore di X3, anziché ritentarle alla cieca. Quando X3 non è raggiungibile, accodate le modifiche per inviarle nell’ordine corretto non appena torna disponibile.

7. Regole di responsabilità sui dati. X3 gestisce ciò che viene prodotto: prodotto, quantità, distinta base, ciclo di lavorazione e sito. SkyPlanner gestisce quando e dove: sequenza, centro di lavoro e orari di inizio e fine. Concordate che i pianificatori smettano di rischedulare nel Planning workbench e di eseguire FUNMAUTJ sugli ordini gestiti da SkyPlanner. In caso contrario, le loro modifiche verranno sovrascritte alla successiva riscrittura dei dati in X3.

• Le proposte non sono ordini di produzione. Le proposte MRP non hanno righe di operazione MFGOPE finché non vengono convertite in ordini di produzione pianificati o confermati. Schedulate quindi gli ordini convertiti, non le proposte.
• Lacune nei calendari. Se una giornata lavorativa non ha una tabella oraria, viene applicato lo schema predefinito DEFDIH. Una giornata vuota senza schema predefinito genera date e carichi errati. Prima di esportare i calendari, assegnate una tabella oraria a ogni giornata lavorativa di ciascuna struttura settimanale.
• Carichi per periodo non aggiornati. Dopo una modifica alla capacità o al calendario, i carichi per periodo già presenti in X3 non si aggiornano finché non eseguite una nuova schedulazione e avviate Recalculate loads (FUNMIWL). Non verificate SkyPlanner confrontandolo con dati non aggiornati di Loads inquiry (CONSMWK).
• No. of resources indica il numero di addetti della squadra. WSTNBR è il numero di risorse necessarie a un’operazione presso il centro di lavoro, ad esempio tre persone in un centro di lavoro composto da risorse umane. Associatelo al numero di operatori del centro di lavoro SkyPlanner, che consente di schedulare più persone contemporaneamente sulla stessa operazione. Negli stabilimenti che utilizzavano l’interfaccia avanzata GFS, il valore è impostato su 1, come richiesto da Sage: verificate quindi dove è registrato il numero effettivo di addetti.
• Le operazioni del ciclo di lavorazione prive di centro di lavoro non possono essere assegnate a un centro di lavoro SkyPlanner. Vengono segnalate durante la mappatura.
• Unità di tempo e centri di lavoro sostitutivi. I tempi del ciclo di lavorazione hanno una propria unità di tempo (TIMUOMCOD) e i centri di lavoro sostitutivi hanno una priorità. Mappate entrambi esplicitamente e ripetete il controllo della mappatura dopo ogni aggiornamento di X3.
• Ordini bloccati. Se lo stabilimento utilizzava anche Production Scheduler, gli ordini inviati a quel sistema hanno lo stato Being optimized e non possono essere modificati finché non vengono rimossi dalla schedulazione (PSOPTFREE). Sbloccateli prima del passaggio al nuovo sistema.

Scegli SkyPlanner se vuoi essere operativo in poche settimane, non dopo un progetto APS lungo mesi.

Il prezzo parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. Il preventivo per l’integrazione viene preparato in anticipo in base al tuo processo e alle tue esigenze, insieme al piano scelto, così conosci il costo complessivo prima di iniziare. Consulta prezzi e funzionalità, oppure avvia la prova gratuita di 30 giorni con un massimo di 20 centri di lavoro, senza carta di credito.