Integrácie / ERP / MRPeasy
Sprievodca integráciou MRPeasy na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou MRPeasy ukazuje konzultantom a IT tímom, ako prepojiť MRPeasy so SkyPlanner APS. SkyPlanner sa s MRPeasy prepája obojsmerne cez MRPeasy REST API:
- Do SkyPlanner sa prenášajú výrobné príkazy, technologické postupy, kusovníky, skupiny pracovísk, pracoviská, položky, skladové zásoby a nákupné objednávky.
- Plánované termíny a priebeh výroby sa zapisujú späť do každého objektu Manufacturing Order.
- SkyPlanner odosiela zmeny rozvrhu cez webhooky hneď, ako nastanú.
SkyPlanner už bol prepojený s MRPeasy v zákazníckych projektoch. Tím SkyPlanner počas zavádzania prispôsobí integráciu vášmu nastaveniu MRPeasy a poskytuje jej podporu aj po spustení do ostrej prevádzky. Tento sprievodca je určený konzultantom a vývojárom, ktorí sa chcú zapojiť alebo sami vyvíjať riešenia s využitím zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
MRPeasy REST API: v1 a v2
MRPeasy je jednotný cloudový produkt bez lokálne inštalovaných verzií, takže všetci zákazníci používajú rovnaké API. Existujú dve verzie:
- REST API v1 (OpenAPI 1.0, server
https://api.mrpeasy.com/rest/v1) je API pre ostrú prevádzku. Zahŕňa/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsa výrobné reporty, napríklad/report/production/operations. - REST API v2 (OpenAPI 2.0.0, server
https://api.mrpeasy.com/rest/v2) je v počiatočnej fáze vývoja. Pridáva/workstation-groupss poľamiwork_hoursaholidays,/workstationss poľamiproductivityaidle,/inventory,/stock-movementa metódu PATCH. Výrobné príkazy zostávajú vo v1.
Dávajte pozor na názvy. Skupine pracovísk označenej v rozhraní MRPeasy ako Workstation group zodpovedá vo v1 work-center-types (type_id). Pracovisku Workstation zodpovedá work-centers (center_id). Operácie technologického postupu odkazujú cez type_id na skupinu, nie na stroj.
API je súčasťou plánu MRPeasy Unlimited pre platené účty. MRPeasy tiež uvádza: „Our Support Department cannot help you using the API.“ (Naše oddelenie podpory vám nemôže pomôcť s používaním API.) Za integráciu preto musí niekto zodpovedať: SkyPlanner, váš konzultant pre MRPeasy alebo váš vývojár. Presne túto prácu preberá tím SkyPlanner počas zavádzania.
Autentifikácia a limity
MRPeasy používa autentifikáciu HTTP Basic: Authorization: Basic base64(api-key:api-secret). Kľúč a tajný kľúč sa vytvárajú v časti Settings → Integration → API access. Vymazaním kľúča sa API deaktivuje.
Pri návrhu synchronizácie treba zohľadniť tieto limity:
- Pre každého klienta môže v danom čase prebiehať iba jedna požiadavka: požiadavky sa spracúvajú postupne.
- Najviac 100 požiadaviek za 10 sekúnd. Po prekročení tohto limitu API vráti stavový kód 429.
- Zoznamy štandardne vracajú 100 záznamov a s hlavičkou
Rangeaž 1 000. HlavičkaContent-Rangev odpovedi uvádza celkový počet.
REST API SkyPlanner používa na autentifikáciu API token (SkyPlanner Settings > API). Jeho dokumentácia je dostupná vo formáte Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Udalosti a pravidelné dopytovanie
Cenník MRPeasy uvádza „API, webhooks (for paid accounts)“ (API, webhooky pre platené účty), no špecifikácie v1 a v2 nedokumentujú žiadne webhookové udalosti pre výrobné príkazy. Integrácia preto priebežne zisťuje zmeny v MRPeasy dopytovaním:
- Výrobné príkazy filtruje podľa stavov Not scheduled (15), Scheduled (20), In progress (30) a Paused (35).
- Nákupné objednávky a skladové zásoby načítava v stanovených intervaloch alebo pred každým spustením rozvrhovania.
- Kmeňové dáta načítava pri zmene alebo každú noc.
Sekvenčné dopytovanie s filtrovaním zostáva s dostatočnou rezervou pod limitom 100 požiadaviek za 10 sekúnd. V opačnom smere vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú. Spätný zápis je teda riadený udalosťami.
Mapovanie dát
| Objekt MRPeasy (koncový bod) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Produkty a materiály | MRPeasy → SkyPlanner | Úvodné načítanie, potom každú noc |
BOM s komponentmi (/boms) | Štruktúra produktu, podprodukty, materiály pre jednotlivé produkty | MRPeasy → SkyPlanner | Úvodné načítanie, potom pri zmene |
Operácie technologického postupu (/routings): type_id, fixed_time, variable_time, variable_quantity | Kroky procesu s trvaním, časmi nastavenia a veľkosťou dávky | MRPeasy → SkyPlanner | Úvodné načítanie, potom pri zmene |
Workstation group (/work-center-types; v2 /workstation-groups) | Skupiny pracovísk, zmeny | MRPeasy → SkyPlanner | Úvodné načítanie, potom len zriedka |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Pracoviská, efektivita, neprítomnosti | MRPeasy → SkyPlanner | Úvodné načítanie, denne pre časy nečinnosti |
Manufacturing Order s operáciami, due_date (/manufacturing-orders) | Zákazky a operácie | MRPeasy → SkyPlanner | Pravidelné načítavanie každých pár minút |
Inventory, Stock lots (/stock/inventory, /lots) | Stavy zásob | MRPeasy → SkyPlanner | Každú hodinu alebo pri každom spustení rozvrhovania |
Purchase Order (/purchase-orders) | Očakávaný materiál s predpokladaným dátumom dodania | MRPeasy → SkyPlanner | Každú hodinu alebo pri každom spustení rozvrhovania |
Polia due_date a custom_<id> objektu Manufacturing Order (PUT /manufacturing-orders/{id}) | Plánovaný začiatok, plánované dokončenie, priebeh | SkyPlanner → MRPeasy | Pri zmene rozvrhu prostredníctvom webhooku SkyPlanner |
| Nie je v MRPeasy | Matica časov prestavenia, nástroje ako zdroje s obmedzenou kapacitou, počty operátorov, alternatívne pracoviská | Spravuje sa v SkyPlanner | Nastavuje sa pri zavádzaní |
Spôsoby integrácie
1. Úvodné načítanie kmeňových dát. Načítajte položky, jednotky, kusovníky a technologické postupy z v1 a skupiny pracovísk a pracoviská z v1 alebo v2. Kalendáre prevezmite z v2 /workstation-groups (work_hours, holidays) alebo nastavte zmeny priamo v SkyPlanner. Každú skupinu Active processing priraďte k skupine pracovísk v SkyPlanner a jej pracoviská zaraďte do tejto skupiny.
2. Synchronizácia objednávok a výrobných príkazov. Načítajte otvorené výrobné príkazy s ich operáciami, ako aj otvorené nákupné objednávky a zásoby. SkyPlanner považuje objednaný materiál za dostupný k dátumu dodania nákupnej objednávky a aktualizuje zásoby, keď je objednávka označená ako Delivered. Pri každom preplánovaní kontroluje zásoby aj očakávané nákupné dodávky.
3. Spätný zápis rozvrhu. PUT /manufacturing-orders/{id} podporuje polia code, quantity, due_date a assigned_id, ako aj vlastné polia vo formáte custom_<id>. Ak je to dohodnuté, SkyPlanner zapisuje plánované dokončenie do poľa due_date. Plánovaný začiatok, plánované dokončenie a priebeh zapisuje do vlastných polí MRPeasy. Predaj a nákup tak v MRPeasy vidia skutočný rozvrh. Podrobné poradie operácií a pracovisko pre každú operáciu sú uložené v SkyPlanner, ktorý slúži ako dispečerský prehľad pre výrobu.
4. Výrobné príkazy vytvorené mimo MRPeasy. Ak sa výrobné príkazy vytvárajú cez API, POST /manufacturing-orders prijíma parametre no_scheduling a no_bookings. Použite ich, aby MRPeasy nerezervoval pracoviská, ktorých rozvrh už spravuje SkyPlanner.
5. Potvrdzovanie práce vo výrobe. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations, Production Timer alebo Quick Log Mode a časové záznamy udržiavajú rozvrh aktuálny. Vyberte si jeden kanál na vykazovanie práce. Ak pre rovnaké operácie súbežne používate Internet-kiosk od MRPeasy aj SkyPlanner, vznikajú dve verzie skutočného stavu.
6. Zodpovednosť za dáta a pravidlá riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Položky, kusovníky, technologické postupy, množstvá, zásoby, obstarávanie | MRPeasy |
| Poradie operácií, časy začiatku a konca, priradenie pracovísk | SkyPlanner |
| Matica časov prestavenia, nástroje, počty operátorov, alternatívne zdroje | SkyPlanner |
| Zmeny a neprítomnosti | Jeden systém vybraný pri definovaní rozsahu |
| Priebeh zákazky a vykázaná práca | SkyPlanner, so súhrnom v objekte Manufacturing Order |
Postup pri konštrukcii na zákazku. V jednom realizovanom projekte s MRPeasy sa každý zákaznícky projekt spracúva ako hlavný výrobok a jeden až tri polotovary. Každý z nich má v MRPeasy vlastný kusovník a technologický postup a výrobný príkaz existuje v oboch systémoch. Pri každom výrobnom príkaze zachovajte stabilný spoločný identifikátor, aby pri aktualizáciách nikdy nevznikali duplicity.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Predtým si môžete SkyPlanner počas 30 dní bezplatne vyskúšať na vlastných dátach s ľubovoľným programom MRPeasy. Zo zoznamových zobrazení MRPeasy exportujte položky, kusovníky, technologické postupy, pracoviská a otvorené výrobné príkazy do CSV, importujte ich a overte rozvrh.
Samotný projekt zahŕňa:
- Kontrola programu. Overte, či váš program MRPeasy zahŕňa API, a vytvorte API kľúč a tajný kľúč.
- Mapovanie. Dohodnite mapovaciu tabuľku, pravidlá zodpovednosti za dáta, vlastné polia na spätný zápis a kanál na vykazovanie práce.
- Úvodné načítanie. Položky, jednotky, kusovníky, technologické postupy, skupiny pracovísk, pracoviská a kalendáre.
- Synchronizácia zákaziek a nákupných objednávok. Prírastkové načítavanie podľa stavu s ošetrením odpovede 429.
- Nastavenie obmedzení v SkyPlanner. Matica časov prípravy a prestavenia, nástroje, počty operátorov a alternatívne pracoviská.
- Spätný zápis. Termíny dokončenia a vlastné polia v každom objekte Manufacturing Order.
- Paralelné testovanie. Používajte SkyPlanner súbežne s aktuálnym rozvrhom v Production schedule, porovnávajte termíny a opravte kmeňové dáta.
- Spustenie ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii s MRPeasy
- Časové polia sa líšia podľa rozhrania. Poliam Setup time, Cycle time a Capacity v používateľskom rozhraní zodpovedajú v API polia
fixed_time,variable_timeavariable_quantity. Hodnota Capacity vyššia ako 1 znamená dávkové spracovanie, napríklad v peci. Namapujte ho ako dávkovú operáciu, nie ako dlhší cyklus. - Skupiny Passive processing. Skupiny na sušenie a chladenie fungujú 24/7 bez kapacitných obmedzení. Namapujte ich ako časy čakania, nie ako pracoviská s obmedzenou kapacitou.
- Vo v1 chýbajú kalendáre.
work-centersvracia ibacenter_id,type_id,codeatitle. Použite v2 alebo spravujte zmeny v SkyPlanner. - Prestoje. Údaje o prestojoch pracoviska zahŕňajú údržbu a odstávky. Synchronizujte ich, inak SkyPlanner naplánuje prácu aj na stroji, ktorý je odstavený.
- Technologické postupy odkazujú na skupiny. MRPeasy vyberá stroj s najlepšou dostupnosťou. V SkyPlanner sa pracoviská v skupine stávajú skutočnými alternatívami, medzi ktorými plánovací algoritmus vyberá.
Integrácia s MRPeasy: kto ju nastavuje a zabezpečuje podporu
Práce zahŕňajú mapovanie vašich technologických postupov, skupín pracovísk a toku zákaziek. Patria sem aj obmedzenia, ktoré MRPeasy neeviduje: matica časov prípravy a prestavenia, nástroje, počty operátorov a alternatívne zdroje.
- Tím SkyPlanner nastaví integráciu počas zavádzania a zabezpečuje podporu aj po spustení ostrej prevádzky. Každý závod používa MRPeasy inak a tieto skúsenosti sa premietnu práve do nastavenia integrácie. Podpora MRPeasy nezahŕňa práce s API, preto je dôležité, aby za integráciu zodpovedal jeden tím.
- Integráciu môže vytvoriť váš konzultant pre MRPeasy alebo integračný partner. V jednom realizovanom projekte MRPeasy integračný partner prepojil oba systémy cez ich REST API. SkyPlanner poskytuje REST API, dokumentáciu Swagger/OpenAPI a webhooky.
- Integráciu môžu vytvoriť aj vaši vývojári pomocou API tokenu. Na začiatok stačí API token a tím SkyPlanner v prípade potreby pomôže. Produktovú dokumentáciu vrátane nákupných objednávok a API pre produkty a materiály nájdete v dokumentácii SkyPlanner.
Cena SkyPlanner začína od 199 € mesačne vrátane 5 pracovísk, s mesačnou fakturáciou. Cenovú ponuku na integráciu pripravíme vopred podľa vašich procesov a potrieb spolu s cenou balíka, aby ste poznali celkové náklady ešte pred začatím. Pozrite si cenník, funkcie a porovnanie s vlastným plánovacím nástrojom MRPeasy v článku Plánovanie výroby v MRPeasy s ohľadom na reálne kapacity strojov a pracovníkov. Prehľad nájdete na stránke MRPeasy a ďalšie systémy ERP v prehľade integrácií s ERP.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„SkyPlanner posunul naše plánovanie výroby od tabuliek v Exceli k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Pri plánovaní výroby ušetria každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa dostane na linku v priebehu sekúnd.
+90%efektivita výroby
„Efektivita výroby vzrástla o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrástla o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej ako 30 minút.
6 mesiacovdopredu vidí obchodné oddelenie voľné kapacity
„SkyPlanner poskytuje spoľahlivý základ pre celé plánovanie výroby.“
Anu Järvinen, manažérka výroby
Fredman Operations · Baliace papiere vhodné na styk s potravinami
Obchodné oddelenie vidí voľné kapacity šesť mesiacov dopredu. Na požiadavky na zmenu rozvrhu, ktorých vybavenie predtým trvalo hodinu alebo viac, teraz dostane odpoveď v priebehu sekúnd.
Často kladené otázky
Má MRPeasy API a ktorý balík potrebujem?
Áno. MRPeasy ponúka REST API pre platené účty v balíku Unlimited: v1 je v ostrej prevádzke a v2 vo vývoji. Na autentifikáciu sa používa HTTP Basic s API kľúčom a tajným kľúčom vytvorenými v časti Settings → Integration → API access.
Dokáže SkyPlanner zapísať rozvrh späť do MRPeasy?
Áno. SkyPlanner aktualizuje každý objekt Manufacturing Order cez PUT /manufacturing-orders/{id}. Zapisuje termín dokončenia a vlastné polia pre plánovaný začiatok, plánované dokončenie a priebeh. Podrobné poradie operácií zostáva v SkyPlanner, kde operátori pracujú podľa vlastného zoznamu operácií.
Odosiela MRPeasy zmeny v reálnom čase?
Špecifikácie API neuvádzajú žiadne webhookové udalosti pre výrobné príkazy, preto SkyPlanner každých pár minút načítava otvorené výrobné príkazy podľa stavu. Vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Kto vytvorí integráciu s MRPeasy?
Tím SkyPlanner nastaví obojsmernú integráciu počas zavádzania a zabezpečuje podporu aj po spustení ostrej prevádzky. Integráciu môže vytvoriť aj váš konzultant pre MRPeasy, integračný partner alebo vaši vývojári pomocou zdokumentovaného REST API SkyPlanner.
Môžeme SkyPlanner otestovať pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom CSV z MRPeasy pri akomkoľvek balíku MRPeasy. Platobnú kartu nepotrebujete. Vyskúšajte SkyPlanner alebo kontaktujte obchodné oddelenie a spoločne definujte rozsah integrácie.
