Integrazioni / ERP / HELIOS
Guida all’integrazione di HELIOS per la schedulazione della produzione con SkyPlanner APS
Questa guida all’integrazione di HELIOS spiega a partner e team IT come collegare HELIOS iNuvio e HELIOS Nephrite a SkyPlanner APS. SkyPlanner si integra con HELIOS in entrambe le direzioni, utilizzando le interfacce di HELIOS:
- In ingresso vengono trasferiti gli ordini di produzione (výrobní příkazy) con le relative operazioni, i componenti prodotti, le distinte base, i cicli di lavorazione, le postazioni di lavoro, le macchine, le qualifiche professionali, le risorse di personale, le giacenze e gli ordini di acquisto.
- Le date pianificate di inizio e fine vengono riportate negli ordini di produzione.
- Se lo desideri, le registrazioni dei tempi degli operatori possono essere inviate a HELIOS come consuntivazioni delle operazioni (evidence výrobních operací).
- I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono.
Durante l’avviamento, il team SkyPlanner configura l’integrazione in base alla tua installazione HELIOS e ne assicura il supporto dopo la messa in produzione. Questa guida è rivolta ai partner e agli sviluppatori HELIOS che vogliono partecipare al progetto o sviluppare autonomamente sulla REST API documentata di SkyPlanner (documentazione di riferimento dell’API).
Le interfacce di integrazione di HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco lo descrive come un componente separato di HELIOS iNuvio che consente l’accesso alle aree funzionali di HELIOS iNuvio tramite REST API (guida di Helios Inuvio Server). È incluso nella distribuzione di iNuvio e la specifica OpenAPI è pubblicata nei formati Rapidoc e Redoc. L’API opera sulle viste di HELIOS (browses), ciascuna con il proprio ID e i propri permessi:
- GET /browses/list e GET /browses/meta elencano le viste disponibili e le relative colonne.
- /browses/data legge le righe di una vista e permette di scriverle quando la vista consente la creazione, la modifica e l’eliminazione.
- /api/v1/actions/meta e /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} eseguono azioni esterne su una vista. Attualmente sono supportate le azioni esterne di tipo Procedure, Browse e Plugin.
Le viste di produzione utilizzate da chi si occupa della schedulazione comprendono il piano di produzione (výrobní plán), gli ordini di produzione (výrobní příkazy), i componenti degli ordini di produzione, i materiali e i semilavorati per la produzione, le qualifiche professionali, le risorse di personale, le impostazioni predefinite delle operazioni dei cicli di lavorazione e le consuntivazioni delle operazioni. Allo stesso modo sono disponibili giacenze, carichi, scarichi e ordini di acquisto emessi (vydané objednávky).
HELIOS Nephrite REST API. La roadmap di Nephrite prevede lo sviluppo di una REST API (roadmap di HELIOS Nephrite). Durante la definizione del perimetro, il team SkyPlanner verifica con te e con il tuo partner HELIOS gli endpoint Nephrite della tua installazione. I flussi di dati descritti di seguito restano invariati.
Excel e CSV. Ogni vista di HELIOS consente l’esportazione in Microsoft Office, sufficiente per il caricamento di prova.
Autenticazione e licenze
- Due modalità di autenticazione. iNuvio offre una precedente API di autenticazione proprietaria (/api/token) e una più recente API OAuth2 basata su RFC 6749 (/oauth/token, /oauth/revoke). I token vengono rinnovati tramite POST /oauth/token o GET /api/token.
- Licenze. Helios Inuvio Server è gratuito, mentre la REST API richiede una licenza. Dalla versione 3.0.2026.0301 le API di sistema e delle aree funzionali sono riunite in un’unica Inuvio REST API e l’accesso all’API non è più limitato dal numero di utenti.
- Permessi. L’utente dedicato all’integrazione deve avere i permessi di lettura sulle viste di produzione e di magazzino e il permesso di eseguire le azioni esterne concordate.
Sul lato SkyPlanner, la REST API utilizza per l’autenticazione un token API nell’header Authorization-Token (SkyPlanner Settings > API) ed è documentata in Swagger/OpenAPI. Il tutorial sull’integrazione ti guida nelle prime chiamate.
Eventi e polling
SkyPlanner legge i dati di HELIOS a intervalli prestabiliti. Le chiamate a /browses/data, filtrate sugli ordini di produzione aperti e sulle modifiche recenti, acquisiscono le nuove lavorazioni. La frequenza viene impostata per ogni stabilimento: da pochi minuti per gli ordini di produzione a un’ora per le giacenze.
SkyPlanner invia webhook quando cambia lo stato o la schedulazione: la riscrittura dei dati in HELIOS è quindi basata sugli eventi.
Mappatura dei dati
| Oggetto HELIOS (vista) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
| Schede articolo e componenti prodotti (vyráběné dílce), unità di misura | Prodotti e materiali | HELIOS → SkyPlanner | Caricamento iniziale, poi polling |
| Distinte base (kusovník, kusovníkové vazby) con date di validità | Struttura del prodotto, sottoprodotti, materiali per prodotto | HELIOS → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Cicli di lavorazione (technologický postup): operazione, postazione di lavoro, tempo di preparazione della macchina e dell’operatore, tempo unitario, tempo di chiusura, tempo interoperazionale | Fasi di processo con durate, tempi di attrezzaggio e disattrezzaggio | HELIOS → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Postazioni di lavoro (pracoviště), macchine (stroje), postazioni di lavoro alternative | Centri di lavoro, gruppi di centri di lavoro, centri di lavoro alternativi | HELIOS → SkyPlanner | Caricamento iniziale, poi raramente |
| Qualifiche professionali (výrobní profese), risorse di personale (výrobní personální zdroje) | Personale e numero di operatori per operazione | HELIOS → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Calendari di pianificazione (plánovací kalendáře) | Turni e giorni non lavorativi | HELIOS → SkyPlanner | Ogni giorno, oppure turni gestiti direttamente in SkyPlanner |
| Ordini di produzione (výrobní příkazy), relativi componenti e operazioni, materiali per la produzione | Ordini e operazioni con scadenze e fabbisogni di materiali | HELIOS → SkyPlanner | Polling ogni pochi minuti |
| Giacenze (stav skladu) | Giacenze di magazzino | HELIOS → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
| Ordini di acquisto emessi (vydané objednávky) con date di consegna | Ordini di acquisto, materiali in arrivo per data di consegna | HELIOS → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
| Inizio e fine pianificati per ogni operazione dell’ordine di produzione (azione esterna) | Inizio e fine pianificati per ogni operazione | SkyPlanner → HELIOS | A ogni modifica della schedulazione, tramite webhook di SkyPlanner |
| Consuntivazioni delle operazioni (evidence výrobních operací) | Registrazioni dei tempi e conferme degli operatori | SkyPlanner → HELIOS | A ogni conferma o per turno, se si sceglie questa opzione |
| Non presenti in HELIOS | Matrice dei tempi di attrezzaggio, utensili come risorse a capacità finita, operazioni con più operatori | Gestiti in SkyPlanner | Configurati durante l’avviamento |
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Leggi dalle viste TPV i componenti prodotti, le distinte base, i cicli di lavorazione, le postazioni di lavoro, le macchine, le qualifiche professionali, le risorse di personale e i calendari. Ogni risorsa HELIOS ha un flag che ne determina l’inclusione nella pianificazione della capacità produttiva: decidi quindi, per ciascuna risorsa, che cosa deve schedulare SkyPlanner. Una postazione con quattro macchine diventa un gruppo di centri di lavoro oppure quattro centri di lavoro.
2. Sincronizzazione degli ordini. Leggi gli ordini di produzione con i relativi componenti, operazioni e materiali, oltre agli ordini di acquisto emessi. SkyPlanner considera disponibile il materiale ordinato alla data di consegna dell’ordine di acquisto e aggiorna le giacenze quando l’ordine viene contrassegnato come Delivered. Schedula gli ordini di produzione rilasciati. Le quantità pianificate nel piano di produzione restano in HELIOS finché non diventano ordini di produzione.
3. Riscrittura della schedulazione in HELIOS. Quando il motore colloca o sposta un’operazione, un webhook di SkyPlanner attiva un’azione esterna sulla vista degli ordini di produzione tramite /api/v1/actions/execute. L’azione è una procedura HELIOS, concordata durante la definizione del perimetro, che imposta l’inizio e la fine pianificati dell’operazione dell’ordine. HELIOS convalida la modifica secondo la propria logica.
4. Conferme dal reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer e le registrazioni dei tempi mantengono aggiornata la schedulazione. Scegli tu se inviare a HELIOS i tempi effettivi. Se scegli di farlo, un’azione esterna li registra come consuntivazioni per ogni operazione dell’ordine. In caso contrario, gli operatori continuano a consuntivare sui terminali HELIOS e SkyPlanner legge tali registrazioni.
5. Responsabilità sui dati e regole per i conflitti. Documentatele prima della messa in esercizio:
| Dati | Sistema responsabile |
|---|---|
| Articoli, distinte base, cicli di lavorazione, quantità, stato degli ordini | HELIOS |
| Sequenza delle operazioni, orari di inizio e fine, assegnazione delle macchine | SkyPlanner |
| Matrice dei tempi di attrezzaggio, fabbisogni di utensili e operatori, risorse alternative | SkyPlanner |
| Turni e giorni non lavorativi | Un solo sistema, scelto durante la definizione del perimetro |
| Consuntivazioni delle operazioni, scarichi e carichi di materiali | HELIOS, con inserimento diretto o invio dalle registrazioni dei tempi di SkyPlanner |
Scegli un solo sistema per scrivere le date degli ordini. Se la pianificazione della capacità produttiva di HELIOS o Nephrite APS continua a scrivere le date, disattiva questa funzione per gli ordini schedulati da SkyPlanner, oppure mantieni il piano di HELIOS solo come piano di prova.
Le fasi tipiche del progetto
L’implementazione viene normalmente completata nell’arco di alcune settimane dall’inizio dell’avviamento. Prima di questa fase, convalida la schedulazione durante la prova gratuita di 30 giorni, utilizzando postazioni di lavoro, cicli di lavorazione e ordini di produzione aperti esportati da HELIOS in CSV o Excel.
- Mappatura. Definisci la tabella di mappatura, le regole sulla titolarità dei dati, le frequenze di sincronizzazione e se inviare a HELIOS le consuntivazioni delle operazioni.
- Accesso a HELIOS. Configura Helios Inuvio Server, l’utente dedicato all’integrazione, le credenziali OAuth2 e la licenza della REST API. Esegui prima i test su una copia del database.
- Caricamento iniziale. Componenti prodotti, distinte base, cicli di lavorazione, postazioni di lavoro, macchine, qualifiche professionali, calendari.
- Sincronizzazione degli ordini di produzione e di acquisto. Polling con filtri, 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.
- Riscrittura della schedulazione in HELIOS. Crea e testa le azioni esterne per le date pianificate e, se hai scelto questa opzione, per le consuntivazioni delle operazioni.
- Test in parallelo. Eseguite SkyPlanner in parallelo al piano attuale, confrontate le date e correggete le anagrafiche.
- Messa in esercizio. Attiva la riscrittura dei dati in HELIOS quando i dati coincidono.
Cosa prevedere per un’integrazione con HELIOS
- Flag di pianificazione. Solo le risorse contrassegnate per la pianificazione della capacità produttiva hanno dati di capacità affidabili. Prima del caricamento iniziale, controlla i flag su postazioni di lavoro, macchine, qualifiche professionali e lavorazioni esterne.
- Unità di tempo. I tempi di preparazione, unitari e di chiusura possono essere inseriti in ore, minuti o secondi. Converti le unità durante l’importazione, altrimenti tutte le durate risulteranno errate.
- Tempo tra le operazioni. Il tempo costante tra le operazioni è un tempo di attesa, non un tempo macchina. Modellatelo come attesa, non come capacità produttiva.
- Operazioni in conto lavoro (kooperace). Il tempo di trasporto si applica sia all’andata sia al ritorno. Modellate le lavorazioni esterne come fasi che prevedono solo una durata.
- Viste modificabili. Tutte le viste consentono la lettura, ma solo alcune supportano la creazione, l’aggiornamento e l’eliminazione. GET /browses/list con il filtro browseCreateImplemented=1 indica quali. Le viste degli ordini di produzione sono di sola lettura: le date pianificate vengono quindi reinviate tramite l’azione esterna concordata.
Chi configura e fornisce assistenza per l’integrazione HELIOS
- Il team SkyPlanner configura l’integrazione durante l’avviamento e fornisce assistenza dopo la messa in produzione, per le viste e le azioni esterne concordate. Ogni stabilimento usa HELIOS in modo diverso: questa conoscenza specifica viene applicata proprio in questa fase.
- Il vostro partner HELIOS può partecipare. Conosce la vostra installazione, le procedure personalizzate e le licenze e può configurare Helios Inuvio Server e le azioni esterne insieme al team SkyPlanner.
- I vostri 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 fornisce assistenza quando serve. Consultate la documentazione di integrazione di SkyPlanner.
SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. Il preventivo per l’integrazione viene definito in anticipo, insieme al vostro piano, in base ai vostri processi e alle vostre esigenze. Consultate i prezzi, la schedulazione della produzione a capacità finita con HELIOS, la pagina HELIOS e la sezione dedicata alle integrazioni ERP. Per le nozioni di base, consultate la pagina sulla schedulazione della produzione.
SkyPlanner: le recensioni delle aziende manifatturiere
2 hrisparmiate ogni settimana
“Con SkyPlanner siamo passati dalla pianificazione della produzione su fogli Excel all’ottimizzazione della produzione in tempo reale.”
Kalle Kalliomäki, specialista della supply chain
UTU · Quadri e apparecchiature elettriche 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 produzione schedulati automaticamente
“Ora controlliamo la produzione in modo diverso e conosciamo la nostra 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 e tutta l’organizzazione dispone di una visione della produzione in tempo reale.
100%di affidabilità delle consegne dal 2021
“SkyPlanner ci dà visibilità sulla capacità produttiva e rende prevedibile la pianificazione.”
Dan Berglund, COO/CFO
Opes Corporation · Produzione chimica e alimentare
L’affidabilità delle consegne è stata del 100% per tutto il periodo di utilizzo di SkyPlanner, dal 2021.
Domande frequenti
HELIOS dispone di un’API per gli ordini di produzione?
Sì. Helios Inuvio Server offre accesso REST alle viste di HELIOS iNuvio, tra cui il piano di produzione, gli ordini di produzione, i componenti degli ordini, i materiali per la produzione e le registrazioni delle operazioni. Per HELIOS Nephrite, il team SkyPlanner definisce la modalità di integrazione per la vostra installazione insieme a voi e al vostro partner HELIOS, durante la definizione del perimetro in fase di avviamento.
Come rileva SkyPlanner le modifiche in HELIOS?
SkyPlanner interroga le viste HELIOS a intervalli definiti per ogni stabilimento, filtrando gli ordini di produzione aperti e le modifiche recenti. I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena si verificano.
Come vengono riscritte in HELIOS le date pianificate?
Tramite un’azione esterna sulla vista degli ordini di produzione, eseguita con /api/v1/actions/execute. L’azione è una procedura HELIOS concordata durante la definizione del perimetro: HELIOS applica quindi la propria logica a ogni data ricevuta.
Quale autenticazione usa la REST API di Inuvio?
OAuth2 secondo RFC 6749 su /oauth/token, oppure il precedente sistema proprietario su /api/token. L’API di SkyPlanner usa un token API nell’intestazione Authorization-Token.
Un partner HELIOS dovrebbe proporre HELIOS APS o SkyPlanner?
SkyPlanner, quando il piano del cliente cambia spesso e la pianificazione deve rispettare la capacità disponibile. La pianificazione di HELIOS esegue calcoli su un unico piano attivo, può passare alla capacità illimitata per rispettare le date e lascia al pianificatore la gestione dei conflitti (guida HELIOS). SkyPlanner si collega tramite la REST API, ripianifica automaticamente, pianifica cambi di produzione, utensili, squadre e materiali e include utenti illimitati, a partire 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 HELIOS, senza carta di credito. Iniziate la prova oppure contattate il reparto commerciale per definire il perimetro dell’integrazione.