Przewodnik po integracji Katana ze SkyPlanner APS do harmonogramowania produkcji

Katana to jeden produkt chmurowy w architekturze wielodostępnej, więc wszyscy klienci korzystają z tego samego API. Jest to REST API w wersji v1, dostępne pod adresem https://api.katanamrp.com/v1. Specyfikacja OpenAPI 3.0 znajduje się pod adresem https://api.katanamrp.com/v1/openapi.json, a dokumentacja — w Katana Developer Hub.

Endpointy potrzebne do harmonogramowania:

• Dane podstawowe: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Zlecenia: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Kolejność: /manufacturing_order_rerank.
• Zaopatrzenie i zapotrzebowanie: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Nie ma endpointu /resources. Zasoby produkcyjne są dostępne jako pola resource_id i resource_name w wierszach operacji produktów oraz zleceń produkcyjnych.

Zarejestruj webhook za pomocą POST /webhooks, podając adres HTTPS i potrzebne zdarzenia. (źródło) Zdarzenia przydatne przy harmonogramowaniu:

• manufacturing_order.created, .updated, .deleted, .in_progress, .blocked, .done
• manufacturing_order_operation_row.created, .updated, .in_progress, .paused, .completed
• current_inventory.material_updated, .material_out_of_stock
• purchase_order.* i purchase_order_row.*, w tym zdarzenia przyjęcia dostawy
• product.*, product_recipe_row.* i sales_order.*

Przesyłane dane są skromne: typ zasobu, akcja i href. Odbiorca pobiera pełny obiekt spod adresu href. Każde powiadomienie zawiera nagłówek x-sha2-signature (HMAC SHA-256) służący do weryfikacji. Twój endpoint musi zwrócić odpowiedź 20X w ciągu 10 sekund. Katana ponawia wysyłkę trzy razy: po 30 sekundach, 2 minutach i 15 minutach.

1. Początkowy import danych podstawowych. Pobieraj kolejne strony produktów, materiałów, wariantów, wierszy receptur i wierszy operacji produktów, nie przekraczając limitu żądań. Na podstawie unikalnych zasobów produkcyjnych z wierszy operacji utwórz stanowiska robocze w SkyPlanner i zachowaj powiązanie kluczy 1:1. Dla każdego stanowiska roboczego ustaw w SkyPlanner zmiany, urlopy i nadgodziny, ponieważ Katana nie ma kalendarza zasobów produkcyjnych.

2. Synchronizacja zleceń. Subskrybuj zdarzenia dotyczące zleceń produkcyjnych, wierszy operacji, stanów magazynowych i zamówień zakupu. Po każdym zdarzeniu pobierz obiekt spod jego adresu href i zaktualizuj operację. SkyPlanner uznaje zamówiony materiał za dostępny w dniu dostawy wskazanym w zamówieniu zakupu i aktualizuje stan magazynowy po przyjęciu dostawy. Nocne uzgadnianie danych z filtrowaniem według daty aktualizacji wychwytuje wszystkie pominięte zdarzenia.

3. Zapis harmonogramu w Katana. Dwa wywołania przesyłają plan do Katana:

• POST /manufacturing_order_rerank „moves one or more manufacturing orders to an exact place in the production schedule” (przenosi jedno lub więcej zleceń produkcyjnych w określone miejsce w harmonogramie produkcji). Obsługuje do 250 otwartych zleceń produkcyjnych w jednym żądaniu i umieszcza je na początku, na końcu, przed wskazanym zleceniem lub po nim. (źródło)
• PATCH /manufacturing_orders/{id} ustawia pole production_deadline_date. Katana akceptuje tę wartość tylko wtedy, gdy automatyczne obliczanie terminu dla danej lokalizacji zakładu jest wyłączone. (źródło)

Zmiana kolejności ma znaczenie nie tylko dla samej listy. W Katana „higher-priority MOs reserve required materials and subassemblies first” (zlecenia produkcyjne o wyższym priorytecie jako pierwsze rezerwują wymagane materiały i podzespoły). Kolejność ustalona w SkyPlanner decyduje więc również o tym, któremu zleceniu Katana przydzieli zapasy.

4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations, Production Timer lub Quick Log Mode. SkyPlanner zapisuje status i rzeczywisty czas wykonania w wierszu operacji zlecenia produkcyjnego. Jeśli zakład zamiast tego pozostaje przy Katana Shop Floor App, SkyPlanner odczytuje zdarzenia dotyczące wierszy operacji. Wybierz jeden kanał raportowania dla każdego zakładu.

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

• Tryb automatyczny nadpisuje terminy. „Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Po włączeniu trybu automatycznego wszystkie ręcznie ustawione terminy zostaną nadpisane i nie będzie można ich przywrócić). Wybierz tryb raz, na początku projektu.
• Brak kalendarza zasobów produkcyjnych. Nie wyznaczaj zmian roboczych na podstawie pojedynczej wartości Weekly throughput. Skonfiguruj je w SkyPlanner osobno dla każdego stanowiska roboczego.
• Zasoby produkcyjne tylko w wierszach operacji. Nie zmieniaj nazw zasobów w Katana, ponieważ służą jako klucze do stanowisk roboczych w SkyPlanner.
• Jednostki czasu. planned_time_parameter jest podawany w sekundach: na jednostkę dla operacji z czasem określanym na jednostkę, a łącznie dla typów process, setup i fixed. Prawidłowo zmapuj typ, inaczej czas trwania będzie błędnie przemnożony lub podzielony przez ilość.
• Grupy w produkcji na zamówienie. Przy zmianie kolejności zlecenia produkcyjne powiązane z tym samym zamówieniem sprzedaży pozostają razem, dlatego ustalaj ich kolejność jako grupy.
• Zmieniło się działanie endpointów rerank. Od 7 października 2026 endpointy rerank umieszczają zlecenia dokładnie na wskazanych pozycjach. Integracje napisane z myślą o wcześniejszym działaniu wymagają ponownych testów. (źródło)