Integraatiot / ERP / Lemonsoft
Lemonsoft-integraation opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Lemonsoft-integraation opas kertoo kumppaneille ja IT-tiimeille, miten Lemonsoft ERP yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Lemonsoftin välinen integraatio toimii molempiin suuntiin Lemonsoftin REST API:n kautta:
- SkyPlanneriin tuodaan työnumerot, työvaiheet, koneet, tuoterakenteet, materiaalit ja suunnitellut työvuorot.
- Suunnitellut aloitus- ja lopetusajat sekä valittu kone palautetaan työvaiheille.
- Työntekijöiden kuittaukset palautetaan valmistuskirjauksina.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
Kaskea Group käyttää SkyPlanneria kaksisuuntaisella Lemonsoft-integraatiolla. SkyPlannerin tiimi määrittää integraation Lemonsoft-ympäristöönne sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Kumppanit ja kehittäjät voivat myös toteuttaa integraatioita SkyPlannerin dokumentoidun REST API:n avulla (API-dokumentaatio).
Lemonsoftin REST API
Lemonsoftin integraatiorajapinta on LemonRest. Sen dokumentaatio on Swagger 2.0 -muodossa, ja rajapinnan versio on v1. Koontiversio “LemonRest 2026.10 release-2026.10.2” sisältää 422 polkua. (Swagger)
- Perusosoite on ympäristökohtainen. Se löytyy käyttäjähallinnasta ympäristönhallinnan palveluosoitteista, kentästä Rest API. Lemonsoftin Azure-alustalla perusosoite on
https://rest.lemon.fi. - Saatavuus. Lemonsoftin Alustapalvelun asiakkailla REST API:t ovat valmiiksi asennettuina, ja niiden käyttöön tarvitaan vain käyttöoikeudet. (lähde)
- Testiympäristö. Loppuasiakas tilaa sen Lemonsoft Service Deskistä.
Erillistä Kellokortin työajanseurantarajapintaa ei tarvita tuotannonsuunnitteluun.
Todennus
LemonRest käyttää istuntoa:
POST /api/auth/loginpalauttaasession_id-tunnisteen, kun kutsussa annetaan UserName, Password, Database ja ApiKey.- Lähetä tunniste jokaisen kutsun
Session-Id-otsakkeessa. - Uusi istunto kutsulla
POST /api/auth/renew. Istunnon tilan voi tarkistaa kutsullaGET /api/auth/alive.
POST /api/auth/login/token ottaa vastaan Token-arvon käyttäjätunnuksen ja salasanan sijaan. Luo integraatiolle oma käyttäjä, jolla on API-avain ja vain integraation tarvitsemat oikeudet. (lähde)
SkyPlannerin REST API käyttää todentamiseen API-tokenia (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Integraatio-opas käy läpi ensimmäiset kutsut.
Muutosten tunnistaminen deltakyselyillä
LemonRestissä ei ole webhook- tai tapahtumatilausrajapintoja. Muutokset haetaan deltakyselyllä:
GET /api/production/main_ws/changed?updated_after=...palauttaa edellisen ajon jälkeen muuttuneet työt.- Lisää kyselyyn
optimization=true. Se lisättiin versiossa 2026.6.3 poistamaan lokiriippuvuus ja nopeuttamaan kyselyä. (versiotiedote) GET /api/log/deletion_eventspalauttaa poistetut työt, jotta perutut työt poistuvat myös tuotantosuunnitelmasta.
Tee kyselyt muutaman minuutin välein. SkyPlanner lähettää webhook-ilmoituksia tilan tai tuotantosuunnitelman muuttuessa, joten tietojen palautus Lemonsoftiin toimii tapahtumapohjaisesti.
Tietojen vastaavuudet
| Lemonsoftin tietokohde (rajapintapolku) | SkyPlannerin tietokohde | Suunta | Siirtotiheys |
|---|---|---|---|
Tuote, product_code (/api/products) | Tuotteet ja materiaalit | Lemonsoft → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
Tuoterakenne ja sen Työvaiheet-rivit (/api/products/structure, all_levels) | Tuoterakenne, alituotteet ja työvaiheet asetusaikoineen | Lemonsoft → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Työpisteet ja työpisteryhmät | Lemonsoft → SkyPlanner | Alkusiirto, sen jälkeen harvoin |
Työnumero ProductMainWorkStage-objektina (/api/production/workstage, main_ws/changed) | Tilaukset määräpäivineen ja prioriteetteineen | Lemonsoft → SkyPlanner | Deltakysely muutaman minuutin välein |
Työvaihe ProductSubWorkStage-objektina (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Työt (työvaiheet) työpisteittäin | Lemonsoft → SkyPlanner | Deltakysely muutaman minuutin välein |
Komponenttitarve (main_ws/{worknumber}/materials) | Työkohtaiset materiaalitarpeet | Lemonsoft → SkyPlanner | Jokaisen työn yhteydessä |
Suunnitellut työvuorot (/api/persons/plannedshifts) | Työvuorot ja henkilöstö | Lemonsoft → SkyPlanner | Päivittäin, tai työvuorot ylläpidetään SkyPlannerissa |
Työnumeroon liittyvä myyntitilaus (/api/orders/work/{work_number}) | Asiakas- ja prioriteettitiedot | Lemonsoft → SkyPlanner | Jokaisen työn yhteydessä |
Työvaiheen start_time, end_time, machine_id (PUT /api/production/workstage) | Suunniteltu aloitus- ja lopetusaika sekä työpiste | SkyPlanner → Lemonsoft | Tuotantosuunnitelman muuttuessa SkyPlannerin webhook-ilmoituksen kautta |
Valmistuskirjaus (POST main_ws/sub_ws/completion_entry) | Kuittaukset: valmistunut ja hylätty määrä, tunnit, henkilö | SkyPlanner → Lemonsoft | Jokaisen kuittauksen yhteydessä |
| SkyPlannerissa määritetyt tuotannonsuunnittelun säännöt | Työkohtaisesti sallitut työpisteet, asetusaikamatriisi, työkalut | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutusmallit
1. Perustietojen alkusiirto. Hae koneet ja koneryhmät, tuoterakenteet työvaiheineen sekä vakiotyövaiheet. Kohdista jokainen fyysinen kone SkyPlannerin työpisteeseen. Käytä Isäkone-tietoa vain ryhmittelyyn, sillä isäkoneen kapasiteetti on sen alikoneiden kapasiteettien summa.
2. Työnumeroiden synkronointi. Hae avoimet työnumerot vaiheineen rajapinnasta /api/production/workstage tai main_ws/sub_ws. Suodata tulokset tilan mukaan ja käytä sivutusta. Pidä tiedot sen jälkeen ajan tasalla kyselyllä main_ws/changed. Käytä kenttää work_amount_left, älä kenttää work_amount, sillä Lemonsoft suunnittelee työt jäljellä olevan määrän perusteella. Ostotilaukset ohjaavat SkyPlannerin materiaaliperusteista tuotannonsuunnittelua, joten vaihe odottaa ostotilauksen toimituspäivään asti.
3. Tuotantosuunnitelman palautus Lemonsoftiin. SkyPlanner lähettää jokaisesta suunnittelumoottorin sijoittamasta tai siirtämästä vaiheesta PUT /api/production/workstage -kutsun, joka sisältää työn ja sen sub_workstages-tiedot. Jokaiselle vaiheelle välitetään start_time ja end_time sekä machine_id, jos vaihe siirtyi vaihtoehtoiselle koneelle.
4. Tuotannon kuittaukset. Työntekijät kuittaavat työt SkyPlanner Mobile Confirmations – tai Production Timer -toiminnolla. Jokainen kuittaus lähetetään completion_entry-rajapintaan kentillä sub_workstage_id, person_number, done_amount, hours, failed_amount ja job_done. Jos vaihe kuluttaa materiaalia, lähetä mukana myös material_consumptions. Lemonsoft tekee näistä normaalin valmistuskirjauksen.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Tuotteet, rakenteet, työvaiheet, määrät, työn tila | Lemonsoft |
| Vaiheiden järjestys, aloitus- ja lopetusajat, koneen valinta | SkyPlanner |
| Työkohtaisesti sallitut työpisteet, asetusaikamatriisi, työkalut | SkyPlanner |
| Työvuorot ja poissaolot | Yksi järjestelmä, joka valitaan määrittelyssä |
| Valmistus- ja varastokirjaukset | Lemonsoft, kirjaukset SkyPlannerin kuittauksista |
Ristiriitoja aiheuttavat etenkin Lemonsoftin oma automaattinen tuotannonsuunnittelu ja päivitystoiminto: molemmat sijoittavat lukitsemattomat vaiheet uudelleen. Pidä AUTOTIMING arvossa 0, kun SkyPlanner vastaa tuotantosuunnitelmasta. Jos pidät toiminnon käytössä, lukitse jokaisen takaisin kirjoitetun työnumeron suunnitelma. Lukitus kiinnittää kaikki kyseisen työnumeron vaiheet paikoilleen. Pelkkä Koneiden kapasiteetin lukitus ei riitä, sillä automaattinen tuotannonsuunnittelu siirtää lukitsemattomat työt pois lukitulta päivältä. (lähde)
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikoissa käyttöönoton aloittamisesta. Sitä ennen voit käyttää 30 päivän maksuttomassa kokeilussa omia tietojasi tuomalla työnumerot, työvaiheet ja koneet Excel-vientinä.
- Määrittely. Määritä tietojen vastaavuustaulukko, omistajuussäännöt ja kyselyväli.
- Käyttöoikeudet. Loppuasiakas tilaa testiympäristön Lemonsoft Service Deskistä sekä luo integraatiokäyttäjän ja API-avaimen.
- Alkulataus. Koneet, ryhmät, tuoterakenteet ja työvaiheet.
- Työnumeroiden synkronointi. Muutosten kysely, poistotapahtumat ja istunnon uusiminen.
- Rajoitteiden määrittely SkyPlannerissa. Työkohtaisesti sallitut työpisteet, asetusaikamatriisi ja työkalut.
- Takaisinkirjoitus. Vaiheiden ajat ja valmistuskirjaukset testataan testiympäristössä.
- Rinnakkaiskäyttö ja tuotantoon siirtyminen. Vertaa tuloksia nykyiseen Gantt-kaavioon, korjaa perustiedot ja ota sitten takaisinkirjoitus käyttöön tuotantoympäristössä.
Mitä Lemonsoft-integraatiossa on huomioitava
- Yksi kone vaihetta kohti. Lemonsoftin työvaiheeseen on liitetty yksi kone. Tuotekohtaisesti soveltuvat koneet määritetään käyttöönotossa luettelon tai tuoteominaisuuksien perusteella. SkyPlanner valitsee sitten näistä vaihtoehdoista.
- Päiväkohtainen kapasiteetti. Kiinteä kapasiteetti on päiväkohtainen määrä, eikä poikkeamilla ole kellonaikaa. Mallinna todelliset työvuorot SkyPlannerissa tai lue suunnitellut työvuorot.
- Jäljellä oleva määrä. Määritä kentän
work_amount_leftvastaavuus. Myös asetukset STARTJOB_AUTOTIMENOW ja JOBDONE_AUTOTIMENOW siirtävät Lemonsoftin omaa kuormitusta. - Istunnot vanhenevat. Uusi istunto ennen pitkiä synkronointeja ja varaudu pakotettuun uudelleenkirjautumiseen.
- Kuittaussäännöt. Tarkista jokaisen kuittauksen kelpoisuus vaiheen tilan perusteella ennen lähettämistä ja porrasta kutsuryöppyjä.
- Kaksi käyttöliittymää. LemonOnline ja Windows-versio käyttävät samaa tietokantaa, joten integraatio palvelee molempia.
- Suuret rakenteet. Käytä suurissa tuonneissa rajapintapolkua
/api/async/product/structureyhdessä polun/api/async/status/{jobId}kanssa.
Kuka määrittää Lemonsoft-integraation ja vastaa tuesta?
Työssä määritetään tietojen vastaavuudet koneiden, työvaiheiden ja Lemonsoft-ympäristön mukaan. Lisäksi määritetään SkyPlannerissa ylläpidettävät suunnittelusäännöt: työkohtaisesti sallitut työpisteet, asetusaikamatriisi ja työkalut.
- SkyPlanner-tiimi määrittää integraation käyttöönoton yhteydessä ja vastaa tuesta tuotantoon siirtymisen jälkeen. Jokainen tehdas käyttää Lemonsoftia omalla tavallaan, ja tämä tuntemus hyödynnetään määrityksissä.
- Lemonsoft-kumppanisi voi osallistua. Kumppani tuntee ympäristösi ja voi hoitaa API-käyttäjän, käyttöoikeudet ja testiympäristön. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Omat kehittäjäsi voivat rakentaa sen pohjalta omia ratkaisuja käyttämällä samaa dokumentoitua REST API -rajapintaa ja API-tunnistetta. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa.
Kun yhteys on käytössä, Arcturus-moottori suunnittelee työt Lemonsoftin ajantasaisten työnumeroiden perusteella, ja suunnitellut ajat siirtyvät työvaiheille. SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja siihen sisältyy 5 työpistettä. Laskutus on kuukausittainen. Saat integraatiosta prosessisi ja tarpeidesi mukaisen tarjouksen etukäteen yhdessä tilauksesi kanssa, joten tiedät kokonaiskustannukset ennen aloittamista.
Katso, miten Lemonsoftin oma suunnittelu vertautuu SkyPlanneriin artikkelissa Lemonsoft ja hienokuormitus. Yleiskatsauksen löydät Lemonsoft-sivulta ja muut järjestelmät ERP-integraatioiden koontisivulta.
Valmistavien yritysten kokemuksia SkyPlannerista
Lemonsoftkaksisuuntainen integraatio SkyPlanneriin
Kaskea Group
Sopimusvalmistus: CNC-koneistus, teräsrakenteet ja kokoonpano
Tuotanto suunnitellaan SkyPlannerissa, josta on kaksisuuntainen integraatio Lemonsoftiin.
Vähemmänmateriaalipuutteista johtuvia seisokkeja
”SkyPlannerin arvo meille on siinä, että se on arjessa toimiva työkalu erityisesti toimituspäivien määrittämiseen.”
Tommi Männistö, tuotannonsuunnittelupäällikkö
Eskomatic · Sopimuskoneistus
Automaattinen kuormituksen suunnittelu tarkentaa toimituspäiviä, ja materiaalipuutteista johtuvat tuotantoseisokit ovat vähentyneet merkittävästi.
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono siirtyy linjalle sekunneissa.
+90 %tuotannon tehokkuuteen
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikki työpisteet kattava optimoitu suunnitelma kolmelle kuukaudelle syntyy alle 30 minuutissa.
Usein kysytyt kysymykset
Onko Lemonsoftissa rajapinta tuotantotiedoille?
Kyllä. LemonRest tarjoaa pääsyn tuotantotöihin ja työvaiheisiin, koneisiin, tuoterakenteisiin, materiaaleihin, työvuoroihin ja valmistumiskirjauksiin. Se on esiasennettu Alustapalvelun asiakkaille, ja sen käyttö edellyttää API-avainta ja käyttöoikeuksia.
Tukeeko Lemonsoft webhookeja?
LemonRestissä ei ole listattu webhook-rajapintapisteitä. Muutokset luetaan main_ws/changed-muutoskyselyllä ja poistotapahtumista muutaman minuutin välein. SkyPlannerin omat webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
Miten suunnitellut ajat kirjoitetaan takaisin Lemonsoftiin?
Kutsulla PUT /api/production/workstage, joka päivittää työlle ja sen työvaiheille alkamisajan, päättymisajan ja koneen. Pidä Lemonsoftin automaattinen tuotannonsuunnittelu pois käytöstä silloin, kun SkyPlanner hallitsee aikataulua, tai aseta aikataululukitus jokaiselle työnumerolle, jonka tiedot kirjoitetaan takaisin. Näin SkyPlannerin määrittämät ajat säilyvät muuttumattomina.
Voidaanko työntekijöiden SkyPlannerissa tekemät kuittaukset siirtää Lemonsoftiin?
Kyllä. Jokainen kuittaus siirtyy valmistumiskirjauksena, joka sisältää valmistuneen ja hylätyn määrän, tunnit ja henkilön. Toiminto on päivittäisessä käytössä asiakasprojekteissa.
Kuka toteuttaa Lemonsoft-integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Lemonsoft-ympäristöösi käyttöönoton yhteydessä ja vastaa tuesta tuotantoon siirtymisen jälkeen. Myös Lemonsoft-kumppanisi tai omat kehittäjäsi voivat toteuttaa ratkaisuja SkyPlannerin dokumentoidun REST API -rajapinnan avulla. Alkuun pääsee pelkällä API-tunnisteella.
Voimmeko kokeilla SkyPlanneria ennen integraation toteuttamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voit käyttää enintään 20 työpistettä ja tuoda tiedot Lemonsoftista Excel- tai CSV-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
