Integracja platformy B2B z Comarch ERP XL: jak działa, jakie są rodzaje i na co uważać

Na czym polega integracja platformy B2B z Comarch ERP XL

Integracja to dwie drogi danych. Pierwsza prowadzi z ERP XL do platformy: towary, ceny klienta, promocje, stany, kontrahenci, limity kredytowe, faktury i rozrachunki. Dzięki niej klient widzi w B2B to samo, co handlowiec w ERP XL. Druga prowadzi z platformy do ERP XL: zamówienie klienta zapisuje się jako dokument ZS, bez przepisywania z maila czy z telefonu.

Każda platforma (system) B2B dla ERP XL obiecuje jedno i drugie. Różnią się tym, jak to robią, a od tego zależą szybkość, zgodność cen, obciążenie serwera, liczba zajętych licencji ERP XL i to, co się stanie po kolejnej aktualizacji systemu.

Jakie dane płyną w którą stronę

Dane	Kierunek	Na co patrzeć
Towary, grupy, atrybuty, zdjęcia	ERP XL → B2B	Bez drugiej kartoteki do uzupełniania w platformie
Cenniki, rabaty kontrahenta, promocje	ERP XL → B2B	Cena w B2B ma się zgadzać z ceną na ZS co do grosza
Stany magazynowe, dostawy w drodze	ERP XL → B2B	Im rzadsza synchronizacja, tym większe ryzyko sprzedaży ponad stan
Kontrahenci, osoby, limity kredytowe, przeterminowania	ERP XL → B2B	Decydują, kto i na jakich warunkach zamawia
Zamówienia	B2B → ERP XL	Jako ZS, z właściwym kontrahentem, cenami i ilościami
Statusy zamówień, faktury, rozrachunki	ERP XL → B2B	Klient nie dzwoni z pytaniem „co z moim zamówieniem”
Reklamacje, zapytania ofertowe	w obie strony	Zależnie od zakresu wdrożenia

Pięć technicznych sposobów połączenia z ERP XL

Comarch ERP XL nie ma jednego „okna” do integracji. Dostawcy korzystają z kilku dróg i często je łączą: dane czytają jedną, a zamówienia zapisują drugą.

1. API ERP XL. Oficjalna biblioteka producenta, przez którą program zewnętrzny tworzy dokumenty tak, jakby robił to pracownik: z numeracją, rabatami, kontrolą kredytową i rezerwacjami. To najbezpieczniejsza droga zapisu zamówień. Ograniczenia: działa tylko w systemie Windows, w trybie 32-bitowym, a sesja API wymaga licencji modułu, więc w wielu wdrożeniach integracja zajmuje stanowisko, z którego nie może korzystać pracownik. Do masowego odczytu danych API jest wolne.
2. Odczyt z bazy SQL. Zapytania wprost do tabel ERP XL. Ten sposób jest szybki i oszczędny, dlatego większość platform pobiera tak towary, ceny i stany. Wymaga dobrze napisanych zapytań, żeby nie spowalniać pracy w ERP XL, i przejrzenia przy każdej aktualizacji, bo struktura tabel się zmienia.
3. Zapis bezpośrednio do tabel SQL. Najszybszy, ale omija logikę ERP XL: numerację, rezerwacje, limity, rabaty i historię zmian. Przy zamówieniach oznacza to ryzyko błędnych dokumentów i problemów po aktualizacji. Do tej samej grupy należą własne triggery i procedury dopisane do bazy ERP XL. Przed konwersją bazy do nowej wersji producent zaleca wyłączenie niestandardowych triggerów.
4. Wymiana plików (XML, CSV, EDI). Prosta i odporna na awarie, ale paczkowa: dane są aktualne z chwili ostatniego eksportu, a zamówienie trzeba zaimportować. Sprawdza się przy rzadkiej wymianie, gorzej przy stanach i cenach, które zmieniają się w ciągu dnia.
5. REST API. Standard w nowych systemach. W klasycznym Comarch ERP XL go nie ma; usługi REST pojawiły się dopiero w nowej generacji systemu, działającej w przeglądarce. Jeśli dostawca mówi o „REST API do ERP XL”, zapytaj, kto je dostarcza i co jest pod spodem.

Cztery rodzaje integracji platform B2B z ERP XL

Każdy rodzaj ma swoje zastosowanie, ale słabe strony wychodzą zwykle dopiero po wdrożeniu, gdy klientów przybywa, a ERP XL dostaje kolejną aktualizację. Dlatego przy każdym opisuję zalety i to, co w praktyce boli najbardziej.

1. B2B pracujące bezpośrednio na bazie ERP XL

Platforma działa na serwerze firmy i czyta dane wprost z produkcyjnej bazy ERP XL, bez synchronizacji.

• Zalety: dane są zawsze bieżące i nie ma osobnej bazy do utrzymania.
• Obciążenie i blokady bazy ERP XL. Każde wyszukiwanie, filtr, lista produktów i przeliczenie koszyka to zapytanie do tej samej bazy, na której w tej chwili pracują sprzedaż, magazyn i księgowość. Gdy kilkudziesięciu klientów zamawia jednocześnie, ERP XL zwalnia, a ciężkie zapytania potrafią blokować tabele. Pracownik czeka na zapis dokumentu, a klient na stronę.
• Wyszukiwarka ograniczona bazą ERP. Baza ERP XL jest zaprojektowana pod dokumenty i księgowość, a nie pod wyszukiwanie z literówkami, synonimami i szybkimi filtrami w katalogu liczącym dziesiątki tysięcy pozycji.
• Serwer i bezpieczeństwo po Twojej stronie. Platformę trzeba wystawić do internetu z sieci firmy oraz utrzymywać serwer WWW, certyfikaty i kopie zapasowe.
• Awaria ERP XL to awaria B2B. Gdy serwer ERP jest wyłączony na aktualizację albo kopię, klienci nie złożą zamówienia nawet do kolejki.
• Związanie z wersją ERP XL. Platforma jest zwykle wydawana pod konkretną wersję ERP XL, więc aktualizacja systemu oznacza też aktualizację platformy w tym samym oknie serwisowym.

2. Własna baza platformy i konektor u klienta

Konektor na serwerze firmy pobiera z ERP XL zmiany i zapisuje zamówienia, a klienci pracują na bazie platformy, zaprojektowanej pod wyszukiwanie i nawigację po dużym katalogu.

• Zalety: ruch klientów w ogóle nie dociera do ERP XL, więc pracownicy nie odczuwają godzin szczytu zamówień; wyszukiwarka działa szybko niezależnie od obciążenia ERP; wyłączenie ERP XL na aktualizację nie wyłącza platformy, a zamówienia czekają w kolejce.
• Wady: dane są aktualne z dokładnością do interwału synchronizacji, a jakość całości zależy od konektora: jak często pobiera zmiany, czym zapisuje zamówienia i co robi przy awarii. O te trzy rzeczy warto dopytać najdokładniej. Niżej opisuję, jak rozwiązałem je w Platformie B2B axonit.

3. Pośrednik (integrator)

Osobny program albo usługa w chmurze łączy platformę z ERP XL, często także ze sklepami i marketplace’ami.

• Zalety: gotowe połączenia z wieloma systemami naraz.
• Dodatkowe ogniwo. Dane przechodzą przez trzeciego dostawcę. Przy awarii winnego szuka się między platformą, integratorem i partnerem ERP, a zamówienia czekają.
• Uproszczone ceny. Uniwersalne mapowanie rzadko obejmuje wszystkie rabaty i promocje ERP XL, więc ceny w B2B bywają „prawie” takie jak na fakturze.
• Rzadsza synchronizacja. Zwykle co kilkanaście minut albo co kilka godzin, więc stany potrafią się rozjechać w ciągu dnia.
• Dwie opłaty i dwa terminy aktualizacji. Za integrator płaci się osobno, często z coroczną opłatą za utrzymanie, a po aktualizacji ERP XL trzeba czekać, aż dostosuje go jego producent.

4. Wymiana plików

Eksport i import XML lub CSV, ręcznie albo według harmonogramu.

• Zalety: niski koszt startu i prosta technologia.
• Wady: ceny i stany z ostatniego eksportu; zamówienia trzeba zaimportować, a błędny albo powtórzony import oznacza brakujące lub zdublowane dokumenty; limit kredytowy i dostępność sprawdza się dopiero po fakcie; dużo ręcznych poprawek.

Integracja „szyta na miarę” przez agencję zwykle należy do drugiego lub trzeciego rodzaju. Różnica polega na tym, że po wdrożeniu utrzymujesz ją sam albo płacisz za każdą zmianę i każdą aktualizację ERP XL.

Platforma na bazie ERP XL czy własna baza z konektorem?

Hurtownie najczęściej wybierają między dwoma pierwszymi rodzajami. Tak wypadają w kryteriach, które po wdrożeniu odczuwa się na co dzień:

Kryterium	Na bazie ERP XL	Własna baza i konektor
Obciążenie ERP XL przez klientów	Każde kliknięcie klienta to zapytanie do bazy produkcyjnej	Ruch klientów nie trafia do ERP XL; konektor pobiera tylko zmiany
Blokady odczuwane przez pracowników ERP XL	Rosną razem z liczbą klientów online	Niezależne od ruchu klientów
Wyszukiwarka przy dużym katalogu	Zależy od bazy ERP i jej obciążenia	Baza zaprojektowana pod wyszukiwanie
Aktualność stanów i cen	Natychmiast	Standardowo co 3–5 minut, a nawet co minutę
Zamówienie w ERP XL	Od razu	W kilka sekund, z kolejką na wypadek awarii
Gdy ERP XL jest wyłączony	B2B nie działa	Klienci zamawiają, zamówienia czekają w kolejce
Serwer WWW i porty w sieci firmy	Tak	Nie, tylko połączenie wychodzące
Aktualizacja ERP XL	Razem z aktualizacją platformy	Konektor zapisujący przez API działa dalej; dostosowanie po stronie dostawcy

Co się dzieje z integracją po aktualizacji ERP XL

Comarch wydaje jedną główną wersję ERP XL rocznie, a do każdej kilka wydań poprawkowych (hotfixów). Każda z nich może zmieniać bazę danych: dochodzą tabele i pola, zmieniają się długości i typy kolumn, a przy wersjach związanych z KSeF także nagłówki dokumentów. W samej wersji 2025.1 przybyło kilkanaście tabel, a kilkadziesiąt kolejnych się zmieniło. Producent w dokumentacji każdej wersji ostrzega, że niestandardowe dodatki mogą przestać działać.

Aktualizacji nie da się długo odkładać, bo wymuszają je przepisy (w latach 2025–2026 przede wszystkim KSeF). Dla integracji oznacza to proste pytanie: co może się w niej zepsuć i kto to naprawi?

• Zapis przez API ERP XL jest najbezpieczniejszy, bo producent utrzymuje zgodność wsteczną interfejsu.
• Zapytania odczytu trzeba przejrzeć, bo struktura tabel się zmienia. Dobrze, gdy da się je poprawić w konfiguracji, bez instalowania nowej wersji programu.
• Najwięcej pracy wymagają integracje, które dopisują do bazy ERP XL własne tabele, procedury i triggery albo zapisują dokumenty z pominięciem logiki ERP XL.

Zapytaj dostawcę wprost, czy dostosowanie do nowej wersji jest w abonamencie, ile trwa i co dzieje się z zamówieniami, zanim zostanie zrobione. Przy integracjach opartych na własnych modyfikacjach koszt bywa liczony od kilku tysięcy do nawet 20 000 zł za każdą aktualizację.

Najczęstsze problemy z integracją B2B i ERP XL

• Promocje i rabaty nie przechodzą do platformy. Rabaty dla grup kontrahentów, ceny stałe czy promocje progowe są liczone inaczej niż w ERP XL. Klient widzi jedną cenę, a na fakturze jest inna.
• Synchronizacja tylko w nocy. Pełna wymiana danych trwa godzinami i obciąża bazę, więc odbywa się po pracy. Przez cały dzień klient widzi stany z wczoraj.
• Sprzedaż ponad stan. Rzadka synchronizacja albo przekazywanie niewłaściwego rodzaju stanu sprawia, że ten sam towar sprzedaje się dwa razy.
• Zamówienia, które utknęły. Przy awarii łącza albo usługi zamówienie czeka na ręczny restart lub na nocną synchronizację.
• Licencja zabrana pracownikowi. Integracja zajmuje stanowisko ERP XL, więc jedna osoba w firmie nie może pracować.
• Odbijanie piłeczki. Gdy coś nie działa, dostawca platformy odsyła do dostawcy integracji, ten do partnera ERP, a zamówienia czekają.

YouTube · 1:20

Jak działa konektor Platformy B2B axonit

Platformę B2B dla Comarch ERP XL zbudowałem według drugiego rodzaju: platforma ma własną bazę zaprojektowaną pod wyszukiwanie, a lekki konektor na serwerze firmy łączy ją z ERP XL. Na co dzień pracuje w Texpol Dystrybucja, z której platformy korzysta ponad 500 firm-klientów. Co z tego wynika w praktyce:

1. Bez VPN i otwierania portów. Konektor sam łączy się z platformą szyfrowanym połączeniem wychodzącym. Baza ERP XL nie jest wystawiona do internetu.
2. Bez dodatkowej licencji ERP XL. Konektor działa na koncie pracownika, który i tak pracuje w ERP XL, i korzysta z licencji jego sesji. Nikomu nie zabiera stanowiska.
3. Zamówienia przez oficjalne API ERP XL. ZS i oferty powstają tak, jakby wystawiał je pracownik: z uprawnieniami wskazanego operatora, z numeracją i kontrolami ERP XL.
4. ZS w ERP XL po kilku sekundach. Od kliknięcia „Złóż zamówienie” do dokumentu w ERP XL mija w połowie przypadków 5,7 sekundy (pomiar z 30 dni pracy produkcyjnej).
5. Zamówienie nie ginie. Gdy łącze albo serwer ERP XL chwilowo nie działa, zamówienie czeka w kolejce i trafia do ERP XL samo, w kolejnych próbach. Jeśli ERP XL odrzuci dokument z powodu własnych ustawień, administrator od razu dostaje maila i ponawia go jednym kliknięciem w panelu.
6. Bez podwójnych zamówień. Każde zamówienie ma unikalny klucz sprawdzany po obu stronach, więc ponowienie nie utworzy drugiego ZS.
7. Harmonogram ustawiasz pod siebie. Każdy rodzaj danych ma własny harmonogram. Stany, ceny i promocje, które muszą być aktualne, platforma odświeża standardowo co 3–5 minut, a jeśli trzeba, częściej (nawet co minutę) albo rzadziej, np. co kilka godzin. Rzadziej zmieniane dane, jak zdjęcia czy atrybuty, odświeżają się co godzinę, co kilka godzin albo w nocy. Synchronizacja pobiera tylko zmiany, a nocny przebieg wyrównuje resztę.
8. Ceny według reguł ERP XL. Cenniki, rabaty kontrahenta i promocje pochodzą z ERP XL. Nie prowadzisz drugiego cennika w platformie.
9. Twoje reguły potwierdzania. Czy zamówienie ma być od razu potwierdzone, czy trafić do bufora, decydują ustawienia firmy, np. limit kredytowy i przeterminowane płatności. Kontrolę kredytową ERP XL zamówienia z B2B przechodzą tak samo jak dokumenty wystawiane ręcznie.
10. Konektor nie zmienia struktury bazy ERP XL. Żadnych własnych tabel, procedur ani triggerów, więc przed konwersją do nowej wersji nie ma czego wyłączać.
11. Lekko dla ERP XL. Klienci szukają i przeglądają katalog w bazie platformy, więc ich ruch nie obciąża ERP XL. W godzinach pracy konektor wykonuje kilkadziesiąt krótkich zapytań na kwadrans.
12. Alarm, zanim zauważy klient. Gdy konektor przestaje odpowiadać albo synchronizacja się nie powiedzie, administrator dostaje maila, a w panelu widzi dokumenty do ponowienia.
13. Zgodność z nowymi wersjami ERP XL po stronie axonit. API ERP XL zachowuje zgodność wsteczną, więc konektor działa z nowszą wersją systemu bez przebudowy. Przy większych zmianach wydaję nową wersję konektora, która rozpoznaje wersję ERP XL u klienta i działa także ze starszymi. Zapytania odczytu poprawiam w konfiguracji. Wszystko w abonamencie, więc nie płacisz za dostosowanie integracji po aktualizacji ERP XL.

10 pytań do dostawcy o integrację z ERP XL

1. Czym platforma zapisuje zamówienia: przez API ERP XL czy bezpośrednio do tabel?
2. Ile licencji ERP XL zajmuje integracja i czy zabiera stanowisko pracownikowi?
3. Czy ceny, rabaty i promocje są liczone według reguł ERP XL i czy da się to sprawdzić co do grosza na wybranych kontrahentach?
4. Jak często synchronizują się stany, ceny i statusy zamówień? Czy mogę to zmienić?
5. Co się dzieje z zamówieniem, gdy łącze albo ERP XL nie działa?
6. Jak platforma chroni przed podwójnym zamówieniem?
7. Czy trzeba otwierać porty, stawiać VPN albo wystawiać bazę ERP XL do internetu?
8. Czy integracja instaluje coś w bazie ERP XL: tabele, procedury, triggery?
9. Kto i za ile dostosowuje integrację po aktualizacji ERP XL? Ile to trwa?
10. Kto odpowiada za całość, gdy coś nie działa: jeden dostawca czy kilku?

Pytania o samą platformę (funkcje, wygląd na telefonie, wdrożenie) zebrałem w artykule Jak wybrać platformę B2B dla Comarch ERP XL, a składniki ceny w tekście Ile kosztuje platforma B2B dla Comarch ERP XL.