Integracije / ERP / MRPeasy
Vodnik za integracijo MRPeasy s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik svetovalcem in ekipam IT pojasnjuje, kako povezati MRPeasy s SkyPlanner APS. SkyPlanner se z MRPeasy povezuje dvosmerno prek MRPeasy REST API:
- V SkyPlanner se prenašajo proizvodni nalogi, tehnološki postopki, kosovnice (BOM), skupine delovnih centrov, delovni centri, artikli, zaloge in nabavna naročila.
- Načrtovani datumi in napredek se zapisujejo nazaj v vsak Manufacturing Order.
- SkyPlanner prek webhookov sproti pošilja spremembe terminskega plana.
SkyPlanner je bil v projektih za stranke že povezan z MRPeasy. Ekipa SkyPlanner med uvajanjem prilagodi integracijo vašim nastavitvam MRPeasy in zanjo zagotavlja podporo tudi po prehodu v redno uporabo. Ta vodnik je namenjen svetovalcem in razvijalcem, ki želijo sodelovati pri integraciji ali jo sami razvijati na podlagi dokumentiranega vmesnika SkyPlanner REST API (referenčna dokumentacija API).
MRPeasy REST API: v1 in v2
MRPeasy je enoten izdelek v oblaku brez različic za lokalno namestitev, zato vse stranke uporabljajo isti API. Na voljo sta dve različici:
- REST API v1 (OpenAPI 1.0, strežnik
https://api.mrpeasy.com/rest/v1) je API za produkcijsko uporabo. Vključuje/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsin proizvodna poročila, kot je/report/production/operations. - REST API v2 (OpenAPI 2.0.0, strežnik
https://api.mrpeasy.com/rest/v2) je v zgodnji fazi razvoja. Dodaja/workstation-groupss poljemawork_hoursinholidays,/workstationss poljemaproductivityinidle,/inventory,/stock-movementter PATCH. Proizvodni nalogi ostajajo na v1.
Bodite pozorni na poimenovanja. Workstation group v uporabniškem vmesniku MRPeasy ustreza work-center-types v v1 (type_id). Workstation ustreza work-centers (center_id). Operacije tehnološkega postopka se prek type_id sklicujejo na skupino, ne na stroj.
API je za plačljive račune vključen v paket MRPeasy Unlimited. MRPeasy navaja tudi: “Our Support Department cannot help you using the API.” (Naš oddelek za podporo vam pri uporabi API ne more pomagati.) Zato mora nekdo prevzeti odgovornost za integracijo: SkyPlanner, vaš svetovalec za MRPeasy ali vaš razvijalec. Ekipa SkyPlanner med uvajanjem prevzame prav to delo.
Avtentikacija in omejitve
MRPeasy uporablja avtentikacijo HTTP Basic: Authorization: Basic base64(api-key:api-secret). Ključ API in skrivni ključ ustvarite v Settings → Integration → API access. Če ključ API izbrišete, onemogočite API.
Pri zasnovi sinhronizacije je treba upoštevati naslednje omejitve:
- Posamezen odjemalec ima lahko hkrati v obdelavi le eno zahtevo: zahteve se obdelujejo zaporedno.
- Največ 100 zahtev v 10 sekundah. Če to omejitev presežete, API vrne kodo 429.
- Seznami privzeto vrnejo 100 zapisov, z glavo
Rangepa do 1.000. GlavaContent-Rangev odgovoru poda skupno število.
Na strani SkyPlanner REST API za avtentikacijo uporablja žeton API (SkyPlanner Settings > API), dokumentiran pa je v Swagger/OpenAPI. Vodič za integracijo vas popelje skozi prve klice.
Dogodki in periodično poizvedovanje
Na strani s cenami MRPeasy je navedeno “API, webhooks (for paid accounts)” (API in spletni kavlji za plačljive račune), vendar specifikaciji v1 in v2 ne dokumentirata dogodkov spletnih kavljev za proizvodne naloge. Integracija zato s periodičnim poizvedovanjem iz MRPeasy pridobiva prirastne podatke:
- Proizvodne naloge, filtrirane po stanjih Not scheduled (15), Scheduled (20), In progress (30) in Paused (35).
- Nabavna naročila in zaloge v določenih intervalih ali pred vsakim zagonom terminiranja.
- Matične podatke ob spremembah ali vsako noč.
Zaporedno poizvedovanje s filtri ostaja precej pod omejitvijo 100 zahtev v 10 sekundah. V nasprotni smeri SkyPlanner prek lastnih spletnih kavljev sproti pošilja spremembe terminskega plana, zato povratni zapis temelji na dogodkih.
Preslikava podatkov
| Objekt MRPeasy (končna točka) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Izdelki in materiali | MRPeasy → SkyPlanner | Začetni prenos, nato vsako noč |
BOM s komponentami (/boms) | Struktura izdelka, podizdelki, materiali za posamezen izdelek | MRPeasy → SkyPlanner | Začetni prenos, nato ob spremembah |
Operacije tehnološkega postopka (/routings): type_id, fixed_time, variable_time, variable_quantity | Koraki postopka s trajanjem, pripravljalnimi časi in velikostjo serije | MRPeasy → SkyPlanner | Začetni prenos, nato ob spremembah |
Workstation group (/work-center-types; v2 /workstation-groups) | Skupine delovnih centrov, izmene | MRPeasy → SkyPlanner | Začetni prenos, pozneje redko |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Delovni centri, učinkovitost, odsotnosti | MRPeasy → SkyPlanner | Začetni prenos, za čas nedelovanja dnevno |
Manufacturing Order z operacijami, due_date (/manufacturing-orders) | Nalogi in operacije | MRPeasy → SkyPlanner | Poizvedovanje vsakih nekaj minut |
Inventory, Stock lots (/stock/inventory, /lots) | Stanje zalog | MRPeasy → SkyPlanner | Vsako uro ali ob vsakem zagonu terminiranja |
Purchase Order (/purchase-orders) | Pričakovani material s predvidenim datumom dobave | MRPeasy → SkyPlanner | Vsako uro ali ob vsakem zagonu terminiranja |
Polja due_date in custom_<id> objekta Manufacturing Order (PUT /manufacturing-orders/{id}) | Načrtovani začetek, načrtovani zaključek, napredek | SkyPlanner → MRPeasy | Ob spremembi terminskega plana prek spletnega kavlja SkyPlanner |
| Ni v MRPeasy | Matrika časov menjav, orodja kot omejeni viri, število operaterjev, alternativni delovni centri | Vzdrževanje v SkyPlanner | Nastavitev med uvajanjem |
Načini integracije
1. Začetni prenos matičnih podatkov. Iz v1 pridobite artikle, merske enote, kosovnice in tehnološke postopke, iz v1 ali v2 pa skupine delovnih centrov in delovne centre. Koledarje pridobite iz v2 /workstation-groups (work_hours, holidays) ali izmene nastavite neposredno v SkyPlanner. Vsako skupino Active processing preslikajte v skupino delovnih centrov SkyPlanner, v katero vključite njene delovne centre.
2. Sinhronizacija nalogov. Preberite odprte proizvodne naloge z njihovimi operacijami ter odprta nabavna naročila in zaloge. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko je naročilo označeno kot Delivered. Pri vsakem ponovnem terminiranju preveri tako zaloge kot pričakovane dobave.
3. Povratni zapis terminskega plana. PUT /manufacturing-orders/{id} podpira code, quantity, due_date in assigned_id ter polja po meri v obliki custom_<id>. Če je tako dogovorjeno, SkyPlanner zapiše načrtovani zaključek v due_date, načrtovani začetek, načrtovani zaključek in napredek pa v polja po meri v MRPeasy. Prodaja in nabava tako v MRPeasy vidita dejanski terminski plan. Podrobno zaporedje operacij in dodelitev delovnega centra za vsako operacijo ostajata v SkyPlanner, ki proizvodnji služi kot pregled za razporejanje dela.
4. Nalogi, ustvarjeni zunaj MRPeasy. Če naloge kdaj ustvarjate prek API, POST /manufacturing-orders sprejema no_scheduling in no_bookings. Uporabite ju, da MRPeasy ne rezervira delovnih centrov, ki jih že terminira SkyPlanner.
5. Potrjevanje dela v proizvodnji. Operaterji beležijo delo s SkyPlanner Mobile Confirmations, Production Timer ali Quick Log Mode, časovni zapisi pa skrbijo za ažurnost terminskega plana. Izberite en kanal poročanja. Če za iste operacije vzporedno uporabljate MRPeasy Internet-kiosk in SkyPlanner, nastaneta dve različici dejanskega stanja.
6. Odgovornost za podatke in pravila reševanja neskladij. Zapišite jih pred prehodom v redno uporabo:
| Podatki | Lastnik |
|---|---|
| Artikli, kosovnice, tehnološki postopki, količine, zaloge, nabava | MRPeasy |
| Zaporedje operacij, časi začetka in konca, dodelitev delovnih centrov | SkyPlanner |
| Matrika časov menjav, orodja, število operaterjev, alternativni viri | SkyPlanner |
| Izmene in odsotnosti | En sistem, izbran pri opredelitvi obsega |
| Napredek nalogov in zabeleženo delo | SkyPlanner, s povzetkom na Manufacturing Order |
Razvoj in izdelava po naročilu. V enem od izvedenih projektov z MRPeasy se vsak projekt za kupca pretvori v glavni izdelek in enega do tri polizdelke. Vsak ima v MRPeasy svojo kosovnico in tehnološki postopek, proizvodni nalog pa obstaja v obeh sistemih. Vsakemu nalogu dodelite trajen skupni identifikator, da pri posodobitvah nikoli ne nastanejo podvojeni zapisi.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko opravite 30-dnevni brezplačni preizkus z lastnimi podatki, ne glede na paket MRPeasy. Iz seznamov v MRPeasy izvozite artikle, kosovnice, tehnološke postopke, delovne centre in odprte proizvodne naloge v CSV, jih uvozite in preverite terminski plan.
Sam projekt vključuje naslednje korake:
- Preverjanje paketa. Preverite, ali paket MRPeasy vključuje API, ter ustvarite ključ API in skrivni ključ.
- Preslikava. Določite preslikovalno tabelo, pravila o tem, kateri sistem je odgovoren za posamezne podatke, polja po meri za povratni zapis in kanal za poročanje.
- Začetni prenos. Artikli, enote, kosovnice, tehnološki postopki, skupine delovnih centrov, delovni centri in koledarji.
- Sinhronizacija proizvodnih nalogov in nabavnih naročil. Postopno pridobivanje sprememb s poizvedovanjem po statusu in obravnavo odzivov 429.
- Nastavitev omejitev v SkyPlanner. Matrika časov menjav, orodja, število operaterjev in alternativni delovni centri.
- Povratni zapis. Roki in polja po meri na vsakem nalogu Manufacturing Order.
- Vzporedno testiranje. SkyPlanner uporabljajte vzporedno z obstoječim terminskim planom proizvodnje, primerjajte datume in popravite matične podatke.
- Prehod v redno uporabo. Ko se podatki ujemajo, vklopite povratni zapis.
Kaj upoštevati pri integraciji z MRPeasy
- Časovna polja se med vmesnikoma razlikujejo. Poljem Setup time, Cycle time in Capacity v uporabniškem vmesniku v API ustrezajo
fixed_time,variable_timeinvariable_quantity. Capacity nad 1 pomeni šaržno obdelavo, na primer v peči. Preslikajte jo kot šaržno operacijo, ne kot daljši cikel. - Skupine za pasivno obdelavo. Skupine za sušenje in hlajenje delujejo 24/7 brez omejitev zmogljivosti. Preslikajte jih kot čakalne čase, ne kot delovne centre z omejeno zmogljivostjo.
- V v1 ni koledarjev.
work-centersvrne lecenter_id,type_id,codeintitle. Uporabite v2 ali vzdržujte izmene v SkyPlanner. - Čas nedelovanja. Čas nedelovanja delovnega centra zajema vzdrževanje in zastoje. Sinhronizirajte ga, sicer SkyPlanner razporeja delo na stroj, ki ne obratuje.
- Tehnološki postopki se sklicujejo na skupine. MRPeasy izbere stroj z najboljšo razpoložljivostjo. V SkyPlanner delovni centri iz skupine postanejo dejanske alternative, med katerimi izbira algoritem.
Integracija z MRPeasy: kdo jo nastavi in zagotavlja podporo
Delo zajema preslikavo vaših tehnoloških postopkov, skupin delovnih centrov in poteka obdelave nalogov ter nastavitev omejitev, ki jih MRPeasy ne hrani: matrike pripravljalnih časov, orodij, števila operaterjev in alternativnih virov.
- Ekipa SkyPlanner nastavi integracijo med uvajanjem in zanjo zagotavlja podporo po začetku redne uporabe. Vsak obrat uporablja MRPeasy po svoje, pri nastavitvi pa se upoštevajo te posebnosti. Ker podpora MRPeasy ne zajema dela z API, je pomembno, da je za integracijo odgovorna ena ekipa.
- Integracijo lahko izdela vaš svetovalec za MRPeasy ali integracijski partner. V enem od izvedenih projektov z MRPeasy je integracijski partner sistema povezal prek njunih REST API. SkyPlanner zagotavlja REST API, dokumentacijo Swagger/OpenAPI in spletne kavlje.
- Integracijo lahko razvijejo tudi vaši razvijalci z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga. Dokumentacija izdelka, vključno z nabavnimi nalogi ter API za izdelke in materiale, je na voljo v dokumentaciji SkyPlanner.
SkyPlanner je na voljo od 199 € na mesec z vključenimi 5 delovnimi centri in mesečnim obračunavanjem. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj s ponudbo za paket, tako da pred začetkom poznate celoten strošek. Oglejte si cene, funkcionalnosti in primerjavo z lastnim orodjem za terminiranje MRPeasy na strani terminiranje proizvodnje z MRPeasy. Pregled je na voljo na strani MRPeasy, druge sisteme ERP pa najdete v pregledu integracij s sistemi ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
2 hprihranka vsak teden
»S sistemom SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, nov vrstni red operacij pa do proizvodne linije prispe v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90 %.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90 %, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
6 mesecevvnaprej prodaja vidi proste zmogljivosti
»SkyPlanner zagotavlja zanesljivo osnovo za celotno planiranje proizvodnje.«
Anu Järvinen, vodja proizvodnje
Fredman Operations · Papir za embalažo, primeren za stik z živili
Prodaja vidi proste zmogljivosti šest mesecev vnaprej, na zahteve za spremembo terminskega plana, za katere so prej potrebovali uro ali več, pa zdaj odgovorijo v nekaj sekundah.
Pogosta vprašanja
Ali ima MRPeasy API in kateri paket potrebujem?
Da. MRPeasy plačljivim računom v paketu Unlimited ponuja REST API: v1 je v produkcijski uporabi, v2 pa v razvoju. Za avtentikacijo uporablja HTTP Basic s ključem API in skrivnim ključem, ki ju pridobite v Settings → Integration → API access.
Ali lahko SkyPlanner zapiše terminski plan nazaj v MRPeasy?
Da. SkyPlanner posodobi vsak Manufacturing Order prek PUT /manufacturing-orders/{id} ter zapiše rok in polja po meri za načrtovani začetek, načrtovani konec in napredek. Podrobno zaporedje operacij ostane v sistemu SkyPlanner, kjer operaterji delajo po svojem seznamu dodeljenih operacij.
Ali MRPeasy sproti pošilja spremembe?
Specifikacije API ne navajajo dogodkov spletnih kavljev za proizvodne naloge, zato SkyPlanner vsakih nekaj minut poizveduje po odprtih nalogih glede na status. Spletni kavlji sistema SkyPlanner pošiljajo spremembe terminskega plana takoj, ko nastanejo.
Kdo izdela integracijo z MRPeasy?
Ekipa SkyPlanner med uvajanjem nastavi dvosmerno integracijo in zanjo zagotavlja podporo po začetku redne uporabe. Integracijo lahko na podlagi dokumentiranega REST API sistema SkyPlanner izdela tudi vaš svetovalec za MRPeasy, integracijski partner ali vaši razvijalci.
Ali lahko SkyPlanner preizkusimo pred izdelavo integracije?
Da. 30-dnevni brezplačni preizkus podpira do 20 delovnih centrov z uvozom datotek CSV iz MRPeasy, ne glede na vaš paket MRPeasy in brez kreditne kartice. Začnite preizkus ali se obrnite na prodajo za opredelitev obsega integracije.
