Liidestused / ERP / MRPeasy
MRPeasy liidestamise juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See MRPeasy liidestamise juhend näitab konsultantidele ja IT-meeskondadele, kuidas ühendada MRPeasy SkyPlanner APS-iga. SkyPlanner vahetab MRPeasyga andmeid mõlemas suunas MRPeasy REST API kaudu:
- SkyPlannerisse tuuakse tootmistellimused, tehnoloogilised marsruudid, BOM-id, töökeskuste rühmad, töökeskused, artiklid, laoseis ja ostutellimused.
- Planeeritud kuupäevad ja edenemine kirjutatakse tagasi iga tootmistellimuse (Manufacturing Order) andmetesse.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
SkyPlanner on kliendiprojektides MRPeasyga liidestatud. SkyPlanneri meeskond seadistab juurutamise käigus liidestuse teie MRPeasy seadistusele vastavaks ja pakub tuge ka pärast kasutuselevõttu. See juhend on mõeldud konsultantidele ja arendajatele, kes soovivad selles töös osaleda või ise SkyPlanneri dokumenteeritud REST API põhjal lahendusi arendada (API dokumentatsioon).
MRPeasy REST API: v1 ja v2
MRPeasy on üks pilvetoode, millel pole kohapeal paigaldatavaid versioone. Seetõttu kasutavad kõik kliendid sama API-t. Saadaval on kaks versiooni:
- REST API v1 (OpenAPI 1.0, server
https://api.mrpeasy.com/rest/v1) on tootmiskasutuses olev API. See hõlmab lõpp-punkte/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsning tootmisaruandeid, näiteks/report/production/operations. - REST API v2 (OpenAPI 2.0.0, server
https://api.mrpeasy.com/rest/v2) on varases arendusjärgus. See lisab lõpp-punktid/workstation-groupsväljadegawork_hoursjaholidays,/workstationsväljadegaproductivityjaidle,/inventoryja/stock-movementning PATCH-meetodi. Tootmistellimused jäävad v1 alla.
Pöörake tähelepanu nimetustele. MRPeasy kasutajaliidese Workstation group vastab v1-s ressursile work-center-types (type_id). Workstation vastab ressursile work-centers (center_id). Tehnoloogilise marsruudi operatsioonid viitavad välja type_id kaudu rühmale, mitte masinale.
API kuulub MRPeasy Unlimited paketti ja on saadaval tasulistele kontodele. MRPeasy märgib ka: “Our Support Department cannot help you using the API.” (Meie tugiosakond ei saa teid API kasutamisel aidata.) Seega vajab liidestus vastutajat: SkyPlannerit, teie MRPeasy konsultanti või arendajat. Just selle töö võtab SkyPlanneri meeskond juurutamise käigus enda kanda.
Autentimine ja piirangud
MRPeasy kasutab HTTP Basic autentimist: Authorization: Basic base64(api-key:api-secret). Võti ja saladus luuakse menüüs Settings → Integration → API access. Võtme kustutamine lülitab API välja.
Sünkroonimise kavandamisel tuleb arvestada järgmiste piirangutega:
- Ühe kliendi kohta saab korraga olla töös üks päring: päringuid töödeldakse järjest.
- Kuni 100 päringut 10 sekundi jooksul. Selle piiri ületamisel tagastab API veakoodi 429.
- Loendipäringud tagastavad vaikimisi 100 kirjet ja päisega
Rangekuni 1 000 kirjet. Vastuse päisContent-Rangeannab kirjete koguarvu.
SkyPlanneri poolel kasutab REST API autentimiseks API pääsutõendit (SkyPlanner Settings > API) ning on dokumenteeritud Swagger/OpenAPI abil. Liidestamise õpetus selgitab, kuidas teha esimesed päringud.
Sündmused ja perioodilised päringud
MRPeasy hinnalehel on kirjas “API, webhooks (for paid accounts)” (API ja veebihaagid tasulistele kontodele), kuid v1 ja v2 spetsifikatsioonides pole tootmistellimuste veebihaagisündmusi dokumenteeritud. Seetõttu küsib liidestus MRPeasyst muudatusi perioodiliselt:
- Tootmistellimused filtreeritakse olekute Not scheduled (15), Scheduled (20), In progress (30) ja Paused (35) järgi.
- Ostutellimusi ja laoseisu päritakse kindla graafiku alusel või enne iga ajakava koostamist.
- Põhiandmeid päritakse muudatuste korral või igal ööl.
Järjestikuste filtreeritud päringute sagedus jääb tublisti alla piirangu 100 päringut 10 sekundi jooksul. Vastassuunas edastavad SkyPlanneri enda veebihaagid ajakava muudatused kohe nende tekkimisel, seega on tagasikirjutus sündmuspõhine.
Andmete vastendamine
| MRPeasy objekt (lõpp-punkt) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Tooted ja materjalid | MRPeasy → SkyPlanner | Esmane laadimine, seejärel igal ööl |
BOM koos komponentidega (/boms) | Toote struktuur, alamtooted, materjalid toote kohta | MRPeasy → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Tehnoloogilise marsruudi operatsioonid (/routings): type_id, fixed_time, variable_time, variable_quantity | Tööetapid koos kestuste, seadistusaegade ja partii suurusega | MRPeasy → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Workstation group (/work-center-types; v2 /workstation-groups) | Töökeskuste rühmad, vahetused | MRPeasy → SkyPlanner | Esmane laadimine, seejärel harva |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Töökeskused, efektiivsusnäitajad, puudumised | MRPeasy → SkyPlanner | Esmane laadimine, seisakuajad iga päev |
Manufacturing Order koos operatsioonide ja väljaga due_date (/manufacturing-orders) | Tellimused ja tööd | MRPeasy → SkyPlanner | Päringud iga paari minuti järel |
Inventory, Stock lots (/stock/inventory, /lots) | Laoseisud | MRPeasy → SkyPlanner | Iga tund või iga ajakava koostamise korral |
Purchase Order (/purchase-orders) | Saabuv materjal koos eeldatava tarnekuupäevaga | MRPeasy → SkyPlanner | Iga tund või iga ajakava koostamise korral |
Objekti Manufacturing Order väljad due_date ja custom_<id> (PUT /manufacturing-orders/{id}) | Planeeritud algus, planeeritud lõpp, edenemine | SkyPlanner → MRPeasy | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
| MRPeasys puudub | Seadistusaegade maatriks, piiratud saadavusega tööriistad, operaatorite arv, alternatiivsed töökeskused | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Liidestuse töövood
1. Põhiandmete esmane laadimine. Tooge artiklid, mõõtühikud, BOM-id ja tehnoloogilised marsruudid v1 kaudu ning töökeskuste rühmad ja töökeskused v1 või v2 kaudu. Võtke kalendrid v2 lõpp-punktist /workstation-groups (work_hours, holidays) või määrake vahetused otse SkyPlanneris. Vastendage iga Active processing rühm SkyPlanneri töökeskuste rühmaga ning lisage selle töökeskused rühma liikmeteks.
2. Tellimuste sünkroonimine. Lugege sisse avatud tootmistellimused koos operatsioonidega, avatud ostutellimused ja laoseis. SkyPlanner loeb tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ning uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered. Igal ajakava ümberkoostamisel kontrollitakse nii laoseisu kui ka saabuvaid oste.
3. Ajakava tagasikirjutus. PUT /manufacturing-orders/{id} toetab välju code, quantity, due_date ja assigned_id ning kohandatud välju kujul custom_<id>. Kui nii on kokku lepitud, kirjutab SkyPlanner planeeritud lõpu väljale due_date; planeeritud alguse, planeeritud lõpu ja edenemise kirjutab see MRPeasy kohandatud väljadele. Nii näevad MRPeasyt kasutavad müügi- ja ostutöötajad tegelikku ajakava. Operatsioonide üksikasjalikku järjestust ja igale operatsioonile määratud töökeskust hallatakse SkyPlanneris. Selle vaate järgi suunatakse tootmises töid.
4. Väljaspool MRPeasyt loodud tellimused. Kui tellimusi luuakse API kaudu, saab POST /manufacturing-orders päringus kasutada parameetreid no_scheduling ja no_bookings. Kasutage neid, et MRPeasy ei broneeriks töökeskusi, mille ajakava koostab juba SkyPlanner.
5. Tööde kinnitamine tootmises. Operaatorid registreerivad tööd funktsioonidega SkyPlanner Mobile Confirmations, Production Timer või Quick Log Mode ning ajakirjed hoiavad ajakava ajakohasena. Valige üks aruandluskanal. MRPeasy Internet-kiosk ja SkyPlanner annavad samade operatsioonide paralleelsel registreerimisel tegelikkusest kaks eri pilti.
6. Vastutuse ja vastuolude lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Artiklid, BOM-id, tehnoloogilised marsruudid, kogused, laoseis, hanked | MRPeasy |
| Operatsioonide järjestus, algus- ja lõpuajad, töökeskuste määramine | SkyPlanner |
| Seadistusaegade maatriks, tööriistad, operaatorite arv, alternatiivsed ressursid | SkyPlanner |
| Vahetused ja puudumised | Üks süsteem, mis valitakse ulatuse määramisel |
| Tellimuse edenemine ja registreeritud tööd | SkyPlanner, kokkuvõte objekti Manufacturing Order kirjel |
Klienditellimuse järgi projekteerimise töövoog. Ühes ellu viidud MRPeasy projektis luuakse iga kliendiprojekti jaoks põhitoode ning üks kuni kolm pooltoodet. Igaühel neist on MRPeasys oma BOM ja tehnoloogiline marsruut ning tootmistellimus on olemas mõlemas süsteemis. Kasutage igal tellimusel püsivat ühist tunnust, et uuendamisel ei tekiks kunagi duplikaate.
Projekti tavapärased etapid
Liidestus valmib tavaliselt nädalate jooksul pärast juurutamise algust. Enne seda saate 30-päevase tasuta prooviperioodi jooksul kasutada oma andmeid, olenemata MRPeasy paketist. Eksportige MRPeasy loendivaadetest artiklid, BOMid, tehnoloogilised marsruudid, töökeskused ja avatud tootmistellimused CSV-failidesse, importige need ning kontrollige ajakava.
Projekt hõlmab järgmisi etappe:
- Paketi kontroll. Veenduge, et MRPeasy pakett sisaldab API kasutusõigust, ning looge API võti ja saladus.
- Andmete vastendamine. Leppige kokku vastendustabel, andmete haldamise reeglid, tagasikirjutuse kohandatud väljad ja aruandluskanal.
- Esmane andmelaadimine. Artiklid, ühikud, BOMid, tehnoloogilised marsruudid, töökeskuste rühmad, töökeskused ja kalendrid.
- Tellimuste ja ostutellimuste sünkroonimine. Muudatuste perioodiline pärimine oleku järgi koos vastusekoodi 429 käsitlemisega.
- Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed töökeskused.
- Tagasikirjutus. Iga Manufacturing Order objekti tähtajad ja kohandatud väljad.
- Paralleelne testimine. Kasutage SkyPlannerit senise tootmisajakava kõrval, võrrelge kuupäevi ja parandage põhiandmed.
- Tööle rakendamine. Kui andmed klapivad, lülitage tagasikirjutus sisse.
Millega MRPeasy integreerimisel arvestada
- Ajaväljad erinevad liideseti. Kasutajaliidese väljadele Setup time, Cycle time ja Capacity vastavad APIs
fixed_time,variable_timejavariable_quantity. Kui Capacity väärtus on üle 1, tähendab see partiitöötlust, näiteks ahjus. Vastendage see partiitööna, mitte pikema tsüklina. - Passive processing rühmad. Kuivatamise ja jahutamise rühmad töötavad 24/7 ilma võimsuspiiranguteta. Vastendage need ooteaegadena, mitte piiratud võimsusega töökeskustena.
- Versioonis v1 kalendreid pole.
work-centerstagastab ainult väljadcenter_id,type_id,codejatitle. Kasutage versiooni v2 või hallake vahetusi SkyPlanneris. - Seisakuaeg. Töökeskuse seisakuaja andmed hõlmavad hooldusi ja seisakuid. Sünkroonige need, muidu planeerib SkyPlanner tööd masinale, mis ei tööta.
- Tehnoloogilised marsruudid viitavad rühmadele. MRPeasy valib kõige paremini saadaval oleva masina. SkyPlanneris on rühma töökeskused tegelikud alternatiivid, mille vahel planeerimismootor valib.
MRPeasy integratsioon: kes selle seadistab ja tuge pakub
Töö hõlmab teie tehnoloogiliste marsruutide, töökeskuste rühmade ja tellimuste liikumise vastendamist. Lisaks seadistatakse piirangud, mida MRPeasy ei talleta: seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed ressursid.
- SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu käigus ja pakub tuge ka pärast tööle rakendamist. Iga tehas kasutab MRPeasyt erinevalt ning seadistamisel rakendatakse just neid teadmisi. Kuna MRPeasy tugi ei hõlma APIga seotud töid, on oluline, et integratsiooni eest vastutaks üks meeskond.
- Integratsiooni saab luua teie MRPeasy konsultant või integratsioonipartner. Ühes ellu viidud MRPeasy projektis ühendas integratsioonipartner kaks süsteemi mõlema REST API kaudu. SkyPlanner pakub REST API liidest, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Ka teie enda arendajad saavad integratsiooni luua, kasutades API pääsutõendit. Alustamiseks piisab API pääsutõendist ning SkyPlanneri meeskond aitab vajaduse korral. Toote dokumentatsiooni, sealhulgas ostutellimuste ning toodete ja materjalide API kohta, leiate SkyPlanneri dokumentatsioonist.
SkyPlanneri hind algab 199 € kuus, sisaldab 5 töökeskust ja arveldamine toimub iga kuu. Integratsioonile tehakse teie protsessi ja vajaduste põhjal hinnapakkumine koos paketiga, nii et kogukulu on teada enne alustamist. Vaadake hindu ja funktsioone ning võrdlust MRPeasy enda ajakavatööriistaga lehel MRPeasy tootmise planeerimine masinate ja töötajate tegelikku võimekust arvestades. Ülevaate leiate MRPeasy lehelt ning teised ERP-süsteemid on koondatud ERP-integratsioonide lehele.
Tootjate kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.”
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimine säästab igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise tõhusust
„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õlmiva optimeeritud plaani koostamiseks kolmeks kuuks kulub alla 30 minuti.
6 kuudette näeb müük vaba tootmisvõimsust
„SkyPlanner loob kogu tootmise planeerimisele usaldusväärse aluse.”
Anu Järvinen, tootmisjuht
Fredman Operations · Toiduohutu pakkepaber
Müügimeeskond näeb vaba tootmisvõimsust kuus kuud ette ning ajakava muutmise päringutele, millele vastamine võttis varem tunni või rohkem, saab nüüd vastuse sekunditega.
Korduma kippuvad küsimused
Kas MRPeasyl on API ja millist paketti ma vajan?
Jah. MRPeasy pakub maksvatele Unlimited-paketi kasutajatele REST API liidest: v1 on kasutusel ja v2 arendamisel. Autentimine toimub HTTP Basic meetodil, kasutades API võtit ja saladust, mille leiate menüüst Settings → Integration → API access.
Kas SkyPlanner saab ajakava MRPeasysse tagasi kirjutada?
Jah. SkyPlanner uuendab iga Manufacturing Order objekti päringuga PUT /manufacturing-orders/{id}, salvestades tähtaja ning kavandatud alguse, kavandatud lõpu ja edenemise andmed vastavatele kohandatud väljadele. Operatsioonide üksikasjalikku järjestust hallatakse SkyPlanneris, kus operaatorid töötavad oma tööjärjekorra alusel.
Kas MRPeasy saadab muudatused välja reaalajas?
API spetsifikatsioonis ei ole tootmistellimuste jaoks dokumenteeritud veebihaagi sündmusi, seega pärib SkyPlanner avatud tellimusi oleku järgi iga paari minuti järel. SkyPlanneri enda veebihaagid edastavad ajakava muudatused kohe nende tekkimisel.
Kes loob MRPeasy integratsiooni?
SkyPlanneri meeskond seadistab kahesuunalise integratsiooni kasutuselevõtu käigus ja pakub tuge ka pärast tööle rakendamist. Integratsiooni saab SkyPlanneri dokumenteeritud REST API liidese abil luua ka teie MRPeasy konsultant, integratsioonipartner või teie enda arendajad.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saate kasutada kuni 20 töökeskust ja importida MRPeasyst andmeid CSV-failidega, olenemata MRPeasy paketist. Krediitkaarti pole vaja. Alustage prooviperioodi või võtke ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
