Integrazioni / ERP / JobBOSS²
Guida all’integrazione di JobBOSS² per la schedulazione della produzione con SkyPlanner APS
Questa guida spiega a partner e team IT come collegare JobBOSS² di ECI a SkyPlanner APS. L’integrazione tra SkyPlanner e JobBOSS² è bidirezionale e utilizza le API di ECI:
- Vengono importati Orders e Order Line Items, Order Routings, Estimates, Routings e materiali, Work Centers, Employees, Company Calendar, Job Requirements e righe degli ordini di acquisto.
- Le date di inizio e fine pianificate vengono riscritte in ogni fase di Order Routing.
- Se lo desideri, le registrazioni dei tempi degli operatori possono essere inviate a JobBOSS² come Time Ticket Details.
- I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono.
Durante l’avviamento, il team SkyPlanner configura l’integrazione in base al tuo ambiente JobBOSS² e continua a fornire assistenza dopo la messa in produzione. Questa guida è rivolta ai partner e agli sviluppatori che vogliono partecipare al progetto o sviluppare autonomamente sulla REST API documentata di SkyPlanner (documentazione API). Un’azienda statunitense che produce su commessa lo ha già fatto:
Le interfacce di integrazione di JobBOSS²
ECI pubblica le proprie API per la produzione, corredate di specifiche OpenAPI, sul sito ECI Manufacturing API Documentation. Per la schedulazione ne interessano due:
- JobBOSS² API (v1). Specifica per JobBOSS², utilizza REST e JSON. Consente di leggere e scrivere ordini, Order Line Items, Order Routings, Estimates, Routings, materiali, Job Requirements, Work Centers, Company Calendar, Employees, ordini di acquisto, Time Tickets e Time Ticket Details. ECI dichiara che “is currently only supported for JobBOSS² hosted (Cloud) customers.” (Al momento è supportata solo per i clienti JobBOSS² ospitati nel cloud.)
- ECI ERP API (v2.1). Una REST API indipendente dal prodotto, per Deacom, M1 e JobBOSS². Per JobBOSS² gestisce commesse, operazioni e materiali delle commesse, articoli, operazioni degli articoli, centri di lavoro, righe degli ordini di acquisto e righe delle registrazioni dei tempi. ECI precisa che “the actual ERP database could be a cloud hosted ERP or on premises install,” (Il database ERP può essere ospitato nel cloud o installato in locale), quindi questa è l’interfaccia da usare per JobBOSS² in locale.
Entrambe le API adottano le stesse convenzioni: espressioni di filtro come lastModDate[gte]=, un parametro fields=, sort= e paginazione con take e skip, dove il valore predefinito di take è 200. “All dates submitted to the API are assumed to be in UTC.” (Tutte le date inviate all’API sono considerate in UTC.)
Per entrambe vale la regola di ECI: “All APIs must be activated by ECI before use.” (Tutte le API devono essere attivate da ECI prima dell’uso.) Contatta per tempo il tuo referente commerciale ECI.
Autenticazione e accesso
- Utenti API. L’integrazione utilizza un utente API creato nella Integration Engine Management Console di ECI. L’utente API determina a quale prodotto, cliente e database vengono indirizzate le chiamate.
- Credenziali client OAuth 2.0. Il client ID e il segreto consentono di ottenere un token dall’endpoint token di Authentication API. Ogni chiamata invia poi
Authorization: Bearer [token]. - Ambito di accesso. Concedi all’utente API l’accesso solo alle risorse necessarie per la tabella di mappatura qui sotto.
Sul lato SkyPlanner, la REST API utilizza un token API per l’autenticazione (SkyPlanner Settings > API) ed è documentata in Swagger/OpenAPI. Il tutorial di integrazione ti guida nelle prime chiamate.
Eventi e polling
Nessuna delle due API di ECI documenta webhook. Sul lato JobBOSS² si usa il polling: filtra Order Line Items, Order Routings e righe degli ordini di acquisto in base a lastModDate dall’ultima esecuzione, usando take e skip per la paginazione. La frequenza viene definita per ogni officina: da pochi minuti per le commesse a un’ora per le giacenze.
SkyPlanner invia webhook quando cambiano lo stato o il programma di produzione, quindi la scrittura di ritorno è basata su eventi.
Mappatura dei dati
| Oggetto JobBOSS² (risorsa di JobBOSS² API) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
Estimates (/estimates), materiali (/materials) | Prodotti, materiali, struttura del prodotto | JobBOSS² → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Routings (/routings): centro di lavoro, tempo di attrezzaggio, tempo ciclo, numero di addetti, macchine per l’operazione | Fasi del ciclo di lavorazione con durate e tempi di attrezzaggio | JobBOSS² → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Work Centers (/work-centers): ore per turno, attività sui turni da 1 a 3, giorni lavorativi | Centri di lavoro, gruppi di centri di lavoro, efficienze | JobBOSS² → SkyPlanner | Caricamento iniziale, raramente in seguito |
Company Calendar (/company-calendars), Employees (/employees) | Turni, giorni non lavorativi, personale | JobBOSS² → SkyPlanner | Ogni giorno, oppure gestione dei turni in SkyPlanner |
Orders e Order Line Items (/order-line-items): numero commessa, data di consegna, priorità, quantità da produrre | Ordini con date di consegna e priorità | JobBOSS² → SkyPlanner | Polling ogni pochi minuti |
Order Routings (/order-routings): fasi della commessa, stato, ore residue | Operazioni per ciascuna fase del ciclo di lavorazione | JobBOSS² → SkyPlanner | Polling ogni pochi minuti |
Job Requirements (/job-requirements), righe degli ordini di acquisto (/purchase-order-line-items) | Fabbisogni di materiali, ordini di acquisto per data di consegna | JobBOSS² → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Inizio e fine pianificati, macchina e operatore per ogni fase | SkyPlanner → JobBOSS² | A ogni modifica del programma, tramite webhook SkyPlanner |
| Time Ticket Details (POST): commessa, fase, centro di lavoro, dipendente, tempo di attrezzaggio, tempo ciclo, pezzi finiti e scartati, ora di inizio e fine | Registrazioni dei tempi e conferme degli operatori | SkyPlanner → JobBOSS² | A ogni conferma o a ogni turno, se si sceglie questa opzione |
| Non presenti in JobBOSS² | Matrice dei tempi di attrezzaggio, utensili come risorse a capacità finita, macchine e personale alternativi | Gestiti in SkyPlanner | Configurati durante l’avviamento |
Per JobBOSS² in locale, gli stessi oggetti vengono letti tramite le risorse di ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers e /purchase-order-lines, mentre le registrazioni dei tempi vengono inviate a /timecard-lines.
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Leggi Estimates, Routings, materiali, Work Centers, Company Calendar ed Employees. Definisci con cura la mappatura dei centri di lavoro: un centro con quattro torni diventa un gruppo di centri di lavoro oppure quattro centri di lavoro, così SkyPlanner può mettere in sequenza le operazioni di ogni macchina.
2. Sincronizzazione delle commesse. Leggi gli Order Line Items aperti con i relativi Order Routings, Job Requirements e righe aperte degli ordini di acquisto. 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. Escludi le commesse sospese e quelle chiuse.
3. Scrittura di ritorno del programma di produzione. Quando il motore colloca o sposta una fase, un webhook di SkyPlanner attiva una richiesta PATCH a /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. La richiesta imposta estimatedStartDate ed estimatedEndDate in UTC e, se SkyPlanner ha assegnato la fase a un’altra macchina o persona, anche workCenter ed employeeCode. Le date vengono riportate sulle fasi della commessa già visualizzate in Whiteboard, Planning Board e Scheduling Advisor.
4. Conferme dal reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer e le registrazioni dei tempi mantengono aggiornato il programma di produzione. Puoi scegliere se inviare i tempi consuntivi a JobBOSS². Se scegli di farlo, ogni conferma diventa un Time Ticket Detail con tempo di attrezzaggio, tempo ciclo e pezzi. In caso contrario, la raccolta dati resta in JobBOSS² e SkyPlanner legge l’avanzamento da Order Routings.
5. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima della messa in produzione:
| Dati | Sistema responsabile |
|---|---|
| Estimates, Routings, quantità, date di consegna, stato delle commesse | JobBOSS² |
| Sequenza delle fasi, orari di inizio e fine, macchina e operatore per ogni fase | SkyPlanner |
| Matrice dei tempi di attrezzaggio, requisiti relativi a utensili e operatori, risorse produttive alternative | SkyPlanner |
| Turni e giorni non lavorativi | Un solo sistema, scelto durante la definizione del perimetro |
| Registrazioni dei tempi, prelievi di materiali, carichi di magazzino, calcolo dei costi | JobBOSS², con inserimento diretto o invio dalle registrazioni dei tempi di SkyPlanner |
Scegli un solo sistema per scrivere le date delle fasi delle commesse. Per le operazioni che schedula, SkyPlanner sostituisce la rischedulazione in Whiteboard: i pianificatori spostano quindi le operazioni in SkyPlanner e le date vengono trasferite a JobBOSS².
Le fasi tipiche del progetto
L’implementazione viene normalmente completata nel giro di poche settimane dall’inizio dell’avviamento. Prima di allora, verifica il programma di produzione durante la prova gratuita di 30 giorni, usando Work Centers, cicli di lavorazione e commesse aperte esportati da JobBOSS² in formato CSV o Excel.
- Mappatura. Definisci la tabella di mappatura, le responsabilità sui dati, le frequenze di sincronizzazione e se inviare a JobBOSS² le registrazioni dei tempi.
- Accesso ECI. Chiedi a ECI di attivare la JobBOSS² API o la ERP API e di creare l’utente API. Se disponi di un’azienda di prova in un ambiente sandbox, usala per i test.
- Caricamento iniziale. Estimates, Routings, Work Centers, calendario e dipendenti.
- Sincronizzazione delle commesse e degli ordini di acquisto. Polling con filtri
lastModDate, paginazione e nuovi tentativi 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 nell’ERP. Chiamate PATCH a Order Routing attivate dai webhook di SkyPlanner, più Time Ticket Details se previsto.
- Test in parallelo. Usa SkyPlanner in parallelo al tabellone attuale, confronta le date e correggi le anagrafiche.
- Avvio in produzione. Attiva la scrittura nell’ERP quando i dati coincidono.
Cosa prevedere per un’integrazione con JobBOSS²
- Hosting o installazione locale. La JobBOSS² API è destinata ai clienti in hosting. Le installazioni locali usano la ERP API, che espone un elenco di risorse diverso. Definisci quale usare al passaggio 1.
- UTC ovunque. L’API legge e scrive in UTC. Converti gli orari nel fuso dello stabilimento, altrimenti un inizio alle 7:00 verrà registrato all’ora sbagliata.
- Centri di lavoro che raggruppano più macchine. Un centro di lavoro può rappresentare una macchina, un gruppo, una cella o delle persone. Il numero di macchine e la dimensione della squadra indicati per ogni fase del ciclo di lavorazione comunicano a SkyPlanner quante risorse produttive servono per quella fase.
- Lavorazioni esterne. Le fasi associate a un fornitore anziché a un centro di lavoro incidono sul lead time, non sulla capacità interna. Modellale come fasi che richiedono solo tempo.
- Fasi sovrapposte e non presidiate. Le fasi del ciclo di lavorazione possono essere contrassegnate come sovrapponibili o eseguibili senza presidio. Trasferisci entrambi i flag per pianificare correttamente le lavorazioni non presidiate.
- Unità di tempo. I tempi di attrezzaggio e i tempi ciclo hanno unità proprie; il tempo di coda è attesa, non tempo macchina. Converti le unità durante l’importazione, altrimenti tutte le durate saranno errate.
- Paginazione. Per impostazione predefinita, ogni pagina contiene 200 record. Gestisci la paginazione a ogni lettura.
Chi configura e fornisce assistenza per l’integrazione con JobBOSS²
- Il team SkyPlanner configura l’integrazione durante l’avviamento e fornisce assistenza dopo l’avvio in produzione, per le risorse e le regole di polling concordate. Ogni officina usa JobBOSS² in modo diverso: nella configurazione e nell’assistenza si tiene conto di queste specificità.
- Il tuo partner JobBOSS² può partecipare. Conosce la tua configurazione e può coordinare con ECI l’attivazione dell’API e la creazione dell’utente API, insieme al team SkyPlanner.
- I tuoi sviluppatori possono estendere l’integrazione usando la REST API di SkyPlanner con un token API. Per iniziare basta un token API e il team SkyPlanner offre assistenza quando serve. Consulta la documentazione sull’integrazione di SkyPlanner.
SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. Il preventivo per l’integrazione viene fornito in anticipo insieme al piano, in base ai tuoi processi e alle tue esigenze. Consulta i prezzi, la schedulazione della produzione a capacità finita con JobBOSS², la pagina JobBOSS², le funzionalità di SkyPlanner e la sezione dedicata alle integrazioni ERP.
Aziende manifatturiere che usano SkyPlanner
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 elettrici e apparecchiature di manovra
La pianificazione della produzione fa risparmiare 2 ore di lavoro ogni settimana e una nuova coda di lavoro arriva alla 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 creare un piano ottimizzato di tre mesi per tutti i centri di lavoro.
1.000 e piùordini di lavoro schedulati automaticamente
“Ora controlliamo la produzione in modo diverso e conosciamo la nostra capacità produttiva molto più a fondo.”
Hannu Ryynänen, amministratore delegato
Mamec · Miscelatori industriali, pompe e produzione conto terzi ad alta tecnologia
Migliaia di ordini di lavoro vengono schedulati automaticamente e tutta l’organizzazione dispone di una visione della produzione in tempo reale.
98%di affidabilità delle consegne, rispetto al precedente 50% circa
“SkyPlanner ha un ruolo decisivo nel mantenere la nostra affidabilità delle consegne.”
Hannu Lahtinen, amministratore delegato
KJH-Comp · Lavorazione della lamiera e produzione conto terzi
L’affidabilità delle consegne è passata da circa il 50% a punte del 98% e ora per la schedulazione basta un supervisore anziché due.
Domande frequenti
JobBOSS² dispone di un’API?
Sì. ECI pubblica la JobBOSS² API e la ERP API, indipendente dal prodotto: entrambe sono REST con specifiche OpenAPI. Per i clienti in hosting, la JobBOSS² API legge e scrive ordini, Order Routings, Estimates, Work Centers, ordini di acquisto e Time Tickets.
Come si autentica l’integrazione con JobBOSS²?
Tramite il flusso client credentials di OAuth 2.0. ECI attiva l’API, viene creato un utente API dalla Integration Engine Management Console e ogni chiamata include un token Bearer.
JobBOSS² supporta i webhook?
La documentazione delle API di ECI non prevede webhook, quindi l’integrazione interroga periodicamente JobBOSS² con filtri lastModDate, secondo una frequenza definita per ogni officina. I webhook di SkyPlanner inviano invece le modifiche alla schedulazione non appena avvengono.
Come vengono riscritte in JobBOSS² le date pianificate?
Per ogni fase di lavorazione. SkyPlanner aggiorna tramite PATCH ogni Order Routing con estimatedStartDate e estimatedEndDate, oltre a workCenter ed employeeCode quando la fase è stata assegnata a un’altra macchina o a un altro operatore.
Un partner JobBOSS² dovrebbe proporre ECI APS o SkyPlanner?
SkyPlanner, quando il cliente vuole rendere operativa in poche settimane la schedulazione della produzione su più risorse, nel rispetto della capacità disponibile. ECI APS è un componente aggiuntivo separato basato su LYNQ. SkyPlanner si collega tramite la JobBOSS² API di ECI, pianifica cambi di attrezzaggio, squadre, attrezzature di fissaggio e materiali, ripianifica automaticamente e parte da 199 € al mese.
Possiamo provare SkyPlanner prima di realizzare l’integrazione?
Sì. La prova gratuita di 30 giorni supporta fino a 20 centri di lavoro con importazioni CSV o Excel da JobBOSS², senza carta di credito. Inizia la prova oppure contatta il team commerciale per la definizione del perimetro dell’integrazione.
