Jak połączyć WMS z Comarch ERP Optima lub XL: kiedy ma to sens, jakie dokumenty płyną w którą stronę, jakimi drogami je przenieść i co przygotować do analizy.
Firma, która prowadzi sprzedaż i księgi w Comarch ERP Optima albo XL, rzadko szuka drugiego systemu na miejsce pierwszego. Szuka narzędzia, które doda to, czego moduł magazynowy nie robi: adres miejsca składowania i skan przy każdym ruchu. Przy takim zakupie ważniejsze od listy funkcji jest pytanie, co stanie się z dokumentami, gdy magazyn zacznie pracować w osobnym systemie.
Ta strona odpowiada na nie dla obu produktów Comarch: kiedy WMS ma sens, które dokumenty idą w którą stronę, jakimi drogami da się je przenieść i co ustalić przed startem. Mechanizm kolejki i ponowień, wspólny dla każdego ERP, opisuje strona o integracji magazynu online z ERP, a ogólne zasady wymiany strona o integracji z systemem ERP.
Kiedy WMS przy Optimie, a kiedy przy XL
Skala firmy decyduje o liczbie magazynów i dokumentów, a więc o tym, jak wymagająca jest wymiana.
Comarch kieruje Optimę do małych i średnich firm, a XL do większych organizacji. Przy Optimie WMS ma sens wtedy, gdy magazyn przerósł listę pobrania: rośnie liczba lokalizacji i zamówień dziennie, a stan w ERP trzeba co tydzień korygować po przeliczeniu. Przy XL powody są inne. Firmy mają kilka magazynów i produkcję, a dostawy umawiają na godziny, więc o wymianie decyduje liczba dokumentów i zależności między nimi, a nie liczba funkcji. Kryteria, po których poznaje się moment przejścia z modułu magazynowego ERP na WMS, zestawia strona WMS a ERP.
| Kryterium | Optima | XL |
|---|---|---|
| Typowy profil firmy | Mała lub średnia firma, najczęściej jeden magazyn | Średnia lub duża firma, często kilka magazynów |
| Najczęstszy powód WMS | Stan w ERP rozjeżdża się z regałem, brakuje adresów lokalizacji | Wiele magazynów i partie z terminami |
| Pierwsza sprawa do wyjaśnienia | Czy firma ma dostęp do interfejsu API i na jakich warunkach | Wersja XL i zakres API, a przy kilku magazynach także ich mapowanie |
Magazyn nie prowadzi własnej kartoteki towarów. Indeks powstaje w ERP, a WMS dopisuje do niego lokalizację i parametry logistyczne.
Jakie dokumenty i dane płyną między ERP a WMS
Zlecenia i kartoteki idą do magazynu, a potwierdzenia ruchów wracają do ERP.
Podział ról jest taki sam przy Optimie i XL. ERP prowadzi finanse i sprzedaż, a WMS odpowiada za to, co dzieje się z towarem w hali. Schemat pokazuje granicę: zlecenia schodzą do magazynu, a zatwierdzone dokumenty wracają do ERP kolejką.
Najpierw idzie kartoteka. Indeks towaru i jego kod EAN powstają w ERP i trafiają do asortymentu WMS, gdzie magazyn dopisuje lokalizację oraz parametry pakowania. Dlatego pole z kodem kreskowym w kartotece Optimy lub XL musi odpowiadać temu, co magazynier skanuje: błędny kod zatrzymuje operację już przy pierwszym skanie. Jak wygląda kartoteka po stronie magazynu, opisują kartoteki magazynowe.
| Dane | Kierunek | Po stronie WMS | Uwaga |
|---|---|---|---|
| Kartoteka towarów i kontrahenci | z ERP do WMS | Asortyment i kontrahent | Lokalizacje dopisuje magazyn i nie wracają one do ERP |
| Zamówienie zakupu | z ERP do WMS | ZPZ, zlecenie przyjęcia | Przyjęcie bez zlecenia powstaje jako PZB |
| Zamówienie sprzedaży | z ERP do WMS | ZWZ, zlecenie wydania | Kompletacja idzie według lokalizacji |
| Przyjęcie PZ | z WMS do ERP | PZ lub PZB po skanie | Do ERP trafiają ilości rzeczywiste, a nie zamówione |
| Wydanie WZ | z WMS do ERP | WZ lub WZB po kompletacji | ERP może wystawić fakturę z tych samych danych |
| Przesunięcie MM | z WMS do ERP | Przesunięcie między magazynami | Ruch między regałami jednego magazynu zostaje w WMS |
| Stany magazynowe | porównanie w obie strony | Stan lokalizacyjny | ERP widzi ilość, a WMS jej rozbicie na lokalizacje i partie |
Zamówienie zakupu z ERP staje się w magazynie zleceniem przyjęcia ZPZ. Po skanie towaru na rampie powstaje dokument PZ z ilościami rzeczywistymi, więc przyjęcie częściowe albo z nadwyżką wraca do ERP w takiej postaci, w jakiej zaszło. Dostawy umawiane na godziny obsługuje awizacja dostaw, a numer awizo jest jednym z pól zlecenia.
Wydanie biegnie w odwrotną stronę. Zamówienie sprzedaży z Optimy lub XL staje się zleceniem wydania ZWZ, magazynier realizuje je według lokalizacji (kompletacja zamówień), a zatwierdzony dokument WZ wraca do ERP. Przesunięcie MM między magazynami też wraca do ERP, natomiast ruch między regałami jednego magazynu zostaje w WMS, bo ERP nie widzi adresów miejsc. Stany ilościowe zgadzają się w obu systemach dzięki dokumentom, a nie dzięki osobnemu przesyłaniu zapasów.
Drogi integracji po stronie ERP
Wybór drogi zależy od interfejsu, który producent udostępnia w danej wersji ERP.
Studio WMS.net przenosi dane z ERP kilkoma kanałami, na przykład plikami Excel albo przez WebService. Kanały opisuje strona o integracji z systemem ERP. Przy Comarch wybór sprowadza się do pytania, jaki interfejs producent oferuje w konkretnej wersji Optimy lub XL. Tabela zestawia drogi, które potwierdza dokumentacja Comarch, oraz te, które trzeba ustalić w analizie (stan na 6.10.2026).
| Droga | Optima | XL |
|---|---|---|
| Interfejs API producenta | Używany przez inne produkty Comarch, autoryzacja przez firmę i operatora | Biblioteka CDN_API.DLL i logowanie funkcją XLLogin |
| Web API i REST | Usługi Web API oferują też partnerzy Comarch, a zakres sprawdza się u producenta | REST API w wersji webowej XL, zakres zależy od wersji |
| Pliki XML (ECOD) | Brak opisu w dokumentacji, którą sprawdziliśmy | Pliki Ecod-XML z zamówieniami i awizami wysyłki |
| Pliki Excel lub FTPS | Droga zapasowa, gdy ERP nie daje interfejsu | Droga zapasowa, gdy ERP nie daje interfejsu |
Dla XL dokumentacja Comarch opisuje interfejs API w bibliotece CDN_API.DLL (opis XL017). Aplikacja loguje się funkcją XLLogin do wskazanej bazy jako operator z hasłem, a operator nie może mieć pustego hasła. Biblioteka współpracuje z .NET i z VBA. Wersja webowa XL ma osobne REST API zbudowane z mikrousług. Instrukcja instalacji do wersji 2023.1 wymienia usługi dla wybranych obszarów, więc przed wyborem tej drogi trzeba sprawdzić, czy obejmuje dokumenty magazynowe w danej wersji.
Dla Optimy dokumentacja Comarch pokazuje interfejs API od strony użytkownika. W opisie połączenia z Comarch BPM jest zakładka Autoryzacja API, w której podaje się firmę oraz operatora z hasłem. To potwierdza, że Optima przyjmuje wywołania z aplikacji zewnętrznych. Opisu programistycznego ani warunków licencji nie znaleźliśmy w publicznej bazie wiedzy, więc trzeba je uzgodnić z Comarch albo z jego partnerem.
ECOD wymaga osobnego wyjaśnienia, bo nazwa pada przy integracjach z XL. Według dokumentacji Comarch to wymiana dokumentów handlowych plikami XML między dostawcą a odbiorcą, w tym zamówień i awiz wysyłki. Wymaga numerów GLN u partnerów i kodów EAN przy towarach. SoftwareStudio wymienia wśród zrealizowanych integracji połączenie CDN XL z ECOD Connector, więc ta droga ma zastosowanie również przy magazynie. To, które komunikaty przejmuje WMS, ustala się osobno dla każdego wdrożenia.
O drodze integracji decydują wersja ERP i licencja interfejsu, a nie preferencje dostawcy WMS.
Kto wykonuje integracje po stronie Studio WMS.net
Za wymianę z ERP odpowiada usługa Windows na serwerze.
Studio WMS.net ma konektor do danej wersji ERP, a integracje wykonuje SSService.exe. To usługa Windows instalowana na serwerze, która realizuje zadania systemu, w tym wymianę danych z Optimą lub XL.
Tabela wyżej pokazuje, co oferuje sama Optima lub XL, od interfejsu API po pliki. Po stronie Studio WMS.net integrację wykonuje usługa. Ogólny opis kanałów wymiany znajdziesz na stronie o integracji z systemem ERP, a tutaj liczy się wersja Twojego ERP.
Które wersje Optimy i XL obejmuje konektor i jaką drogą idą dane, potwierdza analiza przedwdrożeniowa. Ta sama analiza wskazuje dokumenty objęte wymianą.
Obsługa błędów i ponowień przy wymianie z ERP
Niezależnie od drogi dokument zatwierdzony w magazynie nie może zginąć w drodze do ERP.
Magazyn nie czeka na odpowiedź ERP. Zatwierdzony dokument trafia do kolejki wyjściowej w tej samej transakcji SQL, w której powstał, a osobny proces wysyła go do ERP w kolejności FIFO. Kody odpowiedzi i tryb awaryjny opisuje strona o integracji magazynu online z ERP. Tutaj wystarczy to, co zmienia się przy Comarch.
Kolejność ma znaczenie przy każdym ERP. Wydanie WZ nie może dotrzeć do Optimy lub XL przed przyjęciem PZ, które dało mu towar, bo ERP odrzuci wydanie albo zapisze stan ujemny, zależnie od ustawień magazynu. Jeden błędny dokument nie zatrzymuje reszty, ale dokumenty od niego zależne trzeba obsłużyć razem z nim. Analiza ustala więc, kto rozstrzyga takie pary.
| Błąd | Przykład | Reakcja | Kto interweniuje |
|---|---|---|---|
| Przejściowy | Przerwa w usłudze ERP, restart serwera bazy | Ponowienie po odczekaniu, licznik prób rośnie | Dopiero po wyczerpaniu prób |
| Trwały | Indeks nieznany w ERP, operator bez uprawnień do magazynu | Dokument trafia do kolejki błędów | Od razu, bo ponawianie niczego nie zmieni |
| Duplikat | Dokument wysłany przed awarią i ponowiony po niej | Rozpoznanie po kluczu i pominięcie | Nie |
| ERP niedostępny | Okno serwisowe, aktualizacja wersji ERP | Tryb awaryjny, magazyn pracuje dalej | Tylko do kontroli po powrocie usługi |
Dokument zatwierdzony na hali ma dotrzeć do ERP jeden raz i w kolejności, nawet jeśli po drodze ERP przestanie odpowiadać.
Diagnostyka zaczyna się od statusów w kolejce wyjściowej. Gdy księgowość nie widzi w ERP przyjęcia, administrator sprawdza, czy dokument czeka w kolejce, czy leży w kolejce błędów.
Zakres wdrożenia i dane do analizy przedwdrożeniowej
Analiza zamienia ogólny opis integracji w listę dokumentów i pól.
Analiza przedwdrożeniowa rozstrzyga, jaką drogą idą dane i które typy dokumentów obejmuje wymiana. Osobno ustala, kto odpowiada za kolejkę błędów. Integracja jest częścią zakresu wdrożenia WMS, a nie osobnym projektem. Moduł integracji ERP jest dostępny od wersji STANDARD licencji, a jego miejsce w ofercie pokazuje cennik.
Żeby analiza ruszyła sprawnie, firma przygotowuje po stronie ERP cztery rzeczy:
- Wersja i licencja - numer wersji Optimy lub XL oraz informacja, czy firma ma dostęp do interfejsu API i na jakich warunkach.
- Magazyny i dokumenty - lista magazynów ERP i typy dokumentów używane w obiegu razem z numeracją.
- Kartoteka - sposób zapisu kodu EAN i przeliczniki jednostek miary, a także to, czy ERP prowadzi partie.
- Środowisko - baza testowa ERP oraz konto operatora do interfejsu z hasłem.
Po analizie wiadomo, czy partie i terminy ważności prowadzi WMS (partie i daty ważności) i jak ma wyglądać adresacja lokalizacji. Skan na terminalu zapisuje wtedy ruch w WMS, a dokument wraca do ERP kolejką. Testy wymiany na bazie testowej warto zaplanować przed startem produkcyjnym, bo dopiero one pokazują, czy ERP przyjmuje dokumenty w takiej postaci, w jakiej je wysyłamy.