Průvodce integrací Lemonsoft pro rozvrhování výroby se SkyPlanner APS
Tento průvodce integrací Lemonsoft ukazuje partnerům a IT týmům, jak propojit Lemonsoft ERP se SkyPlanner APS. SkyPlanner se s Lemonsoft propojuje obousměrně prostřednictvím REST API systému Lemonsoft:
- Do SkyPlanner se načítají čísla výrobních zakázek (työnumero), pracovní operace (työvaihe), stroje, struktury výrobků, materiály a plánované směny.
- Plánované časy zahájení a dokončení a vybraný stroj se zapisují zpět k pracovním operacím.
- Potvrzení od obsluhy se zapisují zpět jako hlášení výroby.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Kaskea Group používá SkyPlanner s obousměrnou integrací Lemonsoft. Tým SkyPlanner při zavádění nastaví integraci podle vaší konfigurace Lemonsoft a poskytuje podporu i po spuštění do ostrého provozu. Partneři a vývojáři mohou také využít zdokumentované REST API systému SkyPlanner (referenční dokumentace API).
REST API systému Lemonsoft
Integrační API systému Lemonsoft se nazývá LemonRest a je zdokumentováno ve formátu Swagger 2.0, verze v1. Sestavení „LemonRest 2026.10 release-2026.10.2“ uvádí 422 cest. (Swagger)
- Základní URL se liší podle prostředí. Najdete ji ve správě uživatelů, v části pro správu prostředí a adresy služeb, v poli Rest API. Na platformě Azure systému Lemonsoft je základní adresa
https://rest.lemon.fi. - Dostupnost. Zákazníci platformové služby Lemonsoft (Alustapalvelu) mají REST API předinstalovaná a potřebují pouze přidělit uživatelská oprávnění. (zdroj)
- Testovací prostředí. Koncový zákazník si je objednává u Lemonsoft Service Desk.
Samostatné API pro evidenci pracovní doby Kellokortti není pro rozvrhování potřeba.
Ověřování
LemonRest používá relaci:
- Volání
POST /api/auth/logins parametry UserName, Password, Database a ApiKey vrátísession_id. - Při každém volání jej odesílejte v hlavičce
Session-Id. - Relaci obnovujte pomocí
POST /api/auth/renew. Ke kontrole funkčnosti sloužíGET /api/auth/alive.
POST /api/auth/login/token přijímá místo uživatelského jména a hesla parametr Token. Vytvořte pro integraci samostatného uživatele s klíčem API a pouze s oprávněními, která integrace potřebuje. (zdroj)
Na straně SkyPlanner se přístup k REST API ověřuje pomocí tokenu API (SkyPlanner Settings > API). API je zdokumentováno ve Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Zjišťování změn: rozdílové dotazy
LemonRest nemá endpointy pro webhooky ani odběr událostí. Změny se načítají rozdílovým dotazem:
GET /api/production/main_ws/changed?updated_after=...vrací operace změněné od posledního spuštění.- Přidejte
optimization=true. Tento parametr byl přidán ve verzi 2026.6.3, aby odstranil závislost na protokolu a zrychlil dotaz. (poznámky k vydání) GET /api/log/deletion_eventszachytí odstraněné operace, takže zrušená práce zmizí z rozvrhu.
Dotazujte se každých několik minut. SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu, takže zpětný zápis je řízen událostmi.
Mapování dat
| Objekt v Lemonsoft (endpoint) | Objekt ve SkyPlanner | Směr | Četnost |
|---|---|---|---|
Tuote, product_code (/api/products) | Výrobky a materiály | Lemonsoft → SkyPlanner | Úvodní načtení, poté při změně |
Tuoterakenne s řádky Työvaiheet (/api/products/structure, all_levels) | Struktura výrobku, dílčí výrobky, technologické operace s přípravnými časy | Lemonsoft → SkyPlanner | Úvodní načtení, poté při změně |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Pracoviště, skupiny pracovišť | Lemonsoft → SkyPlanner | Úvodní načtení, poté jen zřídka |
Työnumero jako ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Zakázky s termíny dokončení a prioritou | Lemonsoft → SkyPlanner | Rozdílové dotazy každých několik minut |
Työvaihe jako ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operace (technologické kroky) podle pracovišť | Lemonsoft → SkyPlanner | Rozdílové dotazy každých několik minut |
Potřeba komponent (main_ws/{worknumber}/materials) | Materiálové požadavky pro jednotlivé operace | Lemonsoft → SkyPlanner | S každou operací |
Plánované směny (/api/persons/plannedshifts) | Směny, pracovníci | Lemonsoft → SkyPlanner | Denně, nebo se směny spravují ve SkyPlanner |
Prodejní objednávka navázaná na číslo výrobní zakázky (/api/orders/work/{work_number}) | Informace o zákazníkovi a prioritě | Lemonsoft → SkyPlanner | S každou operací |
Työvaihe start_time, end_time, machine_id (PUT /api/production/workstage) | Plánované zahájení, dokončení a pracoviště | SkyPlanner → Lemonsoft | Při změně rozvrhu prostřednictvím webhooku SkyPlanner |
Hlášení výroby (POST main_ws/sub_ws/completion_entry) | Potvrzení: vyrobené a zmetkové množství, hodiny, pracovník | SkyPlanner → Lemonsoft | Při každém potvrzení |
| Pravidla rozvrhování nastavená ve SkyPlanner | Povolená pracoviště pro jednotlivé operace, matice přípravných časů, nástroje | Spravováno ve SkyPlanner | Nastavení při zavádění |
Integrační postupy
1. Úvodní načtení kmenových dat. Načtěte stroje a skupiny strojů, struktury výrobků s jejich pracovními operacemi a standardní pracovní fáze. Každý konkrétní stroj namapujte na pracoviště ve SkyPlanner. Nadřazené stroje (Isäkone) používejte pouze k seskupování, protože sčítají kapacitu podřízených strojů.
2. Synchronizace výrobních zakázek. Z /api/production/workstage nebo main_ws/sub_ws načtěte otevřené výrobní zakázky s jejich operacemi. Použijte filtrování podle stavu a stránkování. Poté je průběžně aktualizujte pomocí main_ws/changed. Mapujte work_amount_left, nikoli work_amount, protože Lemonsoft rozvrhuje podle zbývajícího množství. Nákupní objednávky poskytují vstupy pro rozvrhování podle dostupnosti materiálu ve SkyPlanner, takže operace čeká na termín dodání z nákupní objednávky.
3. Zpětný zápis rozvrhu. Pro každou operaci, kterou plánovací algoritmus zařadil nebo přesunul, odesílá SkyPlanner PUT /api/production/workstage s operací a jejími sub_workstages. Každá operace obsahuje start_time, end_time a při přesunu na alternativní stroj také machine_id.
4. Potvrzování práce ve výrobě. Obsluha potvrzuje práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer. Každé potvrzení se odesílá do completion_entry s poli sub_workstage_id, person_number, done_amount, hours, failed_amount a job_done. Pokud operace spotřebovává materiál, odešlete spolu s potvrzením také material_consumptions. Lemonsoft pak provede standardní zaúčtování výroby (valmistuskirjaus).
5. Pravidla odpovědnosti za data a řešení konfliktů. Sepište je před spuštěním do ostrého provozu:
| Data | Odpovědný systém |
|---|---|
| Výrobky, struktury, pracovní operace, množství, stav operací | Lemonsoft |
| Pořadí operací, časy zahájení a dokončení, výběr stroje | SkyPlanner |
| Povolená pracoviště pro jednotlivé operace, matice přípravných časů, nástroje | SkyPlanner |
| Směny a absence | Jeden systém zvolený při vymezení rozsahu |
| Hlášení výroby a skladové pohyby | Lemonsoft, zápis na základě potvrzení ze SkyPlanner |
Hlavním zdrojem konfliktů je vlastní automatické rozvrhování v Lemonsoft a akce obnovení: obojí znovu zařazuje nezamčené operace. Dokud rozvrh spravuje SkyPlanner, ponechte AUTOTIMING na hodnotě 0. Pokud jej necháte zapnutý, nastavte zámek rozvrhu u každé zapisované výrobní zakázky; tím se zafixují všechny její operace. Samotné Koneiden kapasiteetin lukitus nestačí, protože automatické rozvrhování přesouvá nezamčené operace ze zamčeného dne jinam. (zdroj)
Obvyklý průběh projektu
Implementace bývá dokončena během několika týdnů od zahájení zavádění. Ještě předtím probíhá 30denní bezplatné zkušební období s vašimi vlastními daty z excelového exportu výrobních zakázek, operací a strojů.
- Vymezení rozsahu. Stanovte mapovací tabulku, pravidla odpovědnosti za data a interval dotazování.
- Přístup. Koncový zákazník si objedná testovací prostředí u Lemonsoft Service Desk a vytvoří integračního uživatele a klíč API.
- Úvodní načtení. Stroje, skupiny, struktury výrobků a pracovní operace.
- Synchronizace výrobních zakázek. Rozdílové dotazy, události odstranění a obnovování relace.
- Nastavení omezení v SkyPlanner. Povolená pracoviště pro jednotlivé operace, matice seřizovacích časů a nástroje.
- Zpětný zápis. Časy výrobních fází a záznamy o dokončení ověřené v testovacím prostředí.
- Souběžný provoz a spuštění. Porovnejte výsledky se stávajícím Ganttovým diagramem, opravte kmenová data a poté zapněte zpětný zápis v produkčním prostředí.
S čím počítat při integraci s Lemonsoft
- Jeden stroj na výrobní fázi. Každá výrobní fáze v Lemonsoft má přiřazený jeden stroj. Při zavádění se vhodné stroje pro jednotlivé výrobky určí ze seznamu nebo z vlastností výrobku. SkyPlanner pak vybírá z těchto možností.
- Denní kapacita. Pevná kapacita je vyjádřena jako denní objem a odchylky nemají přiřazený konkrétní čas. V SkyPlanner namodelujte skutečné směny nebo načtěte naplánované směny.
- Zbývající množství. Namapujte
work_amount_left. Nastavení STARTJOB_AUTOTIMENOW a JOBDONE_AUTOTIMENOW také posouvají zátěž rozvrženou přímo v Lemonsoft. - Platnost relací vyprší. Před dlouhou synchronizací obnovte relaci a zajistěte obsluhu vynuceného opětovného přihlášení.
- Pravidla pro potvrzování. Před odesláním každého potvrzení ověřte, zda odpovídá stavu výrobní fáze, a při větším počtu volání mezi nimi dodržujte rozestupy.
- Dva klienti. LemonOnline a verze pro Windows sdílejí jednu databázi, takže integrace funguje pro oba klienty.
- Rozsáhlé struktury. Pro velké importy použijte
/api/async/product/structurespolu s/api/async/status/{jobId}.
Integrace s Lemonsoft: kdo ji nastavuje a zajišťuje podporu
Součástí práce je přizpůsobení mapování vašim strojům, pracovním operacím a konfiguraci Lemonsoft. Zahrnuje také pravidla rozvrhování spravovaná v SkyPlanner: povolená pracoviště pro jednotlivé operace, matici seřizovacích časů a nástroje.
- Tým SkyPlanner integraci nastaví při zavádění a po spuštění zajišťuje její podporu. Každý závod používá Lemonsoft jinak a právě při nastavení se tyto znalosti uplatní.
- Zapojit se může i váš partner pro Lemonsoft. Zná vaše nastavení a může zajistit uživatelský účet pro API, oprávnění a testovací prostředí. SkyPlanner poskytuje REST API, dokumentaci Swagger/OpenAPI a webhooky.
- Na integraci mohou navázat i vaši vlastní vývojáři. Využijí stejné zdokumentované REST API s API tokenem. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže.
Po propojení vytváří modul Arcturus rozvrh podle aktuálních výrobních zakázek z Lemonsoft a plánované časy se zapisují do výrobních fází. SkyPlanner stojí od 199 € měsíčně za 5 pracovišť s měsíční fakturací. Cenovou nabídku na integraci připravíme předem podle vašich procesů a potřeb společně s nabídkou tarifu, takže celkové náklady znáte ještě před zahájením.
Podívejte se na srovnání s vlastním plánováním Lemonsoft v článku Plánování výroby v Lemonsoft s ohledem na skutečné kapacity strojů a pracovníků. Přehled najdete na stránce Lemonsoft, další systémy pak v přehledu integrací s ERP.
Jak SkyPlanner hodnotí výrobní firmy
Lemonsoftobousměrná integrace se SkyPlanner
Kaskea Group
Zakázková výroba: CNC obrábění, ocelové konstrukce a montáž
Výroba se plánuje v systému SkyPlanner, který je obousměrně propojen se systémem Lemonsoft.
Méně prostojůkvůli nedostatku materiálu
„Přínos SkyPlanner pro nás spočívá v tom, že je to nástroj, který funguje v každodenním provozu, zejména při stanovování dodacích termínů.“
Tommi Männistö, vedoucí plánování výroby
Eskomatic · Zakázkové obrábění
Automatické plánování vytížení kapacit přináší přesnější dodací termíny a počet prostojů ve výrobě způsobených nedostatkem materiálu výrazně klesl.
2 húspory každý týden
„Díky SkyPlanner jsme přešli od plánování výroby v excelových tabulkách k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozvaděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová fronta operací se na linku dostane během několika sekund.
+90 %efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
Časté dotazy
Má Lemonsoft API pro výrobní data?
Ano. LemonRest zpřístupňuje výrobní zakázky a jejich fáze, stroje, struktury výrobků, materiály a směny a umožňuje zapisovat údaje o dokončení výroby. Zákazníci Alustapalvelu jej mají předinstalovaný. K použití je potřeba API klíč a uživatelská oprávnění.
Podporuje Lemonsoft webhooky?
V LemonRest nejsou uvedeny žádné endpointy pro webhooky. Změny se načítají rozdílovým dotazem main_ws/changed a pomocí událostí odstranění, a to každých několik minut. Vlastní webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Jak se plánované časy zapisují zpět do Lemonsoft?
Pomocí PUT /api/production/workstage, který u výrobní zakázky a jejích fází aktualizuje čas zahájení, čas ukončení a stroj. Dokud rozvrh řídí SkyPlanner, ponechte automatické rozvrhování v Lemonsoft vypnuté, nebo u každé zapisované výrobní zakázky nastavte zámek rozvrhu. Časy tak zůstanou na hodnotách, které nastavil SkyPlanner.
Lze potvrzení obsluhy ze SkyPlanner zapisovat do Lemonsoft?
Ano. Každé potvrzení se zapíše jako záznam o dokončení s vyrobeným a zmetkovým množstvím, odpracovanými hodinami a pracovníkem. V zákaznických projektech se tato funkce používá denně.
Kdo vytváří integraci s Lemonsoft?
Tým SkyPlanner při zavádění nastaví obousměrnou integraci podle vaší konfigurace Lemonsoft a po spuštění zajišťuje její podporu. Váš partner pro Lemonsoft nebo vaši vlastní vývojáři mohou také stavět na zdokumentovaném REST API SkyPlanner. Pro začátek stačí API token.
Můžeme SkyPlanner vyzkoušet před vytvořením integrace?
Ano. Během 30denního bezplatného zkušebního období můžete využívat až 20 pracovišť a importovat data z Lemonsoft ve formátu Excel nebo CSV. Platební karta není potřeba. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým kvůli vymezení rozsahu integrace.
