Průvodce integrací MRPeasy pro rozvrhování výroby se SkyPlanner APS

MRPeasy je jednotný cloudový produkt bez lokálně instalovaných verzí, takže všichni zákazníci používají stejné API. Existují dvě verze:

1. REST API v1 (OpenAPI 1.0, server https://api.mrpeasy.com/rest/v1) je API pro ostrý provoz. Zahrnuje /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units a výrobní přehledy, například /report/production/operations.
2. REST API v2 (OpenAPI 2.0.0, server https://api.mrpeasy.com/rest/v2) je v rané fázi vývoje. Přidává /workstation-groups s poli work_hours a holidays, /workstations s poli productivity a idle, dále /inventory, /stock-movement a metodu PATCH. Výrobní příkazy zůstávají ve v1.

Dejte pozor na názvosloví. Skupině pracovišť označené v rozhraní MRPeasy jako Workstation group odpovídá ve v1 work-center-types (type_id). Pracovišti Workstation odpovídá work-centers (center_id). Operace technologického postupu odkazují přes type_id na skupinu, nikoli na stroj.

API je součástí tarifu MRPeasy Unlimited pro placené účty. MRPeasy také uvádí: „Our Support Department cannot help you using the API.“ (Naše oddělení podpory vám s používáním API nemůže pomoci.) Za integraci proto musí někdo odpovídat: SkyPlanner, váš konzultant pro MRPeasy nebo váš vývojář. Právě tuto práci při zavádění přebírá tým SkyPlanner.

Ceník MRPeasy uvádí „API, webhooks (for paid accounts)“ (API a webhooky pro placené účty), ale specifikace v1 ani v2 nepopisují žádné webhookové události pro výrobní příkazy. Integrace proto z MRPeasy průběžně načítá přírůstky a změny pomocí dotazování:

• Výrobní příkazy filtruje podle stavů Not scheduled (15), Scheduled (20), In progress (30) a Paused (35), tedy nerozvrženo, rozvrženo, probíhá a pozastaveno.
• Nákupní objednávky a skladové zásoby načítá v nastavených intervalech nebo před každým spuštěním rozvrhování.
• Kmenová data načítá při změně nebo každou noc.

Sekvenční dotazování s filtrováním zůstává s rezervou pod limitem 100 požadavků za 10 sekund. V opačném směru odesílají vlastní webhooky SkyPlanner změny rozvrhu hned, jak nastanou. Zpětný zápis je tedy řízen událostmi.

1. Úvodní načtení kmenových dat. Z v1 načtěte položky, jednotky, kusovníky a technologické postupy. Skupiny pracovišť a pracoviště načtěte z v1 nebo v2. Kalendáře převezměte z v2 /workstation-groups (work_hours, holidays), nebo nastavte směny přímo ve SkyPlanner. Každou skupinu typu Active processing namapujte na skupinu pracovišť ve SkyPlanner a zařaďte do ní příslušná pracoviště.

2. Synchronizace příkazů a objednávek. Načtěte otevřené výrobní příkazy včetně operací, otevřené nákupní objednávky a skladové zásoby. SkyPlanner považuje objednaný materiál za dostupný k termínu dodání nákupní objednávky a aktualizuje zásoby, jakmile je objednávka označena stavem Delivered. Při každém přeplánování se kontrolují skladové zásoby i očekávané dodávky.

3. Zpětný zápis rozvrhu. PUT /manufacturing-orders/{id} podporuje pole code, quantity, due_date a assigned_id i vlastní pole ve formátu custom_<id>. Je-li to dohodnuto, SkyPlanner zapisuje plánované dokončení do due_date. Plánovaný začátek, plánované dokončení a stav rozpracovanosti zapisuje do vlastních polí MRPeasy. Obchod a nákup tak v MRPeasy vidí skutečný rozvrh. Podrobné pořadí operací a přiřazení pracoviště ke každé operaci zůstávají ve SkyPlanner, který slouží jako dispečerský přehled pro dílnu.

4. Výrobní příkazy vytvořené mimo MRPeasy. Pokud někdy vytváříte výrobní příkazy přes API, POST /manufacturing-orders přijímá parametry no_scheduling a no_bookings. Použijte je, aby MRPeasy nerezervoval pracoviště, jejichž rozvrhování už zajišťuje SkyPlanner.

5. Odvádění výroby. Obsluha zaznamenává práci pomocí SkyPlanner Mobile Confirmations, Production Timer nebo Quick Log Mode. Časové záznamy udržují rozvrh aktuální. Zvolte jeden způsob vykazování. Pokud stejné operace vykazujete souběžně v MRPeasy Internet-kiosk i ve SkyPlanner, vznikají dva rozdílné záznamy o skutečném průběhu práce.

6. Odpovědnost za data a pravidla řešení konfliktů. Sepište je před spuštěním ostrého provozu:

Postup při konstrukci na zakázku. V jednom realizovaném projektu s MRPeasy vzniká z každého zákaznického projektu hlavní výrobek a jeden až tři polotovary. Každý z nich má v MRPeasy vlastní kusovník a technologický postup a výrobní příkaz existuje v obou systémech. U každého příkazu zachovejte stálý společný identifikátor, aby při aktualizacích nikdy nevznikaly duplicity.

• Pole pro časy se v jednotlivých rozhraních liší. Polím Setup time, Cycle time a Capacity v uživatelském rozhraní odpovídají v API pole fixed_time, variable_time a variable_quantity. Hodnota Capacity vyšší než 1 znamená dávkové zpracování, například v peci. Namapujte ji jako dávkovou operaci, nikoli jako delší cyklus.
• Skupiny typu Passive processing. Skupiny pro sušení a chlazení fungují 24/7 bez kapacitních omezení. Namapujte je jako čekací doby, nikoli jako pracoviště s omezenou kapacitou.
• Ve v1 chybějí kalendáře. work-centers vrací pouze center_id, type_id, code a title. Použijte v2 nebo spravujte směny v SkyPlanner.
• Prostoje. Workstation idle time obsahuje údaje o údržbě a odstávkách. Synchronizujte je, jinak SkyPlanner naplánuje práci i na stroji, který je mimo provoz.
• Technologické postupy odkazují na skupiny. MRPeasy vybírá stroj s nejlepší dostupností. V SkyPlanner se pracoviště ve skupině stávají skutečnými alternativami, mezi nimiž plánovací algoritmus vybírá.