Integrazioni / ERP / Senior ERP
Guida all’integrazione di Senior ERP per la schedulazione della produzione con SkyPlanner APS
Questa guida spiega a partner e team IT come collegare Senior ERP di Senior Sistemas (Gestão Empresarial | ERP XT con Senior X) a SkyPlanner APS. SkyPlanner si integra con Senior ERP in entrambe le direzioni, tramite le interfacce di Senior:
- In ingresso vengono acquisiti gli ordini di produzione (OP) con le relative fasi, i cicli di lavorazione (roteiros), le risorse produttive e i relativi centri, gli SKU, le strutture di prodotto, le giacenze e gli ordini di acquisto.
- L’inizio e la fine pianificati per ciascuna fase dell’OP, insieme alla risorsa produttiva scelta per eseguirla, vengono riscritti nell’OP.
- Se lo desideri, le registrazioni dei tempi degli operatori vengono inviate a Senior come apontamentos de produção.
- Senior X Events Hub avvisa SkyPlanner quando cambia lo stato di una fase dell’OP, mentre 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 di Senior ERP e continua a fornire assistenza dopo la messa in produzione. Questa guida si rivolge ai partner e agli sviluppatori che vogliono partecipare al progetto o sviluppare autonomamente soluzioni basate sulla REST API documentata di SkyPlanner (documentazione API).
Le interfacce di integrazione di Senior ERP
ERP XT è un sistema ibrido. La documentazione di Senior afferma che Gestão Empresarial XT “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (diventa un sistema ibrido: un sistema on-premises, locale, che integra soluzioni cloud) (documentazione Senior, tradotta). Un sistema di schedulazione utilizza tre interfacce Senior:
- Web service G5 (SOAP). Sono servizi sul server Senior, denominati in base al modulo (com.senior.g5.co.<module>…). Ciascuno è pubblicato in tre varianti WSDL: sapiens_Sync, sapiens_Async e sapiens_Scheduled. I servizi per la produzione includono com.senior.g5.co.mpr.pcp.ordemproducao, che “calls the same production order generation routine” (richiama la stessa routine di generazione degli ordini di produzione) della schermata ERP (documentazione Senior, tradotta), oltre ai servizi per i prodotti (com.senior.g5.co.ger.cad.produto) e per le dichiarazioni di produzione.
- REST API di Senior X Platform, disponibili su api.senior.com.br per gli ambiti ERP che Senior espone su Senior X, come prodotti e ordini di vendita (documentazione Senior).
- Webhook di Events Hub. Si creano in Senior X nel percorso Tecnologia > Customização > Events Hub > Webhooks. Manufacturing pubblica l’evento erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus quando cambia lo stato di una fase dell’OP (documentazione Senior).
Autenticazione e accesso
- Senior X Platform. L’integrazione effettua l’accesso con una richiesta POST a platform.senior.com.br sul percorso /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, indicando l’utente nel formato user@tenant. La risposta contiene un token di accesso Bearer e un token di aggiornamento. Le chiavi applicative consentono di accedere con loginWithKey (access key, secret, tenant). Le chiamate REST includono l’header authorization e un header client_id che identifica l’applicazione connessa, registrata nel portale API di Senior e associata a un ruolo nell’ERP.
- Web service G5. Le chiamate includono i parametri user, password ed encryption. Se si usa un token Senior X, il token sostituisce la password (documentazione Senior).
- Autorizzazioni. Crea un utente Senior dedicato all’integrazione, con accesso ai dati di PCP, progettazione, magazzino e acquisti che l’integrazione legge e scrive.
Sul lato SkyPlanner, l’autenticazione alla REST API avviene tramite un token API nell’header Authorization-Token (SkyPlanner Settings > API). La REST API è documentata in Swagger/OpenAPI. Il tutorial sull’integrazione illustra le prime chiamate passo per passo.
Eventi e polling
Events Hub gestisce gli eventi di reparto: quando cambia lo stato di una fase dell’OP, il webhook raggiunge SkyPlanner e la schedulazione si aggiorna. Gli altri dati vengono acquisiti tramite polling. Le letture, filtrate sugli OP confermati e rilasciati e sulle modifiche recenti, rilevano il nuovo lavoro da eseguire. La frequenza viene definita per ciascuno stabilimento: da pochi minuti per gli OP a un’ora per le giacenze.
SkyPlanner invia webhook quando cambia lo stato o la schedulazione: il flusso di ritorno è quindi basato sugli eventi.
Mappatura dei dati
| Oggetto Senior ERP (interfaccia) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
| SKU: produto e derivação, unità di misura (web service G5 o entità Senior X) | Prodotti e materiali | Senior → SkyPlanner | Caricamento iniziale, poi polling |
| Struttura di prodotto (engenharia do SKU) | Struttura del prodotto, semilavorati, materiali per prodotto | Senior → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Roteiro con estágios: sequenza e dipendenza dalla fase precedente | Fasi del processo in sequenza | Senior → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Centri di lavoro, durate, tempi di attrezzaggio e disattrezzaggio, efficienze | Senior → SkyPlanner | Caricamento iniziale, raramente in seguito |
| Centro de recurso | Gruppi di centri di lavoro | Senior → SkyPlanner | Caricamento iniziale, raramente in seguito |
| Calendário: Feriados, calendario di produzione per turno | Turni e giorni non lavorativi | Senior → SkyPlanner | Ogni giorno, oppure turni gestiti in SkyPlanner |
| Ordens de produção (Firme, Liberada) con fasi e materiali | Ordini e operazioni con scadenze e fabbisogni di materiali | Senior → SkyPlanner | Polling ogni pochi minuti |
| Stato della fase OP (Events Hub orderProductionStageChangeStatus) | Avanzamento dell’operazione | Senior → SkyPlanner | In tempo reale tramite webhook |
| Estoque per SKU | Giacenze di magazzino | Senior → SkyPlanner | Polling ogni ora o all’esecuzione della schedulazione |
| Ordens de compra con date di consegna | Ordini di acquisto, materiali in arrivo per data di consegna | Senior → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
| Fase OP: inizio e fine pianificati, risorsa produttiva | Inizio e fine pianificati per operazione, centro di lavoro assegnato | SkyPlanner → Senior | A ogni modifica della schedulazione, tramite webhook SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, data e ora di inizio e fine | Registrazioni dei tempi e conferme degli operatori | SkyPlanner → Senior | Per conferma o per turno, se previsto |
| Non presente in Senior ERP | Matrice dei tempi di attrezzaggio, utensili come risorse a capacità finita, operazioni con più operatori, macchine e personale alternativi | Gestiti in SkyPlanner | Configurazione durante l’avviamento |
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Leggi SKU, strutture, roteiros, recursos, centros de recurso e calendario di produzione. Definisci con attenzione la corrispondenza dei centri di risorse: un centro de recurso con quattro macchine diventa un gruppo di centri di lavoro oppure quattro centri di lavoro. Converti Fator de carga nell’efficienza del centro di lavoro SkyPlanner oppure nei turni, non in entrambi.
2. Sincronizzazione degli OP. Leggi gli OP negli stati Firme e Liberada con le relative fasi e i materiali, oltre agli ordini di acquisto aperti. Gli OP in stato Planejada possono ancora essere modificati o eliminati dall’MRP: schedulali solo se vuoi una visione previsionale. 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.
3. Riscrittura della schedulazione. Quando il motore colloca o sposta una fase, un webhook SkyPlanner attiva la riscrittura. Questa imposta l’inizio e la fine pianificati di ciascuna fase dell’OP e la risorsa produttiva scelta: sono gli stessi campi che il pianificatore modifica in Programação de produção. Durante la definizione del perimetro, il team SkyPlanner concorda con te e con il tuo partner Senior il web service specifico da usare.
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. Sei tu a scegliere se inviare a Senior i tempi effettivi. In caso affermativo, ogni conferma diventa un apontamento de produção sulla fase dell’OP, con quantità prodotta, scarti e orari di inizio e fine. Senior accetta dichiarazioni di produzione solo per gli OP in stato Liberada o Andamento. Se registri la produzione tramite Fábrica ao Vivo, SkyPlanner legge invece l’avanzamento tramite Events Hub.
5. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima della messa in produzione:
| Dati | Sistema responsabile |
|---|---|
| SKU, strutture, roteiros, quantità e stato degli OP | Senior ERP |
| Sequenza delle fasi, orari di inizio e fine, assegnazione delle risorse produttive | SkyPlanner |
| Matrice dei tempi di attrezzaggio, requisiti di utensili e operatori, risorse produttive alternative | SkyPlanner |
| Calendario di produzione e turni | Un solo sistema, scelto durante la definizione del perimetro |
| Apontamentos, movimenti di magazzino, calcolo dei costi | Senior ERP, con inserimento diretto o invio dalle registrazioni dei tempi di SkyPlanner |
Affida a un solo sistema la scrittura delle date delle fasi. Se i pianificatori continuano a mettere in sequenza gli stessi OP in Programação de produção o nel diagramma di Gantt, concorda quali OP sono gestiti da SkyPlanner.
Le fasi tipiche del progetto
L’implementazione viene normalmente completata entro poche settimane dall’inizio dell’avviamento. Prima di questa fase, verifica la schedulazione durante la prova gratuita di 30 giorni, usando risorse produttive, roteiros e OP aperti esportati da Senior in formato CSV o Excel.
- Mappatura. Definisci la tabella di corrispondenza, le responsabilità di gestione dei dati, le frequenze di sincronizzazione e se gli apontamentos devono essere inviati a Senior.
- Accesso a Senior. Crea l’utente per l’integrazione, registra l’applicazione nel portale API di Senior e abilita i web service G5 e il webhook di Events Hub. Esegui prima i test in un ambiente di collaudo.
- Caricamento iniziale. SKU, strutture, roteiros, recursos, centros de recurso, calendario.
- Sincronizzazione di OP e ordini di acquisto. Polling con filtri e nuovi tentativi in caso di errore, oltre al webhook per lo stato delle fasi.
- Configurazione dei vincoli in SkyPlanner. Matrice dei tempi di attrezzaggio, utensili, numero di operatori per operazione e macchine o personale alternativi.
- Riscrittura della schedulazione. Date delle fasi e risorse produttive tramite i webhook SkyPlanner, più gli apontamentos se previsti.
- Test in parallelo. Esegui SkyPlanner in parallelo al piano attuale, confronta le date e correggi le anagrafiche.
- Messa in produzione. Attiva la scrittura dei dati in Senior ERP quando i dati corrispondono.
Cosa prevedere nell’integrazione con Senior ERP
- Quattro tempi per risorsa produttiva. Recurso contiene i tempi di lavorazione, attrezzaggio, carico e scarico e trasferimento. I tempi di carico e trasferimento possono riguardare la movimentazione, non l’impiego della macchina. Definisci per ogni risorsa produttiva come mappare ciascun tempo, altrimenti tutte le durate risulteranno errate.
- Un solo tempo di attrezzaggio per risorsa produttiva. Il campo Tempo setup di Senior contiene un unico valore. Durante l’avviamento, costruisci in SkyPlanner la matrice dei tempi di attrezzaggio sulla base dei cambi di produzione effettivi.
- Varianti. In Senior, uno SKU è composto da un prodotto e da una derivação; i roteiros possono variare per ciascuna variante. Includi il codice della variante nelle chiavi dei prodotti SkyPlanner.
- Stati degli OP. Solo gli OP in stato Liberada e Andamento accettano dichiarazioni di produzione. Gestisci i cambi di stato in Senior e lascia che SkyPlanner li recepisca tramite Events Hub.
- Architettura ibrida. I web service G5 vengono eseguiti sul server Senior, mentre Events Hub opera in Senior X. Prevedi l’accesso di rete per entrambi.
- Formato dei numeri. I servizi web di Senior rifiutano i numeri con separatori delle migliaia e richiedono la virgola decimale. Invia i numeri in questo formato.
Chi configura l’integrazione con Senior ERP e fornisce assistenza
- Il team SkyPlanner configura l’integrazione durante l’avviamento e fornisce assistenza dopo la messa in produzione, per i servizi web, le API di Senior X e i webhook di Events Hub concordati. Ogni stabilimento utilizza Senior ERP in modo diverso: è qui che entra in gioco questa competenza.
- Il vostro partner Senior può partecipare. Conosce la vostra configurazione, le personalizzazioni e le licenze e può affiancare il team SkyPlanner nella configurazione dell’utente di integrazione, nella registrazione al portale API e nella configurazione dei servizi web.
- I vostri 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 fornisce assistenza quando serve. La documentazione è disponibile nella guida all’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 piano, in base ai vostri processi e alle vostre esigenze. Consultate i prezzi, la pagina sulla schedulazione della produzione a capacità finita con Senior ERP, la pagina dedicata a Senior ERP e la panoramica delle integrazioni ERP.
Le recensioni delle aziende manifatturiere su SkyPlanner
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 elettrici e apparecchiature di manovra
La pianificazione della produzione consente di 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 su tre mesi per tutti i centri di lavoro.
1.000 e piùordini di produzione schedulati automaticamente
“Controlliamo la produzione in modo diverso e abbiamo una conoscenza della capacità produttiva di tutt’altro livello.”
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.
Menofermi per carenza di materiali
“Il valore di SkyPlanner per noi è avere uno strumento che funziona nel lavoro quotidiano, soprattutto per stabilire le date di consegna.”
Tommi Männistö, responsabile della pianificazione della produzione
Eskomatic · Lavorazioni meccaniche conto terzi
La schedulazione automatica dei carichi permette di definire date di consegna più precise e i fermi di produzione dovuti alla carenza di materiali sono diminuiti drasticamente.
Domande frequenti
Senior ERP dispone di un’API per gli ordini di produzione?
Sì. Il servizio web G5 com.senior.g5.co.mpr.pcp.ordemproducao genera gli OP con la stessa procedura utilizzata nella schermata dell’ERP; altri servizi G5 gestiscono i prodotti e le dichiarazioni di produzione. Senior X Platform aggiunge REST API con autenticazione tramite token Bearer e webhook di Events Hub.
Senior ERP supporta i webhook?
Sì. Senior X Events Hub invia webhook, tra cui orderProductionStageChangeStatus quando una fase di un OP cambia stato. SkyPlanner lo utilizza per seguire l’avanzamento in reparto in tempo reale e, tramite i propri webhook, invia a sua volta le modifiche alla schedulazione.
Come vengono riportate in Senior ERP le date pianificate?
SkyPlanner imposta l’inizio e la fine pianificati di ogni fase dell’OP e la risorsa produttiva scelta per eseguirla: sono gli stessi campi che il pianificatore modifica in Programação de produção. A ogni modifica della schedulazione, un webhook di SkyPlanner avvia la scrittura dei dati in Senior ERP attraverso il canale che il team SkyPlanner stabilisce per la vostra installazione Senior durante la definizione del perimetro in fase di avviamento.
L’integrazione funziona con Senior X ed ERP XT?
Sì. ERP XT viene eseguito sul vostro server, con servizi cloud su Senior X. L’integrazione utilizza i servizi web G5 sul server e le API di Senior X ed Events Hub nel cloud.
Possiamo provare SkyPlanner prima di realizzare l’integrazione?
Sì. La prova gratuita di 30 giorni supporta fino a 20 centri di lavoro, con importazioni da Senior tramite CSV o Excel, senza carta di credito. Iniziate la prova oppure contattate il team commerciale per definire il perimetro dell’integrazione.
