Integrazioni / ERP / Acumatica Cloud ERP
Guida all’integrazione di Acumatica con SkyPlanner APS per la schedulazione della produzione
Questa guida mostra a partner e team IT come collegare Acumatica Cloud ERP (Manufacturing Edition) a SkyPlanner APS. L’integrazione tra SkyPlanner e Acumatica è bidirezionale:
- SkyPlanner riceve gli ordini di produzione con le relative operazioni, i centri di lavoro, le macchine, gli utensili, i turni, gli articoli a magazzino e gli ordini di acquisto.
- Le date di inizio e fine pianificate vengono scritte nelle operazioni dell’ordine di produzione e l’ordine viene reso definitivo.
- Le registrazioni dei tempi degli operatori tornano in Acumatica come registrazioni di manodopera e di avanzamento.
- I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono.
Durante l’avviamento, il team SkyPlanner configura l’integrazione in base alla configurazione di Acumatica e continua a fornire assistenza dopo la messa in produzione. Questa guida si rivolge a partner e sviluppatori che vogliono partecipare al progetto o sviluppare autonomamente soluzioni usando la REST API documentata di SkyPlanner (documentazione di riferimento dell’API).
Le interfacce di integrazione di Acumatica
L’integrazione utilizza le interfacce già incluse in Acumatica. Non viene installato nulla nell’istanza.
- REST API basata su contratto. Gli endpoint hanno una versione che segue quella del rilascio. L’endpoint Manufacturing (ad esempio 26.200.001 per 2026 R2) espone
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryeMaterialEntry. L’endpoint Default comprendeStockItem,PurchaseOrdereSalesOrder. Gli URL seguono lo schema{instance}/entity/{Endpoint}/{version}/{Entity}. - Azioni sullo stesso endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryeReleaseMaterialEntryeseguono la stessa logica dei pulsanti nelle schermate. - OData. Qualsiasi Generic Inquiry (SM208000) può essere esposta tramite OData. Una Generic Inquiry delle operazioni di produzione aperte, con le relative date, è il modo più rapido per leggere i dati in blocco.
- Notifiche push (SM302000). Basate su una Generic Inquiry o su una query predefinita, inviano le righe inserite ed eliminate a un URL configurabile.
- Scenari di importazione ed esportazione con provider CSV ed Excel per il caricamento massivo.
Le entità e le azioni sono elencate nella schermata Web Service Endpoints (SM207000) e nel repository del client REST di Acumatica.
Autenticazione e limiti
Acumatica utilizza OAuth 2.0 e OpenID Connect tramite applicazioni client registrate nella schermata Connected Applications (SM303010). I flussi documentati sono Authorization Code, Implicit, Resource Owner Password Credentials e Hybrid. Per un’integrazione server, registra un utente dedicato all’integrazione con ruoli limitati ai privilegi strettamente necessari e utilizza Authorization Code con un refresh token oppure Resource Owner Password Credentials.
I limiti dipendono dalla licenza: la schermata License Monitoring Console (SM604000) mostra il numero consentito di richieste API al minuto e di utenti API.
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 spiega come effettuare le prime chiamate.
Mappatura dei dati
| Oggetto Acumatica (endpoint / schermata) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Prodotti e materiali | Acumatica → SkyPlanner | Caricamento iniziale, poi aggiornamenti incrementali |
BillOfMaterial (AM208000): materiali, operazioni | Struttura del prodotto, prodotti di livello inferiore, materiali per prodotto | Acumatica → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
| Operazioni della BOM: Setup, Run, Machine, Queue, Finish, Move Time | Fasi del processo con durate, tempi di attrezzaggio e disattrezzaggio | Acumatica → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Centri di lavoro, gruppi di centri di lavoro, efficienze, centri di lavoro alternativi | Acumatica → SkyPlanner | Caricamento iniziale, poi raramente |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Turni e capacità del personale | Acumatica → SkyPlanner | Ogni giorno, oppure turni gestiti in SkyPlanner |
Tool (AM205500) | Utensili come risorse produttive a capacità finita | Acumatica → SkyPlanner | Caricamento iniziale |
ProductionOrder con OrderOperationDetail (Planned, Released, In Process) | Ordini e lavorazioni con scadenze, priorità di esecuzione e fabbisogni di materiali | Acumatica → SkyPlanner | Notifica push o polling ogni pochi minuti |
Righe di PurchaseOrder (Default) | Ordini di acquisto con data di consegna prevista | Acumatica → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
| Quantità degli articoli per magazzino | Giacenze di magazzino | Acumatica → SkyPlanner | Polling ogni ora o a ogni esecuzione della schedulazione |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Inizio, fine e centro di lavoro pianificati per ogni operazione | SkyPlanner → Acumatica | A ogni modifica della schedulazione, tramite webhook di SkyPlanner |
Azione FirmProductionOrder | Impedisce ad Acumatica APS di modificare le date scritte | SkyPlanner → Acumatica | Dopo ogni scrittura dei dati in Acumatica |
LaborEntry, MoveEntry con azioni di rilascio | Registrazioni dei tempi, quantità completate, conferme degli operatori | SkyPlanner → Acumatica | A ogni conferma o per turno |
| Non presenti in Acumatica | Matrice dei tempi di attrezzaggio, operatori nominativi, lavorazioni con più operatori | Gestiti in SkyPlanner | Configurati durante l’avviamento |
Schemi di integrazione
1. Caricamento iniziale delle anagrafiche. Leggi prima i centri di lavoro, le macchine, gli utensili, i turni e i calendari. Poi leggi gli articoli a magazzino e le distinte base. Decidi come mappare un centro di lavoro con più macchine: come un gruppo di centri di lavoro in cui ogni macchina è un centro di lavoro, oppure come un unico centro di lavoro. Il campo Basis for Capacity di Acumatica indica quale logica segue lo stabilimento.
2. Sincronizzazione degli ordini. Leggi gli ordini di produzione e le relative operazioni dall’ordine, non dalla BOM. Le operazioni vengono copiate nell’ordine ed è lì che i pianificatori le modificano. Configura una notifica push su una Generic Inquiry degli ordini e delle operazioni aperti, oppure interrogala tramite polling. Leggi anche le 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.
3. Scrittura della schedulazione in Acumatica. Per ogni operazione inserita o spostata dal motore, SkyPlanner scrive StartDate ed EndDate in OrderOperationDetail, insieme al centro di lavoro se la lavorazione è stata spostata su uno alternativo. Quindi richiama FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Quando si esegue la schedulazione a capacità finita degli ordini di produzione, il sistema non rischedula gli ordini di produzione resi definitivi.) (fonte)
4. Conferme dal reparto produttivo. Gli operatori registrano il lavoro con SkyPlanner Mobile Confirmations o Production Timer. Le registrazioni dei tempi diventano documenti LaborEntry (tempo e quantità completata per operazione) oppure documenti MoveEntry (solo quantità), rilasciati con l’azione corrispondente. Se il reparto registra già gli avanzamenti in Acumatica, tramite Labor (AM301000) o Shop Floor Kiosk, i dati di avanzamento fluiscono nella direzione opposta. Scegli un solo canale, mai entrambi.
5. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima della messa in produzione:
| Dati | Sistema responsabile |
|---|---|
| Articoli a magazzino, distinte base, quantità, stato degli ordini, calcolo dei costi | Acumatica |
| Sequenza delle operazioni, orari di inizio e fine, assegnazione ai centri di lavoro | SkyPlanner |
| Matrice dei tempi di attrezzaggio, utensili, fabbisogni di operatori, alternative | SkyPlanner |
| Turni e assenze | Un solo sistema, scelto durante la definizione del perimetro |
| Registrazioni di manodopera e di avanzamento | Acumatica, con registrazioni provenienti dai tempi rilevati in SkyPlanner o inserite in reparto |
La principale fonte di conflitti è l’APS di Acumatica stesso. Rough Cut Planning o APS Maintenance Process possono ricalcolare le date degli ordini schedulati da SkyPlanner. Rendere definitivo ogni ordine dopo la scrittura impedisce che ciò avvenga. Escludi inoltre gli ordini già schedulati dalle elaborazioni APS.
Le fasi tipiche del progetto
L’implementazione si completa normalmente nel giro di poche settimane dall’inizio dell’onboarding. Prima, puoi usare i tuoi dati nella prova gratuita di 30 giorni. Esporta in Excel da una Generic Inquiry i centri di lavoro e gli ordini di produzione aperti con le relative operazioni, importali e verifica la schedulazione.
- Mappatura. Definisci la tabella di mappatura, le regole su quale sistema gestisce ciascun dato, le frequenze di sincronizzazione e il canale per registrare le ore di manodopera.
- Accesso. Registra l’applicazione connessa, crea l’utente e i ruoli per l’integrazione e conferma la versione dell’endpoint in Web Service Endpoints. Parti dall’ambiente sandbox.
- Caricamento iniziale. Centri di lavoro, macchine, utensili, turni, articoli a magazzino e distinte base.
- Sincronizzazione degli ordini. Ordini di produzione, operazioni e ordini di acquisto tramite notifiche push o polling.
- Configurazione dei vincoli in SkyPlanner. Matrice dei tempi di attrezzaggio, operatori nominativi, lavorazioni con più operatori e alternative.
- Scrittura dei dati in Acumatica. Date delle operazioni, ordini resi definitivi e registrazioni di manodopera o avanzamento.
- Esecuzione in parallelo. Confronta le date di SkyPlanner con il piano attuale e correggi le anagrafiche.
- Avvio in produzione. Attiva la scrittura dei dati in Acumatica quando i dati corrispondono.
Cosa prevedere per un’integrazione con Acumatica
- Verifica quale motore APS è attivo. Classic e Optimized memorizzano le impostazioni separatamente e solo uno dei due può essere abilitato. Controlla Enable/Disable Features (CS100000) prima della prima scrittura dei dati in Acumatica.
- Fissa la versione dell’endpoint. La versione fa parte dell’URL. Ogni aggiornamento di release aggiunge una nuova versione: ripeti quindi i test a ogni aggiornamento.
- Aggiornamento delle operazioni. Alcuni campi delle operazioni sono di sola lettura tramite REST e anche lo stato dell’ordine influisce. Prova in un ambiente sandbox la sequenza di scrittura dei dati per gli ordini negli stati Released e In Process.
- Unità e campi temporali. Il tempo di lavorazione è riferito a Run Units, il tempo macchina a Machine Units. I tempi di coda e di movimentazione “affect the calculated schedule but do not occupy work center capacity.” (influiscono sulla schedulazione calcolata, ma non occupano la capacità del centro di lavoro). Esegui con attenzione le conversioni durante l’importazione.
- Disponibilità dei materiali. Classic APS richiede che tutti i materiali siano disponibili per l’intera quantità. SkyPlanner pianifica in base alle scorte e alle date di arrivo degli ordini di acquisto. Concorda quale indicazione devono seguire i pianificatori.
- Limiti API. Il numero di richieste al minuto dipende dalla licenza. Usa letture incrementali e notifiche push, non ricaricamenti completi.
Chi configura l’integrazione con Acumatica e fornisce assistenza
- Il team SkyPlanner configura l’integrazione durante l’onboarding e fornisce assistenza dopo l’avvio in produzione. Ogni stabilimento usa Acumatica in modo diverso: è qui che entra in gioco questa esperienza.
- Il tuo partner Acumatica può partecipare. Conosce le tue personalizzazioni, le Generic Inquiries e i ruoli. SkyPlanner mette a disposizione la REST API, la documentazione Swagger/OpenAPI e i webhook.
- Anche i tuoi sviluppatori possono realizzare l’integrazione usando la stessa REST API con un token API. Per iniziare basta un token API e il team SkyPlanner interviene quando serve. Laboratory & Allied ha scelto questa strada con SAP Business One: il suo team IT interno ha realizzato l’integrazione in gran parte autonomamente, con il supporto di SkyPlanner.
SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. L’integrazione viene preventivata in anticipo in base ai tuoi processi e alle tue esigenze, insieme al piano scelto, così conosci il costo complessivo prima di iniziare. Per un confronto con l’APS di Acumatica, consulta Schedulazione della produzione a capacità finita con Acumatica. Trovi una panoramica nella pagina dedicata ad Acumatica e gli altri sistemi nella sezione sulle integrazioni ERP.
Le aziende manifatturiere raccontano 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 la 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 il controllo della produzione è diverso e la nostra conoscenza della capacità produttiva è su tutt’altro livello.”
Hannu Ryynänen, amministratore delegato
Mamec · Miscelatori industriali, pompe e produzione conto terzi ad alta tecnologia
Migliaia di ordini di lavoro vengono schedulati automaticamente, con una visione della produzione in tempo reale per tutta l’organizzazione.
99,2%di affidabilità delle consegne
“SkyPlanner ci ha dato la visibilità necessaria per 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 sistemi di raccolta delle acque piovane
Quest’anno l’affidabilità delle consegne ha raggiunto il 99,2% e la schedulazione consente di risparmiare fino a quattro ore di lavoro al giorno.
Domande frequenti
L’API di Acumatica include gli ordini di produzione?
Sì. L’endpoint Manufacturing della REST API basata su contratto espone ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool e le registrazioni di manodopera e avanzamento, oltre ad azioni come FirmProductionOrder.
Chi realizza l’integrazione con Acumatica?
Il team SkyPlanner configura l’integrazione bidirezionale in base alla tua configurazione di Acumatica durante l’onboarding e fornisce assistenza dopo l’avvio in produzione. Anche il tuo partner Acumatica o i tuoi sviluppatori possono realizzarla usando la REST API documentata di SkyPlanner: per iniziare basta un token API.
Serve Acumatica APS per questa integrazione?
No. In Acumatica la schedulazione a capacità finita viene eseguita dalla maschera Rough Cut Planning, mentre Classic APS pianifica a capacità infinita gli ordini che terminano oltre 120 giorni (fonte). SkyPlanner crea autonomamente una schedulazione dettagliata a capacità finita a partire da ordini di produzione, operazioni, centri di lavoro, macchine e utensili. L’integrazione funziona quindi indipendentemente dall’attivazione di APS, che secondo Acumatica “is subject to licensing” (è soggetto a licenza). Autopilot mantiene aggiornata la schedulazione e gli operatori registrano il lavoro con Mobile Confirmations.
Come impedire che Acumatica APS sovrascriva le date di SkyPlanner?
SkyPlanner rende definitivo ogni ordine di produzione dopo aver scritto le date delle relative operazioni. La schedulazione a capacità finita di Acumatica non ripianifica gli ordini resi definitivi.
Acumatica può inviare le modifiche in tempo reale?
Sì. Le notifiche push (SM302000) configurate su una Generic Inquiry inviano le righe modificate a un URL non appena avvengono le modifiche. I webhook di SkyPlanner inviano invece le modifiche alla schedulazione nella direzione opposta.
Quale metodo di autenticazione deve usare l’integrazione?
OAuth 2.0 tramite un client registrato in Connected Applications (SM303010), con un utente dedicato all’integrazione e ruoli con i soli privilegi necessari. Il flusso viene confermato per la tua istanza durante la definizione del perimetro.
Possiamo provare SkyPlanner prima di realizzare l’integrazione?
Sì. La prova gratuita di 30 giorni supporta fino a 20 centri di lavoro con importazioni Excel o CSV da una Generic Inquiry di Acumatica, senza carta di credito. Inizia la prova oppure contatta il team commerciale per definire il perimetro dell’integrazione.
