Guida all’integrazione di Visma Net per la schedulazione della produzione con SkyPlanner APS

• Visma Net ERP API. Un’interfaccia REST con una specifica OpenAPI ancora denominata “Visma.net ERP API v1”, con percorsi v1 e v2. L’URL di base è https://api.finance.visma.net. Dal 1 febbraio 2026, il vecchio dominio integration.visma.net è soggetto a limitazioni del traffico ed è in fase di dismissione (avviso).
• SalesOrder service v3 all’indirizzo https://salesorder.visma.net. Gli endpoint v1 e v2 per gli ordini di vendita sono giunti a fine vita.
• Webhook tramite Visma Developer Portal.
• Background API. L’header erp-api-background mette in coda le chiamate lunghe, restituisce 202 con un ID dell’attività e invia una notifica quando il risultato è pronto.
• Scenari di importazione ed esportazione in Visma Net, con provider di dati CSV, Excel o SQL, per caricamenti una tantum delle anagrafiche.

L’API non dispone di endpoint per ordini di produzione, cicli di lavorazione o centri di lavoro, perché Visma Net non prevede questi oggetti. I dati per la schedulazione provengono da articoli, kit, ordini e giacenze:

• GET /v1/inventory: articoli gestiti e non gestiti a magazzino, inclusi l’indicatore kit e la classe articolo
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: righe dei componenti per revisione
• GET /v1/kitassembly: assemblaggi esistenti, filtrabili per tipo e stato
• SalesOrder service v3: domanda con date richieste e righe d’ordine
• GET /v1/inventorysummary/{inventoryNumber}: quantità in giacenza e disponibili per magazzino
• GET /v1/purchaseorder e GET /v2/PurchaseReceipt: materiali in arrivo e ricevimenti

Tutti gli endpoint che restituiscono elenchi accettano lastModifiedDateTime con lastModifiedDateTimeCondition, oltre a pageNumber e pageSize: ogni sincronizzazione può quindi essere incrementale.

I webhook del Visma Developer Portal coprono gli eventi rilevanti per la schedulazione:

• Inventory Item Created, Updated e Changed
• Purchase Order Changed e Status Changed
• Sales Order Changed e Status Changed, in fase di migrazione al publisher SalesOrderService

Non sono previsti eventi per Kit assembly o Kit specifications. SkyPlanner li interroga tramite polling con filtri lastModifiedDateTime. Le giacenze vengono interrogate a ogni esecuzione della schedulazione. Nella direzione opposta, SkyPlanner invia webhook quando cambia lo stato o la schedulazione.

1. Caricamento iniziale delle anagrafiche. Leggi gli articoli di magazzino, le classi articolo e l’ultima revisione di Kit specification per ogni kit. Associa ogni riga componente a un materiale di SkyPlanner. Quindi crea ciò che Visma Net non contiene: centri di lavoro, turni, fasi di lavorazione con tempi di attrezzaggio ed esecuzione, matrice dei tempi di attrezzaggio e fabbisogni di utensili. Importa questi dati in formato CSV o Excel. Questa è la parte più consistente del progetto.

2. Sincronizzazione degli ordini. Scegli un modello per la domanda:

• Basato sugli ordini di vendita. Le righe aperte degli ordini di vendita relative ad articoli kit diventano ordini SkyPlanner, con la data richiesta come data di consegna.
• Basato sugli assemblaggi. I Kit assemblies creati in Visma Net con stato On hold diventano operazioni SkyPlanner.

Gli ordini di acquisto aperti vengono importati con le rispettive date. 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. Grazie anche al riepilogo delle giacenze, la schedulazione verifica sia le scorte sia gli acquisti in arrivo.

3. Scrittura della schedulazione in Visma Net. Nella configurazione basata sugli ordini di vendita, SkyPlanner crea un Kit assembly di tipo Production per ogni operazione schedulata. Imposta l’articolo kit, la revisione, il magazzino, la quantità e i componenti, quindi collega l’assemblaggio alla riga dell’ordine di vendita. La data dell’assemblaggio corrisponde alla data di fine prevista. Quando Autopilot sposta l’operazione, una chiamata PUT aggiorna la data prima del rilascio.

Kit assembly dispone di un solo campo Date: gli orari delle singole operazioni restano quindi in SkyPlanner, mentre Visma Net riceve la data rilevante per vendite e magazzino.

4. Consuntivazione in reparto. Gli operatori registrano il lavoro con Mobile Confirmations o Production Timer e le registrazioni dei tempi mantengono aggiornata la schedulazione. Al termine dell’ultima fase, SkyPlanner richiama l’azione di rilascio sul Kit assembly. Il rilascio contabilizza le quantità prodotte e il consumo dei componenti; segue il batch di contabilità generale. Le ore vengono aggregate in Employee time cards settimanali oppure in transazioni di progetto per le lavorazioni gestite per progetto.

5. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima della messa in produzione:

Una modifica a una Kit specification genera una nuova revisione. Rileggi l’ultima revisione e aggiorna la mappatura: solo l’ultima revisione può essere usata per la produzione. Le modifiche manuali ai componenti di un assemblaggio restano valide in Visma Net, quindi SkyPlanner rilegge l’assemblaggio prima del rilascio.

• Nessun ciclo di lavorazione da importare. Tutte le fasi di lavorazione e i tempi di attrezzaggio ed esecuzione vengono definiti in SkyPlanner. Pianifica il lavoro necessario e stabilisci chi se ne occuperà.
• Advanced logistics. Kit assembly richiede il gruppo Advanced logistics. Con Standard logistics, registra la produzione tramite Inventory receipt e Inventory issue.
• Revisioni bloccate. Una revisione di Kit specification già utilizzata non può essere modificata e solo l’ultima revisione può essere usata per la produzione.
• Unità di misura. Kit assembly ha una propria unità di misura. In fase di importazione, allineala alle quantità in SkyPlanner.
• Polling in assenza di eventi. I kit non dispongono di webhook. Per rispettare il limite orario delle richieste, usa aggiornamenti incrementali basati su lastModifiedDateTime, non ricaricamenti completi.
• Endpoint attuali. Sviluppa l’integrazione usando solo api.finance.visma.net e SalesOrder service v3.
• Approvazione del tenant. Le credenziali client non funzionano finché l’amministratore del tenant non approva l’app. Pianifica questo passaggio con anticipo.
• Cartellini ore settimanali. I cartellini ore richiedono Advanced financials e hanno cadenza settimanale. Aggrega le ore degli operatori per settimana oppure registrale come transazioni di progetto.