Integracije / ERP / Lemonsoft
Vodnik za integracijo Lemonsoft s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako povezati Lemonsoft ERP s SkyPlanner APS. SkyPlanner se z Lemonsoft povezuje dvosmerno prek njegovega REST API:
- V SkyPlanner se prenašajo številke delovnih nalogov (työnumero), delovne faze (työvaihe), stroji, strukture izdelkov, materiali in načrtovane izmene.
- Na delovne faze se povratno zapišejo načrtovani časi začetka in konca ter izbrani stroj.
- Potrditve operaterjev se povratno zapišejo kot knjižbe izdelave.
- Spletni povratni klici sistema SkyPlanner pošiljajo spremembe terminskega plana takoj, ko se zgodijo.
Kaskea Group uporablja SkyPlanner z dvosmerno integracijo z Lemonsoft. Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši nastavitvi sistema Lemonsoft in zanjo zagotavlja podporo tudi po prehodu v produkcijo. Partnerji in razvijalci lahko svoje rešitve gradijo tudi na dokumentiranem REST API sistema SkyPlanner (referenčna dokumentacija API).
REST API sistema Lemonsoft
Integracijski API sistema Lemonsoft je LemonRest, dokumentiran v formatu Swagger 2.0, različica v1. Izdaja “LemonRest 2026.10 release-2026.10.2” navaja 422 poti. (Swagger)
- Osnovni URL je odvisen od okolja. Najdete ga v upravljanju uporabnikov, v razdelku za upravljanje okolij in naslove storitev, v polju Rest API. Na platformi Azure sistema Lemonsoft je osnovni naslov
https://rest.lemon.fi. - Razpoložljivost. Za stranke storitve platforme Lemonsoft (Alustapalvelu) so vmesniki REST API že nameščeni; dodeliti je treba le uporabniške pravice. (vir)
- Testno okolje. Končna stranka ga naroči pri Lemonsoft Service Desk.
Ločeni API za evidentiranje delovnega časa Kellokortti ni potreben za terminiranje.
Preverjanje pristnosti
LemonRest uporablja sejo:
- Klic
POST /api/auth/logins parametri UserName, Password, Database in ApiKey vrnesession_id. - Pošljite ga v glavi
Session-Idpri vsakem klicu. - Sejo obnovite s klicem
POST /api/auth/renew. Za preverjanje delovanja uporabiteGET /api/auth/alive.
POST /api/auth/login/token namesto uporabniškega imena in gesla sprejme Token. Ustvarite namenskega uporabnika za integracijo s ključem API in samo s pravicami, ki jih integracija potrebuje. (vir)
REST API na strani sistema SkyPlanner za avtentikacijo uporablja žeton API (SkyPlanner Settings > API) in je dokumentiran v formatu Swagger/OpenAPI. Vodič za integracijo vas vodi skozi prve klice.
Zaznavanje sprememb: poizvedbe po spremembah
LemonRest nima končnih točk za spletne povratne klice ali naročanje na dogodke. Spremembe se berejo s poizvedbo po spremembah:
GET /api/production/main_ws/changed?updated_after=...vrne operacije, ki so se spremenile od zadnjega izvajanja.- Dodajte
optimization=true. Ta parameter je bil dodan v izdaji 2026.6.3, da odpravi odvisnost od dnevnika in pospeši poizvedbo. (opombe ob izdaji) GET /api/log/deletion_eventszazna izbrisane operacije, da se preklicano delo odstrani iz terminskega plana.
Poizvedbe izvajajte vsakih nekaj minut. SkyPlanner ob spremembi stanja ali terminskega plana pošlje spletne povratne klice, zato povratno zapisovanje temelji na dogodkih.
Preslikava podatkov
| Objekt v sistemu Lemonsoft (končna točka) | Objekt v sistemu SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Tuote, product_code (/api/products) | Izdelki in materiali | Lemonsoft → SkyPlanner | Začetni prenos, nato ob spremembi |
Tuoterakenne z vrsticami Työvaiheet (/api/products/structure, all_levels) | Struktura izdelka, podizdelki, procesni koraki s pripravljalnimi časi | Lemonsoft → SkyPlanner | Začetni prenos, nato ob spremembi |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Delovni centri, skupine delovnih centrov | Lemonsoft → SkyPlanner | Začetni prenos, pozneje redko |
Työnumero kot ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Nalogi z roki in prioriteto | Lemonsoft → SkyPlanner | Poizvedbe po spremembah vsakih nekaj minut |
Työvaihe kot ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operacije (procesni koraki) po delovnih centrih | Lemonsoft → SkyPlanner | Poizvedbe po spremembah vsakih nekaj minut |
Potrebe po komponentah (main_ws/{worknumber}/materials) | Materialne potrebe po operacijah | Lemonsoft → SkyPlanner | Z vsako operacijo |
Načrtovane izmene (/api/persons/plannedshifts) | Izmene, osebje | Lemonsoft → SkyPlanner | Dnevno ali vodenje izmen v sistemu SkyPlanner |
Prodajno naročilo, povezano s številko delovnega naloga (/api/orders/work/{work_number}) | Podatki o stranki in prioriteti | Lemonsoft → SkyPlanner | Z vsako operacijo |
Polja start_time, end_time, machine_id objekta Työvaihe (PUT /api/production/workstage) | Načrtovani začetek, konec in delovni center | SkyPlanner → Lemonsoft | Ob spremembi terminskega plana prek spletnega povratnega klica sistema SkyPlanner |
Knjižba izdelave (POST main_ws/sub_ws/completion_entry) | Potrditve: izdelana in izmetna količina, ure, oseba | SkyPlanner → Lemonsoft | Ob vsaki potrditvi |
| Pravila terminiranja, nastavljena v sistemu SkyPlanner | Dovoljeni delovni centri za posamezno operacijo, matrika pripravljalnih časov, orodja | Vzdrževanje v sistemu SkyPlanner | Nastavitev med uvajanjem |
Integracijski vzorci
1. Začetni prenos matičnih podatkov. Preberite stroje in skupine strojev, strukture izdelkov z delovnimi fazami ter standardne delovne faze. Vsak dejanski stroj preslikajte v delovni center sistema SkyPlanner. Nadrejene stroje (Isäkone) uporabljajte samo za združevanje v skupine, saj seštevajo zmogljivosti podrejenih strojev.
2. Sinhronizacija številk delovnih nalogov. Odprte številke delovnih nalogov s pripadajočimi fazami preberite iz /api/production/workstage ali main_ws/sub_ws, pri čemer uporabite filtriranje po stanju in razdelitev na strani. Nato jih sproti posodabljajte s klicem main_ws/changed. Preslikajte work_amount_left, ne work_amount, saj Lemonsoft terminira glede na preostalo količino. Nabavna naročila zagotavljajo podatke za terminiranje v sistemu SkyPlanner glede na razpoložljivost materiala, zato faza čaka na datum dobave iz nabavnega naročila.
3. Povratni zapis terminskega plana. Za vsako fazo, ki jo je mehanizem razporedil ali premaknil, SkyPlanner pošlje PUT /api/production/workstage z operacijo in njenimi sub_workstages. Vsaka faza vsebuje start_time in end_time, ob premiku na drug stroj pa tudi machine_id.
4. Potrditve iz proizvodnje. Operaterji potrjujejo delo s SkyPlanner Mobile Confirmations ali Production Timer. Vsaka potrditev se pošlje v completion_entry s polji sub_workstage_id, person_number, done_amount, hours, failed_amount in job_done. Če faza porablja material, skupaj s potrditvijo pošljite še material_consumptions; Lemonsoft nato izvede običajno knjiženje izdelave (valmistuskirjaus).
5. Pravila o lastništvu podatkov in reševanju konfliktov. Zapišite jih pred prehodom v produkcijo:
| Podatki | Lastnik |
|---|---|
| Izdelki, strukture, delovne faze, količine, stanje operacije | Lemonsoft |
| Zaporedje faz, časi začetka in konca, izbira stroja | SkyPlanner |
| Dovoljeni delovni centri za posamezno operacijo, matrika pripravljalnih časov, orodja | SkyPlanner |
| Izmene in odsotnosti | En sistem, izbran pri opredelitvi obsega |
| Knjižbe izdelave in zalog | Lemonsoft, knjiženje na podlagi potrditev iz sistema SkyPlanner |
Glavna vira konfliktov sta samodejno terminiranje v sistemu Lemonsoft in funkcija osvežitve: oba ponovno razporedita nezaklenjene faze. Dokler terminski plan upravlja SkyPlanner, naj bo AUTOTIMING nastavljen na 0. Če ga pustite vklopljenega, zaklenite terminski plan pri vsaki številki delovnega naloga, v katero se zapisuje; s tem fiksirate vse faze tega naloga. Samo Koneiden kapasiteetin lukitus ne zadostuje, ker samodejno terminiranje nezaklenjene operacije premakne z zaklenjenega dne. (vir)
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko v 30-dnevnem brezplačnem preizkusu uporabite lastne podatke iz izvoza številk delovnih nalogov, faz in strojev v Excel.
- Opredelitev obsega. Določite tabelo preslikav, pravila o lastništvu podatkov in interval poizvedovanja.
- Dostop. Končna stranka pri Lemonsoft Service Desk naroči testno okolje ter ustvari uporabnika za integracijo in ključ API.
- Začetni prenos. Stroji, skupine, strukture izdelkov in delovne faze.
- Sinhronizacija številk delovnih nalogov. Redne poizvedbe po spremembah, dogodki izbrisa in obnavljanje seje.
- Nastavitev omejitev v sistemu SkyPlanner. Dovoljeni delovni centri za posamezno operacijo, matrika pripravljalnih časov in orodja.
- Povratni zapis. Časi faz in knjižbe izdelave, preverjeni v testnem okolju.
- Vzporedno delovanje in prehod v produkcijo. Primerjajte rezultate z obstoječim gantogramom, popravite matične podatke in nato v produkcijskem okolju vklopite povratno zapisovanje.
Kaj upoštevati pri integraciji s sistemom Lemonsoft
- En stroj na fazo. V sistemu Lemonsoft je vsaki fazi dodeljen en stroj. Ob uvedbi se iz seznama ali lastnosti izdelka določijo stroji, primerni za posamezen izdelek. SkyPlanner nato izbira med njimi.
- Dnevna zmogljivost. Fiksna zmogljivost je podana kot dnevna količina, odstopanja pa nimajo določene ure. V sistemu SkyPlanner modelirajte dejanske izmene ali preberite načrtovane izmene.
- Preostala količina. Preslikajte
work_amount_left. Nastavitvi STARTJOB_AUTOTIMENOW in JOBDONE_AUTOTIMENOW premikata tudi obremenitev v samem sistemu Lemonsoft. - Seje potečejo. Pred daljšimi sinhronizacijami obnovite sejo in poskrbite za obravnavo prisilne ponovne prijave.
- Pravila potrjevanja. Pred knjiženjem vsako potrditev preverite glede na stanje faze in pri večjem številu klicev uravnavajte njihovo pogostost.
- Dva odjemalca. LemonOnline in različica za Windows uporabljata isto podatkovno zbirko, zato integracija deluje za oba.
- Obsežne strukture. Za obsežne uvoze uporabite
/api/async/product/structureskupaj z/api/async/status/{jobId}.
Integracija s sistemom Lemonsoft: kdo jo nastavi in zanjo zagotavlja podporo
Delo vključuje preslikavo vaših strojev, delovnih faz in nastavitev sistema Lemonsoft. Vključuje tudi pravila terminiranja, ki jih vzdržujete v sistemu SkyPlanner: dovoljene delovne centre za posamezno operacijo, matriko pripravljalnih časov in orodja.
- Ekipa SkyPlanner integracijo nastavi ob uvedbi in zanjo zagotavlja podporo po prehodu v produkcijo. Vsak obrat uporablja Lemonsoft drugače in pri nastavitvi uporabimo znanje o teh posebnostih.
- Sodeluje lahko tudi vaš partner za Lemonsoft. Partner pozna vaše nastavitve in lahko poskrbi za uporabnika API, pravice in testno okolje. SkyPlanner zagotavlja REST API, dokumentacijo Swagger/OpenAPI in spletne povratne klice.
- Tudi vaši razvijalci lahko gradijo na tej osnovi z uporabo istega dokumentiranega REST API in žetona API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga.
Po vzpostavitvi povezave pogon Arcturus terminira na podlagi aktualnih delovnih nalogov iz sistema Lemonsoft, načrtovani časi pa se zapišejo v delovne faze. Cena za SkyPlanner se začne pri 199 € na mesec in vključuje 5 delovnih centrov, obračunava pa se mesečno. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj z izbranim paketom, tako da celotne stroške poznate še pred začetkom.
Kako se s tem primerja lastno planiranje v sistemu Lemonsoft, preberite na strani Terminiranje proizvodnje z upoštevanjem razpoložljivih zmogljivosti v sistemu Lemonsoft. Pregled najdete na strani o sistemu Lemonsoft, druge sisteme pa v pregledu integracij s sistemi ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
Lemonsoftdvosmerna integracija s sistemom SkyPlanner
Kaskea Group
Pogodbena proizvodnja: CNC-obdelava, jeklene konstrukcije in montaža
Proizvodnjo planirajo v sistemu SkyPlanner, ki je dvosmerno povezan s sistemom Lemonsoft.
Manjzastojev zaradi pomanjkanja materiala
»Vrednost, ki nam jo prinaša SkyPlanner, je v tem, da je to orodje, ki se obnese pri vsakodnevnem delu, zlasti pri določanju dobavnih rokov.«
Tommi Männistö, vodja planiranja proizvodnje
Eskomatic · Pogodbena strojna obdelava
Samodejno razporejanje proizvodnih obremenitev omogoča natančnejše določanje dobavnih rokov, zastoji v proizvodnji zaradi pomanjkanja materiala pa so se močno zmanjšali.
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za dobavno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri delovnega časa, nova čakalna vrsta operacij pa pride na proizvodno linijo v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, izdelava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
Pogosta vprašanja
Ali ima Lemonsoft API za proizvodne podatke?
Da. LemonRest omogoča dostop do proizvodnih nalogov in delovnih faz, strojev, struktur izdelkov, materialov in izmen ter knjiženje izvedbe. Za uporabnike storitve Alustapalvelu je že nameščen, za uporabo pa potrebujete ključ API in uporabniške pravice.
Ali Lemonsoft podpira spletne kavlje?
V LemonRest ni navedenih končnih točk za spletne kavlje. Spremembe se berejo s poizvedbo main_ws/changed za pridobivanje sprememb in z dogodki izbrisa, ki se preverjajo vsakih nekaj minut. Lastni spletni kavlji sistema SkyPlanner pošiljajo spremembe terminskega plana takoj, ko nastanejo.
Kako se načrtovani časi zapišejo nazaj v Lemonsoft?
S klicem PUT /api/production/workstage, ki za nalog in njegove delovne faze posodobi čas začetka, čas konca in stroj. Dokler terminski plan upravlja SkyPlanner, naj bo samodejno terminiranje v sistemu Lemonsoft izklopljeno. Lahko pa za vsak delovni nalog, v katerega zapisujete, nastavite zaklep terminskega plana, da časi ostanejo takšni, kot jih je določil SkyPlanner.
Ali se lahko potrditve operaterjev iz sistema SkyPlanner knjižijo v Lemonsoft?
Da. Vsaka potrditev se knjiži kot zapis izvedbe z izdelano količino, količino izmeta, urami in osebo. Pri strankah to v okviru projektov poteka vsak dan.
Kdo vzpostavi integracijo s sistemom Lemonsoft?
Ekipa SkyPlanner ob uvedbi nastavi dvosmerno integracijo glede na vaše nastavitve sistema Lemonsoft in po zagonu produkcijskega delovanja zagotavlja podporo. Tudi vaš partner za Lemonsoft ali vaši razvijalci lahko razvijajo rešitve z dokumentiranim REST API sistema SkyPlanner. Za začetek zadostuje žeton API.
Ali lahko SkyPlanner preizkusimo pred vzpostavitvijo integracije?
Da. Brezplačni 30-dnevni preizkus podpira do 20 delovnih centrov z uvozom datotek Excel ali CSV iz sistema Lemonsoft. Kreditne kartice ne potrebujete. Začnite preizkus ali stopite v stik s prodajo za opredelitev obsega integracije.
