Integracijos / ERP / Lemonsoft
Lemonsoft integravimo vadovas gamybos tvarkaraščiams sudaryti naudojant SkyPlanner APS
Šiame Lemonsoft integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti Lemonsoft ERP su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Lemonsoft abiem kryptimis per Lemonsoft REST API:
- Į SkyPlanner perduodami darbų numeriai (työnumero), darbo etapai (työvaihe), įrenginiai, gaminių struktūros, medžiagos ir suplanuotos pamainos.
- Į darbo etapų duomenis grąžinamas suplanuotas pradžios bei pabaigos laikas ir pasirinktas įrenginys.
- Operatorių patvirtinimai grąžinami kaip atlikimo įrašai.
- SkyPlanner siunčia pranešimus per webhook sąsajas vos pasikeitus tvarkaraščiui.
Kaskea Group naudoja SkyPlanner su dvikrypte Lemonsoft integracija. Diegdama sistemą, SkyPlanner komanda pritaiko integraciją prie jūsų Lemonsoft konfigūracijos ir ją palaiko pradėjus eksploataciją. Partneriai ir programuotojai taip pat gali kurti sprendimus naudodami dokumentuotą SkyPlanner REST API (API žinynas).
Lemonsoft REST API
Lemonsoft integravimo API yra LemonRest, dokumentuota Swagger 2.0 formatu, versija v1. Leidime „LemonRest 2026.10 release-2026.10.2“ nurodyti 422 keliai. (Swagger)
- Bazinis URL priklauso nuo aplinkos. Jį rasite naudotojų valdymo skiltyje, prie aplinkos valdymo ir paslaugų adresų, lauke Rest API. Lemonsoft Azure platformoje bazinis adresas yra
https://rest.lemon.fi. - Prieinamumas. Lemonsoft platformos paslaugos (Alustapalvelu) klientams REST API jau įdiegtos – tereikia suteikti naudotojo teises. (šaltinis)
- Testavimo aplinka. Galutinis klientas ją užsako per Lemonsoft Service Desk.
Atskira Kellokortti darbo laiko apskaitos API tvarkaraščiams sudaryti nereikalinga.
Autentifikavimas
LemonRest naudoja seansą:
- Užklausa
POST /api/auth/loginsu UserName, Password, Database ir ApiKey grąžinasession_id. - Siųskite jį kiekvienos užklausos antraštėje
Session-Id. - Seansą pratęskite užklausa
POST /api/auth/renew. Veikimui patikrinti naudokiteGET /api/auth/alive.
POST /api/auth/login/token vietoj naudotojo vardo ir slaptažodžio priima Token. Sukurkite atskirą integracijos naudotoją su API raktu ir suteikite tik integracijai būtinas teises. (šaltinis)
SkyPlanner REST API autentifikavimui naudoja API prieigos raktą (SkyPlanner Settings > API) ir yra dokumentuota Swagger/OpenAPI formatu. Integravimo pamokoje paaiškinama, kaip atlikti pirmąsias užklausas.
Pakeitimų aptikimas: pokyčių užklausos
LemonRest neturi webhook ar prenumeratos galinių taškų. Pakeitimai nuskaitomi pokyčių užklausa:
GET /api/production/main_ws/changed?updated_after=...grąžina nuo paskutinio užklausos vykdymo pakeistas užduotis.- Pridėkite
optimization=true. Šis parametras įtrauktas į 2026.6.3 leidimą, kad būtų panaikinta priklausomybė nuo žurnalo ir užklausa veiktų greičiau. (leidimo pastabos) GET /api/log/deletion_eventsaptinka pašalintas užduotis, todėl atšaukti darbai pašalinami iš tvarkaraščio.
Vykdykite užklausas kas kelias minutes. Pasikeitus būsenai ar tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, todėl duomenų grąžinimą inicijuoja įvykiai.
Duomenų susiejimas
| Lemonsoft objektas (galinis taškas) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Tuote, product_code (/api/products) | Gaminiai ir medžiagos | Lemonsoft → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Tuoterakenne su Työvaiheet eilutėmis (/api/products/structure, all_levels) | Gaminio struktūra, pusgaminiai, proceso etapai su paruošimo trukme | Lemonsoft → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Darbo centrai, darbo centrų grupės | Lemonsoft → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
Työnumero kaip ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Užsakymai su įvykdymo terminais ir prioritetu | Lemonsoft → SkyPlanner | Pokyčių užklausos kas kelias minutes |
Työvaihe kaip ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Kiekvieno darbo centro užduotys (proceso etapai) | Lemonsoft → SkyPlanner | Pokyčių užklausos kas kelias minutes |
Komponentų poreikis (main_ws/{worknumber}/materials) | Kiekvienai užduočiai reikalingos medžiagos | Lemonsoft → SkyPlanner | Su kiekviena užduotimi |
Suplanuotos pamainos (/api/persons/plannedshifts) | Pamainos, darbuotojai | Lemonsoft → SkyPlanner | Kasdien arba pamainos tvarkomos SkyPlanner |
Su darbo numeriu susietas pardavimo užsakymas (/api/orders/work/{work_number}) | Informacija apie klientą ir prioritetą | Lemonsoft → SkyPlanner | Su kiekviena užduotimi |
Työvaihe laukai start_time, end_time, machine_id (PUT /api/production/workstage) | Suplanuota pradžia, pabaiga ir darbo centras | SkyPlanner → Lemonsoft | Pasikeitus tvarkaraščiui, per SkyPlanner webhook |
Atlikimo įrašas (POST main_ws/sub_ws/completion_entry) | Patvirtinimai: pagamintas ir brokuotas kiekis, valandos, darbuotojas | SkyPlanner → Lemonsoft | Su kiekvienu patvirtinimu |
| SkyPlanner nustatytos tvarkaraščio sudarymo taisyklės | Užduočiai leidžiami darbo centrai, paruošimo trukmių matrica, įrankiai | Tvarkoma SkyPlanner | Nustatoma diegimo metu |
Integravimo būdai
1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite įrenginius ir jų grupes, gaminių struktūras su darbo etapais bei standartinius darbo etapus. Kiekvieną konkretų įrenginį susiekite su SkyPlanner darbo centru. Pirminius įrenginius (Isäkone) naudokite tik grupavimui, nes jie sumuoja pavaldžių įrenginių pajėgumus.
2. Darbų numerių sinchronizavimas. Iš /api/production/workstage arba main_ws/sub_ws puslapiais nuskaitykite neužbaigtų darbų numerius su jų etapais, filtruodami pagal būseną. Vėliau juos atnaujinkite naudodami main_ws/changed. Susiekite work_amount_left, o ne work_amount, nes Lemonsoft tvarkaraštį sudaro pagal likusį kiekį. Pirkimo užsakymų duomenys naudojami SkyPlanner sudarant tvarkaraštį pagal medžiagų prieinamumą, todėl etapas laukia pirkimo užsakyme nurodytos pristatymo datos.
3. Tvarkaraščio grąžinimas. Kiekvienam variklio suplanuotam ar perkeltam etapui SkyPlanner siunčia PUT /api/production/workstage su užduotimi ir jos sub_workstages. Kiekvienam etapui perduodami start_time, end_time ir, jei etapas perkeltas į alternatyvų įrenginį, machine_id.
4. Patvirtinimai iš gamybos. Operatoriai patvirtina atliktus darbus naudodami SkyPlanner Mobile Confirmations arba Production Timer. Kiekvienas patvirtinimas siunčiamas į completion_entry su sub_workstage_id, person_number, done_amount, hours, failed_amount ir job_done. Jei etape sunaudojamos medžiagos, kartu siųskite material_consumptions – Lemonsoft užregistruos įprastą pagaminimo įrašą (valmistuskirjaus).
5. Duomenų valdymo ir konfliktų sprendimo taisyklės. Užfiksuokite jas prieš pradėdami eksploataciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Gaminiai, struktūros, darbo etapai, kiekiai, užduoties būsena | Lemonsoft |
| Etapų seka, pradžios ir pabaigos laikas, įrenginio pasirinkimas | SkyPlanner |
| Užduočiai leidžiami darbo centrai, paruošimo trukmių matrica, įrankiai | SkyPlanner |
| Pamainos ir neatvykimai | Viena sistema, pasirinkta apimties apibrėžimo metu |
| Atlikimo ir atsargų apskaitos įrašai | Lemonsoft, įrašai registruojami pagal SkyPlanner patvirtinimus |
Pagrindinis konfliktų šaltinis – pačios Lemonsoft automatinis tvarkaraščių sudarymas ir atnaujinimo veiksmas: abu iš naujo suplanuoja neužrakintus etapus. Kol tvarkaraštį valdo SkyPlanner, palikite AUTOTIMING reikšmę 0. Jei šią funkciją paliekate įjungtą, užrakinkite kiekvieno įrašyto darbo numerio tvarkaraštį – taip užfiksuojami visi to numerio etapai. Vien Koneiden kapasiteetin lukitus nepakanka, nes automatinis tvarkaraščių sudarymas perkelia neužrakintas užduotis iš užrakintos dienos. (šaltinis)
Įprasti projekto etapai
Pradėjus diegimą, darbai paprastai baigiami per kelias savaites. Prieš tai per 30 dienų nemokamą bandomąjį laikotarpį sistema veikia su jūsų duomenimis: į Excel eksportuotais darbų numeriais, etapais ir įrenginiais.
- Apimties apibrėžimas. Sutarkite dėl duomenų susiejimo lentelės, atsakomybės už duomenis taisyklių ir užklausų intervalo.
- Prieiga. Galutinis klientas užsako testavimo aplinką per Lemonsoft Service Desk ir sukuria integracijos naudotoją bei API raktą.
- Pradinis įkėlimas. Įrenginiai, grupės, gaminių struktūros ir darbo etapai.
- Darbų numerių sinchronizavimas. Periodinės pokyčių užklausos, pašalinimo įvykiai ir seanso pratęsimas.
- Apribojimų nustatymas SkyPlanner sistemoje. Kiekvienai užduočiai leidžiami darbo centrai, paruošimo trukmių matrica ir įrankiai.
- Duomenų įrašymas atgal. Etapų laikai ir atlikimo įrašai, patikrinti bandymų aplinkoje.
- Lygiagretus veikimas ir paleidimas. Palyginkite su dabartine Gantt diagrama, sutvarkykite pagrindinius duomenis ir tuomet įjunkite duomenų įrašymą atgal darbinėje aplinkoje.
Į ką atsižvelgti planuojant integraciją su Lemonsoft
- Vienam etapui – vienas įrenginys. Lemonsoft etape nurodomas vienas įrenginys. Diegimo metu konkrečiam gaminiui tinkami įrenginiai nustatomi pagal sąrašą arba gaminio savybes, o SkyPlanner vėliau pasirenka iš galimų variantų.
- Dienos pajėgumas. Fiksuotas pajėgumas nurodomas kaip dienos kiekis, o nukrypimams konkretus paros laikas nenurodomas. Sumodeliuokite faktines pamainas SkyPlanner sistemoje arba nuskaitykite suplanuotas pamainas.
- Likęs kiekis. Susiekite lauką
work_amount_left. Nustatymai STARTJOB_AUTOTIMENOW ir JOBDONE_AUTOTIMENOW taip pat perkelia pačioje Lemonsoft sistemoje suplanuotą apkrovą. - Seansai baigia galioti. Prieš ilgą sinchronizavimą atnaujinkite seansą ir numatykite, kaip bus apdorojamas reikalavimas prisijungti iš naujo.
- Patvirtinimų taisyklės. Prieš siųsdami kiekvieną patvirtinimą patikrinkite, ar jis atitinka etapo būseną, ir siųsdami užklausų serijas reguliuokite jų dažnį.
- Dvi kliento programos. LemonOnline ir Windows versija naudoja vieną duomenų bazę, todėl integracija veikia su abiem.
- Didelės gaminių struktūros. Didelės apimties importui naudokite
/api/async/product/structurekartu su/api/async/status/{jobId}.
Kas konfigūruoja ir prižiūri integraciją su Lemonsoft
Darbai apima duomenų susiejimą pagal jūsų įrenginius, darbo etapus ir Lemonsoft konfigūraciją. Taip pat nustatomos SkyPlanner sistemoje saugomos tvarkaraščio sudarymo taisyklės: kiekvienai užduočiai leidžiami darbo centrai, paruošimo trukmių matrica ir įrankiai.
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją po paleidimo. Kiekviena gamykla Lemonsoft naudoja savaip, todėl šiame etape pritaikomos žinios apie jūsų darbo specifiką.
- Gali dalyvauti ir jūsų Lemonsoft partneris. Partneris žino jūsų konfigūraciją ir gali pasirūpinti API naudotoju, teisėmis bei bandymų aplinka. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir pranešimus apie įvykius (webhooks).
- Jūsų programuotojai gali plėsti integraciją naudodami tą pačią dokumentuotą REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda.
Sujungus sistemas, Arcturus variklis sudaro tvarkaraštį pagal aktualius Lemonsoft darbų numerių duomenis, o suplanuoti laikai įrašomi į darbo etapus. SkyPlanner kainuoja nuo 199 € per mėnesį, į kainą įskaičiuoti 5 darbo centrai, mokama kas mėnesį. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su plano kaina, todėl visas išlaidas žinote dar prieš pradėdami.
Kaip skiriasi pačios Lemonsoft planavimo galimybės, skaitykite puslapyje Lemonsoft gamybos planavimas pagal realius staklių ir darbuotojų pajėgumus. Apžvalgą rasite Lemonsoft puslapyje, o kitas sistemas – ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
Lemonsoftdvikryptė integracija su SkyPlanner
Kaskea Group
Sutartinė gamyba: CNC apdirbimas, plieninės konstrukcijos ir surinkimas
Gamyba planuojama SkyPlanner sistemoje, kuri dvikrypte integracija sujungta su Lemonsoft.
Mažiauprastovų dėl medžiagų trūkumo
„SkyPlanner mums vertinga tuo, kad tai kasdieniame darbe pasiteisinantis įrankis, ypač nustatant pristatymo datas.“
Tommi Männistö, gamybos planavimo vadovas
Eskomatic · Mechaninis apdirbimas pagal užsakymą
Automatiškai planuojant apkrovą galima tiksliau nustatyti pristatymo datas, o gamybos prastovų dėl medžiagų trūkumo gerokai sumažėjo.
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstomieji įrenginiai
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja užduočių eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas išaugo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas išaugo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
Dažniausiai užduodami klausimai
Ar Lemonsoft turi API gamybos duomenims?
Taip. Per LemonRest pasiekiamos gamybos užduotys ir darbo etapai, staklės, gaminių struktūros, medžiagos, pamainos ir atlikimo registravimas. Alustapalvelu klientams ji jau įdiegta; norint ja naudotis, reikia API rakto ir naudotojo teisių.
Ar Lemonsoft palaiko pranešimus apie įvykius (webhooks)?
LemonRest dokumentacijoje nenurodyta jokių „webhook“ galinių taškų. Pakeitimai nuskaitomi naudojant pokyčių užklausą main_ws/changed ir šalinimo įvykius, kas kelias minutes tikrinant, ar yra naujų duomenų. SkyPlanner „webhook“ pranešimai perduoda tvarkaraščio pakeitimus iškart, kai jie įvyksta.
Kaip suplanuoti laikai įrašomi į Lemonsoft?
Naudojant PUT /api/production/workstage, kuriuo atnaujinama užduotis ir jos darbo etapai, nurodant pradžios laiką, pabaigos laiką ir stakles. Kol tvarkaraštį valdo SkyPlanner, laikykite Lemonsoft automatinį tvarkaraščio sudarymą išjungtą arba kiekvienam darbų numeriui, į kurį įrašomi duomenys, įjunkite tvarkaraščio užraktą. Taip SkyPlanner nustatyti laikai nebus pakeisti.
Ar operatorių patvirtinimus iš SkyPlanner galima įrašyti į Lemonsoft?
Taip. Kiekvienas patvirtinimas įrašomas kaip atlikimo įrašas, kuriame nurodomi pagamintas ir brokuotas kiekiai, valandos ir darbuotojas. Klientų projektuose tai naudojama kasdien.
Kas kuria integraciją su Lemonsoft?
SkyPlanner komanda diegimo metu sukonfigūruoja dvikryptę integraciją pagal jūsų Lemonsoft konfigūraciją ir prižiūri ją po paleidimo. Jūsų Lemonsoft partneris arba programuotojai taip pat gali kurti sprendimus naudodami dokumentuotą SkyPlanner REST API – pradžiai pakanka API prieigos rakto.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti duomenis iš Lemonsoft per Excel arba CSV failus. Kredito kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
