Przewodnik po integracji MRPeasy z SkyPlanner APS do harmonogramowania produkcji

MRPeasy to jeden produkt chmurowy, bez wersji instalowanych lokalnie, więc wszyscy klienci korzystają z tego samego API. Dostępne są dwie wersje:

1. REST API v1 (OpenAPI 1.0, serwer https://api.mrpeasy.com/rest/v1) to API do użytku produkcyjnego. Obejmuje /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units oraz raporty produkcyjne, takie jak /report/production/operations.
2. REST API v2 (OpenAPI 2.0.0, serwer https://api.mrpeasy.com/rest/v2) jest na wczesnym etapie rozwoju. Dodaje /workstation-groups z polami work_hours i holidays, /workstations z polami productivity i idle, a także /inventory, /stock-movement oraz metodę PATCH. Obsługa zleceń produkcyjnych pozostaje w v1.

Zwróć uwagę na nazewnictwo. Workstation group w interfejsie MRPeasy odpowiada work-center-types w v1 (type_id). Workstation odpowiada work-centers (center_id). Operacje w marszrucie technologicznej wskazują przez type_id grupę, a nie maszynę.

API jest dostępne w planie Unlimited MRPeasy dla płatnych kont. MRPeasy zaznacza też: „Our Support Department cannot help you using the API.” (Nasz dział wsparcia nie może pomóc w korzystaniu z API). Dlatego integracja wymaga wskazania strony odpowiedzialnej: SkyPlanner, konsultanta MRPeasy lub programisty. Zespół SkyPlanner zajmuje się właśnie tym podczas wdrożenia.

Na stronie z cennikiem MRPeasy widnieje „API, webhooks (for paid accounts)” (API i webhooki dla płatnych kont), ale specyfikacje v1 i v2 nie dokumentują żadnych zdarzeń webhook dla zleceń produkcyjnych. Dlatego integracja odpytuje MRPeasy przyrostowo:

• Zlecenia produkcyjne są filtrowane według statusów Not scheduled (15), Scheduled (20), In progress (30) i Paused (35).
• Zamówienia zakupu i stany magazynowe są pobierane cyklicznie lub przed każdym uruchomieniem harmonogramowania.
• Dane podstawowe są pobierane po zmianie lub co noc.

Sekwencyjne odpytywanie z filtrowaniem pozostawia duży zapas do limitu 100 żądań na 10 sekund. W przeciwnym kierunku webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco, więc zapis zwrotny jest sterowany zdarzeniami.

1. Początkowy import danych podstawowych. Pobierz kartoteki indeksów, jednostki, BOM i marszruty technologiczne z v1, a grupy stanowisk roboczych i stanowiska robocze z v1 lub v2. Kalendarze pobierz z /workstation-groups w v2 (work_hours, holidays) lub ustaw zmiany robocze bezpośrednio w SkyPlanner. Dla każdej grupy Active processing utwórz odpowiadającą jej grupę stanowisk roboczych w SkyPlanner i przypisz do niej stanowiska z grupy źródłowej.

2. Synchronizacja zleceń i zamówień. Odczytaj otwarte zlecenia produkcyjne wraz z operacjami, a także otwarte zamówienia zakupu i stany magazynowe. SkyPlanner uznaje zamówiony materiał za dostępny w terminie dostawy podanym w zamówieniu zakupu i aktualizuje stan magazynowy, gdy zamówienie otrzyma status Delivered. Przy każdym przeliczeniu harmonogramu sprawdzane są zarówno zapasy, jak i oczekiwane dostawy z zamówień zakupu.

3. Zapis zwrotny harmonogramu. PUT /manufacturing-orders/{id} obsługuje pola code, quantity, due_date i assigned_id oraz pola niestandardowe w postaci custom_<id>. Jeśli tak uzgodniono, SkyPlanner zapisuje planowane zakończenie w polu due_date, a planowane rozpoczęcie, planowane zakończenie i postęp realizacji — w polach niestandardowych MRPeasy. Dzięki temu działy sprzedaży i zakupów pracujące w MRPeasy widzą rzeczywisty harmonogram. Szczegółowa kolejność operacji i przypisanie stanowisk do poszczególnych operacji pozostają w SkyPlanner, który służy do przekazywania zadań na halę produkcyjną.

4. Zlecenia tworzone poza MRPeasy. Jeśli zlecenia są tworzone przez API, POST /manufacturing-orders przyjmuje parametry no_scheduling i no_bookings. Użyj ich, aby MRPeasy nie rezerwował stanowisk roboczych, których pracę harmonogramuje już SkyPlanner.

5. Potwierdzanie pracy na hali. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations, Production Timer lub Quick Log Mode, a harmonogram jest na bieżąco aktualizowany na podstawie zapisów czasu pracy. Wybierz jeden kanał raportowania. Równoległe korzystanie z Internet-kiosk MRPeasy i SkyPlanner do rejestrowania tych samych operacji tworzy dwa sprzeczne obrazy sytuacji.

6. Odpowiedzialność za dane i zasady rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:

Projektowanie na zamówienie. W jednym ze zrealizowanych projektów integracji z MRPeasy każdy projekt klienta przekłada się na produkt główny i od jednego do trzech półproduktów. Każdy ma własny BOM i marszrutę technologiczną w MRPeasy, a zlecenie produkcyjne istnieje w obu systemach. Każde zlecenie powinno mieć stały, wspólny identyfikator, aby aktualizacje nigdy nie tworzyły duplikatów.

• Pola czasu różnią się zależnie od interfejsu. Polom Setup time, Cycle time i Capacity w interfejsie użytkownika odpowiadają w API pola fixed_time, variable_time i variable_quantity. Wartość Capacity powyżej 1 oznacza przetwarzanie partiami, na przykład w piecu. Odwzoruj je jako operację wykonywaną partiami, a nie dłuższy cykl.
• Grupy Passive processing. Grupy suszenia i chłodzenia działają 24/7 bez ograniczeń zdolności produkcyjnych. Odwzoruj je jako czasy oczekiwania, a nie stanowiska robocze o ograniczonej zdolności produkcyjnej.
• W v1 brakuje kalendarzy. work-centers zwraca tylko center_id, type_id, code i title. Korzystaj z v2 lub zarządzaj zmianami roboczymi w SkyPlanner.
• Czas przestoju. Czas przestoju stanowiska roboczego obejmuje konserwację i przerwy w pracy. Synchronizuj te dane, inaczej SkyPlanner zaplanuje pracę na niedostępnej maszynie.
• Marszruty technologiczne wskazują grupy. MRPeasy wybiera maszynę o najlepszej dostępności. W SkyPlanner stanowiska robocze należące do grupy stają się rzeczywistymi alternatywami, spośród których wybiera silnik planowania.