Liidestused / ERP / Lemonsoft
Lemonsofti integreerimise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Lemonsofti integreerimise juhend näitab partneritele ja IT-meeskondadele, kuidas ühendada Lemonsoft ERP SkyPlanner APS-iga. SkyPlanner vahetab Lemonsoftiga andmeid mõlemas suunas Lemonsofti REST API kaudu:
- SkyPlannerisse jõuavad töönumbrid (työnumero), tööetapid (työvaihe), masinad, tootestruktuurid, materjalid ja planeeritud vahetused.
- Planeeritud algus- ja lõpuajad ning valitud masin kirjutatakse tagasi tööetappidesse.
- Operaatorite kinnitused saadetakse tagasi valmimiskannetena.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
Kaskea Group kasutab SkyPlannerit koos kahesuunalise Lemonsofti integratsiooniga. SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus teie Lemonsofti keskkonna järgi ja pakub tuge ka pärast kasutuselevõttu. Partnerid ja arendajad saavad lahendusi luua ka SkyPlanneri dokumenteeritud REST API abil (API dokumentatsioon).
Lemonsofti REST API
Lemonsofti integratsiooni-API on LemonRest, mille dokumentatsioon kasutab Swagger 2.0 vormingut ja versioonitähist v1. Järk „LemonRest 2026.10 release-2026.10.2” sisaldab 422 teed. (Swagger)
- Baas-URL on igal keskkonnal oma. Selle leiate kasutajahaldusest keskkonnahalduse teenuseaadresside alt väljalt Rest API. Lemonsofti Azure’i platvormil on baas-URL
https://rest.lemon.fi. - Kättesaadavus. Lemonsofti platvormiteenuse (Alustapalvelu) klientidel on REST API-d eelpaigaldatud ja vaja on vaid kasutusõigusi. (allikas)
- Testkeskkond. Lõppklient tellib selle Lemonsoft Service Deskist.
Eraldi Kellokortti tööaja arvestuse API-t pole ajakava koostamiseks vaja.
Autentimine
LemonRest kasutab seanssi:
- Päring
POST /api/auth/loginparameetritega UserName, Password, Database ja ApiKey tagastabsession_id. - Saatke see iga päringu päises
Session-Id. - Uuendage seanssi päringuga
POST /api/auth/renew. Töökorras olekut saab kontrollida päringugaGET /api/auth/alive.
POST /api/auth/login/token võtab kasutajanime ja parooli asemel vastu parameetri Token. Looge integratsiooni jaoks eraldi kasutaja koos API-võtmega ning andke talle ainult integratsiooniks vajalikud õigused. (allikas)
SkyPlanneri REST API kasutab autentimiseks API-tokenit (SkyPlanner Settings > API) ning selle dokumentatsioon on Swagger/OpenAPI vormingus. Integreerimise õpetus näitab, kuidas esimesi päringuid teha.
Muudatuste tuvastamine: deltapäringud
LemonRestil pole veebihaakide ega sündmuste tellimise lõpp-punkte. Muudatusi loetakse deltapäringuga:
GET /api/production/main_ws/changed?updated_after=...tagastab pärast eelmist käivitust muudetud tööd.- Lisage
optimization=true. See parameeter lisati versioonis 2026.6.3, et eemaldada sõltuvus logist ja kiirendada päringut. (versioonimärkmed) GET /api/log/deletion_eventstuvastab kustutatud tööd, nii et tühistatud tööd eemaldatakse ajakavast.
Tehke päringuid iga paari minuti järel. SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega toimub tagasikirjutus sündmuspõhiselt.
Andmete vastendamine
| Lemonsofti objekt (lõpp-punkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Tuote, product_code (/api/products) | Tooted ja materjalid | Lemonsoft → SkyPlanner | Esmane laadimine, seejärel muudatuse korral |
Tuoterakenne koos Työvaiheet ridadega (/api/products/structure, all_levels) | Tootestruktuur, alamtooted, tööetapid koos seadistusaegadega | Lemonsoft → SkyPlanner | Esmane laadimine, seejärel muudatuse korral |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Töökeskused, töökeskuste rühmad | Lemonsoft → SkyPlanner | Esmane laadimine, hiljem harva |
Työnumero objektina ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Tellimused koos tähtaegade ja prioriteediga | Lemonsoft → SkyPlanner | Deltapäringud iga paari minuti järel |
Työvaihe objektina ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Tööd (tööetapid) töökeskuste kaupa | Lemonsoft → SkyPlanner | Deltapäringud iga paari minuti järel |
Komponentide vajadus (main_ws/{worknumber}/materials) | Materjalivajadus tööde kaupa | Lemonsoft → SkyPlanner | Koos iga tööga |
Planeeritud vahetused (/api/persons/plannedshifts) | Vahetused, personal | Lemonsoft → SkyPlanner | Iga päev või hallatakse vahetusi SkyPlanneris |
Töönumbriga seotud müügitellimus (/api/orders/work/{work_number}) | Kliendi ja prioriteedi taustteave | Lemonsoft → SkyPlanner | Koos iga tööga |
Työvaihe väljad start_time, end_time, machine_id (PUT /api/production/workstage) | Planeeritud algus, lõpp ja töökeskus | SkyPlanner → Lemonsoft | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
Valmimiskanne (POST main_ws/sub_ws/completion_entry) | Kinnitused: valminud ja praagitud kogus, töötunnid, töötaja | SkyPlanner → Lemonsoft | Iga kinnituse korral |
| SkyPlanneris määratud ajakava koostamise reeglid | Igale tööle lubatud töökeskused, seadistusaegade maatriks, tööriistad | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Integratsiooni töövood
1. Põhiandmete esmane laadimine. Lugege sisse masinad ja masinarühmad, tootestruktuurid koos tööetappidega ning standardsed tööetapid. Vastendage iga konkreetne masin SkyPlanneri töökeskusega. Kasutage ülemmasinaid (Isäkone) ainult rühmitamiseks, sest need summeerivad alammasinate tootmisvõimsuse.
2. Töönumbrite sünkroonimine. Lugege avatud töönumbrid koos etappidega sisse lõpp-punktist /api/production/workstage või main_ws/sub_ws, filtreerides oleku järgi ja kasutades lehekülgede kaupa pärimist. Seejärel hoidke neid ajakohasena päringuga main_ws/changed. Vastendage work_amount_left, mitte work_amount, sest Lemonsoft koostab ajakava järelejäänud koguse põhjal. Ostutellimused annavad sisendi SkyPlanneri materjalipõhisele ajakava koostamisele, nii et tööetapp ootab ostutellimuse tarnekuupäeva.
3. Ajakava tagasikirjutus. Iga etapi kohta, mille mootor ajakavasse paigutas või ümber tõstis, saadab SkyPlanner päringu PUT /api/production/workstage koos töö ja selle sub_workstages andmetega. Iga etapp sisaldab välju start_time ja end_time ning alternatiivsele masinale üleviimise korral ka välja machine_id.
4. Kinnitused tootmisest. Operaatorid kinnitavad tööd funktsiooniga SkyPlanner Mobile Confirmations või Production Timer. Iga kinnitus saadetakse lõpp-punkti completion_entry koos väljadega sub_workstage_id, person_number, done_amount, hours, failed_amount ja job_done. Kui etapis kulub materjali, saatke koos kinnitusega ka material_consumptions ning Lemonsoft teeb tavapärase valmimiskande (valmistuskirjaus).
5. Andmete haldamise ja konfliktide lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Tooted, struktuurid, tööetapid, kogused, töö olek | Lemonsoft |
| Etappide järjekord, algus- ja lõpuajad, masina valik | SkyPlanner |
| Igale tööle lubatud töökeskused, seadistusaegade maatriks, tööriistad | SkyPlanner |
| Vahetused ja puudumised | Üks süsteem, mis valitakse ulatuse määramisel |
| Valmimis- ja laokanded | Lemonsoft, kanded tehakse SkyPlanneri kinnituste alusel |
Peamised konfliktide allikad on Lemonsofti enda automaatne ajakava koostamine ja värskendamistoiming: mõlemad paigutavad lukustamata etapid ümber. Hoidke AUTOTIMING väärtusel 0 sel ajal, kui ajakava haldab SkyPlanner. Kui jätate selle sisse, lukustage iga tagasikirjutatud töönumbri ajakava; see fikseerib kõik selle numbri etapid. Ainult funktsiooni Koneiden kapasiteetin lukitus kasutamisest ei piisa, sest automaatne ajakava koostamine tõstab lukustamata tööd lukustatud päevalt ära. (allikas)
Projekti tavapärased etapid
Lahendus võetakse tavaliselt kasutusele mõne nädala jooksul pärast juurutamise algust. Enne seda saate kasutada 30-päevast tasuta prooviperioodi oma andmetega, mis pärinevad töönumbrite, etappide ja masinate Exceli ekspordist.
- Ulatuse määramine. Leppige kokku vastendustabel, andmete haldamise reeglid ja päringute intervall.
- Juurdepääs. Lõppklient tellib Lemonsoft Service Deskist testkeskkonna ning loob integratsioonikasutaja ja API-võtme.
- Esmane laadimine. Masinad, rühmad, tootestruktuurid ja tööetapid.
- Töönumbrite sünkroonimine. Regulaarsed deltapäringud, kustutamissündmused ja seansi uuendamine.
- Piirangute seadistamine SkyPlanneris. Iga töö jaoks lubatud töökeskused, seadistusaegade maatriks ja tööriistad.
- Tagasikirjutamine. Etappide ajad ja valmimiskanded, mida kontrollitakse testkeskkonnas.
- Paralleelne kasutamine ja kasutuselevõtt. Võrrelge tulemusi praeguse Gantti diagrammiga, parandage põhiandmed ning seejärel lülitage tagasikirjutamine töökeskkonnas sisse.
Millega Lemonsofti integratsiooni kavandamisel arvestada
- Üks masin etapi kohta. Lemonsoftis on iga etapiga seotud üks masin. Kasutuselevõtu käigus määratakse loendi või toote omaduste põhjal, millised masinad igale tootele sobivad. Seejärel valib SkyPlanner nende võimaluste hulgast.
- Päevane tootmisvõimsus. Püsiv tootmisvõimsus määratakse päevase mahuna ning kõrvalekalletel puudub kellaaeg. Modelleerige tegelikud vahetused SkyPlanneris või lugege sisse kavandatud vahetused.
- Järelejäänud kogus. Seostage väli
work_amount_left. Seaded STARTJOB_AUTOTIMENOW ja JOBDONE_AUTOTIMENOW nihutavad ka Lemonsofti enda koormust. - Seansid aeguvad. Uuendage seanssi enne pikki sünkroonimisi ja arvestage kohustusliku uuesti sisselogimisega.
- Kinnitamise reeglid. Enne saatmist kontrollige iga kinnituse vastavust etapi olekule ja hajutage korraga tekkivad päringud ajas.
- Kaks klientrakendust. LemonOnline ja Windowsi versioon kasutavad ühist andmebaasi, seega teenindab integratsioon mõlemat.
- Suured tootestruktuurid. Mahukaks impordiks kasutage
/api/async/product/structurekoos päringuga/api/async/status/{jobId}.
Kes seadistab Lemonsofti integratsiooni ja pakub tuge?
Töö hõlmab andmete seostamist teie masinate, tööetappide ja Lemonsofti seadistusega. Samuti hõlmab see SkyPlanneris hallatavaid ajakava koostamise reegleid: iga töö jaoks lubatud töökeskusi, seadistusaegade maatriksit ja tööriistu.
- SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu käigus ja pakub tuge ka pärast seda. Iga tehas kasutab Lemonsofti omal moel ning seadistamisel rakendatakse just neid teadmisi.
- Kaasata saab ka teie Lemonsofti partneri. Partner tunneb teie seadistust ning saab korraldada API kasutaja, õigused ja testkeskkonna. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Ka teie enda arendajad saavad integratsiooni edasi arendada, kasutades sama dokumenteeritud REST API-t ja API-pääsutõendit. Alustamiseks piisab API-pääsutõendist ning SkyPlanneri meeskond aitab vajaduse korral.
Pärast ühendamist koostab Arcturus ajakava Lemonsofti ajakohaste töönumbrite põhjal ning planeeritud ajad kantakse tööetappidele. SkyPlanneri hind algab 199 € kuus, sisaldab 5 töökeskust ning arveldamine toimub iga kuu. Teie protsessile ja vajadustele vastava integratsiooni hinnapakkumine esitatakse ette koos paketiga, nii et kogukulu on teada enne alustamist.
Lemonsofti enda planeerimisvõimaluste võrdluse leiate lehelt tootmise planeerimine Lemonsoftis, kus käsitletakse masinate ja töötajate tegelikku võimsust arvestava ajakava koostamist. Ülevaate leiate Lemonsofti lehelt ja teised süsteemid ERP-integratsioonide koondlehelt.
Tootmisettevõtete tagasiside SkyPlanneri kohta
Lemonsoftkahesuunaline integratsioon SkyPlanneriga
Kaskea Group
Allhanketootmine: CNC-töötlus, teraskonstruktsioonid ja koostamine
Tootmist planeeritakse SkyPlanneris, mis on Lemonsoftiga kahesuunaliselt integreeritud.
Vähemmaterjalipuudusest tingitud seisakuid
„SkyPlanneri väärtus meie jaoks seisneb selles, et see on igapäevatöös toimiv tööriist, eriti tarnetähtaegade määramisel.”
Tommi Männistö, tootmise planeerimise juht
Eskomatic · Mehaaniline töötlus allhankena
Töökoormuse automaatne planeerimine annab täpsemad tarnetähtajad ning materjalipuudusest tingitud tootmisseisakud on järsult vähenenud.
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahela spetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhususe kasv
„Tootmise tõhusus on kasvanud 90%.”
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise tõhusus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud kolmekuulise plaani koostamiseks kulub alla 30 minuti.
Korduma kippuvad küsimused
Kas Lemonsoftil on tootmisandmete API?
Jah. LemonRest võimaldab ligi pääseda tootmistöödele ja tööetappidele, masinatele, tootestruktuuridele, materjalidele ja vahetustele ning teha valmimiskandeid. Alustapalvelu klientidele on see eelpaigaldatud ning kasutamiseks on vaja API-võtit ja kasutajaõigusi.
Kas Lemonsoft toetab veebihaake?
LemonResti dokumentatsioonis pole veebihaakide lõpp-punkte loetletud. Muudatused loetakse sisse main_ws/changed muudatuste päringu ja kustutamissündmuste abil, mida päritakse iga paari minuti järel. SkyPlanneri enda veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
Kuidas kirjutatakse planeeritud ajad Lemonsofti tagasi?
Päringuga PUT /api/production/workstage, mis uuendab töö ja selle tööetappide algusaja, lõpuaja ning masina. Kuni ajakava haldab SkyPlanner, hoidke Lemonsofti automaatne ajakava koostamine väljalülitatuna või lukustage ajakava iga tagasikirjutatud töönumbri puhul. Nii jäävad SkyPlanneri määratud ajad paika.
Kas operaatorite kinnitusi saab SkyPlannerist Lemonsofti edastada?
Jah. Iga kinnitus edastatakse valmimiskandena, mis sisaldab valmis- ja praakkogust, tunde ning töötajat. Klientide juures kasutatakse seda iga päev.
Kes loob Lemonsofti integratsiooni?
SkyPlanneri meeskond seadistab kasutuselevõtu käigus kahesuunalise integratsiooni vastavalt teie Lemonsofti seadistusele ning pakub tuge ka pärast kasutuselevõttu. Teie Lemonsofti partner või enda arendajad saavad samuti SkyPlanneri dokumenteeritud REST API abil lahendust arendada. Alustamiseks piisab API-pääsutõendist.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevane tasuta prooviperiood võimaldab kasutada kuni 20 töökeskust ja importida Lemonsoftist andmeid Exceli või CSV-failidega. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
