ntegracja e-commerce z ERP nie jest jednym projektem, lecz zbiorem od pięciu do ośmiu odrębnych przepływów danych, z których każdy ma inny kierunek, inną wymaganą świeżość i inne zachowanie w razie awarii. Projekty w tym obszarze rzadko przewracają się na technologii. Przewracają się na dwóch nierozstrzygniętych kwestiach: kto jest właścicielem którego obiektu danych i co ma się stać, gdy jedna strona nie odpowiada.
Siedem przepływów i wymagana aktualność danych
Pierwsza decyzja projektowa to nie wybór narzędzia, lecz wypełnienie tej tabeli dla własnej organizacji.
Kto jest właścicielem czego
Ta tabela jest ważniejsza od wyboru technologii. Bez jej wypełnienia i zaakceptowania przez biznes integracja będzie działać, ale dane będą się rozjeżdżać.
Pięć wzorców architektonicznych
W praktyce dojrzała architektura B2B używa jednocześnie trzech: zdarzeniowo dla zamówień i stanów, wsadowo dla katalogu i rozliczeń, EDI dla dużych odbiorców. Kluczowe jest to, żeby wszystkie kanały trafiały do tego samego modelu zamówienia w warstwie pośredniczącej. Rozgałęzienie kodu per kanał kończy się dwiema rozjeżdżającymi się implementacjami obsługi zamówienia w ciągu roku.
Limity, które przesądzają o wykonalności
To najbardziej pomijana część rozmowy o integracji. Dostawcy publikują twarde limity, a projekty planuje się, jakby ich nie było.
Dynamics 365 Business Central
Limity operacyjne są liczone na użytkownika, nie na środowisko:
- maksymalnie 5 jednoczesnych żądań (request) OData na użytkownika
- 6 000 żądań w pięciominutowym oknie przesuwnym
- limit czasu operacji 8 minut, żądania (request) API przerywane po 10 minutach z kodem 504
- maksymalnie 100 operacji w jednej paczce
- 10 jednoczesnych sesji w tle na środowisko, maksymalnie 5 zadań zaplanowanych na użytkownika
- przekroczenie zwraca 429 Too Many Requests, a Microsoft zaleca ponowienia z wykładniczym wycofaniem i losowym rozrzutem
Wniosek architektoniczny, najważniejszy w całym tekście: jedno konto serwisowe integracji oznacza twardy sufit pięciu jednoczesnych żądań. Skalowanie wymaga rozdzielenia obciążenia na wiele kont, a nie dokupienia mocy.
Comarch ERP XL
API to natywna biblioteka Windows (CDN_API.DLL), wymagająca katalogu instalacyjnego ERP w zmiennej PATH i dołączenia wątku, z wprost sformułowanym w dokumentacji ostrzeżeniem, żeby nie stosować wzorców asynchronicznych. W praktyce oznacza to działanie synchroniczne i powiązanie z wątkiem. Nie da się jej odpytać wprost z platformy w chmurze. Do architektury wchodzi obowiązkowo agent uruchomiony na maszynie z zainstalowanym ERP oraz warstwa pośrednicząca, która zarządza współbieżnością, bo sam ERP nie ma historii skalowania poziomego. To pozycja budżetowa, nie szczegół techniczny.
Shopify
- limit API oparty na kosztach zapytań, punkty na sekundę: Standard 100, Advanced 200, Plus 1 000, Enterprise 2 000, jedno zapytanie maksymalnie 1 000 punktów
- Shopify wprost nie gwarantuje jednokrotnego dostarczenia webhooka. Aplikacja może otrzymać ten sam webhook wielokrotnie, na przykład po przekroczeniu limitu czasu. Deduplikacja po nagłówku X-Shopify-Webhook-Id, ponowienia do 8 prób w ciągu 4 godzin
- pułapka cicha: ograniczenie tworzenia checkoutu w Storefront API zwraca HTTP 200 z błędem „Throttled". Kod 200 nie oznacza sukcesu
NetSuite
Współbieżność jest zarządzana na poziomie konta, przez Service Tier i licencje SuiteCloud Plus. Domyślnie konektor pracuje na 5 jednoczesnych sesjach, a jedno miejsce pozostaje zawsze nieprzydzielone.
Sześć trybów awarii
1. Duplikaty zamówień
Kolejki dostarczają co najmniej raz, a Shopify nie gwarantuje jednokrotnego dostarczenia webhooka. Bez zabezpieczenia duplikaty są kwestią czasu, nie prawdopodobieństwa.
Rozwiązanie: numer zamówienia ze sklepu jako klucz naturalny z ograniczeniem unikalności w ERP, a konektor musi interpretować odpowiedź „już istnieje" jako sukces, nie jako powód do ponowienia. Dodatkowo trwała deduplikacja po identyfikatorze webhooka, z zaplanowanym okresem przechowywania.
2. ERP jako wąskie gardło
Limity z poprzedniej sekcji nie są teoretyczne. Pięć jednoczesnych żądań na użytkownika w Business Central oznacza, że masowa synchronizacja katalogu i obsługa zamówień w godzinach szczytu konkurują o ten sam limit. Objawem jest checkout, który zwalnia w promocji.
Rozwiązanie: kolejka przed ERP, rozdzielenie kont serwisowych per rodzaj obciążenia, oddzielenie zadań masowych od ścieżki transakcyjnej oraz odcięcie dostępności checkoutu od dostępności ERP.
3. Nocna synchronizacja jako źródło błędnych stanów
Najlepszy dostępny przykład podaje dokumentacja Microsoftu i warto go znać dokładnie, bo obnaża mechanizm. Dziesięć sztuk na stanie, dwa otwarte zamówienia sprzedaży: jedna sztuka na poniedziałek i dwie na czwartek. Przy metodzie liczenia „przewidywany dostępny bilans na dziś" synchronizacja we wtorek publikuje dziewięć, a w piątek siedem.
Liczba widoczna w sklepie jest funkcją tego, kiedy uruchomiono zadanie, nie fizycznego stanu magazynu. Dodatkowo konektor zapisuje stan tylko wtedy, gdy różni się od wartości aktualnej w sklepie, więc nieudany przebieg pośredni może zostawić wartość nieaktualną, której kolejne przebiegi nie poprawią, dopóki wartość się nie zmieni.
4. Nadsprzedaż z nadpisywania stanów
To najkosztowniejszy błąd i wynika z nieporozumienia opisanego w tabeli właścicielstwa.
W Adobe Commerce dostępna ilość to suma ilości w źródłach powiększona o rezerwacje, które są ujemne, i pomniejszona o próg braku dostępności. Rezerwacje powstają w chwili złożenia zamówienia i są kompensowane przy wysyłce albo anulowaniu. Tyle mówi dokumentacja Adobe. Wniosek, który z tego wyciągamy na podstawie własnych projektów, jest następujący: integracja, która wpisuje ilości do źródeł bezpośrednio, omija cykl życia rezerwacji. Efektem są rezerwacje osierocone, błędna ilość dostępna do sprzedaży i zamówienia na towar już zarezerwowany.
Rozwiązanie: ERP jest właścicielem stanu fizycznego, platforma właścicielem rezerwacji. Integracja nigdy nie nadpisuje stanu w sposób pomijający mechanizm rezerwacji, a zmiany w źródłach wykonuje się po przetworzeniu zamówień.
5. Brak jednego właściciela ceny
Cena bazowa w ERP, promocje w sklepie, cena kontraktowa w trzecim systemie i brak reguły arbitrażu. Problem jest architektoniczny, nie techniczny.
Dwa poprawne rozwiązania, oba spójne:
- Materializacja. ERP jest autorytatywny i wypycha ceny do struktur platformy. Tak działa pierwszostronny konektor Microsoftu dla Shopify: ceny i rabaty trafiają do grup cenowych, katalogów i rynków B2B. Zaleta: wydajność. Wada: opóźnienie i konieczność pełnej propagacji.
- Wywołanie w czasie rzeczywistym. Warstwa cenowa jest odpytywana przy wyświetleniu i w koszyku. Zaleta: dokładność. Wada: opóźnienie storefrontu i uzależnienie od dostępności systemu cenowego, dlatego przy złożonych cennikach stosuje się wydzielony serwer cen, a nie bezpośrednie odpytywanie ERP.
Czego nie robić: liczyć ceny w dwóch miejscach jednocześnie. To gwarantuje korekty faktur.
6. Niezgodność modeli danych
Nie jest to problem teoretyczny. Poniżej przypadki udokumentowane przez producentów.
- Jednostki miary jako warianty. Gdy różne jednostki tego samego produktu są wariantami, ta sama dostępność przypisuje się do każdego wariantu, co prowadzi do nieprawidłowej dostępnej ilości. Microsoft opisuje to wprost jako znane ograniczenie.
- Zestawy produktowe. Aplikacja Bundles w Shopify blokuje aktualizacje zapasów przez API, więc produkty zestawowe muszą być mapowane na pozycje nieobjęte gospodarką magazynową.
- Podatki. Klienci wymagają szablonów kraju i regionu, bez których dokumenty księgują się z błędną stawką.
- Ilości ułamkowe i ujemne powodują pomijanie synchronizacji faktur.
- Ciche pominięcia. Zamówienia nie synchronizują się z trzech strukturalnych powodów: zostały zarchiwizowane, powstały przed datą ostatniej synchronizacji albo wykluczyły je kryteria filtra. Żaden z nich nie zgłasza błędu, i to jest najgorszy rodzaj awarii.
Rozwiązanie w warstwie procesu, nie kodu: widoczna lista rekordów pominiętych, korelacyjne identyfikatory w logach oraz alerting na wzrost liczby pominięć. Dobrym wzorcem jest tu warstwa antykorupcyjna, czyli translator odcinający model platformy od modelu ERP, z zastrzeżeniem, że sam wprowadza opóźnienie i staje się elementem wymagającym monitorowania.
Specyfika polska
Trzy rzeczy, których nie ma w międzynarodowych poradnikach, a które przesądzają o projekcie w Polsce.
KSeF zmienia właścicielstwo faktury. Obowiązek wystawiania faktur przez Krajowy System e-Faktur objął od 1 lutego 2026 podatników o sprzedaży powyżej 200 mln zł za 2024 rok wraz z VAT, a od 1 kwietnia 2026 pozostałych przedsiębiorców z wyjątkiem najmniejszych podatników. Ci ostatni, czyli wystawiający faktury do 450 zł przy sprzedaży miesięcznej do 10 tys. zł, wchodzą od 1 stycznia 2027. Konsekwencja projektowa jest jednoznaczna: faktura jest obiektem ERP z numeracją KSeF, a sklep nigdy jej nie generuje ani nie numeruje. Jeśli integracja zakładała fakturowanie po stronie e-commerce, wymaga przeprojektowania.
Brak gotowych konektorów do polskich ERP. W oficjalnym Shopware Store są rozszerzenia do Odoo, SAP Business One i Dynamics 365 Business Central, ale wyszukiwanie na 24 sierpnia 2026 nie zwraca żadnego konektora do Comarch, enova365, Symfonii ani Streamsoftu. Zawartość sklepu z rozszerzeniami się zmienia, więc warto to sprawdzić ponownie przed wyceną. Program partnerski Shopify z certyfikowanymi konektorami obejmuje Business Central, NetSuite, Infor, Acumatica i Brightpearl, również nie polskie systemy. Adobe udostępnia Integration Starter Kit, który jest szkieletem zdarzeniowym na App Builder z sześcioma encjami, a nie konektorem do konkretnego ERP. Dla polskiego ERP integracja jest zawsze pracą dedykowaną.
Charakterystyka lokalnych systemów. Comarch ERP Enterprise udostępnia system integracji BIS dostępny zdalnie przez CORBA oraz usługi sieciowe w wariantach SOAP i REST. Niezależnie od BIS system ma inne interfejsy zewnętrzne: WebDAV przez Knowledge Store, dostęp do bazy przez JDBC i ODBC oraz protokoły natywne, w tym Java RMI. Warto tego nie mieszać, bo są to różne warstwy o różnym przeznaczeniu. enova365 ma licencjonowany moduł Integrator z REST i SOAP, ale sterowany harmonogramem zadań, czyli wsadowy z założenia, bez udokumentowanego trybu czasu rzeczywistego. To trzeba wiedzieć przed obiecaniem klientowi stanów magazynowych aktualizowanych na bieżąco.
EDI nie znika. Dla dostawców sieci handlowych EDI jest obowiązkiem narzuconym przez odbiorcę, nie wyborem technologicznym. Comarch ERP XL obsługuje wymianę zamówień i faktur jako XML według szablonów standardu EDI. Realny problem współistnienia EDI i API to identyfikatory: EDI adresuje partnerów przez GLN i produkty przez GTIN, a sklep używa wewnętrznych identyfikatorów klientów i SKU. Kartoteka w ERP musi nieść jedno i drugie, inaczej oba kanały będą tworzyć zduplikowanych klientów i niedopasowane pozycje.
Jak wygląda dobrze zrobiona integracja
Lista kontrolna, którą stosujemy przed uznaniem integracji za gotową.
- Tabela właścicielstwa wypełniona i zaakceptowana przez biznes, nie tylko przez IT.
- Wymagana świeżość ustalona per obiekt, z uzasadnieniem kosztem pomyłki.
- Idempotencja dla każdego przepływu zapisującego, z kluczem naturalnym i ograniczeniem unikalności.
- Kolejka martwych listów i procedura ponownego przetworzenia, opisana i przetestowana.
- Ponowienia z wykładniczym wycofaniem i losowym rozrzutem, z limitem prób i wyłącznikiem obwodu.
- Identyfikatory korelacyjne w logach po obu stronach.
- Widoczna lista rekordów pominiętych i alerting na jej wzrost, zamiast cichych porażek.
- Polityka na wypadek niedostępności ERP dla każdego przepływu: czy checkout działa dalej, czy blokuje, czy przyjmuje zamówienie warunkowo.
- Test na realnym wolumenie, nie na średnim, z uwzględnieniem limitów API obu stron.
- Rozdzielone konta serwisowe dla obciążeń masowych i transakcyjnych.
Punkt ósmy jest tym, którego najczęściej brakuje, a jest decyzją biznesową, nie techniczną. Odpowiedź „checkout blokuje, gdy nie znamy limitu kredytowego" jest poprawna dla części firm i katastrofalna dla innych.
Doświadczenie Strix
Strix jest agencją e-commerce działającą od 2009 roku, z biurami w Krakowie, Utrechcie i Frankfurcie nad Menem. Integracje z ERP oraz serwer cen traktujemy jako osobne kompetencje, ponieważ to one najczęściej decydują o powodzeniu projektu B2B.
- Lynka: wydajny system e-commerce B2B przy złożonej konfiguracji produktu.
- Orno: platforma B2B nastawiona na relacje z klientami, z pełnym obiegiem danych handlowych.
- Grupa 3W: cyfrowy fundament sprzedaży B2B, projekt zaczynający się od procesu, nie od sklepu.
- Reifen1+ (Interpneu): cyfrowe połączenie e-commerce z obsługą warsztatową, czyli integracja wychodząca poza samo zamówienie.
- EMM International: platforma B2B dla klienta wielorynkowego.
- home&you: wdrożenie Ergonode PIM, czyli rozdzielenie właścicielstwa danych produktowych od ERP.
- Tatuum: przebudowa architektury na Magento z PIM Ergonode.
Projekty integracyjne zaczynamy od wypełnienia tabeli właścicielstwa i od inwentaryzacji limitów po stronie ERP. Jeśli okazuje się, że ERP nie udźwignie wymaganej świeżości, mówimy to przed wyceną, a nie po wdrożeniu.
Często zadawane pytania
Jakie dane trzeba synchronizować między e-commerce i ERP? Zwykle siedem przepływów: kartoteka klientów i warunki handlowe, reguły cenowe, stany magazynowe, limity kredytowe i rozrachunki, zamówienia, statusy realizacji oraz faktury i dokumenty. Każdy ma inny kierunek i inną wymaganą świeżość.
Czy synchronizacja stanów magazynowych musi być w czasie rzeczywistym? Dla szybko rotujących pozycji zwykle tak, w praktyce od sekund do kilkunastu minut, i niezależnie od tego sklep musi utrzymywać bufor przeciw nadsprzedaży. Nocna synchronizacja publikuje stan zależny od momentu uruchomienia zadania, a nie od faktycznego stanu magazynu.
Dlaczego pojawiają się duplikaty zamówień w ERP? Ponieważ kolejki komunikatów gwarantują dostarczenie co najmniej raz, a Shopify wprost nie gwarantuje jednokrotnego dostarczenia webhooka i ponawia próby do ośmiu razy w ciągu czterech godzin. Zabezpieczeniem jest idempotencja: numer zamówienia jako klucz naturalny z ograniczeniem unikalności w ERP oraz deduplikacja po identyfikatorze webhooka.
Kto powinien być właścicielem ceny, ERP czy platforma? ERP powinien być właścicielem ceny bazowej i warunków umownych, platforma właścicielem promocji i mechanik sprzedażowych. Kluczowe jest, żeby cena nie była wyliczana w dwóch miejscach jednocześnie. Przy złożonych cennikach stosuje się wydzielony serwer cen zamiast odpytywania ERP przy każdym wyświetleniu.
Czy istnieje gotowy konektor między Shopware a polskim ERP? Nie. W oficjalnym Shopware Store nie ma rozszerzeń do Comarch, enova365, Symfonii ani Streamsoftu. Shopware dostarcza infrastrukturę integracyjną: Admin API z operacjami masowymi przez Sync API, Store API oraz App System z webhookami. Integracja z polskim ERP jest pracą dedykowaną.
Co ogranicza wydajność integracji z Dynamics 365 Business Central? Limity operacyjne liczone na użytkownika: maksymalnie pięć jednoczesnych żądań OData, 6 000 żądań w pięciominutowym oknie, limit czasu operacji osiem minut i maksymalnie sto operacji w paczce. Jedno konto serwisowe integracji tworzy więc twardy sufit pięciu jednoczesnych żądań, a skalowanie wymaga rozdzielenia obciążenia na wiele kont.
Dlaczego integracja z Comarch ERP XL wymaga dodatkowej warstwy? Ponieważ API tego systemu to biblioteka Windows działająca synchronicznie, wymagająca uruchomienia na maszynie z zainstalowanym ERP. Nie da się jej odpytać wprost z platformy w chmurze, więc architektura musi zawierać agenta po stronie ERP i warstwę pośredniczącą zarządzającą współbieżnością.
Jak KSeF wpływa na integrację e-commerce z ERP? Faktura staje się obiektem ERP z numeracją nadaną przez Krajowy System e-Faktur, a sklep nigdy jej nie generuje ani nie numeruje. Obowiązek objął od 1 lutego 2026 podatników o sprzedaży powyżej 200 mln zł za 2024 rok, od 1 kwietnia 2026 pozostałych przedsiębiorców, a od 1 stycznia 2027 podmioty najmniejsze.
Czy EDI jest jeszcze potrzebne, jeśli mamy API? Tak, jeśli sprzedajesz do sieci handlowych albo dużych odbiorców, ponieważ tam kanał narzuca odbiorca. EDI i API współistnieją: oba powinny trafiać do tego samego modelu zamówienia w warstwie pośredniczącej. Głównym problemem jest zgodność identyfikatorów, bo EDI używa GLN i GTIN, a sklep wewnętrznych identyfikatorów i SKU.
Czy iPaaS jest lepszy od integracji dedykowanej? Zależy od wolumenu i liczby systemów. iPaaS skraca czas wdrożenia przy wielu systemach SaaS, ale rozliczenie za operacje skaluje się źle przy dużym ruchu synchronizacji stanów i zamówień, a dla ERP on-premise i tak wymaga agenta. Warto policzyć koszt na realnych wolumenach, nie na średnich.
Kolejny krok
Integrację zaczynamy od dwóch rzeczy: tabeli właścicielstwa danych i inwentaryzacji limitów po stronie ERP. Jedno i drugie to kwestia dni, a rozstrzyga, czy planowana architektura jest w ogóle wykonalna.
Strix, agencja e-commerce, od 2009 roku. Integracje ERP, serwer cen, platformy B2B.