Integrationer / ERP / Lemonsoft
Lemonsoft-integration: guide til produktionsplanlægning med SkyPlanner APS
Denne guide til Lemonsoft-integration viser partnere og IT-teams, hvordan Lemonsoft ERP forbindes med SkyPlanner APS. SkyPlanner udveksler data med Lemonsoft i begge retninger via Lemonsofts REST API:
- Arbejdsnumre (työnumero), arbejdstrin (työvaihe), maskiner, produktstrukturer, materialer og planlagte skift hentes ind.
- Planlagte start- og sluttidspunkter samt den valgte maskine skrives tilbage til arbejdstrinnene.
- Operatørernes tilbagemeldinger sendes tilbage som færdigmeldinger.
- SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
Kaskea Group bruger SkyPlanner med en tovejsintegration til Lemonsoft. Under opstarten tilpasser SkyPlanner-teamet integrationen til jeres Lemonsoft-opsætning og yder support efter idriftsættelsen. Partnere og udviklere kan også bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Lemonsofts REST API
Lemonsofts integrations-API hedder LemonRest og er dokumenteret i Swagger 2.0, version v1. Build “LemonRest 2026.10 release-2026.10.2” indeholder 422 stier. (Swagger)
- Basis-URL’en er specifik for hvert miljø. Den findes i brugeradministrationen under miljøadministration og serviceadresser i feltet Rest API. På Lemonsofts Azure-platform er basis-URL’en
https://rest.lemon.fi. - Tilgængelighed. For kunder på Lemonsofts platformstjeneste (Alustapalvelu) er REST API’erne forudinstalleret og kræver kun brugerrettigheder. (kilde)
- Testmiljø. Slutkunden bestiller det hos Lemonsoft Service Desk.
Det separate API til tidsregistrering i Kellokortti er ikke nødvendigt til detailplanlægningen.
Godkendelse
LemonRest bruger en session:
POST /api/auth/loginmed UserName, Password, Database og ApiKey returnerer etsession_id.- Send det i headeren
Session-Idved hvert kald. - Forny sessionen med
POST /api/auth/renew. BrugGET /api/auth/alivetil at kontrollere, at den er aktiv.
POST /api/auth/login/token bruger Token i stedet for brugernavn og adgangskode. Opret en særskilt integrationsbruger med en API-nøgle og kun de rettigheder, integrationen har brug for. (kilde)
SkyPlanners REST API bruger et API-token til autentificering (SkyPlanner Settings > API) og er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Registrering af ændringer med deltaforespørgsler
LemonRest har ingen endpoints til webhooks eller abonnementer. Ændringer hentes med en deltaforespørgsel:
GET /api/production/main_ws/changed?updated_after=...returnerer opgaver, der er ændret siden sidste kørsel.- Tilføj
optimization=true. Parameteren blev indført i version 2026.6.3 for at fjerne afhængigheden af loggen og gøre forespørgslen hurtigere. (versionsnoter) GET /api/log/deletion_eventsopfanger slettede opgaver, så annulleret arbejde fjernes fra planen.
Hent ændringer med få minutters mellemrum. SkyPlanner sender webhooks, når status eller planen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| Lemonsoft-objekt (endpoint) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
Tuote, product_code (/api/products) | Produkter og materialer | Lemonsoft → SkyPlanner | Ved første indlæsning, derefter ved ændringer |
Tuoterakenne med Työvaiheet-rækker (/api/products/structure, all_levels) | Produktstruktur, delprodukter, procestrin med omstillingstider | Lemonsoft → SkyPlanner | Ved første indlæsning, derefter ved ændringer |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Arbejdsstationer og grupper af arbejdsstationer | Lemonsoft → SkyPlanner | Ved første indlæsning, sjældent derefter |
Työnumero som ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Ordrer med leveringsterminer og prioritet | Lemonsoft → SkyPlanner | Deltaforespørgsler med få minutters mellemrum |
Työvaihe som ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Opgaver (procestrin) pr. arbejdsstation | Lemonsoft → SkyPlanner | Deltaforespørgsler med få minutters mellemrum |
Komponentbehov (main_ws/{worknumber}/materials) | Materialebehov pr. opgave | Lemonsoft → SkyPlanner | Sammen med hver opgave |
Planlagte skift (/api/persons/plannedshifts) | Skift og personale | Lemonsoft → SkyPlanner | Dagligt, eller skiftene vedligeholdes i SkyPlanner |
Salgsordren bag et arbejdsnummer (/api/orders/work/{work_number}) | Oplysninger om kunde og prioritet | Lemonsoft → SkyPlanner | Sammen med hver opgave |
Työvaihe: start_time, end_time, machine_id (PUT /api/production/workstage) | Planlagt start, slut og arbejdsstation | SkyPlanner → Lemonsoft | Ved ændringer i planen via en webhook fra SkyPlanner |
Færdigmelding (POST main_ws/sub_ws/completion_entry) | Tilbagemeldinger: produceret og kasseret antal, timer, person | SkyPlanner → Lemonsoft | Ved hver tilbagemelding |
| Planlægningsregler fastlagt i SkyPlanner | Tilladte arbejdsstationer pr. opgave, omstillingstidsmatrix, værktøjer | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Hent maskiner og maskingrupper, produktstrukturer med tilhørende arbejdstrin samt standardarbejdsfaser. Knyt hver konkret maskine til en arbejdsstation i SkyPlanner. Brug kun overordnede maskiner (Isäkone) til gruppering, da de summerer de underordnede maskiners kapacitet.
2. Synkronisering af arbejdsnumre. Hent åbne arbejdsnumre med tilhørende trin fra /api/production/workstage eller main_ws/sub_ws, filtreret efter status og opdelt i sider. Hold dem derefter opdateret med main_ws/changed. Map work_amount_left, ikke work_amount, da Lemonsoft planlægger ud fra den resterende mængde. Indkøbsordrer indgår i SkyPlanners materialestyrede planlægning, så et trin venter til indkøbsordrens leveringsdato.
3. Tilbageskrivning af planen. For hvert trin, som planlægningsmotoren har placeret eller flyttet, sender SkyPlanner PUT /api/production/workstage med opgaven og dens sub_workstages. Hvert trin indeholder start_time og end_time samt machine_id, hvis det er flyttet til en alternativ maskine.
4. Tilbagemeldinger fra produktionen. Operatørerne melder arbejdet tilbage med SkyPlanner Mobile Confirmations eller Production Timer. Hver tilbagemelding sendes til completion_entry med sub_workstage_id, person_number, done_amount, hours, failed_amount og job_done. Send også material_consumptions, når trinnet forbruger materiale. Lemonsoft bogfører herefter en almindelig færdigmelding (valmistuskirjaus).
5. Regler for dataejerskab og konflikter. Skriv dem ned inden idriftsættelsen:
| Data | Ejer |
|---|---|
| Produkter, strukturer, arbejdstrin, mængder, opgavestatus | Lemonsoft |
| Trinnenes rækkefølge, start- og sluttidspunkter, maskinvalg | SkyPlanner |
| Tilladte arbejdsstationer pr. opgave, omstillingstidsmatrix, værktøjer | SkyPlanner |
| Skift og fravær | Ét system, valgt under afklaringen |
| Færdigmeldinger og lagerposteringer | Lemonsoft, bogført ud fra tilbagemeldinger i SkyPlanner |
Den største kilde til konflikter er Lemonsofts egen automatiske planlægning og opdateringsfunktionen: Begge placerer ulåste trin på ny. Hold AUTOTIMING på 0, mens SkyPlanner styrer planen. Hvis funktionen fortsat er slået til, skal planlåsen sættes på hvert arbejdsnummer, der skrives tilbage. Den fastlåser alle trin under det pågældende nummer. Koneiden kapasiteetin lukitus er ikke nok i sig selv, da den automatiske planlægning flytter ulåste opgaver væk fra en låst dag. (kilde)
Typiske projekttrin
Implementeringen tager normalt uger fra opstart til afslutning. Inden da kører den gratis prøveperiode på 30 dage med jeres egne data fra en Excel-eksport af arbejdsnumre, trin og maskiner.
- Afklaring. Fastlæg mappingtabellen, reglerne for dataejerskab og intervallet for forespørgsler.
- Adgang. Slutkunden bestiller et testmiljø hos Lemonsoft Service Desk og opretter integrationsbrugeren og API-nøglen.
- Første indlæsning. Maskiner, grupper, produktstrukturer og arbejdstrin.
- Synkronisering af arbejdsnumre. Deltaforespørgsler, sletningshændelser og fornyelse af sessioner.
- Opsætning af begrænsninger i SkyPlanner. Tilladte arbejdsstationer pr. opgave, omstillingsmatricen og værktøjer.
- Tilbageskrivning. Operationernes start- og sluttidspunkter samt færdigmeldinger, afprøvet i testmiljøet.
- Paralleldrift og idriftsættelse. Sammenlign med det nuværende Gantt-diagram, ret stamdata, og aktivér derefter tilbageskrivning i produktionsmiljøet.
Det skal I tage højde for i en Lemonsoft-integration
- Én maskine pr. operation. En operation i Lemonsoft har én maskine tilknyttet. Under implementeringen hentes oplysninger om, hvilke maskiner der kan bruges til hvert produkt, fra en liste eller fra produktegenskaber. SkyPlanner vælger derefter blandt alternativerne.
- Daglig kapacitet. Den faste kapacitet angives som en mængde pr. dag, og afvigelser har intet klokkeslæt. Opret de faktiske skiftehold i SkyPlanner, eller indlæs de planlagte skiftehold.
- Restmængde. Map feltet
work_amount_left. Indstillingerne STARTJOB_AUTOTIMENOW og JOBDONE_AUTOTIMENOW flytter også belastningen i Lemonsofts egen plan. - Sessioner udløber. Forny sessionen før lange synkroniseringer, og sørg for at håndtere krav om nyt login.
- Regler for tilbagemeldinger. Kontrollér hver tilbagemelding mod operationens status, før den bogføres, og fordel tætte serier af kald over tid.
- To klienter. LemonOnline og Windows-versionen deler én database, så integrationen dækker begge.
- Store strukturer. Brug
/api/async/product/structuresammen med/api/async/status/{jobId}til store importer.
Lemonsoft-integrationen: Hvem står for opsætning og support?
Arbejdet omfatter mapping til jeres maskiner, operationer og opsætning i Lemonsoft. Det omfatter også de planlægningsregler, I vedligeholder i SkyPlanner: tilladte arbejdsstationer pr. opgave, omstillingsmatricen og værktøjer.
- SkyPlanner-teamet sætter integrationen op under implementeringen og yder support efter idriftsættelsen. Hver fabrik bruger Lemonsoft på sin egen måde, og den viden bliver indarbejdet her.
- Jeres Lemonsoft-partner kan deltage. Partneren kender jeres opsætning og kan tage sig af API-brugeren, rettighederne og testmiljøet. SkyPlanner stiller REST API, Swagger/OpenAPI-dokumentation og webhooks til rådighed.
- Jeres egne udviklere kan bygge videre på integrationen via samme dokumenterede REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov.
Når forbindelsen er etableret, planlægger Arcturus-motoren ud fra aktuelle arbejdsnumre i Lemonsoft, og de planlagte tider overføres til operationerne. SkyPlanner fås fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen, tilpasset jeres proces og behov, sammen med jeres abonnement, så I kender den samlede pris, før I går i gang.
Se, hvordan Lemonsofts egen planlægning klarer sig i sammenligningen, på siden om produktionsplanlægning i Lemonsoft, der tager højde for den faktiske maskin- og personalekapacitet. I finder overblikket på Lemonsoft-siden og andre systemer i oversigten over ERP-integrationer.
Produktionsvirksomheders erfaringer med SkyPlanner
Lemonsofttovejsintegration med SkyPlanner
Kaskea Group
Underleverandørproduktion: CNC-bearbejdning, stålkonstruktioner og montage
Produktionen planlægges i SkyPlanner med en tovejsintegration til Lemonsoft.
Færrestop på grund af materialemangel
“Værdien af SkyPlanner for os er, at det er et værktøj, der fungerer i hverdagen, især når vi skal fastlægge leveringsdatoer.”
Tommi Männistö, chef for produktionsplanlægning
Eskomatic · Maskinbearbejdning som underleverandør
Automatisk planlægning af belastningen giver mere præcise leveringsdatoer, og antallet af produktionsstop på grund af materialemangel er faldet markant.
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-regneark til optimering af produktionen i realtid.”
Kalle Kalliomäki, specialist i forsyningskæder
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 arbejdstimer hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
Ofte stillede spørgsmål
Har Lemonsoft et API til produktionsdata?
Ja. LemonRest giver adgang til produktionsopgaver og operationer, maskiner, produktstrukturer, materialer, skiftehold og bogføring af færdigmeldinger. Det er forudinstalleret hos Alustapalvelu-kunder og kræver en API-nøgle og brugerrettigheder.
Understøtter Lemonsoft webhooks?
Der er ingen webhook-endpoints angivet i LemonRest. Ændringer hentes med deltaforespørgslen main_ws/changed og sletningshændelser med få minutters mellemrum. SkyPlanners egne webhooks sender ændringer i planen, så snart de sker.
Hvordan skrives planlagte tider tilbage til Lemonsoft?
Med PUT /api/production/workstage, som opdaterer en opgave og dens operationer med starttid, sluttid og maskine. Hold Lemonsofts automatiske planlægning slået fra, mens SkyPlanner styrer planen, eller aktivér planlægningslåsen på hvert arbejdsnummer, der skrives til. Så bliver tiderne liggende, som SkyPlanner har planlagt dem.
Kan operatørernes tilbagemeldinger fra SkyPlanner bogføres i Lemonsoft?
Ja. Hver tilbagemelding bogføres som en færdigmelding med antal færdige og fejlbehæftede enheder, timer og person. Det bruges dagligt i kundeprojekter.
Hvem bygger Lemonsoft-integrationen?
SkyPlanner-teamet tilpasser tovejsintegrationen til jeres Lemonsoft-opsætning under implementeringen og yder support efter idriftsættelsen. Jeres Lemonsoft-partner eller egne udviklere kan også bygge videre via SkyPlanners dokumenterede REST API. Et API-token er nok til at komme i gang.
Kan vi teste SkyPlanner, før integrationen bygges?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med import af Excel- eller CSV-filer fra Lemonsoft og kræver ikke kreditkort. Start prøveperioden, eller tal med salg for at afklare integrationens omfang.
