Przewodnik po integracji Epicor Kinetic ze SkyPlanner APS do harmonogramowania produkcji

Epicor podaje: „All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Wszystkie usługi Kinetic, w tym obiekty biznesowe, procesy, raporty, zapytania BAQ i Epicor Functions, są dostępne przez endpointy REST). Integracja do harmonogramowania opiera się na czterech technologiach Epicor:

1. Kinetic REST API v2 (OData v4). Obiekty biznesowe są udostępniane jako usługi o nazwach Erp.BO.<Name>Svc. Typowa ścieżka to /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 jest nadal dostępny, ale to starsza wersja, dlatego integrację należy oprzeć na v2. Zestawy encji i metody dostępne w używanej wersji sprawdź w REST Help pod adresem /api/help/v2/.
2. Business Activity Queries (BAQ) przez REST. Zapytanie BAQ jest udostępniane pod adresem /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. To praktyczny sposób pobierania danych do planowania: jednym wywołaniem można połączyć JobHead, JobOper, JobMtl, PartWhse i PORel (przykład ze społeczności).
3. Epicor Functions (EFx). Funkcje działające po stronie serwera, wywoływane pod adresem /api/v2/efx/{Company}/{Library}/{Function}. Epicor podaje, że funkcje te „can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (mogą być uruchamiane z wielu punktów, w tym przez BPM, usługi REST, harmonogramy i zdarzenia aplikacji).
4. Dyrektywy BPM. Method Directives i Data Directives uruchamiają się po zmianie zlecenia lub operacji i mogą wywołać funkcję wysyłającą dane na zewnątrz.

W przypadku plików DMT obsługuje import, a eksporty BAQ służą do pobierania danych z systemu. Epicor oferuje również Epicor Automation Studio, które opisuje jako „a low-code app for integration-led automations” (aplikację low-code do automatyzacji opartych na integracji). Nie korzystaj z bezpośredniego dostępu do bazy danych: REST, zapytania BAQ i funkcje działają tak samo w instalacji lokalnej i w Kinetic Cloud.

Epicor nie dokumentuje uniwersalnego API do wychodzących webhooków, dlatego zmiany z Kinetic trafiają do SkyPlanner na jeden z dwóch sposobów:

• Reakcja na zdarzenia. Dyrektywa BPM Data Directive dla JobHead lub JobOper wywołuje funkcję Epicor Function, która wysyła zmienione zlecenie do interfejsu REST API SkyPlanner.
• Cykliczne odpytywanie. Zapytanie BAQ z filtrem według daty zmiany uruchamia się co kilka minut lub co godzinę. Takie rozwiązanie jest prostsze w utrzymaniu i łatwiejsze do przywrócenia po awarii.

W przeciwnym kierunku SkyPlanner wysyła zmiany stanu i harmonogramu przez swoje webhooki. Odbiera je oprogramowanie pośredniczące lub endpoint EFx i zapisuje w Kinetic.

1. Początkowy import danych podstawowych. Pobierz dane części, grup zasobów produkcyjnych, zasobów produkcyjnych, zdolności, kalendarzy i pracowników. Na podstawie zasobów w Kinetic utwórz stanowiska robocze w SkyPlanner, a na podstawie grup zasobów — grupy stanowisk roboczych. Duże zbiory pobieraj stronami za pomocą $top i $skip lub zbiorczo przez BAQ.

2. Synchronizacja zleceń. Przesyłaj zlecenia zwolnione do produkcji i zatwierdzone wraz z ich operacjami i materiałami. Pobieraj całe drzewo zlecenia za pomocą GetDatasetForTree lub BAQ, zamiast pobierać każdą encję osobno. Niezatwierdzone zlecenia MRP pozostaw w Kinetic do czasu ich zatwierdzenia. Wraz ze stanami magazynowymi synchronizuj otwarte harmonogramy dostaw zamówień zakupu i ich terminy. SkyPlanner traktuje zamówiony materiał jako dostępny w dniu dostawy i aktualizuje stan magazynowy po oznaczeniu zamówienia zakupu statusem Delivered. Dzięki temu harmonogram uwzględnia zarówno zapasy, jak i oczekiwane dostawy.

3. Zapis harmonogramu w Kinetic. Webhook SkyPlanner wysyła planowany początek, koniec i stanowisko robocze każdej operacji do punktu końcowego EFx (/api/v2/efx/{Company}/{Library}/{Function}). Funkcja zapisuje dane przez silnik harmonogramowania Kinetic — ten sam obiekt biznesowy, z którego korzystają harmonogramowanie w Job Entry i tablice harmonogramowania (przykład ze społeczności):

1. ScheduleEngine.GetNewParamsForJob tworzy dla zlecenia zbiór danych silnika harmonogramowania.
2. Funkcja ustawia numer zlecenia, numery sekwencyjne zespołu i operacji oraz planowaną datę i godzinę rozpoczęcia, a następnie wywołuje ScheduleEngine.MoveJobItem.
3. Jeśli SkyPlanner przypisał operację do innego zasobu w grupie, ScheduleEngine.ChangeResource przenosi ją na ten zasób. Samo MoveJobItem pozostawia domyślny zasób grupy.
4. Funkcja ustawia blokadę harmonogramu zlecenia (JobHead.SchedLocked, opcja Lock w Job Entry), dzięki czemu Global Scheduling zachowuje daty ze SkyPlanner.

Objęcie tych wywołań jedną funkcją Epicor Function zapewnia atomowy zapis dla każdego zlecenia i pozwala dodać własną walidację. Jeśli zakład nie chce korzystać z własnej funkcji, tę samą sekwencję można wykonać bezpośrednimi wywołaniami REST do Erp.BO.ScheduleEngineSvc. Nigdy nie zapisuj bezpośrednio danych w ResourceTimeUsed ani w polach dat JobOper: omija to silnik i powoduje rozbieżności w przydziałach na tablicach harmonogramowania.

4. Meldunki z hali produkcyjnej. Operatorzy rejestrują pracę w SkyPlanner za pomocą Mobile Confirmations, Production Timer lub Quick Log Mode. Każdy zamknięty zapis czasu pracy trafia do ewidencji pracy w Kinetic przez Erp.BO.LaborSvc: StartActivity i EndActivityByEmp służą do rejestracji na bieżąco, a Labors z Update — do wpisów wprowadzanych po wykonaniu pracy. Jeśli zakład wymaga zatwierdzania, uwzględnij submitForApproval w przepływie i zakresie uprawnień.

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

Zlecenia harmonogramowane przez SkyPlanner mają włączoną blokadę harmonogramu, więc Global Scheduling nie zmienia ich terminów. Dla zasobów produkcyjnych nieplanowanych przez SkyPlanner pozostaw harmonogramowanie w Kinetic.

Wdrożenie zazwyczaj kończy się w ciągu kilku tygodni od rozpoczęcia prac. Projekt integracji z Kinetic obejmuje:

1. 30-dniowy okres próbny na danych zleceń, operacji i zasobów produkcyjnych wyeksportowanych do plików CSV lub Excel, jeszcze przed rozpoczęciem prac programistycznych.
2. Klucz API, zakres dostępu, osobne konto użytkownika do integracji i zapytania BAQ, z których integracja odczytuje dane.
3. Mapowanie danych podstawowych: zdolności wykonawczych, grup zasobów, zasobów produkcyjnych, kalendarzy i pracowników na stanowiska, grupy, zmiany i personel w SkyPlanner.
4. Początkowy import indeksów, technologii produkcji (BOM i operacji) oraz zasobów produkcyjnych.
5. Synchronizacja zleceń i zamówień zakupu (terminy PORel) oraz stanów magazynowych PartWhse.
6. Zapis planowanych terminów operacji w Kinetic przez ScheduleEngineSvc (MoveJobItem, ChangeResource) w funkcji Epicor Function, z ustawieniem blokady harmonogramu zlecenia.
7. Meldunki z hali produkcyjnej zapisywane w ewidencji pracy przez LaborSvc.
8. Testy równolegle z bieżącym harmonogramem Kinetic, a następnie uruchomienie produkcyjne.

Nie ma dwóch zakładów, które korzystają z Kinetic w ten sam sposób. Dobór zasobów według zdolności wykonawczych, kalendarze grup zasobów, konstrukcja zapytań BAQ, dyrektywy BPM i metody zapisu zwrotnego właściwe dla danej wersji różnią się między zakładami. Od ich poprawnej konfiguracji zależy, czy planiści będą ufać harmonogramowi, czy go poprawiać.

1. Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Mapuje zasoby produkcyjne, zlecenia i harmonogramy dostaw z zamówień zakupu oraz konfiguruje odczyt zapytań BAQ, wyzwalacze BPM i funkcję zapisu zwrotnego. Łączy API REST i webhooki SkyPlanner z Kinetic REST v2. Wsparcie obejmuje również późniejsze zmiany zapytań BAQ, dyrektyw BPM lub wersji Kinetic.
2. Twój partner Epicor. Partnerzy, którzy już tworzą zapytania BAQ, dyrektywy BPM i Epicor Functions, mogą korzystać z tego samego udokumentowanego API REST SkyPlanner. Umożliwia ono odczyt i zapis zleceń, produktów, materiałów, etapów procesu i wpisów czasu pracy.
3. Twoi programiści. Wewnętrzne zespoły z doświadczeniem w Kinetic REST mogą tworzyć integrację bezpośrednio lub w Automation Studio, jeśli z niego korzystasz. Do rozpoczęcia wystarczy klucz API SkyPlanner (samouczek integracji), a zespół SkyPlanner pomaga w razie potrzeby. Publicznie dostępną dokumentację produktu znajdziesz w dokumentacji SkyPlanner.

Ten sam model integracji oparty na API i webhookach działa produkcyjnie z innymi systemami ERP, na przykład w UTU. W Laboratory & Allied wewnętrzny zespół IT zbudował integrację z SAP Business One w dużej mierze samodzielnie, przy wsparciu SkyPlanner.

Każda ścieżka zaczyna się tak samo: najpierw skorzystaj z 30-dniowego bezpłatnego okresu próbnego na danych zaimportowanych z CSV, sprawdź harmonogram, a następnie zbuduj integrację. Ceny zaczynają się od 199 € miesięcznie za 5 stanowisk, z rozliczeniem miesięcznym i możliwością rezygnacji w dowolnym momencie. Integrację wyceniamy z góry, zgodnie z Twoim procesem i potrzebami, razem z wybranym planem. Pełny koszt znasz więc przed rozpoczęciem.