Integrationer / ERP / Lemonsoft
Guide till Lemonsoft-integration för produktionsplanering med SkyPlanner APS
Den här guiden visar partner och IT-team hur Lemonsoft ERP ansluts till SkyPlanner APS. SkyPlanner integreras med Lemonsoft i båda riktningarna via Lemonsofts REST API:
- Arbetsnummer (työnumero), arbetssteg (työvaihe), maskiner, produktstrukturer, material och planerade skift läses in.
- Planerade start- och sluttider samt vald maskin återförs till arbetsstegen.
- Operatörernas kvitteringar återförs som färdigrapporteringar.
- SkyPlanners webhooks skickar planändringar direkt när de sker.
Kaskea Group använder SkyPlanner med en dubbelriktad integration med Lemonsoft. SkyPlanner-teamet konfigurerar integrationen efter er Lemonsoft-miljö under införandet och ger support efter driftstart. Partner och utvecklare kan också bygga egna lösningar med SkyPlanners dokumenterade REST API (API-referens).
Lemonsofts REST API
Lemonsofts API för integrationer heter LemonRest och är dokumenterat i Swagger 2.0, version v1. Byggversionen ”LemonRest 2026.10 release-2026.10.2” listar 422 sökvägar. (Swagger)
- Bas-URL:en är specifik för varje miljö. Den finns i användarhanteringen, under miljöhantering och tjänsteadresser, i fältet Rest API. På Lemonsofts Azure-plattform är basadressen
https://rest.lemon.fi. - Tillgänglighet. För kunder som använder Lemonsofts plattformstjänst (Alustapalvelu) är REST API:erna förinstallerade. Det enda som behövs är användarbehörigheter. (källa)
- Testmiljö. Slutkunden beställer den från Lemonsoft Service Desk.
Det separata API:et för tidrapportering i Kellokortti behövs inte för produktionsplaneringen.
Autentisering
LemonRest använder en session:
POST /api/auth/loginmed UserName, Password, Database och ApiKey returnerar ettsession_id.- Skicka det i headern
Session-Idvid varje anrop. - Förnya sessionen med
POST /api/auth/renew. AnvändGET /api/auth/aliveför hälsokontrollen.
POST /api/auth/login/token tar emot en Token i stället för användarnamn och lösenord. Skapa en särskild integrationsanvändare med en API-nyckel och bara de behörigheter som integrationen behöver. (källa)
På SkyPlanner-sidan använder REST API en API-token för autentisering (SkyPlanner Settings > API) och är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Identifiera ändringar med deltafrågor
LemonRest saknar endpoints för webhooks och prenumerationer. Ändringar läses med en deltafråga:
GET /api/production/main_ws/changed?updated_after=...returnerar operationer som har ändrats sedan den senaste körningen.- Lägg till
optimization=true. Parametern infördes i version 2026.6.3 för att ta bort beroendet av loggen och göra frågan snabbare. (versionsinformation) GET /api/log/deletion_eventsfångar upp borttagna operationer så att avbrutna arbeten tas bort ur planen.
Gör avfrågningar med några minuters mellanrum. SkyPlanner skickar webhooks när status eller planen ändras, så återföringen är händelsestyrd.
Datamappning
| Lemonsoft-objekt (endpoint) | SkyPlanner-objekt | Riktning | Frekvens |
|---|---|---|---|
Tuote, product_code (/api/products) | Produkter och material | Lemonsoft → SkyPlanner | Första inläsningen, därefter vid ändringar |
Tuoterakenne med Työvaiheet-rader (/api/products/structure, all_levels) | Produktstruktur, underprodukter, processteg med ställtider | Lemonsoft → SkyPlanner | Första inläsningen, därefter vid ändringar |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Produktionsgrupper, grupperingar av produktionsgrupper | Lemonsoft → SkyPlanner | Första inläsningen, sällan därefter |
Työnumero som ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Order med leveransdatum och prioritet | Lemonsoft → SkyPlanner | Deltaavfrågningar med några minuters mellanrum |
Työvaihe som ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operationer (processteg) per produktionsgrupp | Lemonsoft → SkyPlanner | Deltaavfrågningar med några minuters mellanrum |
Komponentbehov (main_ws/{worknumber}/materials) | Materialbehov per operation | Lemonsoft → SkyPlanner | Med varje operation |
Planerade skift (/api/persons/plannedshifts) | Skift, personal | Lemonsoft → SkyPlanner | Dagligen, alternativt hanteras skiften i SkyPlanner |
Kundorder kopplad till ett arbetsnummer (/api/orders/work/{work_number}) | Information om kund och prioritet | Lemonsoft → SkyPlanner | Med varje operation |
Työvaihe start_time, end_time, machine_id (PUT /api/production/workstage) | Planerad start, planerat slut och vald produktionsgrupp | SkyPlanner → Lemonsoft | När planen ändras, via en webhook från SkyPlanner |
Färdigrapportering (POST main_ws/sub_ws/completion_entry) | Kvitteringar: färdig och kasserad kvantitet, timmar, person | SkyPlanner → Lemonsoft | Vid varje kvittering |
| Planeringsregler som anges i SkyPlanner | Tillåtna produktionsgrupper per operation, ställtidsmatris, verktyg | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsflöden
1. Första inläsningen av grunddata. Läs in maskiner och maskingrupper, produktstrukturer med tillhörande arbetssteg samt standardarbetssteg. Mappa varje enskild maskin till en produktionsgrupp i SkyPlanner. Använd överordnade maskiner (Isäkone) enbart för gruppering, eftersom de summerar de underordnade maskinernas kapacitet.
2. Synkronisering av arbetsnummer. Läs in öppna arbetsnummer med tillhörande steg från /api/production/workstage eller main_ws/sub_ws, med statusfiltrering och paginering. Håll dem sedan uppdaterade med main_ws/changed. Mappa work_amount_left, inte work_amount, eftersom Lemonsoft planerar utifrån återstående kvantitet. Inköpsorder ger underlag till SkyPlanners materialstyrda planering, så ett steg väntar till inköpsorderns leveransdatum.
3. Återföring av planen. För varje steg som planeringsmotorn har placerat eller flyttat skickar SkyPlanner PUT /api/production/workstage med operationen och dess sub_workstages. Varje steg innehåller start_time och end_time samt machine_id om det har flyttats till en alternativ maskin.
4. Kvitteringar från produktionen. Operatörerna kvitterar arbetet med SkyPlanner Mobile Confirmations eller Production Timer. Varje kvittering skickas till completion_entry med sub_workstage_id, person_number, done_amount, hours, failed_amount och job_done. Skicka även med material_consumptions när steget förbrukar material. Lemonsoft gör då en vanlig färdigrapportering (valmistuskirjaus).
5. Regler för dataägarskap och konflikter. Dokumentera reglerna före driftstart:
| Data | Ägare |
|---|---|
| Produkter, strukturer, arbetssteg, kvantiteter, operationsstatus | Lemonsoft |
| Stegens ordningsföljd, start- och sluttider, maskinval | SkyPlanner |
| Tillåtna produktionsgrupper per operation, ställtidsmatris, verktyg | SkyPlanner |
| Skift och frånvaro | Ett system som väljs under kartläggningen |
| Färdigrapporteringar och lagertransaktioner | Lemonsoft, registreras utifrån kvitteringar i SkyPlanner |
Den främsta konfliktkällan är Lemonsofts egen automatiska planering och uppdateringsfunktion: båda placerar om olåsta steg. Låt AUTOTIMING vara 0 så länge SkyPlanner styr planen. Om funktionen är på måste planeringslåset aktiveras för varje arbetsnummer som återförs. Det låser alla steg för det arbetsnumret. Enbart Koneiden kapasiteetin lukitus räcker inte, eftersom den automatiska planeringen flyttar olåsta operationer från en låst dag. (källa)
Vanliga steg i projektet
Implementeringen är normalt klar inom några veckor från att införandet börjar. Innan dess kan ni använda den kostnadsfria provperioden på 30 dagar med era egna data från en Excel-export av arbetsnummer, steg och maskiner.
- Kartläggning. Fastställ mappningstabellen, reglerna för dataägarskap och avfrågningsintervallet.
- Åtkomst. Slutkunden beställer en testmiljö från Lemonsoft Service Desk och skapar integrationsanvändaren och API-nyckeln.
- Första inläsningen. Maskiner, grupper, produktstrukturer och arbetssteg.
- Synkronisering av arbetsnummer. Pollning av ändringar, raderingshändelser och förnyelse av sessioner.
- Ställ in begränsningar i SkyPlanner. Tillåtna produktionsgrupper per operation, ställtidsmatrisen och verktyg.
- Återskrivning. Tider för arbetsmoment och färdigrapportering, testade i testmiljön.
- Parallelldrift och driftsättning. Jämför med det befintliga Gantt-schemat, rätta grunddata och aktivera sedan återskrivning i produktionsmiljön.
Att tänka på inför en integration med Lemonsoft
- En maskin per arbetsmoment. Ett arbetsmoment i Lemonsoft har en maskin. Vilka maskiner som får användas för varje produkt anges vid införandet, via en lista eller produktegenskaper. SkyPlanner väljer sedan bland alternativen.
- Daglig kapacitet. Fast kapacitet anges som en mängd per dag, och avvikelser saknar klockslag. Modellera de faktiska skiften i SkyPlanner eller läs in planerade skift.
- Återstående antal. Mappa
work_amount_left. Inställningarna STARTJOB_AUTOTIMENOW och JOBDONE_AUTOTIMENOW flyttar även Lemonsofts egen beläggning. - Sessioner löper ut. Förnya sessionen före långa synkroniseringar och hantera krav på ny inloggning.
- Regler för återrapportering. Kontrollera varje återrapportering mot arbetsmomentets status innan den skickas, och sprid ut anropen vid anropstoppar.
- Två klienter. LemonOnline och Windows-versionen delar databas, så integrationen fungerar för båda.
- Stora produktstrukturer. Använd
/api/async/product/structuretillsammans med/api/async/status/{jobId}för stora importer.
Integrationen med Lemonsoft: vem konfigurerar den och ger support?
Arbetet omfattar mappning till era maskiner, arbetsmoment och er konfiguration av Lemonsoft. Det omfattar också de planeringsregler ni hanterar i SkyPlanner: tillåtna produktionsgrupper per operation, ställtidsmatrisen och verktyg.
- SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftsättningen. Varje fabrik använder Lemonsoft på sitt sätt, och här tas den kunskapen till vara.
- Er Lemonsoft-partner kan delta. Partnern känner till er konfiguration och kan hantera API-användaren, behörigheter och testmiljön. SkyPlanner tillhandahåller REST API, API-dokumentation i Swagger/OpenAPI och webhooks.
- Era egna utvecklare kan bygga vidare på integrationen via samma dokumenterade REST API med en API-token. Det räcker med en API-token för att komma igång, och SkyPlanner-teamet hjälper till vid behov.
När anslutningen är på plats planerar Arcturus-motorn utifrån aktuella arbetsnummer i Lemonsoft, och de planerade tiderna förs över till arbetsmomenten. SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen utifrån era processer och behov, tillsammans med abonnemanget, så att ni ser hela kostnaden innan ni börjar.
Se hur Lemonsofts egen planering står sig i jämförelsen i Finplanering i Lemonsoft. En översikt finns på Lemonsoft-sidan, och andra system hittar ni i översikten över ERP-integrationer.
Tillverkningsföretagens omdömen om SkyPlanner
Lemonsofttvåvägsintegration med SkyPlanner
Kaskea Group
Legotillverkning: CNC-bearbetning, stålkonstruktioner och montering
Produktionen planeras i SkyPlanner med en tvåvägsintegration till Lemonsoft.
Färrestopp på grund av materialbrist
”Värdet SkyPlanner ger oss är att det är ett verktyg som fungerar i vardagen, särskilt när vi ska fastställa leveransdatum.”
Tommi Männistö, produktionsplaneringschef
Eskomatic · Legobearbetning
Automatisk beläggningsplanering ger mer träffsäkra leveransdatum, och produktionsstoppen på grund av materialbrist har minskat kraftigt.
2 hsparade varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-ark till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90%, och det tar under 30 minuter att skapa en optimerad plan för tre månader för samtliga produktionsgrupper.
Vanliga frågor
Har Lemonsoft ett API för produktionsdata?
Ja. LemonRest ger tillgång till tillverkningsorder och arbetsmoment, maskiner, produktstrukturer, material, skift och färdigrapportering. Det är förinstallerat för Alustapalvelu-kunder och kräver en API-nyckel och användarbehörigheter.
Har Lemonsoft stöd för webhooks?
Inga webhook-endpoints finns listade i LemonRest. Ändringar läses via deltafrågan main_ws/changed och raderingshändelser, som hämtas genom pollning med några minuters mellanrum. SkyPlanners egna webhooks skickar ut planeringsändringar så snart de sker.
Hur skrivs planerade tider tillbaka till Lemonsoft?
Med PUT /api/production/workstage, som uppdaterar en tillverkningsorder och dess arbetsmoment med starttid, sluttid och maskin. Låt Lemonsofts automatiska planering vara avstängd medan SkyPlanner styr planeringen, eller aktivera planeringslåset för varje arbetsnummer som skrivs tillbaka. Då ligger tiderna kvar där SkyPlanner har lagt dem.
Kan operatörernas återrapporteringar från SkyPlanner föras över till Lemonsoft?
Ja. Varje återrapportering registreras som en färdigrapportering med färdigt och kasserat antal, timmar och person. Detta används dagligen i kundprojekt.
Vem bygger integrationen med Lemonsoft?
SkyPlanner-teamet konfigurerar tvåvägsintegrationen för er Lemonsoft-miljö under införandet och ger support efter driftsättningen. Er Lemonsoft-partner eller era egna utvecklare kan också bygga vidare på SkyPlanners dokumenterade REST API. Det räcker med en API-token för att komma igång.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper och importera Excel- eller CSV-filer från Lemonsoft. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för en kartläggning av integrationen.
