Integraatiot / ERP / MRPeasy
MRPeasy-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä MRPeasy-integraatio-opas kertoo konsulteille ja IT-tiimeille, miten MRPeasy yhdistetään SkyPlanner APS:ään. SkyPlannerin ja MRPeasyn välinen integraatio toimii molempiin suuntiin MRPeasyn REST API:n kautta:
- SkyPlanneriin tuodaan valmistustilaukset, reititykset, BOM:t, työpisteryhmät, työpisteet, nimikkeet, varastotiedot ja ostotilaukset.
- Suunnitellut päivämäärät ja etenemistiedot kirjoitetaan takaisin kullekin valmistustilaukselle.
- SkyPlannerin webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner on integroitu MRPeasyyn asiakasprojekteissa. SkyPlanner-tiimi määrittää integraation MRPeasy-ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu konsulteille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa itse integraation SkyPlannerin dokumentoidun REST API:n avulla (API-dokumentaatio).
MRPeasyn REST API: v1 ja v2
MRPeasy on pilvipalvelu, josta ei ole paikallisesti asennettavia versioita. Siksi kaikki asiakkaat käyttävät samaa API:a. API:sta on kaksi versiota:
- REST API v1 (OpenAPI 1.0, palvelin
https://api.mrpeasy.com/rest/v1) on tuotantokäytössä oleva API. Se kattaa päätepisteet/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lotsja/unitssekä tuotantoraportit, kuten/report/production/operations. - REST API v2 (OpenAPI 2.0.0, palvelin
https://api.mrpeasy.com/rest/v2) on kehityksen alkuvaiheessa. Se tuo mukaan päätepisteen/workstation-groupskenttineenwork_hoursjaholidays, päätepisteen/workstationskenttineenproductivityjaidle, päätepisteet/inventoryja/stock-movementsekä PATCH-tuen. Valmistustilaukset käsitellään edelleen v1:ssä.
Huomaa erot nimeämisessä. MRPeasyn käyttöliittymän Workstation group eli työpisteryhmä vastaa v1:ssä resurssia work-center-types (type_id). Workstation eli työpiste vastaa resurssia work-centers (center_id). Reitityksen työvaiheet viittaavat type_id-kentän kautta ryhmään, eivät yksittäiseen koneeseen.
API sisältyy MRPeasyn Unlimited-pakettiin maksullisilla tileillä. MRPeasy myös toteaa: “Our Support Department cannot help you using the API.” (Tukemme ei voi auttaa API:n käytössä.) Integraatiolle tarvitaan siis vastuullinen taho: SkyPlanner, MRPeasy-konsulttisi tai kehittäjäsi. SkyPlanner-tiimi ottaa juuri tämän työn hoitaakseen käyttöönoton aikana.
Tunnistautuminen ja rajoitukset
MRPeasy käyttää HTTP Basic -tunnistautumista: Authorization: Basic base64(api-key:api-secret). Avain ja salainen avain luodaan kohdassa Settings → Integration → API access. Avaimen tyhjentäminen poistaa API:n käytöstä.
Rajoitukset on huomioitava synkronoinnin suunnittelussa:
- Yksi samanaikainen pyyntö asiakassovellusta kohden: pyynnöt käsitellään peräkkäin.
- Enintään 100 pyyntöä 10 sekunnissa. Jos raja ylittyy, API palauttaa koodin 429.
- Listaukset palauttavat oletuksena 100 tietuetta ja
Range-otsakkeen avulla enintään 1 000 tietuetta. VastauksenContent-Rangekertoo kokonaismäärän.
SkyPlannerin REST API käyttää tunnistautumiseen API-tokenia (SkyPlanner Settings > API), ja se on dokumentoitu Swagger/OpenAPI-muodossa. Integraatio-ohje opastaa ensimmäisten kutsujen tekemisessä.
Tapahtumat ja pollaus
MRPeasyn hinnastosivulla mainitaan “API, webhooks (for paid accounts)” (API ja webhookit maksullisille tileille), mutta v1- ja v2-määrityksissä ei ole dokumentoitu valmistustilausten webhook-tapahtumia. Siksi integraatio hakee muutokset MRPeasystä toistuvilla kyselyillä:
- Valmistustilaukset suodatetaan tilojen Ei suunniteltu (15), Suunniteltu (20), Käynnissä (30) ja Keskeytetty (35) mukaan.
- Ostotilaukset ja varastotiedot haetaan määräajoin tai ennen jokaista suunnitteluajoa.
- Perustiedot haetaan niiden muuttuessa tai öisin.
Peräkkäiset, suodatetut kyselyt pysyvät selvästi alle rajan, joka on 100 pyyntöä 10 sekunnissa. Toiseen suuntaan SkyPlannerin omat webhookit välittävät aikataulumuutokset heti niiden tapahtuessa, joten takaisinkirjoitus on tapahtumapohjaista.
Tietojen vastaavuudet
| MRPeasyn objekti (päätepiste) | SkyPlannerin objekti | Suunta | Siirtotiheys |
|---|---|---|---|
Nimike, mittayksikkö (/items, /units) | Tuotteet ja materiaalit | MRPeasy → SkyPlanner | Alkusiirto, sen jälkeen öisin |
BOM komponentteineen (/boms) | Tuoterakenne, alituotteet, tuotekohtaiset materiaalit | MRPeasy → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
Reitityksen työvaiheet (/routings): type_id, fixed_time, variable_time, variable_quantity | Työvaiheet kestoineen, asetusajat ja eräkoko | MRPeasy → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
Työpisteryhmä (/work-center-types; v2 /workstation-groups) | Työpisteryhmät, työvuorot | MRPeasy → SkyPlanner | Alkusiirto, sen jälkeen harvoin |
Työpiste (/work-centers; v2 /workstations: productivity, idle) | Työpisteet, tehokkuudet, poissaolot | MRPeasy → SkyPlanner | Alkusiirto, seisokkiajat päivittäin |
Valmistustilaus työvaiheineen, due_date (/manufacturing-orders) | Tilaukset ja työt | MRPeasy → SkyPlanner | Kyselyt muutaman minuutin välein |
Varastotiedot, varastoerät (/stock/inventory, /lots) | Varastosaldot | MRPeasy → SkyPlanner | Tunneittain tai jokaisella suunnitteluajolla |
Ostotilaus (/purchase-orders) | Saapuva materiaali ja odotettu toimituspäivä | MRPeasy → SkyPlanner | Tunneittain tai jokaisella suunnitteluajolla |
Valmistustilauksen due_date– ja custom_<id>-kentät (PUT /manufacturing-orders/{id}) | Suunniteltu aloitus, suunniteltu valmistuminen, eteneminen | SkyPlanner → MRPeasy | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
| Ei MRPeasyssä | Asetusaikamatriisi, työkalut rajallisina resursseina, työntekijämäärät, vaihtoehtoiset työpisteet | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutustavat
1. Perustietojen alkusiirto. Hae nimikkeet, yksiköt, BOM:t ja reititykset v1:stä sekä työpisteryhmät ja työpisteet v1:stä tai v2:sta. Hae kalenterit v2:n /workstation-groups-päätepisteestä (work_hours, holidays) tai määritä työvuorot suoraan SkyPlannerissa. Liitä kukin Active processing -ryhmä SkyPlannerin työpisteryhmään ja sen työpisteet ryhmän jäseniksi.
2. Tilausten synkronointi. Lue avoimet valmistustilaukset työvaiheineen sekä avoimet ostotilaukset ja varastotiedot. SkyPlanner katsoo tilatun materiaalin olevan käytettävissä ostotilauksen toimituspäivänä ja päivittää varastosaldot, kun ostotilaus merkitään toimitetuksi. Jokaisella uudelleensuunnittelukerralla tarkistetaan sekä varastosaldot että saapuvat ostot.
3. Aikataulun takaisinkirjoitus. PUT /manufacturing-orders/{id} tukee kenttiä code, quantity, due_date ja assigned_id sekä mukautettuja kenttiä muodossa custom_<id>. SkyPlanner kirjoittaa suunnitellun valmistumisajan due_date-kenttään, jos näin on sovittu, sekä suunnitellun aloitusajan, valmistumisajan ja etenemistiedot MRPeasyn mukautettuihin kenttiin. Näin myynti ja hankinta näkevät todellisen aikataulun MRPeasyssä. Yksityiskohtainen työvaiheiden järjestys ja kunkin työvaiheen työpiste ovat SkyPlannerissa, joka toimii tuotannon työnjakonäkymänä.
4. MRPeasyn ulkopuolella luodut tilaukset. Jos tilauksia luodaan API:n kautta, POST /manufacturing-orders hyväksyy parametrit no_scheduling ja no_bookings. Käytä niitä, jotta MRPeasy ei varaa työpisteitä, joiden työt SkyPlanner jo suunnittelee.
5. Tuotannon työkuittaukset. Työntekijät kirjaavat työt SkyPlanner Mobile Confirmations-, Production Timer- tai Quick Log Mode -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Valitse yksi raportointikanava. Jos samoja työvaiheita raportoidaan rinnakkain MRPeasyn Internet-kioskissa ja SkyPlannerissa, syntyy kaksi eri totuutta.
6. Tietojen omistajuus ja ristiriitatilanteiden säännöt. Kirjaa ne ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, BOM:t, reititykset, määrät, varastotiedot, hankinta | MRPeasy |
| Työvaiheiden järjestys, aloitus- ja lopetusajat, työpisteiden valinta | SkyPlanner |
| Asetusaikamatriisi, työkalut, työntekijämäärät, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja poissaolot | Yksi järjestelmä, joka valitaan määrittelyssä |
| Tilauksen eteneminen ja kirjatut työt | SkyPlanner; yhteenvetotiedot Manufacturing Order -objektissa |
Tilauksesta suunniteltavien tuotteiden työnkulku. Eräässä toteutetussa MRPeasy-projektissa jokaisesta asiakasprojektista muodostetaan päätuote ja yhdestä kolmeen puolivalmistetta. Jokaisella on MRPeasyssa oma BOM ja reititys, ja valmistustilaus on molemmissa järjestelmissä. Käytä jokaisella tilauksella pysyvää yhteistä tunnistetta, jotta päivitykset eivät koskaan luo kaksoiskappaleita.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikkojen kuluessa käyttöönoton aloittamisesta. Sitä ennen voit käyttää 30 päivän maksutonta kokeilua omilla tiedoillasi riippumatta MRPeasy-paketistasi. Vie nimikkeet, BOM-rakenteet, reititykset, työpisteet ja avoimet valmistustilaukset MRPeasyn listanäkymistä CSV-tiedostoiksi, tuo ne SkyPlanneriin ja tarkista tuotantoaikataulu.
Varsinainen projekti sisältää seuraavat vaiheet:
- Paketin tarkistus. Varmista, että MRPeasy-pakettiin sisältyy API, ja luo API-avain ja salainen avain.
- Tietojen vastaavuudet. Sovi vastaavuustaulukosta, tietojen omistajuussäännöistä, takaisin kirjoitettavien tietojen mukautetuista kentistä ja raportointikanavasta.
- Ensimmäinen tiedonsiirto. Nimikkeet, yksiköt, BOM-rakenteet, reititykset, työpisteryhmät, työpisteet ja kalenterit.
- Tilausten ja ostotilausten synkronointi. Muutosten haku tilan perusteella ja 429-vastausten käsittely.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työntekijämäärät ja vaihtoehtoiset työpisteet.
- Takaisinkirjoitus. Määräpäivät ja mukautetut kentät jokaisessa Manufacturing Order -objektissa.
- Rinnakkaistestaus. Käytä SkyPlanneria nykyisen Production schedule -näkymän rinnalla, vertaa päivämääriä ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä MRPeasy-integraation suunnittelussa on huomioitava
- Aikakentät eroavat käyttöliittymässä ja APIssa. Käyttöliittymän Setup time-, Cycle time- ja Capacity-kenttiä vastaavat APIssa
fixed_time,variable_timejavariable_quantity. Kun Capacity on yli 1, kyse on eräkäsittelystä, esimerkiksi uunissa. Mallinna se erätyöksi, älä pidemmäksi jaksoajaksi. - Passiivisen käsittelyn ryhmät. Kuivaus- ja jäähdytysryhmät toimivat 24/7 ilman kapasiteettirajoja. Mallinna ne odotusajoiksi, älä kapasiteetiltaan rajallisiksi työpisteiksi.
- Kalenterit puuttuvat v1:stä.
work-centerspalauttaa vain kentätcenter_id,type_id,codejatitle. Käytä v2:ta tai ylläpidä työvuoroja SkyPlannerissa. - Seisokkiaika. Työpisteen Idle time sisältää huollot ja seisokit. Synkronoi tiedot, tai SkyPlanner suunnittelee töitä koneelle, joka ei ole käytössä.
- Reititykset viittaavat ryhmiin. MRPeasy valitsee koneen, jonka saatavuus on paras. SkyPlannerissa ryhmän työpisteet ovat todellisia vaihtoehtoja, joiden väliltä laskentamoottori valitsee.
Kuka määrittää MRPeasy-integraation ja vastaa sen tuesta
Työssä määritetään reititysten, työpisteryhmien ja tilausten kulun vastaavuudet sekä rajoitteet, joita MRPeasy ei sisällä: asetusaikamatriisi, työkalut, työntekijämäärät ja vaihtoehtoiset resurssit.
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Jokainen tehdas käyttää MRPeasya omalla tavallaan, ja tämä osaaminen huomioidaan määrityksissä. MRPeasyn tuki ei kata API-töitä, joten on tärkeää, että yksi tiimi vastaa integraatiosta.
- MRPeasy-konsulttisi tai integraatiokumppanisi voi toteuttaa integraation. Eräässä toteutetussa MRPeasy-projektissa integraatiokumppani yhdisti järjestelmät niiden REST API -rajapintojen kautta. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Omat kehittäjänne voivat rakentaa integraation API-tunnisteella. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Tuotedokumentaatio, joka kattaa myös ostotilaukset sekä tuotteiden ja materiaalien APIn, löytyy SkyPlannerin dokumentaatiosta.
SkyPlanner maksaa alkaen 199 € kuukaudessa ja sisältää 5 työpistettä. Laskutus on kuukausittain. Saat integraatiosta etukäteen tarjouksen, joka perustuu prosessiisi ja tarpeisiisi ja sisältää myös valitsemasi paketin. Näet siis kokonaiskustannukset ennen aloittamista. Tutustu hinnoitteluun ja ominaisuuksiin sekä MRPeasyn oman suunnittelutyökalun vertailuun sivulla MRPeasyn hienokuormitus. Yleiskatsaus löytyy MRPeasy-sivulta ja muut ERP-järjestelmät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan tuotantolinjalle sekunneissa.
+90%tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90%.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90%, ja kaikki työpisteet kattava optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
6 kuukauttavapaata kapasiteettia myynnin nähtävissä
”SkyPlanner luo luotettavan perustan kaikelle tuotannonsuunnittelulle.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuudeksi kuukaudeksi eteenpäin. Aikataulumuutospyyntöihin, joiden käsittely vei aiemmin tunnin tai enemmän, vastataan nyt sekunneissa.
Usein kysytyt kysymykset
Onko MRPeasyssa API, ja minkä paketin tarvitsen?
Kyllä. MRPeasy tarjoaa REST API -rajapinnan maksaville Unlimited-paketin käyttäjille. v1 on tuotantokäytössä ja v2 kehitteillä. Tunnistautuminen tapahtuu HTTP Basic -menetelmällä käyttäen API-avainta ja salaisuutta, jotka löytyvät kohdasta Settings → Integration → API access.
Voiko SkyPlanner kirjoittaa tuotantoaikataulun takaisin MRPeasyyn?
Kyllä. SkyPlanner päivittää jokaisen Manufacturing Order -tilauksen PUT /manufacturing-orders/{id} -kutsulla. Se päivittää määräpäivän ja kirjoittaa mukautettuihin kenttiin suunnitellun aloituksen, suunnitellun valmistumisen ja edistymisen. Yksityiskohtainen työvaihejärjestys säilyy SkyPlannerissa, jossa työntekijät työskentelevät oman työjononsa mukaan.
Lähettääkö MRPeasy muutokset reaaliajassa?
API-määrityksissä ei ole dokumentoitu valmistustilausten webhook-tapahtumia, joten SkyPlanner hakee avoimet tilaukset tilan perusteella muutaman minuutin välein. SkyPlannerin omat webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
Kuka toteuttaa MRPeasy-integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation käyttöönoton aikana ja tukee sitä tuotantokäyttöön siirtymisen jälkeen. Myös MRPeasy-konsulttisi, integraatiokumppanisi tai omat kehittäjäsi voivat toteuttaa integraation SkyPlannerin dokumentoidun REST API -rajapinnan avulla.
Voimmeko testata SkyPlanneria ennen integraation toteuttamista?
Kyllä. Maksuton 30 päivän kokeilu tukee enintään 20 työpistettä ja tietojen tuontia MRPeasysta CSV-tiedostoina kaikilla MRPeasy-paketeilla. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
