Integracijos / ERP / MRPeasy
MRPeasy integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame MRPeasy integravimo vadove konsultantams ir IT komandoms paaiškinama, kaip sujungti MRPeasy su SkyPlanner APS. SkyPlanner keičiasi duomenimis su MRPeasy abiem kryptimis per MRPeasy REST API:
- Į SkyPlanner perduodami gamybos užsakymai, technologiniai maršrutai, BOM, darbo centrų grupės, darbo centrai, prekės, atsargos ir pirkimo užsakymai.
- Suplanuotos datos ir vykdymo eiga įrašomos atgal į kiekvieną Manufacturing Order.
- SkyPlanner žiniatinklio pranešimai (webhooks) perduoda tvarkaraščio pakeitimus vos jiems įvykus.
SkyPlanner jau buvo integruota su MRPeasy klientų projektuose. Diegimo metu SkyPlanner komanda pritaiko integraciją prie jūsų MRPeasy konfigūracijos ir prižiūri ją pradėjus naudoti. Šis vadovas skirtas konsultantams ir programuotojams, norintiems prisidėti prie integravimo arba patiems kurti sprendimus naudojantis dokumentuota SkyPlanner REST API (API žinynas).
MRPeasy REST API: v1 ir v2
MRPeasy yra vienas debesijos produktas, neturintis vietoje diegiamų versijų, todėl visi klientai naudoja tą pačią API. Yra dvi versijos:
- REST API v1 (OpenAPI 1.0, serveris
https://api.mrpeasy.com/rest/v1) yra darbinėje aplinkoje naudojama API. Ji apima/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsir gamybos ataskaitas, pavyzdžiui,/report/production/operations. - REST API v2 (OpenAPI 2.0.0, serveris
https://api.mrpeasy.com/rest/v2) dar tik pradedama kurti. Joje papildomai yra/workstation-groupssuwork_hoursirholidays,/workstationssuproductivityiridle,/inventory,/stock-movementir PATCH. Gamybos užsakymai lieka v1.
Atkreipkite dėmesį į pavadinimus. MRPeasy sąsajos Workstation group v1 API atitinka work-center-types (type_id). Workstation atitinka work-centers (center_id). Technologinio maršruto operacijos per type_id susiejamos su grupe, o ne su konkrečiomis staklėmis.
API suteikiama mokamoms MRPeasy paskyroms su Unlimited planu. MRPeasy taip pat nurodo: „Our Support Department cannot help you using the API.” (Mūsų pagalbos skyrius negali padėti naudotis API.) Todėl už integraciją turi būti atsakinga SkyPlanner, jūsų MRPeasy konsultantas arba programuotojas. Būtent šį darbą diegimo metu ir atlieka SkyPlanner komanda.
Autentifikavimas ir apribojimai
MRPeasy naudoja HTTP Basic autentifikavimą: Authorization: Basic base64(api-key:api-secret). Raktas ir slaptasis raktas sukuriami skiltyje Settings → Integration → API access. Pašalinus raktą, API išjungiama.
Projektuojant sinchronizavimą reikia atsižvelgti į šiuos apribojimus:
- Vienu metu vienam klientui leidžiama tik viena užklausa: užklausos apdorojamos paeiliui.
- Ne daugiau kaip 100 užklausų per 10 sekundžių. Viršijus šią ribą, API grąžina 429.
- Pagal numatytąsias nuostatas sąrašai grąžina 100 įrašų, o su
Rangeantrašte – iki 1 000. Atsakymo antraštėjeContent-Rangenurodomas bendras įrašų skaičius.
SkyPlanner REST API autentifikavimui naudojamas API prieigos raktas (SkyPlanner Settings > API), o jos dokumentacija pateikta Swagger/OpenAPI formatu. Integravimo pamokoje nuosekliai paaiškinamos pirmosios užklausos.
Įvykiai ir periodinės užklausos
MRPeasy kainodaros puslapyje nurodyta „API, webhooks (for paid accounts)” (API ir žiniatinklio pranešimai mokamoms paskyroms), tačiau v1 ir v2 specifikacijose neaprašyti jokie su gamybos užsakymais susiję įvykiai, apie kuriuos būtų siunčiami tokie pranešimai. Todėl integracija periodinėmis užklausomis gauna tik nuo ankstesnės užklausos pasikeitusius MRPeasy duomenis:
- Gamybos užsakymai atrenkami pagal būsenas: Not scheduled (15), Scheduled (20), In progress (30) ir Paused (35).
- Pirkimo užsakymų ir atsargų duomenys gaunami nustatytu periodiškumu arba prieš kiekvieną tvarkaraščio sudarymą.
- Pagrindiniai duomenys gaunami jiems pasikeitus arba kasnakt.
Nuosekliai siunčiant užklausas su filtrais, iki 100 užklausų per 10 sekundžių ribos lieka didelė atsarga. Priešinga kryptimi pačios SkyPlanner žiniatinklio pranešimai perduoda tvarkaraščio pakeitimus vos jiems įvykus, todėl įrašymą atgal inicijuoja įvykiai.
Duomenų susiejimas
| MRPeasy objektas (galinis taškas) | SkyPlanner objektas | Kryptis | Dažnumas |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Gaminiai ir medžiagos | MRPeasy → SkyPlanner | Pradinis įkėlimas, vėliau kasnakt |
BOM su komponentais (/boms) | Gaminio struktūra, tarpiniai gaminiai, kiekvienam gaminiui reikalingos medžiagos | MRPeasy → SkyPlanner | Pradinis įkėlimas, vėliau pasikeitus duomenims |
Technologinio maršruto operacijos (/routings): type_id, fixed_time, variable_time, variable_quantity | Proceso etapai su trukme, paruošimo laiku ir partijos dydžiu | MRPeasy → SkyPlanner | Pradinis įkėlimas, vėliau pasikeitus duomenims |
Workstation group (/work-center-types; v2 /workstation-groups) | Darbo centrų grupės, pamainos | MRPeasy → SkyPlanner | Pradinis įkėlimas, vėliau retai |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Darbo centrai, efektyvumas, nepasiekiamumo laikotarpiai | MRPeasy → SkyPlanner | Pradinis įkėlimas, prastovų duomenys – kasdien |
Manufacturing Order su operacijomis, due_date (/manufacturing-orders) | Užsakymai ir užduotys | MRPeasy → SkyPlanner | Užklausos kas kelias minutes |
Inventory, Stock lots (/stock/inventory, /lots) | Atsargų likučiai | MRPeasy → SkyPlanner | Kas valandą arba kaskart sudarant tvarkaraštį |
Purchase Order (/purchase-orders) | Laukiamos medžiagos su numatoma pristatymo data | MRPeasy → SkyPlanner | Kas valandą arba kaskart sudarant tvarkaraštį |
Manufacturing Order laukai due_date ir custom_<id> (PUT /manufacturing-orders/{id}) | Suplanuota pradžia, suplanuota pabaiga, vykdymo eiga | SkyPlanner → MRPeasy | Pasikeitus tvarkaraščiui, per SkyPlanner žiniatinklio pranešimą |
| MRPeasy nėra | Perderinimo laikų matrica, riboto prieinamumo įrankiai, operatorių skaičius, alternatyvūs darbo centrai | Tvarkoma SkyPlanner sistemoje | Nustatoma diegimo metu |
Integravimo scenarijai
1. Pradinis pagrindinių duomenų įkėlimas. Gaukite prekes, matavimo vienetus, BOM ir technologinius maršrutus iš v1, o darbo centrų grupes ir darbo centrus – iš v1 arba v2. Kalendorius gaukite iš v2 /workstation-groups (work_hours, holidays) arba nustatykite pamainas tiesiogiai SkyPlanner sistemoje. Kiekvieną Active processing grupę susiekite su SkyPlanner darbo centrų grupe, įtraukdami į ją tos grupės darbo centrus.
2. Užsakymų sinchronizavimas. Nuskaitykite neužbaigtus gamybos užsakymus su jų operacijomis, taip pat neužbaigtus pirkimo užsakymus ir atsargas. SkyPlanner laiko, kad užsakytos medžiagos bus prieinamos pirkimo užsakymo pristatymo dieną, ir atnaujina atsargas, kai pirkimo užsakymui nustatoma būsena Delivered. Kiekvieną kartą perskaičiuojant tvarkaraštį tikrinamos tiek esamos atsargos, tiek laukiami pirkimai.
3. Tvarkaraščio įrašymas atgal. PUT /manufacturing-orders/{id} palaiko code, quantity, due_date ir assigned_id, taip pat pasirinktinius laukus custom_<id>. Jei taip sutarta, SkyPlanner įrašo suplanuotą pabaigą į due_date, o suplanuotą pradžią, suplanuotą pabaigą ir vykdymo eigą – į pasirinktinius MRPeasy laukus. Tuomet pardavimo ir pirkimo darbuotojai MRPeasy sistemoje mato tikrąjį tvarkaraštį. Išsami operacijų seka ir kiekvienai operacijai priskirtas darbo centras saugomi SkyPlanner sistemoje, kurioje cecho darbuotojams pateikiamas vykdytinų darbų vaizdas.
4. Užsakymai, sukurti ne MRPeasy sistemoje. Jei užsakymai kuriami per API, POST /manufacturing-orders priima no_scheduling ir no_bookings. Naudokite juos, kad MRPeasy nerezervuotų darbo centrų, kuriems tvarkaraštį jau sudaro SkyPlanner.
5. Darbų patvirtinimas ceche. Operatoriai registruoja darbą naudodamiesi SkyPlanner Mobile Confirmations, Production Timer arba Quick Log Mode, o darbo laiko įrašai padeda nuolat atnaujinti tvarkaraštį. Pasirinkite vieną darbų registravimo kanalą. Tų pačių operacijų registravimas ir per MRPeasy Internet-kiosk, ir per SkyPlanner sukuria dvi skirtingas duomenų versijas.
6. Atsakomybė už duomenis ir konfliktų sprendimo taisyklės. Užfiksuokite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Prekės, BOM, technologiniai maršrutai, kiekiai, atsargos, aprūpinimas | MRPeasy |
| Operacijų seka, pradžios ir pabaigos laikai, darbo centrų priskyrimas | SkyPlanner |
| Perderinimo laikų matrica, įrankiai, operatorių skaičius, alternatyvūs ištekliai | SkyPlanner |
| Pamainos ir neatvykimai | Viena sistema, pasirinkta apimties apibrėžimo metu |
| Užsakymo vykdymo eiga ir užregistruotas darbas | SkyPlanner; suvestinė pateikiama Manufacturing Order įraše |
Projektinės gamybos pagal užsakymą eiga. Viename įgyvendintame MRPeasy projekte kiekvienam kliento projektui sukuriamas pagrindinis gaminys ir nuo vieno iki trijų pusgaminių. Kiekvienas jų MRPeasy sistemoje turi savo BOM ir technologinį maršrutą, o gamybos užsakymas yra abiejose sistemose. Kiekvienam užsakymui priskirkite nekintantį bendrą identifikatorių, kad atnaujinant niekada nebūtų kuriami dublikatai.
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo įvadinių darbų pradžios. Prieš tai galite 30 dienų nemokamai išbandyti sistemą su savo duomenimis, nesvarbu, kurį MRPeasy planą naudojate. Iš MRPeasy sąrašų eksportuokite prekes, BOM, technologinius maršrutus, darbo centrus ir neužbaigtus gamybos užsakymus CSV formatu, importuokite juos ir patikrinkite tvarkaraštį.
Projektą sudaro šie etapai:
- Plano patikra. Įsitikinkite, kad MRPeasy planas apima API prieigą, ir sukurkite API raktą bei slaptąjį raktą.
- Duomenų susiejimas. Patvirtinkite atitikmenų lentelę, duomenų valdymo taisykles, pasirinktinius laukus duomenims įrašyti atgal ir ataskaitų teikimo kanalą.
- Pradinis duomenų įkėlimas. Prekės, matavimo vienetai, BOM, technologiniai maršrutai, darbo centrų grupės, darbo centrai, kalendoriai.
- Užsakymų ir pirkimo užsakymų sinchronizavimas. Periodiškai užklausomis gaunami pakeitimai pagal būseną ir apdorojami 429 atsakymai.
- Apribojimų nustatymas SkyPlanner sistemoje. Perderinimo laikų matrica, įrankiai, operatorių skaičius ir alternatyvūs darbo centrai.
- Duomenų įrašymas atgal. Kiekvieno Manufacturing Order termino ir pasirinktinių laukų atnaujinimas.
- Lygiagretus testavimas. Naudokite SkyPlanner lygiagrečiai su dabartiniu Production schedule, palyginkite datas ir pataisykite pagrindinius duomenis.
- Paleidimas. Kai duomenys sutaps, įjunkite jų įrašymą atgal.
Į ką atsižvelgti planuojant MRPeasy integraciją
- Laiko laukai skirtingose sąsajose skiriasi. Naudotojo sąsajos laukus Setup time, Cycle time ir Capacity API sąsajoje atitinka
fixed_time,variable_timeirvariable_quantity. Didesnė nei 1 Capacity reikšmė reiškia apdorojimą partijomis, pavyzdžiui, krosnyje. Susiekite tai su partijos užduotimi, o ne ilgesniu ciklu. - Passive processing grupės. Džiovinimo ir aušinimo grupės veikia 24/7 be pajėgumų apribojimų. Susiekite jas su laukimo laikais, o ne riboto pajėgumo darbo centrais.
- v1 neteikia kalendorių.
work-centersgrąžina tikcenter_id,type_id,codeirtitle. Naudokite v2 arba tvarkykite pamainas SkyPlanner sistemoje. - Neveikos laikas. Darbo centro neveikos laikas apima techninę priežiūrą ir prastovas. Sinchronizuokite jį, antraip SkyPlanner planuos darbus neveikiančioms staklėms.
- Technologiniuose maršrutuose nurodomos grupės. MRPeasy pasirenka stakles, kurių laisvas laikas tinkamiausias darbui atlikti. SkyPlanner sistemoje grupės darbo centrai tampa realiomis alternatyvomis, iš kurių renkasi planavimo variklis.
MRPeasy integracija: kas ją konfigūruoja ir prižiūri
Darbai apima jūsų technologinių maršrutų, darbo centrų grupių ir užsakymų srauto susiejimą, taip pat apribojimų, kurių MRPeasy nesaugo, nustatymą: paruošimo laikų matricą, įrankius, operatorių skaičių ir alternatyvius išteklius.
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją po paleidimo. Kiekviena gamykla MRPeasy naudoja skirtingai, todėl šiame etape pritaikomos žinios apie jos darbo specifiką. MRPeasy techninė pagalba neapima darbų su API, todėl svarbu, kad už integraciją būtų atsakinga viena komanda.
- Integraciją gali sukurti jūsų MRPeasy konsultantas arba integravimo partneris. Viename įgyvendintame MRPeasy projekte integravimo partneris sujungė abi sistemas naudodamas abiejų REST API. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir webhooks.
- Jūsų programuotojai gali kurti integraciją naudodami API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Produkto dokumentaciją, įskaitant pirkimo užsakymus bei gaminių ir medžiagų API, rasite SkyPlanner dokumentacijoje.
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. Peržiūrėkite kainodarą, funkcijas ir palyginimą su pačios MRPeasy planavimo priemone puslapyje MRPeasy gamybos planavimas pagal realius įrenginių ir darbuotojų pajėgumus. Apžvalgą rasite MRPeasy puslapyje, o kitas ERP sistemas – ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
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 skirstymo į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 padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
6 mėnesiamsį priekį pardavimų komanda mato laisvus pajėgumus
„SkyPlanner suteikia patikimą pagrindą visam gamybos planavimui.“
Anu Järvinen, gamybos vadovė
Fredman Operations · Maistui pakuoti tinkamas popierius
Pardavimų komanda mato laisvus pajėgumus šešiems mėnesiams į priekį, o į prašymus pakeisti tvarkaraštį, kuriems anksčiau reikėdavo valandos ar daugiau, dabar atsakoma per kelias sekundes.
Dažniausiai užduodami klausimai
Ar MRPeasy turi API ir kokio plano reikia?
Taip. Mokamų paskyrų naudotojams su Unlimited planu MRPeasy suteikia REST API: v1 jau naudojama, o v2 dar kuriama. Autentifikavimui naudojamas HTTP Basic su API raktu ir slaptuoju raktu, gaunamais per Settings → Integration → API access.
Ar SkyPlanner gali įrašyti tvarkaraštį atgal į MRPeasy?
Taip. SkyPlanner atnaujina kiekvieną Manufacturing Order per PUT /manufacturing-orders/{id}: įrašo terminą, o į pasirinktinius laukus – planuojamą pradžią, planuojamą pabaigą ir eigą. Išsami operacijų seka lieka SkyPlanner sistemoje, kur operatoriai dirba pagal savo užduočių eilę.
Ar MRPeasy siunčia pakeitimus realiuoju laiku?
API specifikacijose nenurodyta jokių gamybos užsakymų webhook įvykių, todėl SkyPlanner kas kelias minutes užklausomis tikrina atvirus užsakymus pagal būseną. Pati SkyPlanner per webhooks siunčia tvarkaraščio pakeitimus iškart, kai jie įvyksta.
Kas kuria MRPeasy integraciją?
SkyPlanner komanda sukonfigūruoja abipusę integraciją diegimo metu ir prižiūri ją po paleidimo. Jūsų MRPeasy konsultantas, integravimo partneris ar programuotojai taip pat gali kurti integraciją naudodamiesi dokumentuota SkyPlanner REST API.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti CSV duomenis iš MRPeasy, nesvarbu, kurį MRPeasy planą turite. Kredito kortelės nereikia. Išbandykite nemokamai arba susisiekite su pardavimų komanda, kad apibrėžtumėte integracijos apimtį.
