Integrasjoner / ERP / Lemonsoft
Veiledning til Lemonsoft-integrasjon for produksjonsplanlegging med SkyPlanner APS
Denne veiledningen viser partnere og IT-team hvordan de kobler Lemonsoft ERP til SkyPlanner APS. SkyPlanner utveksler data med Lemonsoft i begge retninger via Lemonsofts REST API:
- Arbeidsnumre (työnumero), arbeidsfaser (työvaihe), maskiner, produktstrukturer, materialer og planlagte skift hentes inn.
- Planlagte start- og sluttider og valgt maskin skrives tilbake til arbeidsfasene.
- Operatørenes bekreftelser sendes tilbake som ferdigmeldinger.
- SkyPlanners webhooks sender planendringer fortløpende.
Kaskea Group bruker SkyPlanner med en toveis Lemonsoft-integrasjon. SkyPlanner-teamet tilpasser integrasjonen til Lemonsoft-oppsettet ditt under innføringen og gir støtte etter produksjonssetting. Partnere og utviklere kan også bygge løsninger med SkyPlanners dokumenterte REST API (API-referanse).
Lemonsofts REST API
Lemonsofts integrasjons-API er LemonRest, dokumentert i Swagger 2.0, versjon v1. Versjonen «LemonRest 2026.10 release-2026.10.2» har 422 stier. (Swagger)
- Basis-URL-en er miljøspesifikk. Du finner den i brukeradministrasjonen, under miljøadministrasjon og tjenesteadresser, i feltet Rest API. På Lemonsofts Azure-plattform er basis-URL-en
https://rest.lemon.fi. - Tilgjengelighet. For kunder som bruker Lemonsofts plattformtjeneste (Alustapalvelu), er REST API-ene forhåndsinstallert. Det er bare brukertilgangene som må på plass. (kilde)
- Testmiljø. Sluttkunden bestiller dette fra Lemonsoft Service Desk.
Det separate API-et for tidsregistrering i Kellokortti er ikke nødvendig for produksjonsplanleggingen.
Autentisering
LemonRest bruker en sesjon:
POST /api/auth/loginmed UserName, Password, Database og ApiKey returnerer ensession_id.- Send den i
Session-Id-headeren ved hvert kall. - Forny sesjonen med
POST /api/auth/renew. BrukGET /api/auth/alivetil helsesjekk.
POST /api/auth/login/token tar imot en Token i stedet for brukernavn og passord. Opprett en egen integrasjonsbruker med en API-nøkkel og bare de tilgangene integrasjonen trenger. (kilde)
På SkyPlanner-siden bruker REST API-et et API-token til autentisering (SkyPlanner Settings > API) og er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen viser deg de første kallene.
Oppdag endringer med deltaspørringer
LemonRest har ingen endepunkter for webhooks eller abonnementer. Endringer hentes med en deltaspørring:
GET /api/production/main_ws/changed?updated_after=...returnerer jobber som er endret siden forrige kjøring.- Legg til
optimization=true. Parameteren ble innført i versjon 2026.6.3 for å fjerne avhengigheten av loggen og gjøre spørringen raskere. (versjonsmerknader) GET /api/log/deletion_eventsfanger opp slettede jobber, slik at kansellert arbeid fjernes fra planen.
Hent endringer med noen minutters mellomrom. SkyPlanner sender webhooks når status eller planen endres, så tilbakeskrivingen er hendelsesstyrt.
Datakobling
| Lemonsoft-objekt (endepunkt) | SkyPlanner-objekt | Retning | Hyppighet |
|---|---|---|---|
Tuote, product_code (/api/products) | Produkter og materialer | Lemonsoft → SkyPlanner | Ved førstegangsinnlasting, deretter ved endringer |
Tuoterakenne med Työvaiheet-rader (/api/products/structure, all_levels) | Produktstruktur, underprodukter, prosesstrinn med omstillingstider | Lemonsoft → SkyPlanner | Ved førstegangsinnlasting, deretter ved endringer |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Arbeidsstasjoner, arbeidsstasjonsgrupper | Lemonsoft → SkyPlanner | Ved førstegangsinnlasting, sjelden deretter |
Työnumero som ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Ordrer med leveringsfrister og prioritet | Lemonsoft → SkyPlanner | Deltaspørringer med noen minutters mellomrom |
Työvaihe som ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Jobber (prosesstrinn) per arbeidsstasjon | Lemonsoft → SkyPlanner | Deltaspørringer med noen minutters mellomrom |
Komponentbehov (main_ws/{worknumber}/materials) | Materialbehov per jobb | Lemonsoft → SkyPlanner | Sammen med hver jobb |
Planlagte skift (/api/persons/plannedshifts) | Skift, personell | Lemonsoft → SkyPlanner | Daglig, eller skiftene vedlikeholdes i SkyPlanner |
Salgsordre knyttet til et arbeidsnummer (/api/orders/work/{work_number}) | Informasjon om kunde og prioritet | Lemonsoft → SkyPlanner | Sammen med hver jobb |
Työvaihe: start_time, end_time, machine_id (PUT /api/production/workstage) | Planlagt start, slutt og arbeidsstasjon | SkyPlanner → Lemonsoft | Ved planendringer, via webhook fra SkyPlanner |
Ferdigmelding (POST main_ws/sub_ws/completion_entry) | Bekreftelser: antall ferdige og feilproduserte enheter, timer, person | SkyPlanner → Lemonsoft | Ved hver bekreftelse |
| Planleggingsregler angitt i SkyPlanner | Tillatte arbeidsstasjoner per jobb, omstillingstidsmatrise, verktøy | Vedlikeholdes i SkyPlanner | Settes opp under innføringen |
Integrasjonsmønstre
1. Førstegangsinnlasting av grunndata. Hent maskiner og maskingrupper, produktstrukturer med arbeidsfaser og standard arbeidsfaser. Koble hver fysisk maskin til en arbeidsstasjon i SkyPlanner. Bruk overordnede maskiner (Isäkone) bare til gruppering, siden de summerer kapasiteten til de underordnede maskinene.
2. Synkronisering av arbeidsnumre. Hent åpne arbeidsnumre med tilhørende faser fra /api/production/workstage eller main_ws/sub_ws, filtrert etter status og med paginering. Hold dem deretter oppdatert med main_ws/changed. Bruk work_amount_left, ikke work_amount, i datakoblingen, fordi Lemonsoft planlegger ut fra gjenstående antall. Innkjøpsordrer gir grunnlag for SkyPlanners materialstyrte planlegging, slik at en fase venter til leveringsdatoen på innkjøpsordren.
3. Tilbakeskriving av planen. For hver fase som planleggingsmotoren har plassert eller flyttet, sender SkyPlanner PUT /api/production/workstage med jobben og dens sub_workstages. Hver fase inneholder start_time og end_time, samt machine_id når den er flyttet til en alternativ maskin.
4. Bekreftelser fra produksjonen. Operatørene bekrefter arbeid med SkyPlanner Mobile Confirmations eller Production Timer. Hver bekreftelse sendes til completion_entry med sub_workstage_id, person_number, done_amount, hours, failed_amount og job_done. Send med material_consumptions når fasen forbruker materialer, så registrerer Lemonsoft en vanlig ferdigmelding (valmistuskirjaus).
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Produkter, strukturer, arbeidsfaser, antall, jobbstatus | Lemonsoft |
| Faserekkefølge, start- og sluttider, maskinvalg | SkyPlanner |
| Tillatte arbeidsstasjoner per jobb, omstillingstidsmatrise, verktøy | SkyPlanner |
| Skift og fravær | Ett system, valgt under avklaringen |
| Ferdigmeldinger og lagerposteringer | Lemonsoft, basert på bekreftelser fra SkyPlanner |
Den viktigste konfliktkilden er Lemonsofts egen automatiske planlegging og oppdateringsfunksjonen: Begge plasserer ulåste faser på nytt. Hold AUTOTIMING på 0 så lenge SkyPlanner eier planen. Hvis du lar funksjonen være på, må du aktivere planlåsen på hvert arbeidsnummer det skrives tilbake til. Da låses alle fasene for det arbeidsnummeret. Koneiden kapasiteetin lukitus alene er ikke nok, fordi den automatiske planleggingen flytter ulåste jobber bort fra en låst dag. (kilde)
Typiske prosjekttrinn
Implementeringen er normalt ferdig i løpet av noen uker etter at innføringen starter. Før det kan du bruke den gratis prøveperioden på 30 dager med egne data fra en Excel-eksport av arbeidsnumre, faser og maskiner.
- Avklaring. Fastsett koblingstabellen, reglene for dataeierskap og intervallet for endringsspørringer.
- Tilgang. Sluttkunden bestiller et testmiljø fra Lemonsoft Service Desk og oppretter integrasjonsbrukeren og API-nøkkelen.
- Førstegangsinnlasting. Maskiner, grupper, produktstrukturer og arbeidsfaser.
- Synkronisering av arbeidsnumre. Polling etter endringer, slettingshendelser og fornyelse av økter.
- Oppsett av begrensninger i SkyPlanner. Tillatte arbeidsstasjoner per jobb, matrisen for omstillingstid og verktøy.
- Tilbakeskriving. Tider for arbeidsoperasjoner og ferdigmeldinger, testet i testmiljøet.
- Parallelldrift og produksjonssetting. Sammenlign med dagens Gantt-diagram, rett opp grunndata og aktiver deretter tilbakeskriving i produksjonsmiljøet.
Dette bør du planlegge for i en Lemonsoft-integrasjon
- Én maskin per arbeidsoperasjon. En arbeidsoperasjon i Lemonsoft har én maskin. Ved oppstart hentes informasjon om hvilke maskiner som kan brukes til hvert produkt, fra en liste eller fra produktegenskaper. SkyPlanner velger deretter blant alternativene.
- Daglig kapasitet. Fast kapasitet angis som en mengde per dag, og avvik har ikke noe klokkeslett. Modeller de faktiske skiftene i SkyPlanner, eller les inn planlagte skift.
- Gjenstående mengde. Bruk
work_amount_lefti datakoblingen. Innstillingene STARTJOB_AUTOTIMENOW og JOBDONE_AUTOTIMENOW flytter også belastningen i Lemonsoft. - Økter utløper. Forny økten før lange synkroniseringer, og håndter krav om ny innlogging.
- Regler for bekreftelser. Kontroller hver bekreftelse mot statusen til arbeidsoperasjonen før den sendes, og fordel tette serier av kall over tid.
- To klienter. LemonOnline og Windows-versjonen deler én database, så integrasjonen betjener begge.
- Store strukturer. Bruk
/api/async/product/structuresammen med/api/async/status/{jobId}ved store importer.
Lemonsoft-integrasjonen: Hvem setter den opp og gir støtte?
Arbeidet omfatter kobling mot maskinene, arbeidsoperasjonene og Lemonsoft-oppsettet deres. Det omfatter også planleggingsreglene som vedlikeholdes i SkyPlanner: tillatte arbeidsstasjoner per jobb, matrisen for omstillingstid og verktøy.
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter produksjonssetting. Hver fabrikk bruker Lemonsoft på sin måte, og denne kunnskapen tas med i oppsettet.
- Lemonsoft-partneren deres kan delta. Partneren kjenner oppsettet deres og kan håndtere API-bruker, rettigheter og testmiljø. SkyPlanner leverer REST API, Swagger/OpenAPI-dokumentasjon og webhooks.
- Egne utviklere kan bygge videre på integrasjonen med det samme dokumenterte REST API-et og et API-token. Et API-token er nok til å komme i gang, og SkyPlanner-teamet bistår ved behov.
Når tilkoblingen er på plass, planlegger Arcturus-motoren ut fra oppdaterte arbeidsnumre i Lemonsoft, og de planlagte tidene overføres til arbeidsoperasjonene. SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og faktureres månedlig. Dere får et pristilbud på integrasjonen tilpasset prosessen og behovene deres, sammen med abonnementet, slik at dere ser totalkostnaden før dere starter.
Se hvordan Lemonsofts egen planlegging står seg på siden om produksjonsplanlegging med Lemonsoft innenfor faktisk maskin- og personellkapasitet. Du finner oversikten på Lemonsoft-siden og andre systemer i oversikten over ERP-integrasjoner.
Produsentenes erfaringer med SkyPlanner
Lemonsofttoveisintegrasjon med SkyPlanner
Kaskea Group
Kontraktsproduksjon: CNC-maskinering, stålkonstruksjoner og montering
Produksjonen planlegges i SkyPlanner, med en toveisintegrasjon mot Lemonsoft.
Færrestopp på grunn av materialmangel
«Verdien av SkyPlanner for oss er at det er et verktøy som fungerer i det daglige, særlig når vi skal fastsette leveringsdatoer.»
Tommi Männistö, leder for produksjonsplanlegging
Eskomatic · Maskinering på oppdrag
Automatisk planlegging av belastningen gir mer presise leveringsdatoer, og produksjonsstans som skyldes materialmangel, er kraftig redusert.
2 tspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-regneark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektrotavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 arbeidstimer hver uke, og en ny arbeidskø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder på tvers av alle arbeidsstasjoner.
Ofte stilte spørsmål
Har Lemonsoft et API for produksjonsdata?
Ja. LemonRest gir tilgang til produksjonsjobber og arbeidsoperasjoner, maskiner, produktstrukturer, materialer, skift og registrering av ferdigmeldinger. Det er forhåndsinstallert for Alustapalvelu-kunder og krever en API-nøkkel og brukerrettigheter.
Støtter Lemonsoft webhooks?
Ingen webhook-endepunkter er oppført i LemonRest. Endringer leses med deltaspørringen main_ws/changed og slettingshendelser, som hentes ved polling med noen minutters mellomrom. SkyPlanners egne webhooks sender planendringer fortløpende.
Hvordan skrives planlagte tider tilbake til Lemonsoft?
Med PUT /api/production/workstage, som oppdaterer en jobb og arbeidsoperasjonene med starttid, sluttid og maskin. Hold Lemonsofts automatiske planlegging avslått så lenge SkyPlanner styrer planen, eller lås planen for hvert arbeidsnummer det skrives til. Da beholdes tidene SkyPlanner har satt.
Kan operatørkvitteringer fra SkyPlanner registreres i Lemonsoft?
Ja. Hver kvittering registreres som en ferdigmelding med ferdigprodusert og kassert mengde, timer og person. Dette brukes daglig i kundeprosjekter.
Hvem bygger Lemonsoft-integrasjonen?
SkyPlanner-teamet tilpasser toveisintegrasjonen til Lemonsoft-oppsettet deres under innføringen og gir støtte etter produksjonssetting. Lemonsoft-partneren deres eller egne utviklere kan også bygge videre med SkyPlanners dokumenterte REST API. Et API-token er nok til å komme i gang.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med Excel- eller CSV-import fra Lemonsoft, uten krav om kredittkort. Start prøveperioden, eller snakk med salg for en avklaring av integrasjonens omfang.
