Integracje / ERP / HELIOS
Przewodnik po integracji HELIOS z systemem SkyPlanner APS do planowania produkcji
Ten przewodnik po integracji HELIOS pokazuje partnerom i zespołom IT, jak połączyć HELIOS iNuvio i HELIOS Nephrite ze SkyPlanner APS. SkyPlanner integruje się z HELIOS dwukierunkowo, korzystając z interfejsów tego systemu:
- Do SkyPlanner trafiają zlecenia produkcyjne (výrobní příkazy) wraz z operacjami, produkowanymi częściami, zestawieniami materiałowymi (BOM), marszrutami technologicznymi, stanowiskami, maszynami, zawodami, zasobami kadrowymi, stanami magazynowymi i zamówieniami zakupu.
- Planowane daty rozpoczęcia i zakończenia są zapisywane zwrotnie w zleceniach produkcyjnych.
- Jeśli wybierzesz taką opcję, wpisy czasu pracy operatorów mogą być zapisywane zwrotnie jako ewidencja operacji (evidence výrobních operací).
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do konfiguracji HELIOS i zapewnia jej wsparcie po uruchomieniu produkcyjnym. Ten przewodnik jest przeznaczony dla partnerów i programistów HELIOS, którzy chcą uczestniczyć w pracach lub samodzielnie tworzyć rozwiązania na bazie udokumentowanego REST API SkyPlanner (dokumentacja API).
Interfejsy integracyjne HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco opisuje go jako odrębny komponent HELIOS iNuvio, który zapewnia dostęp przez REST API do obszarów funkcjonalnych HELIOS iNuvio (pomoc Helios Inuvio Server). Jest dostarczany wraz z dystrybucją iNuvio, a specyfikacja OpenAPI jest publikowana w formatach Rapidoc i Redoc. API działa na przeglądach HELIOS (browses), z których każdy ma własny identyfikator i uprawnienia:
- GET /browses/list i GET /browses/meta zwracają listę dostępnych przeglądów oraz ich kolumn.
- /browses/data odczytuje wiersze przeglądu i umożliwia ich zapis tam, gdzie przegląd zezwala na tworzenie, aktualizację i usuwanie.
- /api/v1/actions/meta i /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} służą do uruchamiania akcji zewnętrznych w przeglądzie. Obecnie są to akcje zewnętrzne typu Procedure, Browse i Plugin.
Przeglądy produkcyjne używane do harmonogramowania obejmują plan produkcji (výrobní plán), zlecenia produkcyjne (výrobní příkazy), części w zleceniach produkcyjnych, materiały i półprodukty do produkcji, zawody, zasoby kadrowe, predefiniowane ustawienia operacji marszruty oraz ewidencję operacji. W ten sam sposób dostępne są stany magazynowe, przyjęcia, wydania i wystawione zamówienia zakupu (vydané objednávky).
HELIOS Nephrite REST API. Plan rozwoju Nephrite obejmuje rozwój REST API (plan rozwoju HELIOS Nephrite). Podczas określenia zakresu zespół SkyPlanner wspólnie z Tobą i Twoim partnerem HELIOS potwierdza endpointy Nephrite dostępne w Twojej instalacji. Opisane poniżej przepływy danych pozostają takie same.
Excel i CSV. Każdy przegląd HELIOS umożliwia eksport do Microsoft Office, co wystarcza do próbnego importu danych.
Uwierzytelnianie i licencjonowanie
- Dwie metody uwierzytelniania. iNuvio oferuje starsze, autorskie API uwierzytelniania (/api/token) oraz nowsze API OAuth2 oparte na RFC 6749 (/oauth/token, /oauth/revoke). Tokeny są odświeżane przez POST /oauth/token lub GET /api/token.
- Licencjonowanie. Sam Helios Inuvio Server jest bezpłatny, natomiast REST API wymaga licencji. Od wersji 3.0.2026.0301 API systemowe i API obszarów funkcjonalnych są połączone w jedno Inuvio REST API, a dostęp do API nie jest już ograniczony liczbą użytkowników.
- Uprawnienia. Użytkownik integracyjny potrzebuje uprawnień do odczytu przeglądów produkcyjnych i magazynowych oraz do uruchamiania uzgodnionych akcji zewnętrznych.
Po stronie SkyPlanner uwierzytelnianie w REST API odbywa się za pomocą tokenu API w nagłówku Authorization-Token (SkyPlanner Settings > API). Dokumentacja jest dostępna w Swagger/OpenAPI. Samouczek integracji prowadzi przez pierwsze wywołania.
Zdarzenia i cykliczne odpytywanie
SkyPlanner odczytuje dane z HELIOS w ustalonych odstępach czasu. Wywołania /browses/data z filtrami otwartych zleceń produkcyjnych i ostatnich zmian pobierają nowe prace do zaplanowania. Częstotliwość ustala się osobno dla każdego zakładu: zlecenia produkcyjne są odczytywane co kilka minut, a stany magazynowe co godzinę.
SkyPlanner wysyła webhooki przy zmianach stanu lub harmonogramu, więc zapis zwrotny jest wyzwalany zdarzeniami.
Mapowanie danych
| Obiekt HELIOS (przegląd) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
| Kartoteki pozycji i produkowane części (vyráběné dílce), jednostki miary | Produkty i materiały | HELIOS → SkyPlanner | Import początkowy, następnie cykliczne odpytywanie |
| Zestawienia materiałowe BOM (kusovník, kusovníkové vazby) z okresem obowiązywania | Struktura produktu, podprodukty, materiały przypisane do produktu | HELIOS → SkyPlanner | Wczytanie początkowe, potem przy zmianach |
| Marszruty technologiczne (technologický postup): operacja, stanowisko, czas przygotowania maszyny i operatora, czas jednostkowy, czas czynności końcowych, czas międzyoperacyjny | Etapy procesu wraz z czasem trwania oraz czasami przygotowania i czynności końcowych | HELIOS → SkyPlanner | Wczytanie początkowe, potem przy zmianach |
| Stanowiska (pracoviště), maszyny (stroje), stanowiska alternatywne | Stanowiska robocze, grupy stanowisk roboczych, alternatywne stanowiska robocze | HELIOS → SkyPlanner | Wczytanie początkowe, później rzadko |
| Zawody (výrobní profese), zasoby kadrowe (výrobní personální zdroje) | Personel i liczba operatorów na operację | HELIOS → SkyPlanner | Import początkowy, następnie przy zmianach |
| Kalendarze planistyczne (plánovací kalendáře) | Zmiany robocze i dni wolne od pracy | HELIOS → SkyPlanner | Codziennie lub własne zmiany robocze w SkyPlanner |
| Zlecenia produkcyjne (výrobní příkazy), części i operacje w zleceniach, materiały do produkcji | Zlecenia i operacje z terminami realizacji i zapotrzebowaniem materiałowym | HELIOS → SkyPlanner | Odpytywanie co kilka minut |
| Stan magazynu (stav skladu) | Stany magazynowe | HELIOS → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Wystawione zamówienia zakupu (vydané objednávky) z datami dostawy | Zamówienia zakupu, oczekiwane materiały według dat dostawy | HELIOS → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Planowany początek i koniec każdej operacji zlecenia produkcyjnego (akcja zewnętrzna) | Planowany początek i koniec każdej operacji | SkyPlanner → HELIOS | Przy zmianie harmonogramu, przez webhook SkyPlanner |
| Ewidencja operacji (evidence výrobních operací) | Wpisy czasu pracy i potwierdzenia operatorów | SkyPlanner → HELIOS | Przy każdym potwierdzeniu lub po każdej zmianie roboczej, jeśli wybrano tę opcję |
| Brak w HELIOS | Macierz czasów przezbrojeń, narzędzia jako zasoby o ograniczonej dostępności, operacje wymagające wielu operatorów | Utrzymywane w SkyPlanner | Konfigurowane podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Pobierz z przeglądów TPV produkowane części, zestawienia materiałowe BOM, marszruty technologiczne, stanowiska, maszyny, zawody, zasoby kadrowe i kalendarze. Każdy zasób w HELIOS ma znacznik uwzględnienia w planowaniu zdolności produkcyjnych. Dla każdego z nich zdecyduj więc, czy ma go uwzględniać harmonogram SkyPlanner. Stanowisko z czterema maszynami staje się jedną grupą stanowisk roboczych lub czterema stanowiskami roboczymi.
2. Synchronizacja zleceń. Pobierz zlecenia produkcyjne wraz z częściami, operacjami i materiałami oraz wystawione zamówienia zakupu. SkyPlanner uznaje zamówiony materiał za dostępny w dniu dostawy określonym w zamówieniu zakupu i aktualizuje stan magazynowy, gdy zamówienie otrzyma status Delivered. Harmonogramuj zlecenia produkcyjne zwolnione do realizacji. Ilości zaplanowane w planie produkcji pozostają w HELIOS, dopóki nie zostaną przekształcone w zlecenia produkcyjne.
3. Zapis zwrotny harmonogramu. Gdy silnik planujący umieszcza operację w harmonogramie lub ją przesuwa, webhook SkyPlanner uruchamia akcję zewnętrzną w przeglądzie zleceń produkcyjnych przez /api/v1/actions/execute. Akcja ta jest procedurą HELIOS uzgodnioną podczas określenia zakresu. Ustawia planowany początek i koniec operacji zlecenia. HELIOS weryfikuje zmianę zgodnie z własną logiką.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer, a wpisy czasu pracy zapewniają aktualność harmonogramu. To Ty decydujesz, czy rzeczywiste czasy mają być zapisywane zwrotnie w HELIOS. Jeśli tak, akcja zewnętrzna zapisuje je w ewidencji operacji dla każdej operacji zlecenia. Jeśli nie, operatorzy nadal raportują na terminalach HELIOS, a SkyPlanner odczytuje te zapisy.
5. Odpowiedzialność za dane i reguły rozwiązywania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Pozycje, zestawienia materiałowe BOM, marszruty technologiczne, ilości, status zlecenia | HELIOS |
| Kolejność operacji, czasy rozpoczęcia i zakończenia, przypisanie maszyn | SkyPlanner |
| Macierz czasów przezbrojeń, wymagania dotyczące narzędzi i operatorów, zasoby alternatywne | SkyPlanner |
| Zmiany i dni wolne od pracy | Jeden system, wybrany na etapie określania zakresu |
| Ewidencja operacji, wydania i przyjęcia materiałów | HELIOS — dane wprowadzane bezpośrednio lub przesyłane z wpisów czasu pracy SkyPlanner |
Wybierz jeden system odpowiedzialny za zapis dat zleceń. Jeśli moduł planowania zdolności produkcyjnych HELIOS lub Nephrite APS nadal zapisuje daty, wyłącz tę funkcję dla zleceń harmonogramowanych przez SkyPlanner albo pozostaw plan HELIOS wyłącznie jako plan testowy.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia prac. Wcześniej zweryfikuj harmonogram w ramach 30-dniowego bezpłatnego okresu próbnego, korzystając ze stanowisk, marszrut technologicznych i otwartych zleceń produkcyjnych wyeksportowanych z HELIOS do CSV lub Excela.
- Mapowanie. Ustal tabelę mapowania, zasady odpowiedzialności za dane, częstotliwość synchronizacji oraz to, czy ewidencja operacji ma być zapisywana zwrotnie.
- Dostęp do HELIOS. Skonfiguruj Helios Inuvio Server, użytkownika integracyjnego, dane uwierzytelniające OAuth2 i licencję REST API. Najpierw przeprowadź testy na kopii bazy danych.
- Import początkowy. Produkowane części, zestawienia materiałowe BOM, marszruty technologiczne, stanowiska, maszyny, zawody, kalendarze.
- Synchronizacja zleceń i zamówień zakupu. Cykliczne odpytywanie z filtrami, stronicowaniem i ponawianiem prób.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przezbrojeń, narzędzia, liczba operatorów dla każdej operacji oraz alternatywne maszyny lub pracownicy.
- Zapis zwrotny harmonogramu. Utwórz i przetestuj akcje zewnętrzne do zapisu planowanych dat oraz, jeśli wybrano tę opcję, ewidencji operacji.
- Testy równoległe. Twórz harmonogram w SkyPlanner równolegle z obecnym planem, porównaj daty i popraw dane podstawowe.
- Uruchomienie produkcyjne. Włącz zapis zwrotny, gdy dane będą zgodne.
Co uwzględnić przy integracji z HELIOS
- Znaczniki planowania. Tylko zasoby oznaczone do uwzględnienia w planowaniu zdolności produkcyjnych mają wiarygodne dane o tych zdolnościach. Przed pierwszym importem sprawdź znaczniki stanowisk, maszyn, zawodów i podwykonawstwa.
- Jednostki czasu. Czas przygotowania, czas jednostkowy i czas czynności końcowych można wprowadzać w godzinach, minutach lub sekundach. Przelicz je podczas importu, inaczej wszystkie czasy trwania będą błędne.
- Czas międzyoperacyjny. Stały czas międzyoperacyjny to oczekiwanie między operacjami, a nie czas pracy maszyny. Modeluj go jako oczekiwanie, bez obciążania zdolności produkcyjnych.
- Operacje kooperacyjne (kooperace). Czas transportu obejmuje drogę do kooperanta i z powrotem. Modeluj kooperację jako etapy uwzględniające wyłącznie czas.
- Przeglądy z możliwością zapisu. Każdy przegląd obsługuje odczyt, ale tylko niektóre pozwalają tworzyć, aktualizować i usuwać dane. Żądanie GET /browses/list z filtrem browseCreateImplemented=1 wskazuje, które z nich to umożliwiają. Przeglądy zleceń produkcyjnych są dostępne tylko do odczytu, dlatego planowane terminy są przekazywane z powrotem przez uzgodnioną akcję zewnętrzną.
Kto konfiguruje i wspiera integrację z HELIOS
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym, w zakresie uzgodnionych zestawień i akcji zewnętrznych. Każdy zakład korzysta z HELIOS inaczej — konfiguracja uwzględnia tę specyfikę.
- Twój partner HELIOS może uczestniczyć we wdrożeniu. Zna Twoją instalację, niestandardowe procedury i warunki licencyjne. Może wspólnie z zespołem SkyPlanner skonfigurować Helios Inuvio Server i akcje zewnętrzne.
- Twoi programiści mogą rozwijać integrację, korzystając z REST API SkyPlanner i tokena API. Do rozpoczęcia prac wystarczy token API, a zespół SkyPlanner pomaga w razie potrzeby. Szczegóły znajdziesz w dokumentacji integracji SkyPlanner.
SkyPlanner kosztuje od 199 € miesięcznie za 5 stanowisk roboczych, z rozliczeniem co miesiąc. Integrację wyceniamy z góry wraz z abonamentem, zgodnie z Twoim procesem i potrzebami. Zobacz cennik, harmonogramowanie produkcji z HELIOS, stronę HELIOS oraz przegląd integracji z ERP. Podstawy opisujemy na stronie o harmonogramowaniu produkcji.
Opinie firm produkcyjnych o SkyPlanner
2 hoszczędności co tydzień
„Dzięki SkyPlanner przeszliśmy od planowania produkcji w arkuszach Excela do jej optymalizacji w czasie rzeczywistym.”
Kalle Kalliomäki, specjalista ds. łańcucha dostaw
UTU · Rozdzielnice elektryczne i aparatura rozdzielcza
Planowanie produkcji pozwala zaoszczędzić 2 godziny pracy tygodniowo, a nowa kolejka operacji trafia na linię w ciągu kilku sekund.
+90%wydajności produkcji
„Wydajność produkcji wzrosła o 90%.”
Abdul Rucyinga, kierownik IT
Laboratory & Allied · Produkcja farmaceutyczna
Wydajność produkcji wzrosła o 90%, a przygotowanie zoptymalizowanego planu na trzy miesiące dla wszystkich stanowisk roboczych zajmuje mniej niż 30 minut.
1 000 i więcejzleceń produkcyjnych zaplanowanych automatycznie
„Mamy zupełnie inną kontrolę nad produkcją, a nasza wiedza o zdolnościach produkcyjnych jest na całkiem innym poziomie.”
Hannu Ryynänen, prezes
Mamec · Mieszalniki przemysłowe, pompy i zaawansowana technologicznie produkcja kontraktowa
Tysiące zleceń produkcyjnych są planowane automatycznie, a cała organizacja ma wgląd w produkcję w czasie rzeczywistym.
100%terminowości dostaw od 2021 roku
„SkyPlanner daje nam wgląd w zdolności produkcyjne i sprawia, że planowanie staje się przewidywalne.”
Dan Berglund, COO/CFO
Opes Corporation · Produkcja chemiczna i spożywcza
Terminowość dostaw wynosi 100% przez cały okres korzystania ze SkyPlanner, od 2021 roku.
Najczęściej zadawane pytania
Czy HELIOS udostępnia API do zleceń produkcyjnych?
Tak. Helios Inuvio Server zapewnia dostęp przez REST do zestawień HELIOS iNuvio, w tym planu produkcji, zleceń produkcyjnych, pozycji zleceń, materiałów do produkcji i rejestrów operacji. W przypadku HELIOS Nephrite zespół SkyPlanner ustala sposób integracji dla Twojej instalacji wspólnie z Tobą i Twoim partnerem HELIOS podczas określania zakresu wdrożenia.
Jak SkyPlanner pobiera zmiany z HELIOS?
SkyPlanner cyklicznie odpytuje zestawienia HELIOS według harmonogramu ustalonego dla danego zakładu, ograniczając pobierane dane do otwartych zleceń produkcyjnych i ostatnich zmian. Własne webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Jak planowane terminy są zapisywane z powrotem w HELIOS?
Przez akcję zewnętrzną w zestawieniu zleceń produkcyjnych, uruchamianą za pomocą /api/v1/actions/execute. Akcja jest procedurą HELIOS uzgodnioną podczas określania zakresu, więc HELIOS stosuje własną logikę do każdego otrzymanego terminu.
Z jakiego uwierzytelniania korzysta Inuvio REST API?
Z OAuth2 zgodnego z RFC 6749 pod adresem /oauth/token lub ze starszego, autorskiego mechanizmu /api/token. API SkyPlanner korzysta z tokena API w nagłówku Authorization-Token.
Czy partner HELIOS powinien proponować HELIOS APS czy SkyPlanner?
SkyPlanner, gdy plan klienta często się zmienia, a planowanie musi uwzględniać rzeczywiste ograniczenia zdolności produkcyjnych. Planowanie w HELIOS opiera się na obliczeniach dla jednego aktywnego planu, może przejść na nieograniczone zdolności produkcyjne, aby dotrzymać terminów, a rozwiązywanie kolizji pozostawia planiście (pomoc HELIOS). SkyPlanner łączy się przez REST API, automatycznie aktualizuje plan i uwzględnia przezbrojenia, narzędzia, zespoły pracowników oraz materiały. Jest dostępny od 199 € miesięcznie, bez limitu użytkowników.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. Bezpłatny 30-dniowy okres próbny pozwala korzystać z maksymalnie 20 stanowisk roboczych i importować dane z HELIOS w formacie CSV lub Excel. Karta kredytowa nie jest wymagana. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.