Integracje / ERP / Senior ERP
Przewodnik po integracji Senior ERP ze SkyPlanner APS do planowania produkcji
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć Senior ERP firmy Senior Sistemas (Gestão Empresarial | ERP XT z Senior X) ze SkyPlanner APS. Integracja SkyPlanner z Senior ERP działa w obu kierunkach i korzysta z interfejsów Senior:
- Do SkyPlanner trafiają zlecenia produkcyjne (OP) wraz z etapami, marszruty (roteiros), zasoby produkcyjne i ich centra, SKU, struktury produktów, stany magazynowe oraz zamówienia zakupu.
- Do OP wracają planowane terminy rozpoczęcia i zakończenia każdego etapu oraz wybrany dla niego zasób produkcyjny.
- Jeśli wybierzesz tę opcję, zarejestrowane czasy pracy operatorów są przesyłane z powrotem jako apontamentos de produção.
- Senior X Events Hub informuje SkyPlanner o zmianie statusu etapu OP, a webhooki SkyPlanner na bieżąco przesyłają zmiany harmonogramu.
Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do Twojego środowiska Senior ERP, a po uruchomieniu produkcyjnym zapewnia jej wsparcie. Ten przewodnik jest przeznaczony dla partnerów i programistów, którzy chcą uczestniczyć w tych pracach lub samodzielnie tworzyć rozwiązania oparte na udokumentowanym REST API SkyPlanner (dokumentacja API).
Interfejsy integracyjne Senior ERP
ERP XT jest systemem hybrydowym. Według dokumentacji Senior Gestão Empresarial XT „becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (staje się systemem hybrydowym: systemem lokalnym z integracją rozwiązań chmurowych) (dokumentacja Senior, tłumaczenie). Narzędzie do harmonogramowania korzysta z trzech interfejsów Senior:
- Usługi sieciowe G5 (SOAP). Działają na Twoim serwerze Senior, a ich nazwy odpowiadają modułom (com.senior.g5.co.<module>…). Każda jest publikowana w trzech wariantach WSDL: sapiens_Sync, sapiens_Async i sapiens_Scheduled. Usługi produkcyjne obejmują com.senior.g5.co.mpr.pcp.ordemproducao, która „calls the same production order generation routine” (wywołuje tę samą procedurę generowania zleceń produkcyjnych) co ekran ERP (dokumentacja Senior, tłumaczenie), a także usługi obsługujące produkty (com.senior.g5.co.ger.cad.produto) i raportowanie produkcji.
- Interfejsy REST API Senior X Platform pod adresem api.senior.com.br obsługują obszary ERP udostępniane przez Senior w Senior X, takie jak produkty i zamówienia sprzedaży (dokumentacja Senior).
- Webhooki Events Hub. Tworzy się je w Senior X w sekcji Tecnologia > Customização > Events Hub > Webhooks. Moduł Manufacturing publikuje zdarzenie erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus, gdy etap OP zmienia status (dokumentacja Senior).
Uwierzytelnianie i dostęp
- Senior X Platform. Integracja loguje się żądaniem POST do platform.senior.com.br pod ścieżką /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, podając użytkownika w formacie user@tenant. Odpowiedź zawiera token dostępu Bearer oraz token odświeżania. Logowanie za pomocą kluczy aplikacji odbywa się przez loginWithKey (access key, secret, tenant). Wywołania REST zawierają nagłówek authorization oraz nagłówek client_id. Ten drugi identyfikuje łączącą się aplikację, zarejestrowaną w portalu API Senior i powiązaną z rolą w ERP.
- Usługi sieciowe G5. Wywołania zawierają parametry użytkownika, hasła i szyfrowania. Przy korzystaniu z tokena Senior X token zastępuje hasło (dokumentacja Senior).
- Uprawnienia. Utwórz w Senior osobne konto użytkownika dla integracji, z dostępem do danych PCP, technologicznych, magazynowych i zakupowych, które integracja odczytuje i zapisuje.
Po stronie SkyPlanner REST API używa do uwierzytelniania tokena 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 odpytywanie
Events Hub obsługuje zdarzenia z hali produkcyjnej: gdy etap OP zmienia status, webhook dociera do SkyPlanner i harmonogram jest aktualizowany. Pozostałe dane są pobierane przez cykliczne odpytywanie. Odczyty ograniczone do zatwierdzonych i zwolnionych OP oraz ostatnich zmian pozwalają wykrywać nowe zlecenia. Częstotliwość ustala się dla każdego zakładu: od kilku minut dla OP do godziny dla stanów magazynowych.
SkyPlanner wysyła webhooki przy zmianie stanu lub harmonogramu, więc zapis zwrotny jest wyzwalany zdarzeniami.
Mapowanie danych
| Obiekt Senior ERP (interfejs) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
| SKU: produto i derivação, jednostki miary (usługi sieciowe G5 lub encje Senior X) | Produkty i materiały | Senior → SkyPlanner | Import początkowy, następnie odpytywanie |
| Struktura produktu (engenharia do SKU) | Struktura produktu, półprodukty, materiały przypisane do produktu | Senior → SkyPlanner | Import początkowy, następnie przy zmianie |
| Roteiro z estágios: kolejność, zależność od poprzedniego etapu | Kroki procesu we właściwej kolejności | Senior → SkyPlanner | Import początkowy, następnie przy zmianie |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Stanowiska robocze, czasy trwania, czasy przygotowania i zakończenia pracy, wydajność | Senior → SkyPlanner | Import początkowy, później sporadycznie |
| Centro de recurso | Grupy stanowisk roboczych | Senior → SkyPlanner | Import początkowy, później sporadycznie |
| Calendário: Feriados, kalendarz produkcji dla każdej zmiany | Zmiany robocze i dni wolne od pracy | Senior → SkyPlanner | Codziennie lub własne zmiany robocze w SkyPlanner |
| Ordens de produção (Firme, Liberada) z etapami i materiałami | Zlecenia i operacje z terminami realizacji i zapotrzebowaniem materiałowym | Senior → SkyPlanner | Odpytywanie co kilka minut |
| Status etapu OP (Events Hub orderProductionStageChangeStatus) | Postęp operacji | Senior → SkyPlanner | W czasie rzeczywistym przez webhook |
| Estoque dla każdego SKU | Stany magazynowe | Senior → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Ordens de compra z terminami dostaw | Zamówienia zakupu, oczekiwane materiały według terminów dostaw | Senior → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Etap OP: planowany początek i koniec, zasób produkcyjny | Planowany początek i koniec każdej operacji, przypisane stanowisko robocze | SkyPlanner → Senior | Po zmianie harmonogramu, przez webhook SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, data i godzina rozpoczęcia oraz zakończenia | Rejestry czasu pracy i potwierdzenia operatorów | SkyPlanner → Senior | Po każdym potwierdzeniu lub po każdej zmianie, jeśli wybrano tę opcję |
| Brak w Senior ERP | Macierz czasów przezbrojeń, narzędzia jako zasoby o ograniczonej dostępności, operacje wymagające wielu operatorów, alternatywne maszyny i pracownicy | Zarządzane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Odczytaj SKU, struktury, roteiros, recursos, centros de recurso oraz kalendarz produkcji. Świadomie zmapuj centra zasobów: centro de recurso z czterema maszynami staje się jedną grupą stanowisk roboczych lub czterema stanowiskami roboczymi. Przelicz Fator de carga na wydajność stanowiska roboczego w SkyPlanner albo uwzględnij go w zmianach roboczych — nie stosuj obu sposobów jednocześnie.
2. Synchronizacja OP. Odczytaj OP o statusach Firme i Liberada wraz z etapami i materiałami oraz otwarte zamówienia zakupu. MRP nadal może zmienić lub usunąć OP o statusie Planejada, dlatego uwzględniaj je w harmonogramie tylko wtedy, gdy chcesz uzyskać obraz przyszłej produkcji. SkyPlanner uznaje zamówiony materiał za dostępny w terminie dostawy zamówienia zakupu i aktualizuje stan magazynowy po oznaczeniu zamówienia jako Delivered.
3. Zapis harmonogramu do ERP. Gdy silnik harmonogramowania umieszcza lub przesuwa etap w harmonogramie, webhook SkyPlanner uruchamia zapis zwrotny. Ustawia on planowany początek i koniec każdego etapu OP oraz wybrany dla niego zasób produkcyjny. Są to te same pola, które planista edytuje w Programação de produção. Podczas określania zakresu zespół SkyPlanner uzgadnia z Tobą i Twoim partnerem Senior, która usługa sieciowa zostanie użyta.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer, a zarejestrowane czasy pozwalają na bieżąco aktualizować harmonogram. Ty decydujesz, czy rzeczywiste czasy mają być przesyłane do Senior. Jeśli tak, każde potwierdzenie staje się wpisem apontamento de produção dla etapu OP, z wyprodukowaną ilością, brakami oraz czasem rozpoczęcia i zakończenia. Senior przyjmuje raporty produkcyjne tylko dla OP o statusie Liberada lub Andamento. Jeśli raportujesz przez Fábrica ao Vivo, SkyPlanner odczytuje postęp przez Events Hub.
5. Odpowiedzialność za dane i reguły rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| SKU, struktury, roteiros, ilości i status OP | Senior ERP |
| Kolejność etapów, czasy rozpoczęcia i zakończenia, przypisanie zasobów produkcyjnych | SkyPlanner |
| Macierz czasów przezbrojeń, wymagane narzędzia i operatorzy, alternatywne zasoby produkcyjne | SkyPlanner |
| Kalendarz produkcji i zmiany robocze | Jeden system, wybrany podczas określania zakresu |
| Apontamentos, ruchy magazynowe, kalkulacja kosztów | Senior ERP — dane wprowadzane bezpośrednio lub przesyłane z rejestrów czasu pracy SkyPlanner |
Wybierz jeden system odpowiedzialny za zapis terminów etapów. Jeśli planiści nadal ustalają kolejność tych samych OP w Programação de produção lub na wykresie Gantta, uzgodnij, za które OP odpowiada SkyPlanner.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia prac. Wcześniej sprawdź harmonogram w ramach 30-dniowego bezpłatnego okresu próbnego, korzystając z zasobów produkcyjnych, roteiros i otwartych OP wyeksportowanych z Senior do plików CSV lub Excel.
- Mapowanie. Ustal tabelę mapowania, zasady odpowiedzialności za dane, częstotliwość synchronizacji oraz to, czy apontamentos mają być przesyłane z powrotem.
- Dostęp do Senior. Utwórz użytkownika integracji, zarejestruj aplikację w portalu API Senior oraz włącz usługi sieciowe G5 i webhook Events Hub. Najpierw przeprowadź testy na bazie testowej.
- Import początkowy. SKU, struktury, roteiros, recursos, centros de recurso, kalendarz.
- Synchronizacja OP i zamówień zakupu. Cykliczne odpytywanie z filtrami i ponawianiem prób oraz webhook statusu etapu.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przezbrojeń, narzędzia, liczba operatorów dla każdej operacji oraz alternatywne maszyny lub pracownicy.
- Zapis harmonogramu do ERP. Terminy etapów i zasoby produkcyjne przesyłane przez webhooki SkyPlanner oraz apontamentos, jeśli wybrano tę opcję.
- Testy równoległe. Twórz harmonogram w SkyPlanner równolegle z dotychczasowym planem, porównaj terminy i popraw dane podstawowe.
- Uruchomienie produkcyjne. Włącz zapis zwrotny, gdy dane będą zgodne.
Co uwzględnić przy integracji z Senior ERP
- Cztery rodzaje czasu dla zasobu. Recurso zawiera czas procesu, przezbrojenia, załadunku i rozładunku oraz transportu. Czas załadunku i transportu może dotyczyć obsługi materiału, a nie pracy maszyny. Dla każdego zasobu ustal, jak zmapować poszczególne czasy — inaczej wszystkie czasy trwania będą błędne.
- Jeden czas przezbrojenia na zasób. Tempo setup w Senior to pojedyncza wartość. Podczas wdrożenia zbuduj w SkyPlanner macierz czasów przezbrojeń na podstawie rzeczywistych przezbrojeń w Twoim zakładzie.
- Warianty produktu. SKU w Senior to produkt wraz z derivação, a roteiros mogą się różnić w zależności od wariantu. Uwzględnij kod wariantu w kluczach produktów w SkyPlanner.
- Statusy OP. Raporty produkcyjne można zapisywać tylko dla OP o statusie Liberada lub Andamento. Zmieniaj statusy w Senior i pozwól SkyPlanner śledzić te zmiany przez Events Hub.
- Wdrożenie hybrydowe. Usługi sieciowe G5 działają na Twoim serwerze Senior, a Events Hub — w Senior X. Zaplanuj dostęp sieciowy do obu środowisk.
- Format liczb. Usługi sieciowe Senior odrzucają liczby z separatorami tysięcy i wymagają przecinka dziesiętnego. Przesyłaj liczby w tym formacie.
Kto konfiguruje i wspiera integrację z Senior ERP
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Obejmuje ono uzgodnione usługi sieciowe, API Senior X oraz webhooki Events Hub. Każdy zakład korzysta z Senior ERP inaczej — właśnie tutaj wykorzystujemy tę wiedzę.
- Twój partner Senior może uczestniczyć w pracach. Zna konfigurację, modyfikacje i warunki licencji Twojego systemu. Wspólnie z zespołem SkyPlanner może skonfigurować użytkownika integracji i usługi sieciowe oraz przeprowadzić rejestrację w portalu API.
- Twoi programiści mogą rozbudowywać integrację, korzystając z REST API SkyPlanner i tokenu API. Na początek wystarczy token API, a zespół SkyPlanner pomaga w razie potrzeby. Szczegóły znajdziesz w dokumentacji integracji SkyPlanner.
Cena SkyPlanner zaczyna się od 199 € miesięcznie i obejmuje 5 stanowisk roboczych, z rozliczeniem co miesiąc. Wycenę integracji otrzymasz z góry wraz z wyceną planu, z uwzględnieniem Twojego procesu i potrzeb. Zobacz cennik, informacje o harmonogramowaniu produkcji z Senior ERP, stronę Senior ERP oraz przegląd integracji z ERP.
Opinie firm produkcyjnych 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 zadań trafia na linię w ciągu kilku 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.
1 000+zleceń produkcyjnych harmonogramowanych automatycznie
„Teraz inaczej kontrolujemy produkcję, a nasza wiedza o zdolnościach produkcyjnych jest na zupełnie innym poziomie.”
Hannu Ryynänen, prezes
Mamec · Mieszalniki przemysłowe, pompy i produkcja kontraktowa zaawansowanych technologicznie wyrobów
Tysiące zleceń produkcyjnych są harmonogramowane automatycznie, a cała organizacja ma wgląd w produkcję w czasie rzeczywistym.
Mniejprzestojów z powodu braków materiałowych
„Wartość SkyPlanner polega dla nas na tym, że sprawdza się w codziennej pracy, zwłaszcza przy ustalaniu terminów dostaw.”
Tommi Männistö, kierownik ds. 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
Czy Senior ERP udostępnia API do zleceń produkcyjnych?
Tak. Usługa sieciowa G5 com.senior.g5.co.mpr.pcp.ordemproducao generuje zlecenia OP przy użyciu tej samej procedury, która jest wykorzystywana do ich tworzenia na ekranie ERP. Inne usługi G5 obsługują produkty i raportowanie produkcji. Senior X Platform udostępnia dodatkowo REST API z logowaniem za pomocą tokenu Bearer oraz webhooki Events Hub.
Czy Senior ERP obsługuje webhooki?
Tak. Senior X Events Hub wysyła webhooki, w tym orderProductionStageChangeStatus przy zmianie statusu etapu zlecenia OP. SkyPlanner wykorzystuje je do śledzenia postępów na hali w czasie rzeczywistym, a przez własne webhooki przesyła z powrotem zmiany harmonogramu.
Jak planowane terminy są zapisywane z powrotem w Senior ERP?
SkyPlanner ustawia planowany początek i koniec każdego etapu zlecenia OP oraz wybrany dla niego zasób produkcyjny. Są to te same pola, które planista edytuje w Programação de produção. Przy każdej zmianie harmonogramu webhook SkyPlanner uruchamia zapis zwrotny. Odbywa się on ścieżką, którą zespół SkyPlanner ustala dla Twojej instalacji Senior podczas określania zakresu wdrożenia.
Czy integracja działa z Senior X i ERP XT?
Tak. ERP XT działa na Twoim serwerze i korzysta z usług chmurowych Senior X. Integracja wykorzystuje usługi sieciowe G5 na serwerze oraz API Senior X i Events Hub w chmurze.
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 Senior za pomocą plików CSV lub Excel. Nie wymaga karty kredytowej. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.
