Integracje / ERP / proALPHA ERP
Przewodnik po integracji proALPHA ze SkyPlanner APS do harmonogramowania produkcji
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć Proalpha ERP ze SkyPlanner APS. Integracja SkyPlanner z Proalpha działa w obu kierunkach:
- Do SkyPlanner trafiają dane o częściach, zleceniach produkcyjnych wraz z operacjami, zasobach produkcyjnych, kalendarzach, zapasach i zamówieniach zakupu.
- Planowane terminy rozpoczęcia i zakończenia każdej operacji wracają przez setWorkOrderOperationDates.
- Zmiany zasobów produkcyjnych wracają przez changeWorkOrderOperationResource.
- Potwierdzenia operatorów wracają przez operationDataEntry.
- Webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Podczas wdrożenia zespół SkyPlanner konfiguruje integrację zgodnie z konfiguracją Proalpha i zapewnia jej wsparcie po uruchomieniu produkcyjnym. Ten przewodnik jest przeznaczony dla partnerów i programistów, którzy chcą uczestniczyć w pracach lub samodzielnie tworzyć rozwiązania oparte na udokumentowanym REST API SkyPlanner (dokumentacja API).
Interfejsy Proalpha
Proalpha ERP działa na platformie Progress OpenEdge, a w wydaniu Release 9 przeniesiono go na OpenEdge 12. (Proalpha) W harmonogramowaniu istotne są cztery interfejsy.
- Proalpha ERP REST APIs. Publiczny Proalpha API Portal zawiera 108 specyfikacji OpenAPI 3.0 pod ścieżką
api/web/v1. Te interfejsy służą do zapisu zwrotnego oraz odczytu danych o częściach i zapasach. - Integration Workbench (INWB). Jak podaje Proalpha, INWB „is a central platform which connects different IT systems, machines, sites” (jest centralną platformą łączącą różne systemy IT, maszyny i zakłady) oraz „converts the data into the format of the target system.” (przekształca dane do formatu systemu docelowego). (Proalpha) Odbiera komunikaty pAX przez
POST /api/web/v1/inwb/message. Użyj go do przesyłania zleceń produkcyjnych z Proalpha i do Proalpha. - Proalpha Integration Platform. Platforma oparta na n8n, zapowiedziana w kwietniu 2026, „will be available to customers either on-premises or in the cloud.” (będzie dostępna dla klientów lokalnie lub w chmurze). Proalpha „will rely on an API-centric reference architecture and REST interfaces.” (będzie korzystać z architektury referencyjnej opartej na API oraz interfejsów REST). (Proalpha)
- EDI i eksport plików. INWB obsługuje branżowe formaty plików, a eksport plików wystarcza na potrzeby okresu próbnego SkyPlanner.
Endpointy dotyczące produkcji
| API Proalpha | Endpoint | Zastosowanie w integracji |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Planowane rozpoczęcie i zakończenie każdej operacji (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Zasób produkcyjny wybrany podczas harmonogramowania (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Potwierdzenia: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Części z polami partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Zapasy według obszaru MRP |
Uwierzytelnianie
Opublikowane specyfikacje Proalpha przewidują uwierzytelnianie HTTP Basic. Adresy endpointów zależą od środowiska: {schema}://{host}:{port}/api/web/v1/..., na serwerze Proalpha lub w Proalpha Cloud. Utwórz osobne konto techniczne z uprawnieniami ograniczonymi do obiektów z tabeli mapowania. Wspólnie z zespołem IT zaplanuj dostęp sieciowy z chmury SkyPlanner do tego endpointu.
Po stronie SkyPlanner REST API korzysta z uwierzytelniania tokenem API (SkyPlanner Settings > API), a jego dokumentacja jest dostępna w Swagger/OpenAPI. Do rozpoczęcia pracy wystarczy token API. Samouczek integracji prowadzi przez pierwsze wywołania.
Zdarzenia i cykliczne odpytywanie
Proalpha API Portal nie zawiera API do subskrypcji webhooków. Zmiany z Proalpha są przekazywane przez:
- przepływ komunikatów INWB, który wysyła nowe i zmienione zlecenia produkcyjne wraz z ich operacjami
- przepływ pracy n8n na Proalpha Integration Platform
- cykliczne odpytywanie Material API o zapasy
SkyPlanner wysyła webhooki przy zmianach stanu lub harmonogramu, dzięki czemu zapis zwrotny do Proalpha jest wyzwalany zdarzeniami.
Mapowanie danych
| Obiekt lub API Proalpha | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
| Part (Part API) | Produkty i materiały | Proalpha → SkyPlanner | Import początkowy, następnie przy każdej zmianie |
| Model procesu produktu: proces, czynności; pozycje BOM zlecenia produkcyjnego | Struktura produktu, podzespoły, etapy procesu | Proalpha → SkyPlanner | Import początkowy, następnie przy każdej zmianie |
| Zlecenie produkcyjne (Fertigungsauftrag) z ilością i terminem realizacji | Zlecenie i operacje z terminem realizacji i priorytetem | Proalpha → SkyPlanner | Wysyłka przez INWB lub n8n albo co kilka minut |
| Operacje zlecenia produkcyjnego: targetSetupTime, targetProcessTime, resource | Etapy procesu z czasami przezbrojenia i czasami trwania | Proalpha → SkyPlanner | Wraz ze zleceniem produkcyjnym |
| Zasoby produkcyjne, grupy zasobów, alternatywne grupy zasobów | Stanowiska robocze, grupy stanowisk roboczych, alternatywne stanowiska robocze | Proalpha → SkyPlanner | Import początkowy |
| Bloki kalendarza zasobów produkcyjnych z polami intensity i overloadIntensity | Zmiany robocze i wydajności stanowisk roboczych | Proalpha → SkyPlanner | Import początkowy; następnie codziennie lub zarządzanie w SkyPlanner |
| Zapasy według obszaru MRP | Zapasy materiałów | Proalpha → SkyPlanner | Co godzinę lub przed każdym uruchomieniem harmonogramowania |
| Zamówienia zakupu z terminem dostawy | Materiał dostarczany w dniu dostawy | Proalpha → SkyPlanner | Co godzinę lub przed każdym uruchomieniem harmonogramowania |
| setWorkOrderOperationDates | Zaplanowane rozpoczęcie i zakończenie każdej operacji | SkyPlanner → Proalpha | Przy zmianie harmonogramu, przez webhook SkyPlanner |
| changeWorkOrderOperationResource | Stanowisko robocze wybrane przez silnik harmonogramowania | SkyPlanner → Proalpha | Przy zmianie harmonogramu |
| operationDataEntry (setup, process, combined) | Zarejestrowane czasy i ilości z Mobile Confirmations | SkyPlanner → Proalpha | Przy każdym potwierdzeniu lub po każdej zmianie roboczej |
| Reguły harmonogramowania SkyPlanner | Macierz czasów przezbrojenia, narzędzia jako zasoby o ograniczonej dostępności, liczba operatorów | Zarządzane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Odczytaj części przez Part API i jednorazowo zaimportuj zasoby produkcyjne, grupy zasobów i kalendarze przez INWB lub eksport plików. Starannie przypisz każdy zasób produkcyjny Proalpha do stanowiska roboczego SkyPlanner. Alternatywne grupy zasobów stają się alternatywnymi stanowiskami roboczymi.
2. Synchronizacja zleceń. Przepływ komunikatów INWB lub przepływ pracy n8n przesyła otwarte zlecenia produkcyjne wraz z operacjami, czasami docelowymi i zasobami produkcyjnymi. Stany magazynowe są pobierane przez Material API dla poszczególnych obszarów MRP, a otwarte zamówienia zakupu — przez INWB. SkyPlanner uznaje zamówiony materiał za dostępny w dniu dostawy podanym w zamówieniu zakupu i aktualizuje stan magazynowy, gdy zamówienie otrzyma status Delivered.
3. Zapis harmonogramu w systemie źródłowym. Dla każdej operacji, którą silnik umieścił w harmonogramie lub przesunął, integracja wywołuje setWorkOrderOperationDates z identyfikatorem guid operacji oraz terminami rozpoczęcia i zakończenia. Jeśli silnik wybrał inny zasób produkcyjny, następnie wywoływane jest changeWorkOrderOperationResource.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer. Rejestry czasu pracy pozwalają utrzymać aktualność harmonogramu i są przesyłane do Proalpha przez operationDataEntry. Jeśli zakład już rejestruje potwierdzenia na terminalach PDC, pozostaw jeden kanał, aby uniknąć podwójnych zapisów.
5. Odpowiedzialność za dane i zasady rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Części, modele procesów, ilości, status zlecenia produkcyjnego | Proalpha |
| Kolejność operacji, terminy rozpoczęcia i zakończenia, przypisanie zasobów produkcyjnych | SkyPlanner |
| Macierz czasów przezbrojenia, narzędzia, liczba operatorów | SkyPlanner |
| Zmiany robocze i nieobecności | Jeden system, wybrany na etapie określenia zakresu |
| Potwierdzenia i księgowania magazynowe | Proalpha, zasilany rejestrami czasu pracy ze SkyPlanner lub danymi z PDC |
Jeśli Proalpha APS lub Feinplanung jest aktywny, ustal, który system odpowiada za terminy operacji. Dwa systemy planistyczne zapisujące te same terminy będą wzajemnie nadpisywać swoje dane. Dzięki Autopilot SkyPlanner automatycznie aktualizuje harmonogram, gdy zachodzą zmiany w produkcji.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia onboardingu. Wcześniej możesz skorzystać z 30-dniowego bezpłatnego okresu próbnego na własnych danych. Wyeksportuj otwarte zlecenia produkcyjne, operacje i zasoby produkcyjne z Proalpha do pliku CSV lub Excel, zaimportuj je i zweryfikuj harmonogram.
- Warsztaty mapowania. Wspólnie z partnerem Proalpha ustal tabelę mapowania, zasady odpowiedzialności za dane, częstotliwość synchronizacji i kanał potwierdzeń.
- Konfiguracja interfejsów. Włącz interfejsy REST API i przepływy INWB, utwórz użytkownika technicznego i zapewnij dostęp sieciowy. Najpierw w środowisku testowym, potem w produkcyjnym.
- Początkowe wczytanie danych. Części, zasoby produkcyjne, grupy zasobów i kalendarze.
- Synchronizacja zleceń, stanów magazynowych i zamówień zakupu. Zlecenia produkcyjne są wysyłane przez INWB lub n8n, a stany magazynowe pobierane przez cykliczne odpytywanie, z ponawianiem prób.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przezbrojenia, narzędzia, liczba operatorów i alternatywne stanowiska robocze.
- Zapis harmonogramu w systemie źródłowym. setWorkOrderOperationDates i changeWorkOrderOperationResource; na tym etapie dodawane jest też operationDataEntry.
- Praca równoległa. Porównaj terminy ze SkyPlanner z obecnym planem i popraw dane podstawowe.
- Uruchomienie produkcyjne. Włącz zapis do systemu źródłowego, gdy dane będą zgodne.
Co uwzględnić przy integracji z Proalpha
- Brak obiektu marszruty technologicznej. Proalpha planuje na podstawie modeli procesów produktu. Narzędzia przeniesione z projektów SAP lub Business Central szukają marszrut technologicznych i pomijają dane. Odczytuj operacje i pozycje BOM ze zlecenia produkcyjnego.
- Intensywność w kalendarzu. Bloki kalendarza zawierają pola intensity i overloadIntensity. Odwzoruj je jako zmiany robocze i współczynniki wydajności w SkyPlanner, zamiast kopiować same godziny.
- Jednostki miary. Sprawdź quantityUnitCode oraz to, czy docelowy czas przezbrojenia jest określony na zlecenie, czy na sztukę. Błędne jednostki zniekształcają wszystkie czasy trwania.
- Endpointy na serwerze klienta. Warstwa REST działa na Twoim serwerze Proalpha. Konfiguracja zapór sieciowych, portów i certyfikatów decyduje o terminie rozpoczęcia projektu, więc przygotuj je z wyprzedzeniem.
- Wersja systemu. Zanim ustalisz mapowanie, potwierdź z partnerem, które interfejsy REST API udostępnia Twoja wersja Proalpha.
- Dokumentacja wymagająca logowania. Pomoc online Proalpha jest dostępna przez Documentation Portal. Zamiast zgadywać nazwy pól, potwierdź je z partnerem.
Integracja z Proalpha: kto ją konfiguruje i zapewnia wsparcie
- Zespół SkyPlanner konfiguruje integrację podczas onboardingu i zapewnia wsparcie po uruchomieniu produkcyjnym. Każda instalacja Proalpha ma inny model danych — właśnie tutaj to doświadczenie znajduje zastosowanie.
- Twój partner Proalpha może uczestniczyć w projekcie. Zna Twoje modele procesów, przepływy INWB i wersję systemu, a także może skonfigurować dostęp do API. SkyPlanner udostępnia REST API, dokumentację Swagger/OpenAPI i webhooki.
- Twoi programiści mogą rozwijać integrację przy użyciu tego samego REST API i tokenu API. Zespół SkyPlanner pomaga w razie potrzeby. Dokumentacja produktu jest publicznie dostępna na stronie SkyPlanner docs.
Cena SkyPlanner zaczyna się od 199 € miesięcznie i obejmuje 5 stanowisk roboczych, z rozliczeniem miesięcznym. Integrację wyceniamy z góry, zgodnie z Twoimi procesami i potrzebami, razem z wybranym planem, dzięki czemu znasz pełny koszt przed rozpoczęciem. Dowiedz się, jak Proalpha planuje zdolności produkcyjne, z artykułu Czy proALPHA umożliwia harmonogramowanie produkcji z uwzględnieniem dostępnych zdolności produkcyjnych?, poznaj ogólne informacje na stronie proALPHA i sprawdź inne systemy w centrum integracji z ERP.
Opinie producentów o SkyPlanner
2 hoszczędności co tydzień
„Dzięki SkyPlanner przeszliśmy od planowania produkcji w arkuszach Excel do optymalizacji produkcji w czasie rzeczywistym.”
Kalle Kalliomäki, specjalista ds. łańcucha dostaw
UTU · Rozdzielnice i aparatura rozdzielcza
Planowanie produkcji pozwala zaoszczędzić 2 godziny pracy tygodniowo, a nowa kolejka operacji trafia na linię w kilka sekund.
+90%wydajności produkcji
„Wydajność produkcji wzrosła o 90%.”
Abdul Rucyinga, szef działu 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.
99,2%terminowości dostaw
„SkyPlanner ułatwił nam identyfikację wąskich gardeł i sprawił, że zarządzanie produkcją stało się bardziej przejrzyste.”
Toni Tuori, kierownik produkcji
Piristeel · Systemy bezpieczeństwa dachowego i systemy rynnowe
Terminowość dostaw osiągnęła w tym roku 99,2%, a harmonogramowanie pozwala zaoszczędzić do czterech godzin pracy dziennie.
Mniejprzestojów z powodu braków materiałowych
„Wartość SkyPlanner polega dla nas na tym, że to narzędzie sprawdza się w codziennej pracy, zwłaszcza przy ustalaniu terminów dostaw.”
Tommi Männistö, kierownik planowania produkcji
Eskomatic · Usługowa obróbka skrawaniem
Automatyczne harmonogramowanie obciążenia pozwala dokładniej wyznaczać terminy dostaw, a liczba przestojów produkcji spowodowanych brakami materiałowymi znacznie spadła.
Najczęściej zadawane pytania
Z których interfejsów Proalpha korzysta integracja?
Z interfejsów REST API Proalpha do odczytu części i stanów magazynowych oraz zapisu terminów, zasobów produkcyjnych i potwierdzeń. Przepływy komunikatów INWB lub Integration Platform oparta na n8n przesyłają zlecenia produkcyjne wraz z operacjami. Eksporty plików służą do testów w okresie próbnym i masowego wczytywania danych.
Gdzie w Proalpha zapisywane są planowane terminy?
W operacji zlecenia produkcyjnego, przez setWorkOrderOperationDates z terminami rozpoczęcia i zakończenia. Jeśli silnik przeniósł operację na inną maszynę, changeWorkOrderOperationResource aktualizuje przypisany zasób produkcyjny.
Czy Proalpha obsługuje webhooki?
Proalpha API Portal nie wymienia API do subskrypcji webhooków. Zmiany trafiają do SkyPlanner przez przepływy komunikatów INWB, przepływy pracy n8n lub cykliczne odpytywanie. Własne webhooki SkyPlanner umożliwiają zapis do systemu źródłowego w reakcji na zdarzenia.
Czy potwierdzenia operatorów można przesyłać do Proalpha?
Tak. Rejestry czasu pracy ze SkyPlanner Mobile Confirmations są przesyłane przez operationDataEntry wraz z ilością, czasem pracy pracownika i czasem pracy zasobu produkcyjnego. Jeśli używane są również terminale PDC, pozostaw jeden kanał potwierdzeń.
Czy potrzebujemy Proalpha APS i co, jeśli już z niego korzystamy?
Nie jest potrzebny. SkyPlanner sam tworzy harmonogram uwzględniający dostępne zdolności produkcyjne na podstawie zleceń produkcyjnych, operacji i zasobów produkcyjnych, a Autopilot dba o jego aktualność. Jeśli Proalpha APS jest aktywny, podczas określania zakresu ustal, który system odpowiada za terminy operacji. SkyPlanner zapisuje wtedy tylko te terminy, za które odpowiada, więc oba plany nigdy się wzajemnie nie nadpisują.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. W 30-dniowym bezpłatnym okresie próbnym możesz korzystać z maksymalnie 20 stanowisk roboczych, importując zlecenia produkcyjne z pliku CSV lub Excel. Karta kredytowa nie jest wymagana. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby ustalić zakres integracji.
