Integrazioni / ERP / Visma L7
Guida all’integrazione APS con Visma L7 per la schedulazione della produzione
Questa guida spiega a partner e team IT come collegare Visma L7 a SkyPlanner APS. SkyPlanner si integra con Visma L7 in entrambe le direzioni tramite la Visma L7 REST API:
- In ingresso vengono acquisiti numeri di lavoro (työnumero), fasi di lavorazione (työnvaihe), risorse produttive, distinte base, componenti, materiali, giacenze di magazzino, righe di vendita e righe di acquisto.
- Per ogni scheda di lavoro vengono riscritti la risorsa produttiva, la data di inizio, la priorità, la persona assegnata e le ore giornaliere tramite
PUT /manufphases/. - La capacità nel calendario delle risorse produttive viene mantenuta allineata tramite
POST /resourceupdates/. - Gli eventi di produzione registrati nelle code di lavoro di L7 vengono riletti tramite
GET /manufevents/. - 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 configurazione di L7 e fornisce assistenza anche dopo la messa in produzione. Partner e sviluppatori possono inoltre realizzare integrazioni usando la REST API documentata di SkyPlanner (riferimento API).
La REST API di Visma L7
L’API è Visma L7 – REST API, documentata in formato OpenAPI 3.0.3 con un registro delle modifiche (documentazione). Viene eseguita su Visma LTR.
- Il percorso di base è
/ltrws/REST/L7sull’host LTR dell’azienda, installato in sede o nel servizio applicativo ospitato da Visma. - Licenze. Ogni endpoint richiede una licenza distinta. Per scrivere il programma di produzione serve la licenza L7RMFPP per
PUT /manufphases/; per aggiornare la capacità serve L7RMCAP. Anche gli endpoint di lettura richiedono licenze specifiche. - Paginazione. Gli elenchi vengono paginati con
pageSizeerecAftere filtrati conqueryKey1,queryKey2equeryString.
Autenticazione
Ogni chiamata a L7 include due token:
- hash seleziona il database e l’azienda.
- token identifica l’utente API.
L’amministratore LTR crea l’utente API in Visma LTR, lo collega all’azienda L7, gli assegna i profili e crea il token utente (primi passi). Usare un utente dedicato all’integrazione, con i soli diritti necessari.
Sul lato SkyPlanner, l’autenticazione della REST API avviene tramite un token API inviato nell’header Authorization-Token. Il token si crea in Settings > API. Il tutorial di integrazione spiega come effettuare le prime chiamate.
Rilevamento delle modifiche: modifiedAfter
La L7 REST API non dispone di webhook. Le modifiche vengono lette tramite polling:
- Attivare la registrazione delle modifiche (DBLOG) nella manutenzione file di L7 (Tiedostohuolto) per le tabelle lette dall’integrazione, come quelle delle schede di lavoro e dei componenti.
- Chiamare gli endpoint di lettura impostando
modifiedAftersulla data e ora dell’ultima esecuzione. I record eliminati vengono restituiti con un contrassegno di eliminazione, così le lavorazioni annullate vengono rimosse dal programma. - Eseguire il polling ogni pochi minuti. SkyPlanner invia webhook quando cambia lo stato o il programma di produzione, quindi la riscrittura dei dati viene attivata dagli eventi.
Mappatura dei dati
| Oggetto Visma L7 (endpoint) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
Tuote (GET /products/) | Prodotti e materiali | L7 → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Componenti di un numero di lavoro (GET /manufcomponents/) | Sottoprodotti | L7 → SkyPlanner | Polling con modifiedAfter |
Fabbisogni di materiali (GET /manufmaterials/) | Fabbisogni di materiali per operazione | L7 → SkyPlanner | Polling con modifiedAfter |
Gerarchia delle risorse produttive (KRYH) con numero di macchine (GET /manufresources/) | Centri di lavoro e gruppi di centri di lavoro | L7 → SkyPlanner | Caricamento iniziale, poi raramente |
Scheda di lavoro (TSUUNR) per fase (GET /manufphases/) | Operazioni (fasi di processo) per centro di lavoro | L7 → SkyPlanner | Polling ogni pochi minuti |
Giacenze di magazzino (GET /stockbalances/) | Scorte | L7 → SkyPlanner | Polling |
Righe di acquisto (GET /purchaserows/) | Ordini di acquisto con date di consegna | L7 → SkyPlanner | Polling |
Ordini e righe di vendita (GET /salesorders/, GET /salesrows/) | Date di consegna richieste, priorità del cliente | L7 → SkyPlanner | Polling |
Eventi di produzione (GET /manufevents/) | Avanzamento per operazione | L7 → SkyPlanner | Polling |
Campi resource, startDate, priority, person, schedulingDays della scheda di lavoro (PUT /manufphases/) | Centro di lavoro, inizio, sequenza e ore giornaliere pianificati | SkyPlanner → L7 | A ogni modifica del piano di schedulazione, tramite webhook di SkyPlanner |
Capacità nel calendario delle risorse produttive (POST /resourceupdates/) | Capacità dei turni | SkyPlanner → L7 | Quando cambiano i turni |
| Regole di schedulazione impostate in SkyPlanner | Centri di lavoro ammessi, matrice dei tempi di attrezzaggio, utensili, persone | Gestiti in SkyPlanner | Configurazione durante l’avviamento |
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Leggere la gerarchia delle risorse produttive e associare ogni macchina a un centro di lavoro distinto in SkyPlanner. Se una risorsa di L7 comprende più macchine, creare un centro di lavoro per ogni macchina e un gruppo di centri di lavoro per la risorsa. Leggere i prodotti e le distinte base con le relative fasi di lavorazione.
2. Sincronizzazione dei numeri di lavoro. Leggere le schede di lavoro aperte con GET /manufphases/, quindi mantenerle aggiornate con modifiedAfter. Leggere i componenti e i fabbisogni di materiali per ogni numero di lavoro, insieme alle giacenze di magazzino e alle righe di acquisto, in modo che ogni fase attenda la data di consegna della relativa riga di acquisto.
3. Riscrittura del programma di produzione. Per ogni fase che il motore ha collocato o spostato, SkyPlanner chiama PUT /manufphases/. Il corpo della richiesta contiene una voce workSheet per ogni scheda di lavoro, con:
number, la scheda di lavoro, eresource, la risorsa produttiva sceltastartDateepriority, affinché le code di lavoro di L7 mostrino la sequenza di SkyPlannerperson, quando è prevista l’assegnazione a un operatore specificoschedulingDays, le ore pianificate per ogni data
L7 mantiene invariata la priorità impostata da un sistema esterno (fonte), quindi la sequenza viene mantenuta nelle code di lavoro.
4. Sincronizzazione della capacità. Quando in SkyPlanner cambiano turni, festività o straordinari, POST /resourceupdates/ scrive la nuova capacità nel calendario delle risorse produttive di L7. Le viste del carico di L7 risultano così allineate al piano.
5. Avanzamento in reparto. Gli operatori continuano a registrare le attività nelle code di lavoro di L7 e in Visma LTR, mentre SkyPlanner legge gli eventi con GET /manufevents/. Gli operatori possono anche confermare le lavorazioni in SkyPlanner Mobile Confirmations. Autopilot ricalcola il programma in base ai dati provenienti dall’una o dall’altra fonte e la successiva riscrittura trasmette i nuovi orari.
6. Responsabilità sui dati e regole per i conflitti. Documentarle prima della messa in produzione:
| Dati | Sistema responsabile |
|---|---|
| Prodotti, distinte base, fasi di lavorazione, quantità, stato del numero di lavoro | Visma L7 |
| Sequenza delle fasi, date di inizio, ore giornaliere, scelta della risorsa produttiva | SkyPlanner |
| Centri di lavoro ammessi, matrice dei tempi di attrezzaggio, utensili, persone | SkyPlanner |
| Turni e assenze | SkyPlanner, con scrittura nel calendario delle risorse produttive di L7 |
| Eventi di produzione e movimenti di magazzino | Code di lavoro di Visma L7 e LTR |
La principale fonte di conflitti è la pianificazione interna di L7. Il calcolo dei fabbisogni e la pianificazione di dettaglio possono ricollocare le fasi non bloccate. Eseguirli solo per i materiali e le prenotazioni, senza ripianificare le fasi gestite da SkyPlanner.
Le fasi tipiche del progetto
L’implementazione viene normalmente completata nel giro di poche settimane dall’inizio dell’avviamento. Prima di questa fase, la prova gratuita di 30 giorni utilizza i dati aziendali ricavati da un’esportazione Excel di numeri di lavoro, fasi e risorse produttive.
- Definizione del perimetro. Definire la tabella di mappatura, le responsabilità sui dati e l’intervallo di polling.
- Accesso e licenze. Attivare le licenze degli endpoint REST inclusi nel perimetro. L’amministratore LTR crea l’utente API, hash e token, preferibilmente iniziando da un’azienda di test.
- Registrazione delle modifiche. Attivare DBLOG per le tabelle lette dall’integrazione.
- Caricamento iniziale. Risorse produttive, prodotti, distinte base e fasi di lavorazione.
- Sincronizzazione dei numeri di lavoro. Polling con modifiedAfter, eliminazioni e paginazione.
- Configurazione dei vincoli in SkyPlanner. Centri di lavoro ammessi, matrice dei tempi di attrezzaggio, utensili e persone.
- Riscrittura dei dati.
PUT /manufphases/ePOST /resourceupdates/, collaudati nell’azienda di test. - Esecuzione in parallelo e messa in produzione. Confrontare i risultati con il piano attuale, correggere le anagrafiche e poi attivare la riscrittura dei dati nell’ambiente di produzione.
Cosa prevedere per un’integrazione con Visma L7
- Licenze per endpoint. Elenca fin dall’inizio tutti gli endpoint e attiva le relative licenze prima dei test.
- Numero di macchine. In L7, una risorsa produttiva con più macchine ripartisce il lavoro tra queste (fonte). Suddividila in più centri di lavoro in SkyPlanner e ritrasmetti a L7 la risorsa prevista.
- Ore giornaliere. L7 memorizza il piano in ore per data. SkyPlanner invia i dati
schedulingDays, la cui somma corrisponde alla durata della fase. - Calendario di fabbrica. Mantienilo completo: le lacune fanno sì che le fasi vengano schedulate su date passate (fonte).
- Ordini per magazzino.
mainNumber,subNumber,rowNumberenewQuantityservono solo a modificare la quantità di un ordine per magazzino. Omettili per le lavorazioni su ordine cliente. - Il prossimo ERP. Visma ha interrotto lo sviluppo di nuove funzionalità per L7 e l’utilizzo del prodotto terminerà alla fine del 2028 (avviso di Visma). Mantieni le regole di schedulazione in SkyPlanner, non nei campi di L7, così potrai conservarle quando cambierai ERP.
Integrazione con Visma L7: chi la configura e fornisce assistenza
Il lavoro comprende la mappatura delle risorse produttive e delle fasi di lavorazione in base alla tua configurazione di L7. Include anche le regole di schedulazione gestite in SkyPlanner: centri di lavoro consentiti, matrice dei tempi di attrezzaggio, utensili e personale.
- Il team SkyPlanner configura l’integrazione durante l’avviamento e fornisce assistenza dopo la messa in produzione. Ogni stabilimento usa L7 in modo diverso: è qui che entra in gioco questa conoscenza specifica.
- Il tuo partner Visma può partecipare. Conosce la tua configurazione di L7 e LTR e può occuparsi dell’utente API, delle licenze e dell’azienda di test. SkyPlanner mette a disposizione la REST API, la documentazione Swagger/OpenAPI e i webhook.
- Anche i tuoi sviluppatori possono realizzare ulteriori integrazioni usando la stessa REST API documentata con un token API. Per iniziare basta un token API e il team SkyPlanner offre assistenza quando serve.
Quando sostituisci L7, la stessa configurazione di SkyPlanner si collega al nuovo ERP. Consulta le pagine dedicate a Business Central, Visma Net, Lemonsoft, Monitor ERP e Odoo.
SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. Il preventivo per l’integrazione viene preparato in anticipo in base ai tuoi processi e alle tue esigenze, insieme a quello per il piano scelto, così conosci il costo complessivo prima di iniziare.
Per un confronto con la pianificazione nativa di L7, leggi Visma L7 offre la schedulazione della produzione a capacità finita? Trovi una panoramica nella pagina di Visma L7 e gli altri sistemi nella sezione dedicata alle integrazioni ERP.
Le recensioni delle aziende manifatturiere su SkyPlanner
1.000 e piùordini di lavoro schedulati automaticamente
“Abbiamo un controllo diverso sulla produzione e 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 lavoro vengono schedulati automaticamente e tutta l’organizzazione ha una visione della produzione in tempo reale.
98%di affidabilità delle consegne, rispetto al 50% circa iniziale
“SkyPlanner svolge un ruolo decisivo nel mantenere l’affidabilità delle nostre consegne.”
Hannu Lahtinen, amministratore delegato
KJH-Comp · Lavorazione della lamiera e produzione conto terzi
L’affidabilità delle consegne è passata da circa il 50% fino al 98% e ora per la schedulazione basta un solo responsabile anziché due.
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 catena di fornitura
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 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.
Domande frequenti
Visma L7 dispone di un’API per i dati di produzione?
Sì. La REST API di Visma L7 su Visma LTR espone fasi di lavorazione, risorse produttive, componenti, materiali, eventi di produzione, prodotti, giacenze di magazzino, righe di vendita e righe di acquisto. Ogni endpoint richiede una licenza separata e l’amministratore LTR crea l’utente API e i token.
Come viene trasferito il piano da SkyPlanner a Visma L7?
Tramite PUT /manufphases/, che aggiorna per ogni scheda di lavoro la risorsa produttiva, la data di inizio, la priorità, la persona e le ore pianificate per data. POST /resourceupdates/ scrive la capacità nel calendario delle risorse produttive. L7 mantiene la priorità esterna, quindi le code di lavoro seguono l’ordine definito da SkyPlanner.
Visma L7 supporta i webhook?
Non sono documentati webhook. Attiva la registrazione delle modifiche per le tabelle comprese nel perimetro ed esegui il polling con modifiedAfter. I webhook di SkyPlanner inviano le modifiche al piano non appena avvengono.
Quale software di schedulazione si integra con Visma L7?
SkyPlanner APS si integra con Visma L7 in entrambe le direzioni tramite la REST API di L7 e Visma elenca Skycode con SkyPlanner nella sua pagina delle integrazioni di L7. Il team SkyPlanner configura l’integrazione durante l’avviamento.
Chi realizza l’integrazione con Visma L7?
Il team SkyPlanner configura l’integrazione bidirezionale in base alla tua configurazione di L7 durante l’avviamento e fornisce assistenza dopo la messa in produzione. Anche il tuo partner Visma o i tuoi sviluppatori possono realizzare integrazioni usando la REST API documentata di SkyPlanner: per iniziare basta un token API.
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 L7, senza carta di credito. Inizia la prova oppure contatta il team commerciale per la definizione del perimetro dell’integrazione.
