Integracja z ERP, płatnościami i kurierami nie jest projektem na hasło „cyfryzacja” — to przede wszystkim oszczędność czasu i mniej pomyłek w codziennej obsłudze zamówień. Zanim wejdziemy w technikę, warto spojrzeć na liczby: ręczna obsługa jednego zamówienia zajmuje zwykle 4–7 minut, a po integracji 20–40 sekund. Poniżej znajdziesz część organizacyjną: najczęstsze błędy przy wdrożeniu, checklistę do przejścia przed startem i odpowiedzi na pytania, które słyszymy najczęściej od firm ze Szczebrzeszyna i okolic.

Co daje firmie integracja ERP, płatności i kurierów — w liczbach

Opłacalność najlepiej sprawdzić na własnych zamówieniach, nie na ogólnych deklaracjach. Zmierz, ile zajmuje Ci obsługa jednego zamówienia od opłacenia do nadania. W małej firmie to zwykle 4–7 minut: przepisanie danych klienta i pozycji do ERP, dokument sprzedaży, etykieta w panelu kuriera, wklejenie numeru przesyłki do sklepu, mail do klienta. Po integracji ten sam cykl zamyka się w 20–40 sekundach, bo zostaje głównie nadzór i obsługa wyjątków.

Policz to na 200 zamówieniach miesięcznie. Przy 5 minutach na zamówienie daje to 1000 minut, czyli 16 godzin 40 minut pracy co miesiąc — blisko 200 godzin w roku, więcej niż pełny miesiąc pracy jednej osoby. Po integracji, przy 30 sekundach na zamówienie, zostaje około 100 minut miesięcznie. Różnica to ponad 15 godzin miesięcznie, które możesz przesunąć na obsługę klienta, uzupełnianie oferty albo po prostu krótszy dzień pracy.

Koszt błędu przy ręcznym przepisywaniu. Przy 200 zamówieniach i 3% pomyłek mówimy o 6 zdarzeniach miesięcznie. Zły adres to przesyłka zwrotna i ponowny koszt nadania. Zła kwota albo brak faktury to korespondencja, korekta i czas na uzgodnienie z księgowością. Jedno takie zdarzenie to zwykle 15–40 minut pracy. 6 × 25 minut daje 2,5 godziny miesięcznie, których nie widać w żadnym raporcie — a dochodzi jeszcze koszt transportu i ryzyko, że klient nie wróci.

Próg opłacalności. W naszej praktyce integracja zwraca się przy 150–200 zamówieniach miesięcznie, w 2–5 miesięcy. Poniżej 60–80 zamówień oszczędność rzędu 3–4 godzin miesięcznie nie pokryje kosztu utrzymania — lepiej wtedy zawęzić zakres do jednego elementu, najczęściej płatności i etykiet. Zanim podejmiesz decyzję, porównaj stawki: koszt integracji ERP, płatności i kurierów w Zamościu pokazuje, czy liczysz się z jednorazowym wdrożeniem, czy z abonamentem.

Etap obsługiRęczniePo integracji
Przepisanie danych klienta i pozycji do ERP1,5–2,5 min0 s — dane z zamówienia
Dokument sprzedaży / faktura1–1,5 minautomatycznie, bez udziału osoby
Etykieta kurierska1–2 minkilka sekund
Numer przesyłki w sklepie + mail do klienta0,5–1 minautomatycznie
Razem4–7 min20–40 s nadzoru

Jak wygląda przepływ zamówienia po integracji — krok po kroku

Po integracji zamówienie przestaje być zadaniem dla człowieka, a staje się ciągiem zdarzeń. Zestaw tę listę z własną codziennością i sprawdź, którego kroku u Ciebie brakuje.

  1. Złożenie zamówienia — klient wybiera płatność i kuriera. Sklep zapisuje zamówienie ze statusem oczekiwania na płatność.
  2. Webhook płatności — operator (Przelewy24, PayU, Stripe, tpay) wysyła żądanie POST na adres Twojego sklepu. To on jest źródłem prawdy, nie powrót klienta na stronę podziękowania — kartę można zamknąć przed przekierowaniem.
  3. Dokument w ERP — mostek mapuje kontrahenta, pozycje i stawki VAT. Tu wychodzą różnice słowników: jednostki miary, grupy towarowe, zapis NIP-u.
  4. Rezerwacja stanu — towar musi zniknąć z dostępnych, zanim ktoś kupi go drugi raz.
  5. Etykieta kurierska — API kuriera generuje etykietę i numer przesyłki.
  6. Numer przesyłki w sklepie — zamówienie dostaje status wysłane i numer widoczny dla klienta.
  7. Mail do klienta — z numerem i linkiem do śledzenia.
  8. Faktura — PDF do klienta, dokument w księgowości.

Synchronicznie czy przez kolejkę. W trybie synchronicznym sklep czeka na odpowiedź ERP w tym samym żądaniu. Gdy ERP jest aktualizowane, ma wolne zapytanie albo restart, żądanie kończy się timeoutem i nie wiadomo, czy dokument powstał — stąd duplikaty faktur. Kolejka (tabela zadań w bazie, WP-Cron, Redis, RabbitMQ) zapisuje zadanie i przetwarza je w tle z ponowieniami. Każdy task musi mieć klucz idempotencji, np. numer zamówienia plus typ zadania, żeby ponowienie nie utworzyło drugiej faktury, oraz kolejkę zadań nieudanych do ręcznego przejrzenia. W Black Friday kolejka przyjmie 2000 zamówień i poda je ERP w tempie, które ten wytrzyma, zamiast zwracać błędy 500.

Które kroki muszą dziać się od razu? Potwierdzenie płatności, rezerwacja stanu, etykieta i mail z numerem — tu liczą się sekundy. Dokumenty magazynowe, faktura zbiorcza, raporty i synchronizacja stanów z hurtowni mogą poczekać 15–30 minut w harmonogramie. Mechanikę webhooków w sklepie opisuje dokumentacja WooCommerce — zamówienia i webhooki.

KrokTrybMaksymalne opóźnienie
Webhook płatnościczas rzeczywistysekundy
Dokument w ERPkolejka1–15 min
Rezerwacja stanuczas rzeczywistysekundy
Etykieta kurierskakolejka z priorytetem1–5 min
Numer przesyłki w sklepie + mailkolejkado 15 min
Fakturaharmonogram15–60 min
Synchronizacja stanów z hurtowniharmonogram15–30 min

ERP, z którym najczęściej łączymy sklepy w regionie

W małych i średnich firmach w okolicy trafiamy na cztery grupy systemów i każda wymaga innego podejścia.

Subiekt GT. Zapis dokumentów robi się przez Sferę — bibliotekę COM działającą na Windows, która wymaga wykupionej licencji Sfery i zwykle jednego procesu na bazę. Odczyt stanów przez zapytania SQL jest szybszy do wdrożenia, ale nie utworzy dokumentu, a schemat bazy nie jest publicznym API i może się zmienić po aktualizacji. Praktyczny układ to zapis przez Sferę, odczyt do raportów z bazy.

Subiekt nexo. Komunikacja przez Sferę nexo dla podmiotu — wymaga licencji i konfiguracji po stronie serwera, za to dobrze nadaje się do pracy z dokumentami magazynowymi. Typowy problem: mapowanie jednostek miary i grup towarowych między sklepem a kartoteką.

Comarch ERP Optima. Integracja przez Optima API — tworzenie kontrahentów i dokumentów. Uwaga na wersję licencji i słowniki; bez ich uzgodnienia dokumenty wpadają do złych grup.

WF-Mag i WAPRO. Część wersji nie ma publicznego API, więc wymiana idzie plikami eksportu/importu (CSV, XML) w harmonogramie co 15–60 minut. Pułapka: brak potwierdzenia zapisu. Trzeba pilnować plików wynikowych i drugiego zestawu stanów.

Fakturownia, ifirma, inFakt. Dobre rozwiązanie dla firm bez klasycznego ERP — integracja idzie przez API dokumentów, tworzy fakturę i kontrahenta. Ale to nie magazyn: stany trzeba trzymać w sklepie albo w prostym module, a przy dwóch kanałach sprzedaży zaczyna brakować wspólnego stanu.

Kiedy mostek własny. Jeśli ERP nie ma API, masz kilka sklepów lub kanałów, nietypowe mapowanie albo potrzebujesz kolejki, logu zdarzeń i raportu błędów — piszemy moduł pośredniczący. Jeśli masz jeden sklep i jeden ERP z API, gotowy moduł plus konfiguracja jest tańszy i szybszy. Podobne wdrożenia w mniejszych miejscowościach opisujemy przy okazji integracji z ERP i kurierami w Narolu.

SystemKanał wymianyNa co uważać
Subiekt GTSfera (COM) + odczyt SQLlicencja Sfery, jeden proces na bazę, zmiany schematu bazy
Subiekt nexoSfera nexo / API nexokonfiguracja po stronie serwera, mapowanie jednostek i grup
Comarch ERP OptimaOptima APIwersja licencji, słowniki kontrahentów i towarów
WF-Mag, WAPROpliki CSV/XML, część z APIbrak potwierdzenia zapisu, dwa źródła stanów
Fakturownia, ifirma, inFaktREST API dokumentówbrak magazynu — stany trzeba trzymać w sklepie

Płatności online — co musi obsłużyć sklep w 2025 roku

Pięć bramek, które w polskich sklepach pojawiają się najczęściej, to Przelewy24, PayU, Tpay, Autopay i Stripe. Wybór nie zależy od wyglądu panelu, a od tego, co musi obsłużyć koszyk: BLIK, karty, przelewy online, płatności odroczone i raty. BLIK odpowiada za większość transakcji detalicznych — jeśli bramka obsługuje go słabo (brak zwrotu na BLIK, brak ponowienia płatności z panelu), klient kończy z ręcznym przelewem i mailem do księgowości.

Drugi filar to webhooki, czyli powiadomienia od bramki o zmianie statusu płatności. Każdy trzeba zweryfikować: podpis HMAC w nagłówku, lista dozwolonych adresów IP bramki, dopasowanie po identyfikatorze transakcji i kwocie. Webhook bez weryfikacji źródła to otwarte drzwi — każdy może wysłać POST „zapłacono”. Konfigurację webhooków w WooCommerce opisuje oficjalna dokumentacja WooCommerce.

Co się dzieje, gdy webhook nie dotrze — bramka miała przerwę, hosting odrzucił żądanie, wystąpił timeout? Zamówienie zostaje na statusie „oczekiwanie na płatność”, a klient pisze albo dzwoni. Potrzebne są dwie rzeczy: rejestr zdarzeń i bezpieczne odpytywanie. Cron co 10–15 minut pobiera transakcje starsze niż 15 minut i wciąż niepotwierdzone, pyta API bramki po identyfikatorze transakcji i zapisuje odpowiedź w logu. Zapytanie musi być idempotentne — to samo zdarzenie nie może dwa razy wystawić faktury ani dwa razy zdjąć stanu magazynowego.

Najczęstsze źródło rozjazdów to mapowanie statusów. Bramka ma kilka stanów (nowa, w trakcie, potwierdzona, anulowana, zwrócona), sklep swoje (PrestaShop: order state, WooCommerce: wc-pending, wc-processing, wc-refunded), a ERP jeszcze inne. Ta tabela musi być uzgodniona z księgowością przed pierwszym testem — inaczej po miesiącu zwroty lądują w ERP jako nowe zamówienia. Ten sam układ bramka–sklep–ERP wraca w każdym wdrożeniu, także przy integracjach płatności, ERP i kurierów dla firm z Hrubieszowa.

Status w bramceStatus w sklepieDokument w ERP
nowa / oczekującaoczekiwanie na płatność (wc-pending, PrestaShop: oczekiwanie na przelew)brak dokumentu
potwierdzona / settledw realizacji (wc-processing)zamówienie sprzedaży, następnie faktura
anulowana / odrzuconaanulowane (wc-cancelled)brak dokumentu lub zamówienie anulowane
zwrot / refundzwrócone (wc-refunded)korekta faktury + przyjęcie towaru na magazyn
płatność częściowa / nadpłataw realizacji + notatka do zamówieniawymaga ustalenia z księgowością — najczęstszy spór

Kurierzy i wysyłka: InPost, DPD, DHL, Poczta Polska

Integracja kurierska to nie jedna wtyczka, a zestaw reguł do ustalenia przed wdrożeniem. Pierwsza: etykiety. Potrzebne jest generowanie pojedyncze (z karty zamówienia) i zbiorcze w formie manifestu — jednego pliku PDF z etykietami na cały dzień, gotowego przed godziną, w której kurier odbiera paczki. Druga: zamówienie odbioru o stałej godzinie, np. codziennie 13:00–15:00. Bez tego ktoś ręcznie zamawia kuriera każdego dnia.

Trzecia reguła to punkty odbioru. Listy paczkomatów i punktów (DPD Pickup, placówki Poczty) zmieniają się co tydzień, więc nie wpisuje się ich ręcznie — pobiera się je z API przewoźnika i mapuje na metody dostawy w sklepie. Bez mapowania klient wybiera punkt, którego już nie ma. Czwarta: limity. Paczkomat ma gabaryty A, B, C i maksymalną wagę, przesyłka kurierska — własne. Aktualne wartości bierz z cennika przewoźnika i sprawdź przy każdej zmianie umowy, bo te liczby się zmieniają.

Piąta: statusy. Numer nadawczy musi wrócić do zamówienia i wywołać maila do klienta, a statusy przesyłki (nadana, w drodze, do doręczenia, doręczona, awizo, zwrot do nadawcy) — zaktualizować status zamówienia w sklepie i w ERP. Typowa pułapka: klient dostaje dwa powiadomienia, jedno od sklepu, drugie od kuriera. Lepiej wyłączyć jedno.

Szósta: zwroty i ponowne wysyłki. Zwrot to osobny dokument w ERP (przyjęcie na magazyn plus korekta), a ponowna wysyłka — nowa paczka powiązana z tym samym zamówieniem, żeby historia nie zniknęła. Siódma: awaria API. Etykiety powinny iść przez kolejkę z ponowieniami (1 min, 5 min, 15 min), a gdy przewoźnik nie odpowiada dłużej — potrzebny jest fallback: etykieta z panelu kuriera i ręczne wpisanie numeru do zamówienia. Bez tego w dzień awarii stoi cała wysyłka. Kolejność reguł opisujemy też przy spięciu sklepu z kurierami i ERP w Narolu, a szczegóły modułów przewoźnika znajdziesz w dokumentacji dla deweloperów PrestaShop.

PrzewoźnikCo zwykle wchodzi w integracjęCo potwierdzić w dokumentacji przed wyceną
InPostetykiety, paczkomaty i punkty odbioru, statusy przesyłekzakres API, limity gabarytów, sposób pobierania listy punktów
DPDetykiety kurierskie, punkty Pickup, zamówienie odbiorudopuszczalne wagi i wymiary, format etykiety, statusy zwrotów
DHLetykiety kurierskie, przesyłki krajowe i zagraniczneczy potrzebna umowa na API, jakie statusy są udostępniane
Poczta Polskanadawanie przesyłek, potwierdzenia nadania, statusyzakres usług w API, sposób rozliczania i zwrotów

Ile to kosztuje i ile trwa — realne widełki godzinowe

Widełki, których używamy w wycenach dla sklepu z jednym magazynem i standardowym ERP: płatności 8–20 h, kurierzy 12–30 h (jeden przewoźnik; każdy kolejny to zwykle 4–8 h), ERP 24–80 h, moduł niestandardowy od 16 h. Do tego dochodzą testy i czas na poprawki — to nie jest gratis, choć w „tanich” ofertach zwykle go nie ma.

Co podnosi wycenę: brak API w ERP (zostaje eksport i import plików CSV co godzinę, co samo w sobie jest osobnym projektem), licencja ERP bez Sfery albo bez modułu integracyjnego, nietypowe stany magazynowe (rezerwacje, zestawy, produkty na zamówienie), wielomagazynowość, wielowalutowość, dwa sklepy na jednym ERP albo sprzedaż na marketplace. Każda z tych rzeczy to nie drobiazg, a osobny scenariusz do zaprojektowania i przetestowania.

Rozliczenie etapowe działa najlepiej: etap 1 — płatności, etap 2 — kurierzy, etap 3 — ERP, etap 4 — rozszerzenia niestandardowe. Płaci się po odbiorze etapu, więc ryzyko rozkłada się na obie strony, a Ty widzisz działający fragment po kilku tygodniach, nie po pół roku. Orientacyjne stawki i gotowe zestawienie zakresów znajdziesz w cenniku integracji z ERP, płatnościami i kurierami oraz w opisie kosztu wdrożenia integracji w firmie z Zamościa i okolic.

W ofercie powinny być cztery rzeczy: zakres (co dokładnie robimy, a czego nie), założenia (wersje sklepu i ERP, nazwy przewoźników, kto daje dostępy, kto testuje), kryteria odbioru (np. 20 zamówień testowych przechodzi pełną ścieżkę: płatność → dokument w ERP → etykieta → status u klienta) i czas na poprawki (zwykle 14–30 dni od odbioru, bezpłatnie). Brak kryteriów odbioru to najczęstsza przyczyna sporów przy rozliczeniu.

ZakresWidełki godzinoweCo zwykle wchodziCo podnosi czas
Płatności8–20 hjedna bramka, webhooki z weryfikacją, cron do odpytywania, mapowanie statusówdruga bramka, płatności odroczone, obsługa zwrotów i płatności częściowych
Kurierzy12–30 hetykiety pojedyncze i zbiorcze, odbiór o stałej godzinie, punkty odbioru, statusykażdy kolejny przewoźnik, nietypowe limity, zwroty i ponowne wysyłki
ERP24–80 hsynchronizacja zamówień, dokumentów i stanów magazynowych, mapowanie statusówbrak API, licencja bez Sfery, wielomagazynowość, wielowalutowość
Moduł niestandardowyod 16 hfunkcja, której nie ma żadna gotowa wtyczkanietypowe reguły biznesowe, integracja z systemem bez dokumentacji

7 pułapek przy integracji i jak je wykryć przed startem

Większość awarii integracji nie wychodzi w dniu startu, tylko wtedy, gdy coś zdarzy się drugi raz: powtórzony webhook, równoległa sprzedaż ostatniej sztuki, inna strefa czasowa. Poniższą listę przejdziesz w 1–2 dni, jeszcze przed odbiorem prac.

PułapkaJak to sprawdzić przed startem
Duplikaty zamówień przy powtórzonym webhookuWyślij to samo zdarzenie dwa razy (np. z panelu bramki albo powtórzonym żądaniem na endpoint) i sprawdź, czy w sklepie i w ERP powstanie jeden dokument. Wymagaj idempotencji opartej o identyfikator zdarzenia, nie o datę.
Rozjazd stanów magazynowych między sklepem a ERPWystaw 1 sztukę w sklepie i w drugim kanale, kup ją równolegle w odstępie kilku sekund. Sprawdź, czy drugi kanał dostanie blokadę, czy sprzeda towar, którego fizycznie nie ma.
Brak logów i brak środowiska testowegoŻądaj sandboxu bramki i klucza testowego kuriera oraz logu żądań i odpowiedzi z ID korelacji, do którego sam zajrzysz — nie tylko „u wykonawcy na serwerze”.
Strefy czasowe i formaty datZłóż zamówienie o 23:40 i sprawdź, czy data dokumentu w ERP to ten sam dzień. ERP często pracuje w UTC, a sklep w czasie lokalnym.
Polskie znaki w adresachUżyj adresu z Ś, Ł, Ż i myślnikiem. Sprawdź etykietę kurierską, adres na fakturze i plik CSV wysyłany do przewoźnika.
Brak obsługi zwrotów i korekt fakturZapytaj wprost, czy integracja tworzy dokument korygujący i zwrot w ERP, czy obsługuje wyłącznie nowe zamówienia. To najczęściej pomijany zakres.
Brak alertów przy błędzieWyłącz na próbę klucz API i sprawdź, czy ktoś dostaje maila lub wiadomość na Slacka. Błąd, który siedzi cicho w logu, oznacza zamówienia bez etykiety przez kilka dni.

Sam zakres zdarzeń, jakie sklep potrafi wywołać po opłaceniu zamówienia, znajdziesz w dokumentacji dla deweloperów PrestaShop — warto ją przejrzeć przed rozmową o wycenie, żeby nie płacić za funkcje, których platforma nie udostępnia. Jeśli chcesz zobaczyć, jak ten sam zestaw testów wygląda w praktyce u firm z regionu, opisaliśmy to przy okazji wdrożeń w ramach integracji z ERP, płatnościami i kurierami w Zamościu.

PułapkaJak to sprawdzić przed startem
Duplikaty zamówień przy powtórzonym webhookuWyślij to samo zdarzenie dwa razy i sprawdź, czy powstanie jeden dokument
Rozjazd stanów magazynowychSprzedaj ostatnią sztukę równolegle w dwóch kanałach
Brak logów i środowiska testowegoSandbox bramki i kuriera, log żądań i odpowiedzi z ID korelacji
Strefy czasowe i formaty datZamówienie o 23:40 — czy data dokumentu w ERP to ten sam dzień
Polskie znaki w adresachAdres z Ś, Ł, Ż — etykieta, faktura, plik CSV dla przewoźnika
Brak obsługi zwrotów i korekt fakturZapytaj, czy integracja tworzy korektę i zwrot w ERP
Brak alertów przy błędzieWyłącz klucz API na próbę i sprawdź, kto dostaje powiadomienie

Od czego zacząć w firmie ze Szczebrzeszyna — kolejność wdrożenia

W firmie, która nie może zatrzymać sprzedaży na czas wdrożenia, kolejność ma większe znaczenie niż wybór wykonawcy. Zacznij od tego, co daje efekt w pierwszym tygodniu, a stany magazynowe zostaw na koniec — to najbardziej ryzykowny element.

Kolejność MVP:

  1. Płatności online — zwykle 1–3 dni. Zamówienie samo zmienia status na „opłacone”, znika ręczne sprawdzanie przelewów. Najczęściej wystarczy klucz API i webhook.
  2. Etykiety kurierskie — 2–5 dni. Etykieta powstaje z panelu sklepu, numer przesyłki wraca do klienta automatycznie. Mierząc efekt, licz kliknięcia: trzy to dobry wynik, dziesięć to ta sama praca ręczna w innym miejscu.
  3. Dokument sprzedaży w ERP — 3–10 dni. Zamówienie zamienia się w dokument sprzedaży bez przepisywania. Tu najczęściej trzeba uzgodnień z księgowością: jakie pola, jakie statusy, kto wystawia fakturę.
  4. Stany magazynowe — 1–3 tygodnie. Synchronizacja dwukierunkowa, rezerwacje, korekty. Dopiero gdy trzy poprzednie etapy działają stabilnie.

Test na 20–30 realnych zamówieniach. Przez 1–2 tygodnie pracuj równolegle: integracja działa, ale obsługa ręczna też, a Ty porównujesz wyniki. Warunek wyłączenia trybu ręcznego: 20–30 zamówień z rzędu bez ingerencji, w tym co najmniej jedno z płatnością odrzuconą, jedno z polskimi znakami w adresie i jedno z wysyłką zagraniczną, jeśli tak sprzedajesz.

Podział zadań. Klient przygotowuje dostępy i klucze API (bramka, kurier, ERP), decyzję, które statusy zamówień wyzwalają jaki dokument, dane do faktur oraz listę osób do alertów. Wykonawca robi mapowanie pól, kod integracji, logi, środowisko testowe, dokumentację i przekazanie wiedzy. Jeśli księgowość prowadzi firma zewnętrzna — wciągnij ją już na etapie dokumentu w ERP, nie po starcie.

Istniejący sklep a migracja. Na działającym sklepie integracje wdrażasz „obok” i wyłączasz jednym ustawieniem — ryzyko jest małe. Przy migracji ze starej platformy najpierw przenosisz dane i treści, uruchamiasz nowy sklep, a integracje dołączasz na końcu. Łączenie obu projektów naraz to najkrótsza droga do dwóch tygodni przestoju. Zakres i stawki dla takiego planu podajemy osobno w cenniku integracji z ERP, płatnościami i kurierami w Zamościu, a podobną kolejność stosujemy w firmach z okolic, m.in. przy integracjach z ERP, płatnościami i kurierami w Hrubieszowie.

EtapCo dajeRealny czas (mała firma)
Płatności onlineStatus „opłacone” bez sprawdzania przelewów ręcznie1–3 dni
Etykiety kurierskieEtykieta i numer przesyłki bez wchodzenia na stronę przewoźnika2–5 dni
Dokument sprzedaży w ERPBrak przepisywania zamówień do systemu3–10 dni
Stany magazynoweJeden stan w sklepie i w ERP, blokada nadmiernej sprzedaży1–3 tygodnie

Co się dzieje po wdrożeniu — monitoring, SLA i utrzymanie

Integracja nie psuje się w dniu startu, tylko trzy miesiące później — gdy operator zmieni wersję API, a nikt tego nie zauważy, bo zamówienia wciąż przychodzą. Dlatego odbiór prac powinien obejmować monitoring, nie tylko samo działanie funkcji.

Co monitorowaćPróg alarmowyReakcja
Czas odpowiedzi API bramki i ERPpowyżej 3 s przez 5 minut z rzęduautomatyczny alert, sprawdzenie statusu u operatora
Nieudane zadania w kolejce3 zadania w 15 minutponowienie, potem zgłoszenie
Zamówienia bez etykietystarsze niż 4 godziny w godzinach pracyręczne nadanie i sprawdzenie przyczyny
Brak webhooków w ciągu dnia roboczegocisza do godziny 10:00weryfikacja konfiguracji endpointu i klucza

Elementy SLA, które warto uzgodnić na piśmie: okno reakcji (np. 4 godziny w dni robocze i 2 godziny w dniach promocyjnych), jeden kanał zgłoszeń zamiast trzech, ścieżka eskalacji — kto dzwoni, do kogo i po jakim czasie, jeśli przestój trwa dłużej, oraz zapis, czy dni promocyjne i święta są wliczone w okno, czy wyłączone. Bez tego w pierwszy czarny piątek dowiesz się, że „zgłoszenie przyjęte” oznacza odpowiedź w poniedziałek.

Aktualizacje po stronie sklepu, ERP i operatorów. Wersja WooCommerce czy PrestaShop potrafi zmienić strukturę zdarzeń, nowa wersja ERP — nazwy pól, a operatorzy płatności i kurierzy regularnie wygaszają stare wersje API. Zmiana adresu endpointu bramki, ogłoszona z 30-dniowym wyprzedzeniem, zatrzymuje sprzedaż dokładnie w dniu wyłączenia starej wersji. Ustal więc, kto śledzi komunikaty operatorów, kto testuje aktualizację na środowisku testowym i w jakim czasie. Zasady aktualizacji sklepu opisuje dokumentacja WooCommerce, a sposób prowadzenia takiej opieki w mniejszych firmach pokazujemy przy integracjach z ERP, płatnościami i kurierami w Narolu.

Co monitorowaćPróg alarmowyReakcja
Czas odpowiedzi API (bramka, ERP)powyżej 3 s przez 5 minutalert i sprawdzenie statusu u operatora
Nieudane zadania w kolejce3 zadania w 15 minutponowienie, potem zgłoszenie
Zamówienia bez etykietystarsze niż 4 godzinyręczne nadanie i analiza przyczyny
Brak webhooków w dniu roboczymcisza do 10:00weryfikacja endpointu i klucza

Najczęstsze błędy i jak je wykryć

Zakup wtyczki lub modułu przed opisaniem własnego procesu obsługi zamówienia.

Jak wykryć: Nie potrafisz w pięć minut narysować na kartce kroków od złożenia zamówienia do wystawienia faktury ani wskazać, kto wykonuje każdy z nich.

Jak naprawić: Najpierw mapa procesu i decyzja, które kroki mają być automatyczne, które półautomatyczne, a które zostają ręczne. Dopiero potem szukanie narzędzia.

Płatności online traktowane jako osobna wyspa — status „opłacone” ustawia ręcznie pracownik po zalogowaniu do panelu bramki.

Jak wykryć: Po tygodniu bez sprawdzania panelu w sklepie wiszą opłacone zamówienia ze statusem „oczekuje na płatność”.

Jak naprawić: Włączyć webhooki bramki i zmapować ich statusy na statusy zamówienia. Ręczne potwierdzanie zostawić wyłącznie jako wyjątek od reguły.

Brak tabeli mapowania statusów płatności na statusy zamówienia i dokumenty w ERP.

Jak wykryć: Rozjazdy: klient zapłacił, w sklepie status „nowe”, w ERP nie ma dokumentu sprzedaży, a towar już opuścił magazyn.

Jak naprawić: Spisać tabelę: status w bramce → status zamówienia w sklepie → dokument w ERP → informacja dla magazynu. Przejrzeć ją z osobą prowadzącą księgowość przed wdrożeniem.

Założenie, że webhook z bramki płatności zawsze dotrze.

Jak wykryć: Po zmianie adresu sklepu, konfiguracji serwera albo awarii po stronie dostawcy część płatności nie aktualizuje zamówień i nikt tego nie zauważa przez kilka dni.

Jak naprawić: Webhook plus zapytanie kontrolne: zadanie w tle, które po kilku minutach samo odpytuje bramkę o nierozliczone zamówienia i dopiero na podstawie odpowiedzi z API ustawia status.

Etykiety kurierskie generowane pojedynczo, bez manifestu i bez kolejki na wypadek awarii API przewoźnika.

Jak wykryć: Przy kilkudziesięciu paczkach dziennie ktoś klika każdą etykietę osobno, a przy przerwie w API wysyłka stoi do wieczora.

Jak naprawić: Zbiorcze generowanie etykiet i zamykanie manifestu, a zadania wysyłane do API przewoźnika przez kolejkę z ponowieniami. Ręczne etykiety w panelu przewoźnika zostawić jako plan B.

Testowanie integracji wyłącznie na szczęśliwej ścieżce, z pominięciem ograniczeń licencyjnych ERP.

Jak wykryć: Na zamówieniu testowym wszystko działa, a przy pierwszym zwrocie, płatności odroczonej, paczce ponad limit wagi albo dodatkowym stanowisku w ERP proces się sypie.

Jak naprawić: Przygotować listę scenariuszy brzegowych przed startem i sprawdzić z dostawcą ERP, czy wybrany kanał wymiany danych (np. Sfera w Subiekcie GT) mieści się w posiadanej licencji.

Lista kontrolna do odklikania

Podsumowanie

Integracja z ERP, płatnościami i kurierami opłaca się wtedy, gdy jest poprzedzona opisem procesu, a nie zakupem pierwszego lepszego modułu. Największe ryzyko to nie technologia, a brak mapowania statusów, brak obsługi awarii API i testowanie wyłącznie na szczęśliwej ścieżce. Zacznij od checklisty i pomiaru czasu obsługi jednego zamówienia — to kilka godzin pracy, które oszczędzą tygodnie poprawek po starcie.

Najczęściej zadawane pytania

Czy integracja z ERP, płatnościami i kurierami ma sens przy 50 zamówieniach miesięcznie?

Przy 50 zamówieniach oszczędność czasu to zwykle kilka godzin w miesiącu, co samo w sobie rzadko pokrywa koszt pełnego wdrożenia. Jeśli jednak ręczna obsługa generuje błędy — złe adresy, brak faktury, pomylone kwoty — warto zacząć od najtańszego kroku, na przykład automatycznych etykiet. Pełną integrację z ERP odkładamy do momentu, gdy zbliżysz się do 150 zamówień miesięcznie.

Czy muszę mieć klasyczny ERP, żeby spiąć sklep z dokumentami księgowymi?

Nie. Firmy bez Subiekta czy Optimy łączą sklep przez API dokumentów — między innymi z Fakturownią, ifirmą czy inFaktem. Zakres takiej integracji jest węższy, obejmuje głównie faktury i dokumenty magazynowe, ale wielu mikrofirmom w zupełności wystarcza. Trzeba tylko jasno ustalić, który system jest źródłem prawdy o stanie magazynowym.

Co się dzieje, gdy webhook płatności nie dotrze do sklepu?

Zamówienie zostaje w statusie „oczekuje na płatność”, choć klient zapłacił — i najczęściej nikt tego nie widzi, dopóki klient nie napisze. Dlatego obok webhooków warto mieć zadanie w tle, które co kilka minut odpytuje bramkę o nierozliczone zamówienia. Status zmieniamy dopiero po potwierdzeniu z API bramki, nigdy na podstawie samego przypuszczenia.

Czy etykiety kurierskie da się generować zbiorczo dla kilkudziesięciu paczek?

Tak, u InPost, DPD, DHL i Poczty Polskiej można pobrać etykiety dla wielu przesyłek jednym żądaniem i zamknąć je manifestem. Różnice są jednak spore: inny format pliku, inny limit liczby etykiet w jednym wywołaniu, inny sposób zamykania dnia. Te szczegóły trzeba sprawdzić w dokumentacji konkretnego przewoźnika przed wdrożeniem, nie po.

Jak działa obsługa paczkomatów i punktów odbioru?

Listę punktów pobiera się z API przewoźnika i mapuje na metody dostawy w sklepie. Trzeba zdecydować, czy punkt wybiera klient na etapie zakupu, czy wskazuje go pracownik przy generowaniu etykiety — oba modele wymagają innej konfiguracji. Osobno ustal limity rozmiarów i wagi, bo paczka ponad limit zablokuje całą wysyłkę.

Ile trwa wdrożenie integracji?

To zależy od liczby systemów i tego, czy ERP ma gotowy kanał wymiany danych, czy trzeba pisać mostek pośredniczący. Połączenie sklepu z jedną bramką i jednym kurierem to zupełnie inny zakres niż pełna integracja z ERP wraz z dokumentami magazynowymi. Realistyczny termin podajemy dopiero po przejściu mapy procesu — wcześniej każde widełki byłyby zgadywaniem.

Czy integracja zastąpi pracownika obsługującego zamówienia?

Zwykle nie zastępuje, ale zdejmuje najbardziej powtarzalne czynności: przepisywanie danych, wystawianie etykiet, tworzenie dokumentów. Nie znikają zadania wymagające decyzji — reklamacje, nietypowe wysyłki, korekty dokumentów. Realny efekt to mniej błędów i możliwość obsłużenia większej liczby zamówień bez zatrudniania kolejnej osoby.

Jeśli chcesz przejść przez mapę procesu i checklistę razem z nami, napisz do DropDigital. Powiemy wprost, co w Twojej firmie da się zautomatyzować od razu, a co na razie nie ma sensu.

Źródła i materiały