Integrazioni / ERP / Lemonsoft
Guida all’integrazione di Lemonsoft per la schedulazione della produzione con SkyPlanner APS
Questa guida all’integrazione di Lemonsoft mostra a partner e team IT come collegare Lemonsoft ERP a SkyPlanner APS. SkyPlanner si integra con Lemonsoft in entrambe le direzioni tramite la REST API di Lemonsoft:
- Vengono importati numeri degli ordini di produzione (työnumero), fasi di lavorazione (työvaihe), macchine, strutture di prodotto, materiali e turni pianificati.
- Gli orari di inizio e fine pianificati e la macchina scelta vengono riscritti nelle fasi di lavorazione.
- Le conferme degli operatori vengono inviate a Lemonsoft come registrazioni di completamento.
- I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena avvengono.
Kaskea Group utilizza SkyPlanner con un’integrazione bidirezionale con Lemonsoft. Durante l’avviamento, il team SkyPlanner configura l’integrazione in base alla tua configurazione di Lemonsoft 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 Lemonsoft
L’API di integrazione di Lemonsoft è LemonRest, documentata in Swagger 2.0, versione v1. La build “LemonRest 2026.10 release-2026.10.2” elenca 422 percorsi. (Swagger)
- L’URL di base varia in base all’ambiente. Si trova nella gestione utenti, sotto la gestione degli ambienti e gli indirizzi dei servizi, nel campo Rest API. Sulla piattaforma Azure di Lemonsoft, l’URL di base è
https://rest.lemon.fi. - Disponibilità. Per i clienti del servizio di piattaforma Lemonsoft (Alustapalvelu), le REST API sono preinstallate: è sufficiente assegnare i diritti utente. (fonte)
- Ambiente di test. Il cliente finale lo richiede al Lemonsoft Service Desk.
L’API separata di Kellokortti per la rilevazione delle presenze non è necessaria per la schedulazione.
Autenticazione
LemonRest utilizza una sessione:
POST /api/auth/logincon UserName, Password, Database e ApiKey restituisce unsession_id.- Invialo nell’header
Session-Ida ogni chiamata. - Rinnova la sessione con
POST /api/auth/renew.GET /api/auth/aliveserve a verificarne lo stato.
POST /api/auth/login/token accetta un Token al posto di nome utente e password. Crea un utente dedicato all’integrazione con una chiave API e solo i diritti necessari all’integrazione. (fonte)
Sul lato SkyPlanner, l’accesso alla REST API avviene tramite un token API (SkyPlanner Settings > API). L’API è documentata in Swagger/OpenAPI. Il tutorial di integrazione ti guida nelle prime chiamate.
Rilevamento delle modifiche: query incrementali
LemonRest non dispone di endpoint per webhook o sottoscrizioni. Le modifiche vengono lette con una query incrementale:
GET /api/production/main_ws/changed?updated_after=...restituisce le operazioni modificate dall’ultima esecuzione.- Aggiungi
optimization=true. Questo parametro è stato introdotto nella versione 2026.6.3 per eliminare la dipendenza dai log e velocizzare la query. (note di rilascio) GET /api/log/deletion_eventsrileva le operazioni eliminate, così quelle annullate vengono rimosse dal programma di produzione.
Esegui il polling ogni pochi minuti. SkyPlanner invia webhook quando cambia lo stato o il programma di produzione, quindi la riscrittura dei dati in Lemonsoft è basata su eventi.
Mappatura dei dati
| Oggetto Lemonsoft (endpoint) | Oggetto SkyPlanner | Direzione | Frequenza |
|---|---|---|---|
Tuote, product_code (/api/products) | Prodotti e materiali | Lemonsoft → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Tuoterakenne con righe Työvaiheet (/api/products/structure, all_levels) | Struttura di prodotto, semilavorati, fasi di lavorazione con tempi di attrezzaggio | Lemonsoft → SkyPlanner | Caricamento iniziale, poi a ogni modifica |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Centri di lavoro, gruppi di centri di lavoro | Lemonsoft → SkyPlanner | Caricamento iniziale, poi raramente |
Työnumero come ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Ordini con date di consegna e priorità | Lemonsoft → SkyPlanner | Polling incrementale ogni pochi minuti |
Työvaihe come ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operazioni (fasi di lavorazione) per centro di lavoro | Lemonsoft → SkyPlanner | Polling incrementale ogni pochi minuti |
Fabbisogno di componenti (main_ws/{worknumber}/materials) | Fabbisogni di materiali per operazione | Lemonsoft → SkyPlanner | Con ogni operazione |
Turni pianificati (/api/persons/plannedshifts) | Turni, personale | Lemonsoft → SkyPlanner | Ogni giorno, oppure turni gestiti in SkyPlanner |
Ordine di vendita associato a un numero di ordine di produzione (/api/orders/work/{work_number}) | Informazioni su cliente e priorità | Lemonsoft → SkyPlanner | Con ogni operazione |
Campi start_time, end_time, machine_id di Työvaihe (PUT /api/production/workstage) | Inizio, fine e centro di lavoro pianificati | SkyPlanner → Lemonsoft | A ogni modifica del programma, tramite webhook di SkyPlanner |
Registrazione di completamento (POST main_ws/sub_ws/completion_entry) | Conferme: quantità prodotta e scartata, ore, persona | SkyPlanner → Lemonsoft | A ogni conferma |
| Regole di schedulazione impostate in SkyPlanner | Centri di lavoro ammessi per operazione, matrice dei tempi di attrezzaggio, utensili | Gestiti in SkyPlanner | Configurati durante l’avviamento |
Modalità di integrazione
1. Caricamento iniziale delle anagrafiche. Leggi le macchine e i gruppi di macchine, le strutture di prodotto con le relative fasi di lavorazione e le fasi di lavorazione standard. Associa ogni macchina effettiva a un centro di lavoro SkyPlanner. Usa le macchine padre (Isäkone) solo per raggruppare le macchine, perché sommano la capacità delle macchine figlie.
2. Sincronizzazione degli ordini di produzione. Leggi i numeri degli ordini di produzione aperti con le relative fasi da /api/production/workstage o main_ws/sub_ws, filtrando per stato e usando la paginazione. Poi mantienili aggiornati con main_ws/changed. Mappa work_amount_left, non work_amount, perché Lemonsoft esegue la schedulazione sulla quantità residua. Gli ordini di acquisto alimentano la schedulazione di SkyPlanner basata sulla disponibilità dei materiali, quindi una fase attende la data di consegna dell’ordine di acquisto.
3. Riscrittura del programma di produzione. Per ogni fase inserita o spostata dal motore, SkyPlanner invia PUT /api/production/workstage con l’operazione e le relative sub_workstages. Ogni fase include start_time, end_time e, se è stata spostata su una macchina alternativa, machine_id.
4. Conferme dal reparto. Gli operatori confermano il lavoro con SkyPlanner Mobile Confirmations o Production Timer. Ogni conferma viene inviata a completion_entry con sub_workstage_id, person_number, done_amount, hours, failed_amount e job_done. Quando la fase consuma materiale, invia anche material_consumptions: Lemonsoft esegue una normale registrazione di completamento (valmistuskirjaus).
5. Responsabilità sui dati e regole per i conflitti. Mettile per iscritto prima della messa in produzione:
| Dati | Sistema responsabile |
|---|---|
| Prodotti, strutture, fasi di lavorazione, quantità, stato delle operazioni | Lemonsoft |
| Sequenza delle fasi, orari di inizio e fine, scelta della macchina | SkyPlanner |
| Centri di lavoro ammessi per operazione, matrice dei tempi di attrezzaggio, utensili | SkyPlanner |
| Turni e assenze | Un solo sistema, scelto durante la definizione del perimetro |
| Completamenti e movimenti di magazzino | Lemonsoft, con registrazioni generate dalle conferme di SkyPlanner |
Le principali fonti di conflitto sono la schedulazione automatica di Lemonsoft e l’azione di aggiornamento: entrambe riposizionano le fasi non bloccate. Mantieni AUTOTIMING a 0 finché il programma di produzione è gestito da SkyPlanner. Se lo lasci attivo, imposta il blocco della schedulazione su ogni numero di ordine di produzione riscritto: il blocco fissa tutte le fasi di quell’ordine. La sola funzione Koneiden kapasiteetin lukitus non basta, perché la schedulazione automatica sposta le operazioni non bloccate fuori da una giornata bloccata. (fonte)
Fasi tipiche del progetto
L’implementazione viene normalmente completata nell’arco di alcune settimane dall’inizio dell’avviamento. Prima di questa fase, puoi usare la prova gratuita di 30 giorni con i tuoi dati, esportando in Excel numeri degli ordini di produzione, fasi e macchine.
- Definizione del perimetro. Definisci la tabella di mappatura, le responsabilità sui dati e l’intervallo di polling.
- Accesso. Il cliente finale richiede un ambiente di test al Lemonsoft Service Desk e crea l’utente di integrazione e la chiave API.
- Caricamento iniziale. Macchine, gruppi, strutture di prodotto e fasi di lavorazione.
- Sincronizzazione degli ordini di produzione. Polling incrementale, eventi di eliminazione e rinnovo della sessione.
- Configurazione dei vincoli in SkyPlanner. Centri di lavoro ammessi per ogni operazione, matrice dei tempi di attrezzaggio e utensili.
- Scrittura di ritorno. Orari delle fasi e registrazioni di completamento, verificati nell’ambiente di test.
- Esecuzione in parallelo e avvio in produzione. Confronta i risultati con il Gantt attuale, correggi le anagrafiche, quindi attiva la scrittura di ritorno nell’ambiente di produzione.
Cosa prevedere per un’integrazione con Lemonsoft
- Una macchina per fase. A ogni fase di Lemonsoft è associata una sola macchina. Durante l’avviamento, le macchine ammesse per ciascun prodotto vengono ricavate da un elenco o dalle proprietà del prodotto. SkyPlanner sceglie poi tra le alternative.
- Capacità giornaliera. La capacità fissa è espressa come quantità giornaliera e le variazioni non hanno un orario. Configura i turni effettivi in SkyPlanner oppure acquisisci quelli pianificati.
- Quantità residua. Mappa
work_amount_left. Le impostazioni STARTJOB_AUTOTIMENOW e JOBDONE_AUTOTIMENOW spostano anche il carico gestito da Lemonsoft. - Le sessioni scadono. Rinnova la sessione prima delle sincronizzazioni lunghe e gestisci l’eventuale richiesta di un nuovo accesso.
- Regole per le conferme. Prima di inviare ogni conferma, verificane la validità rispetto allo stato della fase e distribuisci nel tempo le chiamate ravvicinate.
- Due client. LemonOnline e la versione Windows condividono un unico database, quindi l’integrazione serve entrambi.
- Strutture di grandi dimensioni. Per le importazioni di grandi dimensioni, usa
/api/async/product/structureinsieme a/api/async/status/{jobId}.
Integrazione con Lemonsoft: chi si occupa della configurazione e dell’assistenza
Il lavoro comprende la mappatura delle tue macchine, delle fasi di lavorazione e della configurazione di Lemonsoft. Include anche le regole di schedulazione gestite in SkyPlanner: centri di lavoro ammessi per ogni operazione, matrice dei tempi di attrezzaggio e utensili.
- Il team SkyPlanner configura l’integrazione durante l’avviamento e fornisce assistenza dopo la messa in produzione. Ogni stabilimento usa Lemonsoft in modo diverso: è in questa fase che si mettono a frutto queste conoscenze specifiche.
- Il tuo partner Lemonsoft può partecipare. Conosce la tua configurazione e può occuparsi dell’utente API, dei permessi e dell’ambiente di test. SkyPlanner mette a disposizione la REST API, la documentazione Swagger/OpenAPI e i webhook.
- Anche i tuoi sviluppatori possono realizzare estensioni usando la stessa REST API documentata e un token API. Per iniziare basta un token API e il team SkyPlanner fornisce assistenza quando serve.
Una volta attivato il collegamento, il motore Arcturus esegue la schedulazione a partire dagli ordini di lavorazione aggiornati di Lemonsoft e gli orari pianificati vengono riportati sulle fasi di lavorazione. SkyPlanner parte da 199 € al mese con 5 centri di lavoro inclusi e fatturazione mensile. Il preventivo dell’integrazione viene preparato in anticipo in base ai tuoi processi e alle tue esigenze, insieme al piano scelto, così conosci il costo complessivo prima di iniziare.
Confronta le funzioni di pianificazione native di Lemonsoft nella pagina sulla schedulazione della produzione a capacità finita con Lemonsoft. Trovi una panoramica nella pagina Lemonsoft e gli altri sistemi nella sezione dedicata alle integrazioni ERP.
Le recensioni delle aziende manifatturiere su SkyPlanner
Lemonsoftintegrazione bidirezionale con SkyPlanner
Kaskea Group
Produzione conto terzi: lavorazioni CNC, strutture in acciaio e assemblaggio
La produzione viene pianificata in SkyPlanner, con un’integrazione bidirezionale con Lemonsoft.
Menofermi per mancanza di materiali
“Il valore di SkyPlanner per noi è avere uno strumento che funziona nell’uso 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 mancanza di materiali sono diminuiti nettamente.
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 permette di risparmiare 2 ore di lavoro ogni settimana e una nuova coda di lavorazione 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
Lemonsoft dispone di un’API per i dati di produzione?
Sì. LemonRest espone ordini e fasi di lavorazione, macchine, strutture di prodotto, materiali e turni, e consente di registrare i completamenti. È preinstallato per i clienti Alustapalvelu e richiede una chiave API e i permessi utente.
Lemonsoft supporta i webhook?
In LemonRest non sono elencati endpoint per i webhook. Le modifiche vengono lette tramite la query incrementale main_ws/changed e gli eventi di eliminazione, interrogati a intervalli di pochi minuti. I webhook di SkyPlanner inviano le modifiche alla schedulazione non appena si verificano.
Come vengono riscritti in Lemonsoft gli orari pianificati?
Tramite PUT /api/production/workstage, che aggiorna un ordine di lavorazione e le sue fasi con ora di inizio, ora di fine e macchina. Quando la schedulazione è gestita da SkyPlanner, mantieni disattivata la schedulazione automatica di Lemonsoft oppure imposta il blocco della schedulazione su ogni ordine di lavorazione aggiornato, così gli orari restano quelli impostati da SkyPlanner.
Le conferme degli operatori in SkyPlanner possono essere registrate in Lemonsoft?
Sì. Ogni conferma viene registrata come completamento, con quantità prodotta e scartata, ore e persona. Questa funzione viene usata ogni giorno nei progetti dei clienti.
Chi realizza l’integrazione con Lemonsoft?
Il team SkyPlanner configura l’integrazione bidirezionale in base alla tua configurazione di Lemonsoft durante l’avviamento e fornisce assistenza dopo la messa in produzione. Anche il tuo partner Lemonsoft o i tuoi sviluppatori possono realizzare soluzioni 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 da Lemonsoft tramite file Excel o CSV, senza carta di credito. Inizia la prova oppure contatta il team commerciale per definire il perimetro dell’integrazione.
