Integrácie / ERP / Lemonsoft
Sprievodca integráciou Lemonsoft na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou Lemonsoft ukazuje partnerom a IT tímom, ako prepojiť Lemonsoft ERP so SkyPlanner APS. SkyPlanner sa s Lemonsoft prepája obojsmerne cez REST API systému Lemonsoft:
- Do SkyPlanner sa prenášajú čísla výrobných zákaziek (työnumero), pracovné operácie (työvaihe), stroje, štruktúry výrobkov, materiály a plánované zmeny.
- Do pracovných operácií sa spätne zapisujú plánované časy začiatku a konca a vybraný stroj.
- Potvrdenia od obsluhy sa spätne zapisujú ako záznamy dokončenia.
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Kaskea Group používa SkyPlanner s obojsmernou integráciou so systémom Lemonsoft. Tím SkyPlanner pri zavádzaní nakonfiguruje integráciu podľa vášho nastavenia Lemonsoft a poskytuje jej podporu aj po spustení do ostrej prevádzky. Partneri a vývojári môžu vlastné riešenia vytvárať aj pomocou zdokumentovaného REST API systému SkyPlanner (referenčná dokumentácia API).
REST API systému Lemonsoft
Integračné API systému Lemonsoft sa nazýva LemonRest a je zdokumentované vo formáte Swagger 2.0, verzia v1. Zostava „LemonRest 2026.10 release-2026.10.2“ uvádza 422 ciest. (Swagger)
- Základná URL sa líši podľa prostredia. Nájdete ju v správe používateľov, v časti správy prostredí a adries služieb, v poli Rest API. Na platforme Azure systému Lemonsoft je základnou adresou
https://rest.lemon.fi. - Dostupnosť. Zákazníci platformovej služby Lemonsoft (Alustapalvelu) majú REST API predinštalované a stačí im prideliť používateľské oprávnenia. (zdroj)
- Testovacie prostredie. Koncový zákazník si ho objedná cez Lemonsoft Service Desk.
Samostatné API na evidenciu času Kellokortti nie je na rozvrhovanie potrebné.
Autentifikácia
LemonRest používa reláciu:
- Volanie
POST /api/auth/logins parametrami UserName, Password, Database a ApiKey vrátisession_id. - Posielajte ho v hlavičke
Session-Idpri každom volaní. - Reláciu obnovujte pomocou
POST /api/auth/renew. Na kontrolu funkčnosti slúžiGET /api/auth/alive.
Volanie POST /api/auth/login/token prijíma namiesto používateľského mena a hesla parameter Token. Vytvorte samostatného používateľa pre integráciu s kľúčom API a iba s oprávneniami, ktoré integrácia potrebuje. (zdroj)
Na strane SkyPlanner používa REST API na autentifikáciu token API (SkyPlanner Settings > API) a je zdokumentované vo formáte Swagger/OpenAPI. Prvými volaniami vás prevedie návod na integráciu.
Zisťovanie zmien: rozdielové dotazy
LemonRest nemá koncové body pre webhooky ani odbery udalostí. Zmeny sa načítavajú rozdielovým dotazom:
- Volanie
GET /api/production/main_ws/changed?updated_after=...vráti operácie zmenené od posledného spustenia. - Pridajte
optimization=true. Tento parameter pribudol vo vydaní 2026.6.3, aby odstránil závislosť od protokolu a zrýchlil dotaz. (poznámky k vydaniu) - Volanie
GET /api/log/deletion_eventszachytí odstránené operácie, aby sa zrušená práca odstránila aj z rozvrhu.
Zmeny zisťujte každých pár minút. SkyPlanner pri zmene stavu alebo rozvrhu odosiela webhooky, takže spätný zápis sa riadi udalosťami.
Mapovanie dát
| Objekt v Lemonsoft (koncový bod) | Objekt v SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Tuote, product_code (/api/products) | Výrobky a materiály | Lemonsoft → SkyPlanner | Úvodné načítanie, potom pri zmene |
Tuoterakenne s riadkami Työvaiheet (/api/products/structure, all_levels) | Štruktúra výrobku, podvýrobky, kroky procesu s časmi prípravy | Lemonsoft → SkyPlanner | Úvodné načítanie, potom pri zmene |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Pracoviská, skupiny pracovísk | Lemonsoft → SkyPlanner | Úvodné načítanie, potom len zriedka |
Työnumero ako ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Zákazky s termínmi dokončenia a prioritou | Lemonsoft → SkyPlanner | Zisťovanie zmien každých pár minút |
Työvaihe ako ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operácie (kroky procesu) na jednotlivých pracoviskách | Lemonsoft → SkyPlanner | Zisťovanie zmien každých pár minút |
Potreba komponentov (main_ws/{worknumber}/materials) | Materiálové požiadavky jednotlivých operácií | Lemonsoft → SkyPlanner | S každou operáciou |
Plánované zmeny (/api/persons/plannedshifts) | Zmeny, personál | Lemonsoft → SkyPlanner | Denne alebo správa zmien v SkyPlanner |
Predajná objednávka priradená k číslu výrobnej zákazky (/api/orders/work/{work_number}) | Informácie o zákazníkovi a priorite | Lemonsoft → SkyPlanner | S každou operáciou |
Polia start_time, end_time, machine_id objektu Työvaihe (PUT /api/production/workstage) | Plánovaný začiatok, koniec a pracovisko | SkyPlanner → Lemonsoft | Pri zmene rozvrhu cez webhook systému SkyPlanner |
Záznam dokončenia (POST main_ws/sub_ws/completion_entry) | Potvrdenia: hotové množstvo a množstvo nepodarkov, hodiny, osoba | SkyPlanner → Lemonsoft | Pri každom potvrdení |
| Pravidlá rozvrhovania nastavené v SkyPlanner | Povolené pracoviská pre jednotlivé operácie, matica časov prípravy, nástroje | Správa v SkyPlanner | Nastavenie pri zavádzaní |
Integračné postupy
1. Úvodné načítanie kmeňových dát. Načítajte stroje a skupiny strojov, štruktúry výrobkov s pracovnými operáciami a štandardné pracovné fázy. Každý konkrétny stroj priraďte k pracovisku v SkyPlanner. Nadradené stroje (Isäkone) používajte len na zoskupovanie, pretože sčítavajú kapacitu podriadených strojov.
2. Synchronizácia výrobných zákaziek. Načítajte otvorené výrobné zákazky s ich operáciami z /api/production/workstage alebo main_ws/sub_ws. Použite filtrovanie podľa stavu a stránkovanie. Potom ich priebežne aktualizujte pomocou main_ws/changed. Mapujte work_amount_left, nie work_amount, pretože Lemonsoft rozvrhuje podľa zostávajúceho množstva. Nákupné objednávky vstupujú do rozvrhovania v SkyPlanner podľa dostupnosti materiálu, takže operácia čaká na termín dodania z nákupnej objednávky.
3. Spätný zápis rozvrhu. Pre každú operáciu, ktorú plánovací modul zaradil alebo presunul, odosiela SkyPlanner PUT /api/production/workstage s operáciou a jej sub_workstages. Každá operácia obsahuje start_time, end_time a pri presune na alternatívny stroj aj machine_id.
4. Potvrdenia z výroby. Obsluha potvrdzuje prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer. Každé potvrdenie sa odosiela do completion_entry s údajmi sub_workstage_id, person_number, done_amount, hours, failed_amount a job_done. Ak operácia spotrebúva materiál, odošlite spolu s potvrdením aj material_consumptions. Lemonsoft potom vykoná štandardný zápis dokončenia výroby (valmistuskirjaus).
5. Pravidlá zodpovednosti za dáta a riešenia konfliktov. Zdokumentujte ich pred spustením do ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Výrobky, štruktúry, pracovné operácie, množstvá, stav operácie | Lemonsoft |
| Poradie operácií, časy začiatku a konca, výber stroja | SkyPlanner |
| Povolené pracoviská pre jednotlivé operácie, matica časov prípravy, nástroje | SkyPlanner |
| Zmeny a neprítomnosti | Jeden systém vybraný pri definovaní rozsahu |
| Záznamy dokončenia a skladové zápisy | Lemonsoft, zápis na základe potvrdení zo SkyPlanner |
Hlavným zdrojom konfliktov je vlastné automatické rozvrhovanie systému Lemonsoft a funkcia obnovenia: obe nanovo zaraďujú nezamknuté operácie. Kým rozvrh spravuje SkyPlanner, ponechajte AUTOTIMING na hodnote 0. Ak ho necháte zapnutý, nastavte zámok rozvrhu pre každé číslo výrobnej zákazky, do ktorej zapisujete. Tým sa zafixujú všetky operácie danej zákazky. Samotné Koneiden kapasiteetin lukitus nestačí, pretože automatické rozvrhovanie presúva nezamknuté operácie zo zamknutého dňa na iný deň. (zdroj)
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Ešte predtým môžete počas 30-dňovej bezplatnej skúšobnej verzie pracovať s vlastnými dátami z exportu výrobných zákaziek, operácií a strojov do Excelu.
- Definovanie rozsahu. Dohodnite tabuľku mapovania, pravidlá zodpovednosti za dáta a interval zisťovania zmien.
- Prístup. Koncový zákazník si objedná testovacie prostredie cez Lemonsoft Service Desk a vytvorí používateľa pre integráciu a kľúč API.
- Úvodné načítanie. Stroje, skupiny, štruktúry výrobkov a pracovné operácie.
- Synchronizácia výrobných zákaziek. Pravidelné zisťovanie zmien, udalosti odstránenia a obnovovanie relácie.
- Nastavenie obmedzení v SkyPlanner. Povolené pracoviská pre jednotlivé operácie, matica časov prípravy a nástroje.
- Spätný zápis. Časy výrobných fáz a záznamy o dokončení, overené v testovacom prostredí.
- Súbežná prevádzka a ostré spustenie. Porovnajte výsledok s aktuálnym Ganttovým diagramom, opravte kmeňové dáta a potom zapnite spätný zápis v produkčnom prostredí.
S čím počítať pri integrácii s Lemonsoft
- Jeden stroj na výrobnú fázu. Každá výrobná fáza v Lemonsoft má priradený jeden stroj. Pri zavádzaní sa vhodné stroje pre jednotlivé produkty určia zo zoznamu alebo z vlastností produktov. SkyPlanner potom vyberá z týchto možností.
- Denná kapacita. Pevná kapacita je vyjadrená ako denný objem a odchýlky nemajú určený konkrétny čas. V SkyPlanner namodelujte skutočné pracovné zmeny alebo načítajte plánované zmeny.
- Zostávajúce množstvo. Namapujte
work_amount_left. Nastavenia STARTJOB_AUTOTIMENOW a JOBDONE_AUTOTIMENOW posúvajú aj zaťaženie rozvrhnuté samotným systémom Lemonsoft. - Platnosť relácií vyprší. Pred dlhými synchronizáciami obnovte reláciu a zabezpečte spracovanie vynúteného opätovného prihlásenia.
- Pravidlá potvrdzovania. Pred zápisom overte každé potvrdenie voči stavu výrobnej fázy a pri nárazových sériách volaní rozložte ich odosielanie v čase.
- Dva klienty. LemonOnline a verzia pre Windows používajú jednu databázu, takže integrácia slúži obom.
- Rozsiahle štruktúry. Pri veľkých importoch používajte
/api/async/product/structurespolu s/api/async/status/{jobId}.
Integrácia s Lemonsoft: kto ju nastavuje a zabezpečuje jej podporu
Práce zahŕňajú mapovanie podľa vašich strojov, výrobných fáz a nastavenia Lemonsoft. Súčasťou sú aj pravidlá rozvrhovania, ktoré spravujete v SkyPlanner: povolené pracoviská pre jednotlivé operácie, matica časov prípravy a nástroje.
- Tím SkyPlanner integráciu nastaví počas zavádzania a po ostrom spustení poskytuje podporu. Každý závod používa Lemonsoft inak a práve tu sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner pre Lemonsoft. Pozná vaše nastavenie a môže zabezpečiť používateľa API, oprávnenia a testovacie prostredie. SkyPlanner poskytuje REST API, dokumentáciu Swagger/OpenAPI a webhooky.
- Na integráciu môžu nadviazať aj vaši vývojári prostredníctvom toho istého zdokumentovaného REST API s tokenom API. Na začiatok stačí token API a tím SkyPlanner v prípade potreby pomôže.
Po prepojení nástroj Arcturus rozvrhuje výrobu podľa aktuálnych výrobných zákaziek v Lemonsoft a plánované časy sa zapisujú do výrobných fáz. Cena SkyPlanner začína od 199 € mesačne a zahŕňa 5 pracovísk s mesačnou fakturáciou. Cenovú ponuku na integráciu podľa vašich procesov a potrieb dostanete vopred spolu s ponukou predplatného, takže celkové náklady poznáte ešte pred začiatkom.
Porovnanie s vlastným plánovaním v Lemonsoft nájdete na stránke Plánovanie výroby v Lemonsoft so zohľadnením reálnej kapacity strojov a pracovníkov. Prehľad nájdete na stránke Lemonsoft a ďalšie systémy v prehľade integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
Lemonsoftobojsmerná integrácia so SkyPlanner
Kaskea Group
Zákazková výroba: CNC obrábanie, oceľové konštrukcie a montáž
Výroba sa plánuje v systéme SkyPlanner, ktorý je obojsmerne prepojený so systémom Lemonsoft.
Menejprestojov pre nedostatok materiálu
„Prínos SkyPlanner pre nás spočíva v tom, že je to nástroj, ktorý funguje v každodennej praxi, najmä pri určovaní termínov dodania.“
Tommi Männistö, manažér plánovania výroby
Eskomatic · Zákazkové obrábanie
Automatické rozvrhovanie výrobnej práce prináša presnejšie termíny dodania a prestoje vo výrobe spôsobené nedostatkom materiálu výrazne klesli.
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme pri plánovaní výroby prešli od excelových tabuliek k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Pri plánovaní výroby sa každý týždeň ušetria 2 hodiny práce a nový poradovník operácií sa na linku dostane v priebehu sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby vzrástla o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
Často kladené otázky
Má Lemonsoft API pre výrobné dáta?
Áno. LemonRest sprístupňuje výrobné operácie a fázy, stroje, štruktúry produktov, materiály, pracovné zmeny a zápis dokončenia. Zákazníci Alustapalvelu ho majú predinštalovaný a na jeho používanie potrebujú kľúč API a používateľské oprávnenia.
Podporuje Lemonsoft webhooky?
V LemonRest nie sú uvedené žiadne koncové body pre webhooky. Zmeny sa načítavajú prírastkovým dopytom main_ws/changed a prostredníctvom udalostí odstránenia, ktoré sa kontrolujú každých niekoľko minút. Vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Ako sa plánované časy zapisujú späť do Lemonsoft?
Pomocou PUT /api/production/workstage, ktorý aktualizuje operáciu a jej výrobné fázy o čas začiatku, čas konca a stroj. Kým rozvrh riadi SkyPlanner, nechajte automatické rozvrhovanie v Lemonsoft vypnuté alebo pri každom zapísanom pracovnom čísle nastavte zámok rozvrhu. Časy tak zostanú podľa nastavenia SkyPlanner.
Môžu sa potvrdenia operátorov zo SkyPlanner zapisovať do Lemonsoft?
Áno. Každé potvrdenie sa zapíše ako záznam o dokončení s údajmi o množstve vyrobených kusov a nepodarkov, počte hodín a pracovníkovi. V zákazníckych projektoch sa to využíva denne.
Kto vytvára integráciu s Lemonsoft?
Tím SkyPlanner počas zavádzania nastaví obojsmernú integráciu podľa vašej konfigurácie systému Lemonsoft a po ostrom spustení poskytuje podporu. Váš partner pre Lemonsoft alebo vaši vývojári môžu integráciu vytvoriť aj pomocou zdokumentovaného REST API SkyPlanner. Na začiatok stačí token API.
Môžeme si SkyPlanner otestovať pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom z Lemonsoft cez Excel alebo CSV, bez potreby platobnej karty. Vyskúšajte ju alebo kontaktujte obchodný tím a definujte rozsah integrácie.
