Integracje / ERP / Comarch ERP XL
Przewodnik po integracji Comarch ERP XL ze SkyPlanner APS do planowania produkcji
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć Comarch ERP XL ze SkyPlanner APS. SkyPlanner zapewnia dwukierunkową integrację z Comarch ERP XL za pośrednictwem interfejsów Comarch:
- Do SkyPlanner trafiają zlecenia produkcyjne wraz z procesami i operacjami, technologie, gniazda produkcyjne, zasoby produkcyjne, kartoteki towarowe, stany magazynowe i zamówienia zakupu.
- Planowane terminy rozpoczęcia i zakończenia są zapisywane zwrotnie w każdej operacji zlecenia produkcyjnego przez XL API.
- Opcjonalnie zapisy czasu pracy operatorów wracają jako realizacje operacji.
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Podczas wdrożenia zespół SkyPlanner konfiguruje integrację odpowiednio do Państwa środowiska Comarch ERP XL i zapewnia jej wsparcie po uruchomieniu. 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 integracyjne Comarch ERP XL
Comarch wymienia trzy sposoby komunikacji z ERP XL: „DCOM, direct database connection (SQL Client), REST API” (DCOM, bezpośrednie połączenie z bazą danych (SQL Client), REST API) (Comarch, tłumaczenie). W integracji z systemem do harmonogramowania kluczowe są dwa z nich:
- XL API (CDN_API.DLL). „These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Funkcje te są zebrane w bibliotece CDN_API.DLL, instalowanej wraz z całym systemem Comarch ERP XL.) (Pomoc Comarch, tłumaczenie) Program zewnętrzny loguje się przez XLLogin, wywołuje funkcje korzystające ze wspólnej sesji, a następnie wylogowuje się przez XLLogout. Każda struktura ma pole Wersja, które określa wersję zestawu parametrów dla danego wydania ERP XL.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 udostępnia mikrousługi REST: „Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Każda mikrousługa RestAPI udostępnia własną interaktywną dokumentację pod adresem /swagger.) (Pomoc Comarch, tłumaczenie)
Bezpośrednie połączenie SQL Client umożliwia odczyt danych podstawowych i zleceń z bazy ERP XL, w zakresie uzgodnionym z zespołem IT i partnerem Comarch.
Funkcje produkcyjne XL API
Comarch dokumentuje następujące funkcje produkcyjne (XL128):
| Obszar | Funkcja | Działanie |
|---|---|---|
| Technologie | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Tworzenie technologii, operacji, przypisania gniazda produkcyjnego do operacji oraz materiału lub produktu w operacji |
| Zlecenia produkcyjne | XLNoweZlecenieProd | Tworzenie zlecenia produkcyjnego |
| Zlecenia produkcyjne | XLZamknijZlecenieProd | Planowanie, przeplanowanie, rozliczanie lub zamykanie zlecenia produkcyjnego, zależnie od kodu akcji |
| Operacje | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Dodawanie operacji lub zasobu produkcyjnego do procesu produkcyjnego |
| Harmonogram | XLDodajTerminDoProcesuProd | Dodawanie przedziału czasowego do operacji: IdCzynnosci, TerminOd, TerminDo |
| Realizacja | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Dodawanie realizacji operacji do zlecenia, zmiana zrealizowanej ilości |
| Dokumenty | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Tworzenie dokumentów RW i PW dla obiektów produkcyjnych |
Uwierzytelnianie i dostęp
- XL API. Integracja loguje się do bazy jako operator ERP XL przez XLLogin i otrzymuje sesję do kolejnych wywołań. Biblioteka DLL działa na hoście Windows z zainstalowanym ERP XL, dlatego usługa zapisu zwrotnego działa w Państwa sieci, w tym samym środowisku co ERP XL.
- REST API. Dostęp konfiguruje się osobno dla każdej instalacji ERP XL Web. Wywołania każdej mikrousługi są opisane na jej stronie Swagger.
- Odczyt SQL. Konto bazy danych z uprawnieniami tylko do odczytu, zatwierdzone przez zespół IT.
Po stronie SkyPlanner REST API korzysta z uwierzytelniania tokenem API w nagłówku Authorization-Token (SkyPlanner Settings > API), a jego dokumentacja jest dostępna w Swagger/OpenAPI. Samouczek integracji prowadzi przez pierwsze wywołania.
Zdarzenia i cykliczne odpytywanie
W sprawdzonej dokumentacji Comarch ERP XL nie opisano webhooków wychodzących. Własny system APS firmy Comarch pobiera dane, gdy planista naciśnie „Aktualizuj dane z ERP” (Pomoc Comarch APS).
Dlatego dane z ERP XL są pobierane przez cykliczne odpytywanie. Odczyty ograniczone do otwartych zleceń produkcyjnych i ostatnich zmian pozwalają wykrywać nowe prace. Częstotliwość ustala się dla każdego zakładu: od odczytu zleceń produkcyjnych co kilka minut po odczyt stanów magazynowych co godzinę.
SkyPlanner wysyła webhooki przy zmianie stanu lub harmonogramu, więc zapis zwrotny jest uruchamiany przez zdarzenia.
Mapowanie danych
| Obiekt Comarch ERP XL (interfejs) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
| Karty towarów, jednostki miary (REST lub odczyt SQL) | Produkty i materiały | ERP XL → SkyPlanner | Import początkowy, następnie cykliczne odpytywanie |
| Technologia: operacje oraz materiały, półprodukty i produkty przypisane do operacji | Struktura produktu, półprodukty, materiały przypisane do etapów procesu | ERP XL → SkyPlanner | Import początkowy, następnie przy zmianie |
| Operacje technologii: gniazda produkcyjne, zasoby produkcyjne, czasy | Etapy procesu wraz z czasem trwania, przezbrojenia i demontażu | ERP XL → SkyPlanner | Import początkowy, następnie przy zmianie |
| Gniazda robocze i zasoby (maszyny, narzędzia, pracownicy) | Stanowiska robocze, grupy stanowisk roboczych, narzędzia, personel | ERP XL → SkyPlanner | Import początkowy, później sporadycznie |
| Kalendarze i okresy, przestoje i awarie | Zmiany robocze, czas wolny od pracy i przestoje | ERP XL → SkyPlanner | Codziennie lub zmiany robocze definiowane bezpośrednio w SkyPlanner |
| Zlecenia produkcyjne (ZP) wraz z procesami, operacjami, materiałami, terminem realizacji i priorytetem | Zlecenia i operacje wraz z terminami realizacji i zapotrzebowaniem materiałowym | ERP XL → SkyPlanner | Odpytywanie co kilka minut |
| Stany według magazynów | Stany magazynowe | ERP XL → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Zamówienia zakupu (ZZ) z terminami dostaw | Zamówienia zakupu, oczekiwane materiały według terminów dostaw | ERP XL → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Terminy operacji: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Planowany początek i koniec każdej operacji | SkyPlanner → ERP XL | Przy zmianie harmonogramu, przez webhook SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Zapisy czasu pracy i potwierdzenia operatorów | SkyPlanner → ERP XL | Po każdym potwierdzeniu lub raz na zmianę, jeśli wybrano tę opcję |
| Brak w ERP XL | Macierz czasów przezbrojeń, narzędzia o ograniczonej dostępności, operacje wymagające wielu operatorów, alternatywne maszyny i personel | Dane utrzymywane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Należy odczytać kartoteki towarowe, technologie, gniazda produkcyjne, zasoby produkcyjne i kalendarze. Mapowanie gniazd produkcyjnych na SkyPlanner wymaga świadomej decyzji: gniazdo z czterema maszynami staje się jedną grupą stanowisk roboczych lub czterema stanowiskami roboczymi. Narzędzia zapisane jako zasoby w ERP XL stają się w SkyPlanner narzędziami o ograniczonej dostępności, a pracownicy — personelem z przypisanymi zmianami roboczymi.
2. Synchronizacja zleceń i zamówień. Należy odczytać zlecenia produkcyjne wraz z operacjami i materiałami oraz otwarte zamówienia zakupu. SkyPlanner traktuje zamówiony materiał jako dostępny w terminie dostawy zamówienia zakupu i aktualizuje stan magazynowy po nadaniu zamówieniu statusu Delivered.
3. Zapis harmonogramu w ERP. Gdy silnik planujący umieści operację w harmonogramie lub ją przesunie, webhook SkyPlanner uruchamia usługę zapisu zwrotnego. Usługa wywołuje XLDodajTerminDoProcesuProd z wartościami TerminOd i TerminDo danej operacji. Dzięki temu każda operacja ZP ma zapisany początek i koniec zaplanowany przez SkyPlanner.
4. Rejestracja wykonania na hali. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer, a wpisy czasu pracy pozwalają utrzymać aktualny harmonogram. Ty decydujesz, czy rzeczywiste czasy mają trafiać z powrotem do ERP. Jeśli tak, usługa dodaje realizacje przez XLDodajRealizacjeOperacjiProd, a dokumenty RW i PW powstają zgodnie z regułami Twojego ERP XL. Jeśli na części stanowisk korzystasz z Comarch MES, zachowaj jedno źródło raportowania dla każdej operacji.
5. Odpowiedzialność za dane i reguły rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Kartoteki towarowe, technologie, ilości, status ZP, kalkulacja kosztów | Comarch ERP XL |
| Kolejność operacji, terminy rozpoczęcia i zakończenia, przypisanie zasobów produkcyjnych | SkyPlanner |
| Macierz czasów przezbrojeń, wymagania dotyczące narzędzi i operatorów, alternatywne zasoby produkcyjne | SkyPlanner |
| Zmiany, kalendarze i przestoje | Jeden system, wybrany podczas określania zakresu |
| Realizacje, dokumenty RW i PW | Comarch ERP XL — dane wprowadzane bezpośrednio lub przesyłane z rejestrów czasu pracy SkyPlanner |
Wybierz jeden system zapisujący terminy operacji. Jeśli automatyczne przeplanowanie w ERP XL lub Comarch APS nadal zapisuje terminy w tych samych zleceniach produkcyjnych, wyłącz tę funkcję dla zleceń planowanych przez SkyPlanner.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia onboardingu. Wcześniej sprawdź harmonogram podczas 30-dniowego bezpłatnego okresu próbnego, korzystając z gniazd produkcyjnych, technologii i otwartych zleceń produkcyjnych wyeksportowanych z ERP XL do plików CSV lub Excel.
- Mapowanie. Ustal tabelę mapowania, odpowiedzialność za dane, częstotliwość synchronizacji oraz to, czy realizacje mają być przesyłane z powrotem do ERP.
- Dostęp do ERP XL. Utwórz operatora integracji, skonfiguruj połączenie do odczytu i zainstaluj usługę zapisu zwrotnego na hoście z zainstalowanym ERP XL. Najpierw przeprowadź testy na kopii bazy danych.
- Początkowe zasilenie danymi. Kartoteki towarowe, technologie, gniazda produkcyjne, zasoby produkcyjne, kalendarze.
- Synchronizacja zleceń produkcyjnych i zamówień zakupu. Cykliczne odpytywanie z filtrami i ponawianiem prób.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przezbrojeń, narzędzia, liczba operatorów na operację oraz alternatywne maszyny lub personel.
- Zapis harmonogramu w ERP. Wywołania XLDodajTerminDoProcesuProd uruchamiane przez webhooki SkyPlanner oraz przesyłanie realizacji, jeśli wybrano tę opcję.
- Testy równoległe. Uruchom 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 Comarch ERP XL
- Zdolność produkcyjna wpisywana ręcznie. W ERP XL zdolność produkcyjna gniazda jest liczbą definiowaną przez użytkownika z dopuszczalnym obciążeniem w %. SkyPlanner wyznacza ją natomiast na podstawie rzeczywistych zmian i zasobów produkcyjnych. Dlatego starannie skonfiguruj zmiany i nie opieraj się na wartości procentowej.
- Zasoby bez ograniczeń. ERP XL nie sprawdza zajętości zasobów oznaczonych jako mające nieograniczoną zdolność produkcyjną. Dla każdego z nich zdecyduj, czy w SkyPlanner ma być stanowiskiem roboczym o ograniczonej zdolności produkcyjnej.
- Zwolnione zlecenia. ERP XL pomija w przeplanowaniu operacje zwolnione do produkcji, chyba że zaznaczono opcję „Przesuń na zwolnionych”. Ustal, jak terminy ze SkyPlanner mają być stosowane do zwolnionych zleceń, i użyj Running Time Lock, aby zamrozić harmonogram na najbliższe godziny.
- Wersje struktur. Struktury XL API zawierają pole Wersja. Ustaw jego wartość zgodnie z używaną wersją ERP XL i ponów testy po każdej corocznej aktualizacji.
- Polskie jednostki i czasy. Czasy operacji i jednostki kalendarza muszą być dokładnie przeliczane podczas importu. W przeciwnym razie wszystkie czasy trwania będą błędne.
Kto konfiguruje integrację z Comarch ERP XL i zapewnia jej wsparcie
- Zespół SkyPlanner konfiguruje integrację podczas onboardingu i zapewnia wsparcie po uruchomieniu produkcyjnym, w uzgodnionym zakresie odczytów i wywołań XL API. Każdy zakład korzysta z Comarch ERP XL inaczej — tę wiedzę uwzględniamy właśnie na tym etapie.
- Twój partner Comarch może uczestniczyć w projekcie. Zna Twoją konfigurację, licencje i XL API. Wspólnie z zespołem SkyPlanner może skonfigurować operatora, połączenie do odczytu oraz host usługi zapisu zwrotnego.
- Twoi programiści mogą rozwijać integrację, korzystając z REST API SkyPlanner i tokenu API. Sam token API wystarczy, aby zacząć, a zespół SkyPlanner pomoże w razie potrzeby. Szczegóły znajdziesz w dokumentacji integracji SkyPlanner.
Ceny SkyPlanner zaczynają się od 199 € miesięcznie za 5 stanowisk roboczych, przy rozliczeniu miesięcznym. Integrację wyceniamy z góry, razem z wybranym planem, zgodnie z Twoim procesem i potrzebami. Zobacz cennik, informacje o harmonogramowaniu produkcji z Comarch ERP XL, stronę Comarch ERP XL oraz przegląd integracji z ERP.
Opinie firm produkcyjnych o SkyPlanner
2 hoszczędności tygodniowo
„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 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.
6 miesięcynaprzód — dział sprzedaży widzi wolne moce produkcyjne
„SkyPlanner stanowi solidną podstawę całego planowania produkcji i zapewnia jego niezawodność.”
Anu Järvinen, kierowniczka produkcji
Fredman Operations · Papiery opakowaniowe do kontaktu z żywnością
Dział sprzedaży widzi wolne moce z wyprzedzeniem sześciu miesięcy, a odpowiedzi na prośby o zmianę harmonogramu, które wcześniej zajmowały godzinę lub dłużej, są teraz gotowe w kilka sekund.
100%terminowości dostaw od 2021 roku
„SkyPlanner daje nam wgląd w zdolności produkcyjne i sprawia, że planowanie jest 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 Comarch ERP XL ma API do obsługi zleceń produkcyjnych?
Tak. XL API (CDN_API.DLL) pozwala tworzyć zlecenia produkcyjne, planować je i przeplanowywać za pomocą XLZamknijZlecenieProd, dodawać terminy operacji przez XLDodajTerminDoProcesuProd oraz rejestrować realizacje przez XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web udostępnia dodatkowo mikrousługi REST udokumentowane w Swagger.
Jak planowane terminy są zapisywane z powrotem w Comarch ERP XL?
Za pomocą funkcji XLDodajTerminDoProcesuProd, która dodaje zakres terminów (TerminOd, TerminDo) do każdej operacji zlecenia produkcyjnego. Webhook SkyPlanner uruchamia to wywołanie przy każdej zmianie harmonogramu.
Czy Comarch ERP XL obsługuje webhooki?
Dokumentacja nie opisuje webhooków wychodzących, dlatego integracja cyklicznie odpytuje ERP XL zgodnie z harmonogramem ustalonym dla danego zakładu. Własne webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Czy partner Comarch powinien proponować Comarch APS czy SkyPlanner?
SkyPlanner — gdy klient chce w ciągu kilku tygodni uzyskać harmonogram uwzględniający ograniczone zdolności produkcyjne, który sam się aktualizuje. Comarch APS to osobna aplikacja z własną bazą PostgreSQL, integratorem i kluczem licencyjnym. Synchronizacja następuje po kliknięciu przez planistę, a czas przezbrojenia jest jedną stałą wartością dla każdej operacji (pomoc Comarch APS). SkyPlanner to oprogramowanie chmurowe, które automatycznie przeplanowuje produkcję i uwzględnia przezbrojenia, narzędzia, zespoły pracowników oraz materiały, w cenie od 199 € miesięcznie.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. 30-dniowy bezpłatny okres próbny obejmuje do 20 stanowisk roboczych i import danych z ERP XL przez pliki CSV lub Excel, bez podawania karty kredytowej. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.
