Integrációk / ERP / Lemonsoft
Lemonsoft-integrációs útmutató gyártásütemezéshez a SkyPlanner APS rendszerrel
Ez a Lemonsoft-integrációs útmutató partnereknek és informatikai csapatoknak mutatja be, hogyan kapcsolható össze a Lemonsoft ERP a SkyPlanner APS rendszerrel. A SkyPlanner a Lemonsoft REST API-ján keresztül kétirányú kapcsolatot biztosít:
- A SkyPlanner átveszi a munkaszámokat (työnumero), a műveleteket (työvaihe), a gépeket, a termékstruktúrákat, az anyagokat és a tervezett műszakokat.
- A tervezett kezdési és befejezési időpontok, valamint a kiválasztott gép visszakerülnek a műveletekhez.
- A gépkezelői visszajelzések készre jelentésként kerülnek vissza a Lemonsoftba.
- A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A Kaskea Group kétirányú Lemonsoft-integrációval használja a SkyPlanner rendszert. A bevezetés során a SkyPlanner csapata az Ön Lemonsoft-környezetéhez igazítja az integrációt, és az éles indulás után is támogatja azt. A partnerek és a fejlesztők a SkyPlanner dokumentált REST API-jára is építhetnek (API-referencia).
A Lemonsoft REST API-ja
A Lemonsoft integrációs API-ja a LemonRest, amelynek v1 verzióját Swagger 2.0 formátumban dokumentálták. A „LemonRest 2026.10 release-2026.10.2” build 422 útvonalat sorol fel. (Swagger)
- Az alap-URL környezetenként eltérő. A felhasználókezelésen belül, a környezetkezelés szolgáltatáscímei között, a Rest API mezőben található. A Lemonsoft Azure-platformján az alap-URL:
https://rest.lemon.fi. - Elérhetőség. A Lemonsoft platformszolgáltatását (Alustapalvelu) használó ügyfeleknél a REST API-k előre telepítve vannak, csak felhasználói jogosultságokra van szükség. (forrás)
- Tesztkörnyezet. A végfelhasználó rendeli meg a Lemonsoft Service Desk szolgáltatástól.
Az ütemezéshez nincs szükség a különálló Kellokortti munkaidő-nyilvántartó API-ra.
Hitelesítés
A LemonRest munkamenetet használ:
- A
POST /api/auth/loginhívás a UserName, Password, Database és ApiKey megadásával egysession_idértéket ad vissza. - Ezt minden hívásnál küldje el a
Session-Idfejlécben. - A munkamenetet a
POST /api/auth/renewhívással újíthatja meg. AGET /api/auth/aliveaz állapotellenőrzésre szolgál.
A POST /api/auth/login/token felhasználónév és jelszó helyett Token értéket fogad. Hozzon létre külön integrációs felhasználót API-kulccsal, és csak az integrációhoz szükséges jogosultságokat adja meg neki. (forrás)
A SkyPlanner oldalán a REST API API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja pedig Swagger/OpenAPI formátumú. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Változások észlelése: deltalekérdezések
A LemonRest nem rendelkezik webhook- vagy feliratkozási végpontokkal. A változások deltalekérdezéssel olvashatók ki:
- A
GET /api/production/main_ws/changed?updated_after=...az előző futás óta módosult gyártási feladatokat adja vissza. - Adja hozzá az
optimization=trueparamétert. Ez a 2026.6.3 kiadásban jelent meg, hogy megszüntesse a naplótól való függést és felgyorsítsa a lekérdezést. (kiadási megjegyzések) - A
GET /api/log/deletion_eventsjelzi a törölt gyártási feladatokat, így a visszavont munkák kikerülnek az ütemtervből.
Néhány percenként kérdezze le a változásokat. A SkyPlanner webhookot küld az állapot vagy az ütemterv változásakor, így a visszaírás eseményvezérelt.
Adatmegfeleltetés
| Lemonsoft-objektum (végpont) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
Tuote, product_code (/api/products) | Termékek és anyagok | Lemonsoft → SkyPlanner | Kezdeti betöltés, majd változáskor |
Tuoterakenne a Työvaiheet sorokkal (/api/products/structure, all_levels) | Termékstruktúra, résztermékek, műveletek az átállási időkkel | Lemonsoft → SkyPlanner | Kezdeti betöltés, majd változáskor |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Munkaállomások, munkaállomás-csoportok | Lemonsoft → SkyPlanner | Kezdeti betöltés, utána ritkán |
Työnumero ProductMainWorkStage objektumként (/api/production/workstage, main_ws/changed) | Rendelések határidővel és prioritással | Lemonsoft → SkyPlanner | Deltalekérdezés néhány percenként |
Työvaihe ProductSubWorkStage objektumként (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Gyártási feladatok (műveletek) munkaállomásonként | Lemonsoft → SkyPlanner | Deltalekérdezés néhány percenként |
Alkatrészigény (main_ws/{worknumber}/materials) | Anyagszükséglet gyártási feladatonként | Lemonsoft → SkyPlanner | Minden gyártási feladattal együtt |
Tervezett műszakok (/api/persons/plannedshifts) | Műszakok, dolgozók | Lemonsoft → SkyPlanner | Naponta, vagy a műszakokat a SkyPlannerben tartják nyilván |
A munkaszámhoz tartozó vevői rendelés (/api/orders/work/{work_number}) | Ügyfél- és prioritási adatok | Lemonsoft → SkyPlanner | Minden gyártási feladattal együtt |
A Työvaihe start_time, end_time, machine_id mezői (PUT /api/production/workstage) | Tervezett kezdés, befejezés és munkaállomás | SkyPlanner → Lemonsoft | Az ütemterv változásakor, SkyPlanner-webhookon keresztül |
Készre jelentés (POST main_ws/sub_ws/completion_entry) | Visszajelzések: elkészült és selejtes mennyiség, munkaórák, dolgozó | SkyPlanner → Lemonsoft | Minden visszajelzéskor |
| A SkyPlannerben megadott ütemezési szabályok | Gyártási feladatonként engedélyezett munkaállomások, átállásiidő-mátrix, szerszámok | A SkyPlannerben karbantartva | Beállítás a bevezetés során |
Integrációs minták
1. A törzsadatok kezdeti betöltése. Olvassa be a gépeket és gépcsoportokat, a termékstruktúrákat a hozzájuk tartozó műveletekkel, valamint a standard műveleteket. Minden tényleges gépet feleltessen meg egy SkyPlanner-munkaállomásnak. A szülőgépeket (Isäkone) csak csoportosításra használja, mivel ezek az alájuk tartozó gépek kapacitását összegzik.
2. Munkaszámok szinkronizálása. Olvassa be a nyitott munkaszámokat a műveleteikkel együtt a /api/production/workstage vagy a main_ws/sub_ws végpontról, állapot szerint szűrve és lapozva. Ezután a main_ws/changed segítségével tartsa őket naprakészen. A work_amount_left mezőt feleltesse meg, ne a work_amount mezőt, mert a Lemonsoft a hátralévő mennyiség alapján ütemez. A beszerzési rendelések adatot szolgáltatnak a SkyPlanner anyagvezérelt ütemezéséhez, így a művelet megvárja a beszerzési rendelés szállítási dátumát.
3. Az ütemterv visszaírása. A SkyPlanner minden olyan műveletnél, amelyet az ütemezőmotor elhelyezett vagy áthelyezett, PUT /api/production/workstage hívást küld a gyártási feladattal és annak sub_workstages adataival. Minden művelet tartalmazza a start_time és end_time értékét, valamint a machine_id értékét, ha alternatív gépre került át.
4. Üzemi visszajelzések. A gépkezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével jelzik vissza a munkát. Minden visszajelzés a completion_entry végpontra kerül a sub_workstage_id, person_number, done_amount, hours, failed_amount és job_done mezőkkel. Ha a művelet anyagot használ fel, küldje el vele együtt a material_consumptions adatokat is; a Lemonsoft ekkor normál készre jelentést (valmistuskirjaus) könyvel.
5. Adatgazdák és ütközéskezelési szabályok. Ezeket az éles indulás előtt rögzítse:
| Adatok | Adatgazda |
|---|---|
| Termékek, struktúrák, műveletek, mennyiségek, a gyártási feladat állapota | Lemonsoft |
| Műveleti sorrend, kezdési és befejezési időpontok, gépválasztás | SkyPlanner |
| Gyártási feladatonként engedélyezett munkaállomások, átállásiidő-mátrix, szerszámok | SkyPlanner |
| Műszakok és távollétek | Egyetlen rendszer, amelyet a felmérés során választanak ki |
| Készre jelentések és készletkönyvelések | Lemonsoft, a SkyPlanner visszajelzései alapján könyvelve |
Az ütközések fő forrása a Lemonsoft saját automatikus ütemezése és a frissítési művelet: mindkettő újra elhelyezi a nem zárolt műveleteket. Amíg a SkyPlanner kezeli az ütemtervet, tartsa az AUTOTIMING értékét 0-n. Ha bekapcsolva hagyja, állítson be ütemezési zárolást minden visszaírt munkaszámra; ez az adott munkaszám összes műveletét rögzíti. A Koneiden kapasiteetin lukitus önmagában nem elegendő, mert az automatikus ütemezés a nem zárolt gyártási feladatokat elmozgatja a zárolt napról. (forrás)
A projekt jellemző lépései
A megvalósítás általában a bevezetés megkezdésétől számított néhány héten belül lezárul. Ezt megelőzően a 30 napos ingyenes próba a saját adataival fut, a munkaszámok, műveletek és gépek Excel-exportja alapján.
- Felmérés. Rögzítsék az adatmegfeleltetési táblázatot, az adatgazdai szabályokat és a lekérdezési időközt.
- Hozzáférés. A végfelhasználó tesztkörnyezetet rendel a Lemonsoft Service Desk szolgáltatástól, és létrehozza az integrációs felhasználót és az API-kulcsot.
- Kezdeti betöltés. Gépek, csoportok, termékstruktúrák és műveletek.
- Munkaszámok szinkronizálása. Deltalekérdezések, törlési események és a munkamenet megújítása.
- Korlátozások beállítása a SkyPlannerben. A gyártási feladatonként engedélyezett munkaállomások, az átállásiidő-mátrix és a szerszámok megadása.
- Visszaírás. A műveleti időpontok és a készre jelentések visszaírásának ellenőrzése a tesztkörnyezetben.
- Párhuzamos működés és éles indulás. Összehasonlítás a jelenlegi Gantt-diagrammal, a törzsadatok javítása, majd a visszaírás bekapcsolása az éles környezetben.
Mire kell felkészülni a Lemonsoft-integrációnál?
- Műveletenként egy gép. A Lemonsoftban minden művelethez egy gép tartozik. A bevezetés során listából vagy a termék tulajdonságaiból határozzuk meg, hogy az egyes termékek mely gépeken gyárthatók. A SkyPlanner ezután ezek közül választ.
- Napi kapacitás. A rögzített kapacitás napi mennyiségként szerepel, az eltérésekhez pedig nem tartozik pontos időpont. Modellezze a tényleges műszakokat a SkyPlannerben, vagy olvassa be a tervezett műszakokat.
- Hátralévő mennyiség. Állítsa be a
work_amount_leftmező megfeleltetését. A STARTJOB_AUTOTIMENOW és a JOBDONE_AUTOTIMENOW beállítás a Lemonsoft saját terhelését is áthelyezi. - A munkamenetek lejárnak. Hosszú szinkronizálás előtt újítsa meg a munkamenetet, és gondoskodjon a kikényszerített újbóli bejelentkezés kezeléséről.
- A visszajelentés szabályai. Beküldés előtt ellenőrizze, hogy minden visszajelentés megfelel-e a művelet állapotának, és időben ossza el az egyszerre jelentkező hívásokat.
- Két kliens. A LemonOnline és a Windows-verzió közös adatbázist használ, így az integráció mindkettőt kiszolgálja.
- Nagy termékstruktúrák. Nagy mennyiségű adat importálásához használja a
/api/async/product/structurevégpontot a/api/async/status/{jobId}végponttal együtt.
Ki állítja be és ki támogatja a Lemonsoft-integrációt?
A munka része az adatok megfeleltetése az Önök gépeinek, műveleteinek és Lemonsoft-beállításainak. Ide tartoznak a SkyPlannerben kezelt ütemezési szabályok is: a gyártási feladatonként engedélyezett munkaállomások, az átállásiidő-mátrix és a szerszámok.
- A SkyPlanner csapata a bevezetés során beállítja az integrációt, az éles indulás után pedig támogatást nyújt hozzá. Minden üzem másként használja a Lemonsoftot; ezt a helyi tudást a beállításoknál hasznosítjuk.
- Az Önök Lemonsoft-partnere is részt vehet a munkában. A partner ismeri a beállításaikat, és kezelheti az API-felhasználót, a jogosultságokat és a tesztkörnyezetet. A SkyPlanner biztosítja a REST API-t, a Swagger/OpenAPI-dokumentációt és a webhookokat.
- Saját fejlesztőik is építhetnek rá ugyanazon dokumentált REST API használatával, API-tokenes hozzáféréssel. Az induláshoz elegendő egy API-token, és a SkyPlanner csapata szükség esetén segít.
A kapcsolat létrejötte után az Arcturus motor a Lemonsoft aktuális munkaszámai alapján ütemez, a tervezett időpontok pedig bekerülnek a műveletekhez. A SkyPlanner havonta 199 €-tól érhető el, 5 munkaállomással, havi számlázással. Az integrációra a folyamataik és igényeik alapján, a választott csomaggal együtt előre adunk árajánlatot, így már az indulás előtt látják a teljes költséget.
A Lemonsoft termelésütemezéséről szóló oldalon összehasonlíthatja a megoldást a Lemonsoft saját tervezési funkcióival. Áttekintést a Lemonsoft oldalán, további rendszereket pedig az ERP-integrációk gyűjtőoldalán talál.
Gyártóvállalatok véleménye a SkyPlannerről
Lemonsoftkétirányú integráció a SkyPlannerrel
Kaskea Group
Bérgyártás: CNC-megmunkálás, acélszerkezetek és összeszerelés
A gyártást a SkyPlannerben tervezik, amely kétirányú integrációval kapcsolódik a Lemonsofthoz.
Kevesebbleállás anyaghiány miatt
„A SkyPlanner értékét számunkra az adja, hogy a mindennapokban jól használható eszköz, különösen a szállítási határidők meghatározásához.”
Tommi Männistö, gyártástervezési vezető
Eskomatic · Bérforgácsolás
A terhelés automatikus ütemezésével pontosabbak a szállítási határidők, és jelentősen csökkent az anyaghiány miatti gyártásleállások száma.
2 hmegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatos gyártástervezésről áttértünk a gyártás valós idejű optimalizálására.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolótáblák és kapcsolóberendezések
A gyártástervezés hetente 2 munkaórát takarít meg, az új feladatsor pedig másodpercek alatt eljut a gyártósorra.
+90%gyártási hatékonyság
„A gyártás hatékonysága 90%-kal nőtt.”
Abdul Rucyinga, informatikai vezető
Laboratory & Allied · Gyógyszergyártás
A gyártás hatékonysága 90%-kal nőtt, és az összes munkaállomásra kiterjedő, három hónapot lefedő optimalizált terv kevesebb mint 30 perc alatt elkészül.
Gyakori kérdések
Van a Lemonsoftnak API-ja a gyártási adatokhoz?
Igen. A LemonRest hozzáférést biztosít a gyártási feladatokhoz és műveletekhez, a gépekhez, a termékstruktúrákhoz, az anyagokhoz és a műszakokhoz, valamint lehetővé teszi a teljesítés rögzítését. Az Alustapalvelu ügyfeleinél előre telepítve van; használatához API-kulcs és felhasználói jogosultságok szükségesek.
Támogatja a Lemonsoft a webhookokat?
A LemonRest nem sorol fel webhook-végpontokat. A változásokat a main_ws/changed változáslekérdezéssel és a törlési események néhány percenkénti lekérdezésével olvassuk be. A SkyPlanner saját webhookjai azonnal továbbítják az ütemezés változásait.
Hogyan kerülnek vissza a tervezett időpontok a Lemonsoftba?
A PUT /api/production/workstage hívással, amely frissíti a gyártási feladat és műveletei kezdési és befejezési időpontját, valamint a hozzárendelt gépet. Amíg az ütemezést a SkyPlanner kezeli, tartsa kikapcsolva a Lemonsoft automatikus ütemezését, vagy állítsa be az ütemezési zárolást minden visszaírt munkaszámnál. Így a SkyPlanner által megadott időpontok változatlanok maradnak.
Átvihetők a SkyPlannerből a gépkezelői visszajelentések a Lemonsoftba?
Igen. Minden visszajelentés teljesítési bejegyzésként kerül át, az elkészült és a selejtes mennyiséggel, a munkaórákkal és a dolgozóval együtt. Ügyfélprojektjeinkben ezt naponta használják.
Ki készíti el a Lemonsoft-integrációt?
A SkyPlanner csapata a bevezetés során az Önök Lemonsoft-beállításaihoz igazítja a kétirányú integrációt, az éles indulás után pedig támogatást nyújt hozzá. Lemonsoft-partnerük vagy saját fejlesztőik is fejleszthetnek a SkyPlanner dokumentált REST API-jára építve; az induláshoz elegendő egy API-token.
Kipróbálhatjuk a SkyPlannert az integráció elkészítése előtt?
Igen. A 30 napos ingyenes próba során legfeljebb 20 munkaállomást használhatnak, a Lemonsoftból származó adatokat pedig Excel- vagy CSV-fájlból importálhatják. Bankkártya nem szükséges. Indítsa el a próbát, vagy egyeztessen értékesítőinkkel az integráció felméréséről.
