Guida all’integrazione di Epicor Kinetic per la schedulazione della produzione con SkyPlanner APS

Epicor dichiara: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Tutti i servizi Kinetic, inclusi oggetti di business, processi, report, BAQ ed Epicor Functions, sono accessibili tramite endpoint REST.) L’integrazione per la schedulazione si basa su quattro tecnologie Epicor:

1. Kinetic REST API v2 (OData v4). Gli oggetti di business sono esposti come servizi denominati Erp.BO.<Name>Svc. Il percorso abituale è /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 è ancora disponibile, ma è una versione legacy: per le nuove integrazioni usate v2. Verificate gli insiemi di entità e i metodi disponibili per la vostra versione nella REST Help all’indirizzo /api/help/v2/.
2. Business Activity Queries (BAQ) tramite REST. Una BAQ è esposta all’indirizzo /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. È una soluzione pratica per leggere i dati necessari alla pianificazione, unendo JobHead, JobOper, JobMtl, PartWhse e PORel in un’unica chiamata (esempio della community).
3. Epicor Functions (EFx). Funzioni lato server richiamabili all’indirizzo /api/v2/efx/{Company}/{Library}/{Function}. Epicor dichiara che “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (possono essere attivate da più punti di ingresso, tra cui BPM, servizi REST, esecuzioni pianificate ed eventi applicativi).
4. Direttive BPM. Le Method Directives e le Data Directives si attivano quando un ordine di produzione o un’operazione cambia e possono richiamare una funzione che invia i dati all’esterno.

Per lo scambio di file, DMT gestisce le importazioni, mentre le esportazioni BAQ consentono di estrarre i dati in uscita. Epicor offre anche Epicor Automation Studio, che descrive come “a low-code app for integration-led automations” (un’applicazione low-code per automazioni basate sull’integrazione). Evitate l’accesso diretto al database: REST, BAQ e funzioni operano allo stesso modo sia in locale sia su Kinetic Cloud.

Epicor non documenta un’API generica per i webhook in uscita, quindi le modifiche di Kinetic raggiungono SkyPlanner in uno di questi due modi:

• Su evento. Una BPM Data Directive su JobHead o JobOper richiama una Epicor Function, che invia l’ordine di produzione modificato alla REST API di SkyPlanner.
• Polling programmato. Una BAQ filtrata per data di modifica viene eseguita ogni pochi minuti oppure ogni ora. È più semplice da gestire e da ripristinare in caso di errore.

Nella direzione opposta, SkyPlanner invia le modifiche di stato e di schedulazione tramite i propri webhook. Il vostro middleware o un endpoint EFx le riceve e le scrive in Kinetic.

1. Caricamento iniziale delle anagrafiche. Leggete articoli, gruppi di risorse produttive, risorse produttive, capacità di lavorazione, calendari e dipendenti. Create i centri di lavoro SkyPlanner a partire dalle risorse di Kinetic e i gruppi di centri di lavoro a partire dai gruppi di risorse. Per leggere grandi volumi di dati, usate la paginazione con $top e $skip, oppure estraete i dati in blocco tramite una BAQ.

2. Sincronizzazione degli ordini. Inviate gli ordini di produzione rilasciati e confermati, completi di operazioni e materiali. Recuperate l’intera struttura dell’ordine con GetDatasetForTree o una BAQ, anziché leggere un’entità alla volta. Lasciate in Kinetic gli ordini MRP non confermati finché non vengono confermati. Insieme alla lettura delle giacenze, sincronizzate le consegne aperte degli ordini di acquisto con le relative date previste. SkyPlanner considera il materiale ordinato disponibile alla data di consegna e aggiorna le giacenze quando l’ordine di acquisto viene contrassegnato come Delivered. La schedulazione tiene quindi conto sia delle giacenze sia degli acquisti in arrivo.

3. Scrittura della schedulazione in Kinetic. Il webhook di SkyPlanner invia l’inizio, la fine e il centro di lavoro pianificati per ogni operazione a un endpoint EFx (/api/v2/efx/{Company}/{Library}/{Function}). La funzione scrive i dati tramite il motore di schedulazione di Kinetic, lo stesso oggetto di business usato dalla schedulazione in Job Entry e dai pannelli di schedulazione (esempio della community):

1. ScheduleEngine.GetNewParamsForJob crea il dataset del motore di schedulazione per l’ordine di produzione.
2. La funzione imposta il numero dell’ordine di produzione, i numeri di sequenza dell’assieme e dell’operazione, la data e l’ora di inizio pianificate, quindi richiama ScheduleEngine.MoveJobItem.
3. Se SkyPlanner ha assegnato l’operazione a un’altra risorsa produttiva del gruppo, ScheduleEngine.ChangeResource la sposta su quella risorsa. Usato da solo, MoveJobItem mantiene la risorsa predefinita del gruppo.
4. La funzione attiva il blocco della schedulazione dell’ordine di produzione (JobHead.SchedLocked, l’opzione Lock in Job Entry), così Global Scheduling mantiene le date di SkyPlanner.

Racchiudere queste chiamate in un’unica Epicor Function mantiene atomica la scrittura per ogni ordine di produzione e permette di aggiungere controlli di validazione personalizzati. Se lo stabilimento preferisce non usare una funzione personalizzata, la stessa sequenza può essere eseguita con chiamate REST dirette a Erp.BO.ScheduleEngineSvc. Non scrivete mai direttamente in ResourceTimeUsed o nei campi data di JobOper: così facendo si aggira il motore e le assegnazioni nei pannelli di schedulazione perdono la sincronizzazione.

4. Consuntivazioni di reparto. Gli operatori registrano il lavoro in SkyPlanner con Mobile Confirmations, Production Timer o Quick Log Mode. Ogni registrazione dei tempi chiusa diventa una registrazione di manodopera in Kinetic tramite Erp.BO.LaborSvc: StartActivity e EndActivityByEmp per le attività registrate in tempo reale, oppure Labors con Update per quelle inserite a posteriori. Se il vostro stabilimento richiede l’approvazione, includete submitForApproval nel flusso e nell’ambito delle autorizzazioni.

5. Responsabilità sui dati e gestione dei conflitti. Definite queste regole per iscritto prima della messa in produzione:

Gli ordini di produzione schedulati da SkyPlanner hanno il blocco della schedulazione attivo, quindi Global Scheduling non ne modifica le date. Mantenete la schedulazione di Kinetic per le risorse produttive non pianificate da SkyPlanner.

L’implementazione viene normalmente completata entro poche settimane dall’inizio dell’avviamento. Un progetto Kinetic comprende:

1. Una prova di 30 giorni con esportazioni CSV o Excel di ordini di produzione, operazioni e risorse produttive, prima di qualsiasi attività di sviluppo.
2. Chiave API, ambito di accesso, un utente dedicato all’integrazione e le BAQ lette dall’integrazione.
3. Mappatura delle anagrafiche: capacità di lavorazione, gruppi di risorse produttive, risorse produttive, calendari e dipendenti vengono associati a postazioni di lavoro, gruppi, turni e personale in SkyPlanner.
4. Caricamento iniziale di articoli, metodi di produzione (BOM e operazioni) e risorse produttive.
5. Sincronizzazione degli ordini di produzione e degli ordini di acquisto (date di consegna di PORel), oltre alle giacenze di PartWhse.
6. Scrittura in Kinetic delle date pianificate delle operazioni tramite ScheduleEngineSvc (MoveJobItem, ChangeResource) in una Epicor Function, con il blocco della schedulazione dell’ordine di produzione attivato.
7. Invio delle consuntivazioni di reparto come registrazioni di manodopera tramite LaborSvc.
8. Test in parallelo con la schedulazione attuale di Kinetic, seguiti dalla messa in produzione.

Ogni stabilimento usa Kinetic in modo diverso. I cicli basati sulle capacità di lavorazione, i calendari dei gruppi di risorse, la struttura delle BAQ, le direttive BPM e i metodi di scrittura disponibili nelle singole versioni cambiano da sito a sito. Configurarli correttamente fa la differenza tra una schedulazione di cui i pianificatori si fidano e una che devono rielaborare.

1. Il team SkyPlanner configura l’integrazione durante l’avviamento e fornisce assistenza dopo la messa in produzione. Il team mappa le vostre risorse produttive, gli ordini di produzione e le consegne programmate degli ordini di acquisto, poi configura le letture delle BAQ, i trigger BPM e la funzione che riporta i dati in Kinetic. Collega l’API REST e i webhook di SkyPlanner a Kinetic REST v2. L’assistenza prosegue anche quando cambiano le vostre BAQ, le BPM o la versione di Kinetic.
2. Il vostro partner Epicor. I partner che sviluppano già BAQ, BPM ed Epicor Functions possono lavorare sulla stessa API REST documentata di SkyPlanner, che legge e scrive ordini, prodotti, materiali, fasi di lavorazione e registrazioni dei tempi.
3. I vostri sviluppatori. I team interni con esperienza nei servizi REST di Kinetic possono sviluppare direttamente, oppure usare Automation Studio se è già in uso. Per iniziare basta una chiave API SkyPlanner (tutorial di integrazione), e il team SkyPlanner fornisce assistenza quando serve. La documentazione del prodotto è pubblica nella documentazione SkyPlanner.

Lo stesso modello basato su API e webhook è già in uso in produzione con altri ERP, ad esempio presso UTU. In Laboratory & Allied, il team IT interno ha realizzato l’integrazione con SAP Business One in gran parte autonomamente, con il supporto di SkyPlanner.

Qualunque percorso scegliate, il punto di partenza è lo stesso: iniziate con la prova gratuita di 30 giorni importando file CSV, verificate la schedulazione e poi realizzate l’integrazione. I prezzi partono da 199 € al mese con 5 postazioni di lavoro, fatturazione mensile e possibilità di disdire in qualsiasi momento. Il preventivo dell’integrazione viene definito in anticipo in base al vostro processo e alle vostre esigenze, insieme al piano scelto, così conoscete il costo complessivo prima di iniziare.