Integrazioni / ERP / proALPHA ERP
Guida all’integrazione di proALPHA per la schedulazione della produzione con SkyPlanner APS
Questa guida all’integrazione di Proalpha spiega a partner e team IT come collegare Proalpha ERP a SkyPlanner APS. SkyPlanner si integra con Proalpha in entrambe le direzioni:
- In ingresso arrivano articoli, ordini di produzione con le relative operazioni, risorse produttive, calendari, giacenze e ordini di acquisto.
- L’inizio e la fine pianificati di ogni operazione vengono reinviati tramite setWorkOrderOperationDates.
- Le modifiche alle risorse produttive vengono reinviate tramite changeWorkOrderOperationResource.
- Le conferme degli operatori vengono reinviate tramite operationDataEntry.
- I webhook di SkyPlanner inviano le modifiche alla schedulazione nel momento in cui avvengono.
Durante l’avviamento, il team SkyPlanner configura l’integrazione in base alla vostra installazione Proalpha e fornisce assistenza anche dopo la messa in produzione. Questa guida è rivolta ai partner e agli sviluppatori che vogliono partecipare al progetto o sviluppare autonomamente usando la REST API documentata di SkyPlanner (documentazione API).
Le interfacce di Proalpha
Proalpha ERP si basa su Progress OpenEdge; con Release 9, la piattaforma è passata a OpenEdge 12. (Proalpha) Per la schedulazione sono rilevanti quattro interfacce.
- Proalpha ERP REST APIs. Il portale pubblico Proalpha API Portal elenca 108 specifiche OpenAPI 3.0 sotto
api/web/v1. Questa interfaccia consente la scrittura dei dati di ritorno e la lettura di articoli e giacenze. - Integration Workbench (INWB). Secondo la descrizione di Proalpha, INWB “is a central platform which connects different IT systems, machines, sites” (è una piattaforma centrale che collega diversi sistemi IT, macchine e siti) e “converts the data into the format of the target system.” (converte i dati nel formato del sistema di destinazione). (Proalpha) Riceve messaggi pAX tramite
POST /api/web/v1/inwb/message. Usatelo per i flussi degli ordini di produzione da e verso Proalpha. - Proalpha Integration Platform. Annunciata ad aprile 2026 e basata su n8n, “will be available to customers either on-premises or in the cloud.” (sarà disponibile per i clienti sia in locale sia nel cloud). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (si baserà su un’architettura di riferimento incentrata sulle API e su interfacce REST). (Proalpha)
- EDI ed esportazioni su file. INWB gestisce i formati di file specifici dei vari settori; le esportazioni su file sono sufficienti per la prova di SkyPlanner.
Gli endpoint per la produzione
| API Proalpha | Endpoint | Utilizzo nell’integrazione |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Inizio e fine pianificati di ogni operazione (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Risorsa produttiva selezionata dalla schedulazione (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Conferme: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Articoli con partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Giacenze per area MRP |
Autenticazione
Le specifiche pubblicate da Proalpha prevedono l’autenticazione HTTP Basic. Gli endpoint dipendono dall’ambiente, {schema}://{host}:{port}/api/web/v1/..., e si trovano sul vostro server Proalpha o su Proalpha Cloud. Create un utente tecnico dedicato con autorizzazioni limitate agli oggetti della tabella di mappatura. Concordate con il vostro team IT l’accesso di rete dal cloud di SkyPlanner a quell’endpoint.
Sul lato SkyPlanner, la REST API usa un token API per l’autenticazione (SkyPlanner Settings > API) ed è documentata in Swagger/OpenAPI. Per iniziare basta un token API. Il tutorial sull’integrazione illustra le prime chiamate.
Eventi e polling
Il Proalpha API Portal non elenca alcuna API per la sottoscrizione ai webhook. Le modifiche in uscita provengono da:
- un flusso di messaggi INWB che invia gli ordini di produzione nuovi e modificati con le relative operazioni
- un workflow n8n sulla Proalpha Integration Platform
- il polling programmato della Material API per le giacenze
SkyPlanner invia webhook quando cambia lo stato o la schedulazione: la scrittura dei dati di ritorno in Proalpha è quindi attivata dagli eventi.
Mappatura dei dati
| Oggetto o API Proalpha | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
| Part (Part API) | Prodotti e materiali | Proalpha → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Modello di processo del prodotto: processo, attività; righe della distinta base dell’ordine di produzione | Struttura del prodotto, sottoprodotti, fasi di lavorazione | Proalpha → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Ordine di produzione (Fertigungsauftrag) con quantità e data di consegna | Ordine e operazioni con data di consegna e priorità | Proalpha → SkyPlanner | Invio push tramite INWB o n8n, oppure ogni pochi minuti |
| Operazioni dell’ordine di produzione: targetSetupTime, targetProcessTime, resource | Fasi di lavorazione con tempi di attrezzaggio e durate | Proalpha → SkyPlanner | Insieme all’ordine di produzione |
| Risorse produttive, gruppi di risorse produttive, gruppi alternativi di risorse produttive | Centri di lavoro, gruppi di centri di lavoro, centri di lavoro alternativi | Proalpha → SkyPlanner | Caricamento iniziale |
| Blocchi del calendario delle risorse produttive con intensity e overloadIntensity | Turni ed efficienze dei centri di lavoro | Proalpha → SkyPlanner | Caricamento iniziale; aggiornamento giornaliero o gestione in SkyPlanner |
| Giacenze per area MRP | Giacenze dei materiali | Proalpha → SkyPlanner | Ogni ora o prima di ogni esecuzione della schedulazione |
| Ordini di acquisto con data di consegna | Materiale in arrivo alla rispettiva data di consegna | Proalpha → SkyPlanner | Ogni ora o prima di ogni esecuzione della schedulazione |
| setWorkOrderOperationDates | Inizio e fine schedulati di ogni operazione | SkyPlanner → Proalpha | A ogni modifica della schedulazione, tramite webhook di SkyPlanner |
| changeWorkOrderOperationResource | Centro di lavoro scelto dal motore | SkyPlanner → Proalpha | A ogni modifica della schedulazione |
| operationDataEntry (setup, process, combined) | Registrazioni dei tempi e quantità da Mobile Confirmations | SkyPlanner → Proalpha | A ogni conferma o per turno |
| Regole di schedulazione di SkyPlanner | Matrice dei tempi di attrezzaggio, utensili come risorse produttive a capacità finita, numero di operatori | Gestione in SkyPlanner | Configurazione durante l’avviamento |
Schemi di integrazione
1. Caricamento iniziale delle anagrafiche. Leggete gli articoli tramite la Part API e caricate una sola volta risorse produttive, gruppi di risorse produttive e calendari tramite INWB o un’esportazione su file. Definite con cura la corrispondenza tra ogni risorsa produttiva di Proalpha e un centro di lavoro di SkyPlanner. I gruppi alternativi di risorse produttive diventano centri di lavoro alternativi.
2. Sincronizzazione degli ordini. Un flusso di messaggi INWB o un workflow n8n invia gli ordini di produzione aperti con le relative operazioni, i tempi previsti e le risorse produttive. Le giacenze vengono lette tramite Material API per area MRP e gli ordini di acquisto aperti tramite INWB. 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.
3. Scrittura della schedulazione in Proalpha. Per ogni operazione che il motore ha collocato o spostato, l’integrazione chiama setWorkOrderOperationDates con il guid dell’operazione e le date e ore di inizio e fine. Se il motore ha scelto un’altra risorsa produttiva, segue la chiamata a changeWorkOrderOperationResource.
4. Consuntivazione in reparto. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer. Le registrazioni dei tempi mantengono aggiornata la schedulazione e vengono inviate a Proalpha tramite operationDataEntry. Se lo stabilimento usa già terminali PDC per la consuntivazione, mantenete un solo canale per evitare registrazioni duplicate.
5. Regole sulla titolarità dei dati e sui conflitti. Mettetele per iscritto prima della messa in produzione:
| Dati | Sistema titolare |
|---|---|
| Articoli, modelli di processo, quantità, stato degli ordini di produzione | Proalpha |
| Sequenza delle operazioni, date e ore di inizio e fine, assegnazione delle risorse produttive | SkyPlanner |
| Matrice dei tempi di attrezzaggio, utensili, numero di operatori | SkyPlanner |
| Turni e assenze | Un solo sistema, scelto in fase di definizione del perimetro |
| Consuntivazioni e movimenti di magazzino | Proalpha, alimentato dalle registrazioni dei tempi di SkyPlanner o da PDC |
Se Proalpha APS o Feinplanung è attivo, stabilite quale sistema gestisce le date delle operazioni. Due sistemi di schedulazione che scrivono le stesse date finiscono per sovrascriversi a vicenda. Con Autopilot, SkyPlanner aggiorna automaticamente la schedulazione quando cambia la produzione.
Le fasi tipiche del progetto
L’implementazione si conclude normalmente nel giro di poche settimane dall’inizio dell’onboarding. Prima di questa fase, la prova gratuita di 30 giorni permette di lavorare con i vostri dati. Esportate da Proalpha gli ordini di produzione aperti, le operazioni e le risorse produttive in formato CSV o Excel, importateli e validate la schedulazione.
- Workshop sulla mappatura. Definite con il vostro partner Proalpha la tabella di mappatura, le regole sulla titolarità dei dati, le frequenze di sincronizzazione e il canale di consuntivazione.
- Configurazione delle interfacce. Abilitate le REST API e i flussi INWB, create l’utente tecnico e consentite l’accesso di rete. Prima nell’ambiente di test, poi in quello di produzione.
- Caricamento iniziale. Articoli, risorse produttive, gruppi di risorse produttive e calendari.
- Sincronizzazione di ordini, giacenze e ordini di acquisto. Invio push degli ordini di produzione tramite INWB o n8n e polling per le giacenze, con nuovi tentativi in caso di errore.
- Configurazione dei vincoli in SkyPlanner. Matrice dei tempi di attrezzaggio, utensili, numero di operatori e centri di lavoro alternativi.
- Scrittura della schedulazione in Proalpha. setWorkOrderOperationDates e changeWorkOrderOperationResource; in questa fase si aggiunge operationDataEntry.
- Esecuzione in parallelo. Confrontate le date di SkyPlanner con il piano attuale e correggete le anagrafiche.
- Messa in produzione. Attivate la scrittura in Proalpha quando i dati coincidono.
Cosa considerare per un’integrazione con Proalpha
- Nessun oggetto per i cicli di lavorazione. Proalpha pianifica in base ai modelli di processo dei prodotti. Gli strumenti ripresi da progetti SAP o Business Central cercano i cicli di lavorazione e tralasciano dei dati. Leggete le operazioni e le righe della distinta base dall’ordine di produzione.
- Intensità del calendario. I blocchi di calendario contengono intensity e overloadIntensity. Mappateli sui turni e sulle efficienze di SkyPlanner anziché copiare semplicemente le ore.
- Unità di misura. Verificate quantityUnitCode e se il tempo di attrezzaggio previsto è riferito all’ordine o al singolo pezzo. Unità errate falsano tutte le durate.
- Endpoint ospitati dal cliente. Il livello REST viene eseguito sul vostro server Proalpha. Firewall, porte e certificati determinano la data di avvio del progetto: predisponete quindi gli accessi per tempo.
- Versione installata. Prima di definire la mappatura, verificate con il vostro partner quali REST API espone la vostra versione di Proalpha.
- Documentazione accessibile previa autenticazione. La guida online di Proalpha è disponibile tramite Documentation Portal. Verificate i nomi dei campi con il vostro partner anziché procedere per ipotesi.
Integrazione con Proalpha: chi la configura e fornisce assistenza
- Il team SkyPlanner la configura durante l’onboarding e fornisce assistenza dopo la messa in produzione. Ogni installazione di Proalpha è modellata in modo diverso: è qui che entra in gioco questa competenza.
- Il vostro partner Proalpha può partecipare. Il partner conosce i vostri modelli di processo, i flussi INWB e la versione installata e può configurare l’accesso alle API. SkyPlanner fornisce la REST API, la documentazione Swagger/OpenAPI e i webhook.
- Anche i vostri sviluppatori possono estendere l’integrazione usando la stessa REST API con un token API. Il team SkyPlanner fornisce assistenza quando serve. La documentazione del prodotto è pubblica e disponibile nella documentazione 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, in base ai vostri processi e alle vostre esigenze, insieme a quello del piano: così conoscete il costo complessivo prima di iniziare. Scoprite come Proalpha pianifica la capacità in proALPHA offre la schedulazione della produzione a capacità finita?, consultate la panoramica nella pagina proALPHA e scoprite gli altri sistemi nella sezione dedicata alle 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 fa risparmiare 2 ore di lavoro ogni settimana e una nuova coda di lavoro raggiunge la 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 per creare un piano ottimizzato di tre mesi per tutti i centri di lavoro bastano meno di 30 minuti.
99,2%di affidabilità delle consegne
“SkyPlanner ci ha permesso di individuare i colli di bottiglia e ha reso più chiara la gestione della produzione.”
Toni Tuori, responsabile di produzione
Piristeel · Sistemi di sicurezza per tetti e di raccolta delle acque piovane
Quest’anno l’affidabilità delle consegne ha raggiunto il 99,2% e la schedulazione fa risparmiare fino a quattro ore di lavoro al giorno.
Menofermi per carenza di materiali
“Il valore di SkyPlanner per noi sta nel fatto che è uno strumento che funziona nel lavoro quotidiano, soprattutto per definire le date di consegna.”
Tommi Männistö, responsabile della pianificazione della produzione
Eskomatic · Lavorazioni meccaniche conto terzi
La schedulazione automatica dei carichi consente di definire date di consegna più precise e i fermi di produzione dovuti alla carenza di materiali si sono ridotti nettamente.
Domande frequenti
Quali interfacce di Proalpha utilizza l’integrazione?
Le REST API di Proalpha per gli articoli, le giacenze e la scrittura di date, risorse produttive e consuntivazioni. I flussi di messaggi INWB o Integration Platform, basata su n8n, trasmettono gli ordini di produzione con le relative operazioni. Le esportazioni su file servono per la prova e i caricamenti massivi.
Dove vengono scritte le date pianificate in Proalpha?
Sull’operazione dell’ordine di produzione, tramite setWorkOrderOperationDates, con data e ora di inizio e fine. Se il motore ha spostato l’operazione su un’altra macchina, changeWorkOrderOperationResource aggiorna la risorsa produttiva.
Proalpha supporta i webhook?
Proalpha API Portal non elenca alcuna API per la sottoscrizione di webhook. Le modifiche arrivano a SkyPlanner tramite flussi di messaggi INWB, workflow n8n o polling. I webhook di SkyPlanner permettono di attivare la scrittura in Proalpha in risposta agli eventi.
Le consuntivazioni degli operatori possono essere inviate a Proalpha?
Sì. Le registrazioni dei tempi di SkyPlanner Mobile Confirmations vengono inviate tramite operationDataEntry, con quantità, tempi del personale e delle risorse produttive. Mantenete un solo canale di consuntivazione se sono in uso anche terminali PDC.
Serve Proalpha APS? E se lo usiamo già?
Non serve. SkyPlanner crea autonomamente una schedulazione della produzione a capacità finita a partire dai vostri ordini di produzione, dalle operazioni e dalle risorse produttive, e Autopilot la mantiene aggiornata. Se Proalpha APS è attivo, stabilite in fase di definizione del perimetro quale sistema gestisce le date delle operazioni. SkyPlanner scriverà quindi solo le date di propria competenza, così i due piani non si sovrascriveranno mai a vicenda.
Possiamo provare SkyPlanner prima di realizzare l’integrazione?
Sì. La prova gratuita di 30 giorni supporta fino a 20 centri di lavoro con un’esportazione CSV o Excel dei vostri ordini di produzione, senza carta di credito. Iniziate la prova oppure contattate il team commerciale per definire il perimetro dell’integrazione.
