Integracja przestała działać - lista kontrolna diagnozy krok po kroku

Łukasz Palej

Technical Implementation Expert

4.06.2026

Integracja przestała działać - lista kontrolna diagnozy krok po kroku

Wsparcie programistyczne dla e-commerce

Łukasz PalejTechnical Implementation Expert

Programiści

Gdy integracja przestała działać, nie zaczynaj od restartu ani od ręcznego przepisywania zamówień. Najpierw ustal zakres awarii: który przepływ danych stoi, od kiedy i czy dotyczy wszystkich kont. Potem przejdź listę kontrolną diagnozy w stałej kolejności: logi i kody odpowiedzi API, harmonogram zadań, autoryzacja, zmiany z ostatnich dni, limity zapytań, a na końcu kolejki i dane. Dopiero znaleziona przyczyna mówi, co naprawić i jak bezpiecznie uzupełnić zaległości.

W tym wpisie pokazujemy, jak krok po kroku zdiagnozować integrację sklepu z marketplace, ERP, kurierem albo bramką płatności. Lista sprawdzi się niezależnie od tego, czy integrację napisał Twój programista, czy działa ona jako gotowy moduł lub wtyczka. Wyjaśniamy też, co oznaczają najczęstsze kody błędów, gdzie szukać logów w WooCommerce, Shopify, PrestaShop i Allegro oraz jak po naprawie odzyskać brakujące zamówienia bez tworzenia duplikatów.

[#wazne] W skrócie: gdy integracja przestała działać, przejdź listę kontrolną w kolejności - zakres i czas awarii, logi i kody HTTP, harmonogram zadań, autoryzacja, zmiany po obu stronach, limity API, kolejki i dane. Większość awarii to wygasłe lub unieważnione tokeny, wyłączone webhooki, zmiany w API albo nowe wartości, których nie obejmuje mapowanie. Przed naprawą zapisz, czego brakuje, a po naprawie uzupełnij dane bez duplikatów. Programiści Vinson diagnozują i naprawiają integracje sklepów z Allegro, ERP, kurierami i płatnościami.

Co to znaczy, że integracja przestała działać

Integracja to stałe połączenie dwóch systemów, które wymieniają dane bez udziału człowieka: przez API, webhooki albo pliki wymiany. Integracja przestała działać, gdy dane przestają płynąć w ogóle, płyną z dużym opóźnieniem albo docierają w złej postaci. Ten trzeci przypadek jest najtrudniejszy, bo z zewnątrz wszystko wygląda poprawnie, a błędy wychodzą dopiero przy pakowaniu paczki albo w księgowości.

Najczęściej właściciel sklepu zauważa awarię po jednym z tych objawów:

zamówienia z marketplace nie pojawiają się w sklepie, ERP lub integratorze,
stany magazynowe w ofertach nie zmieniają się po sprzedaży w innym kanale,
płatność jest zaksięgowana u operatora, a zamówienie w sklepie nadal wisi jako nieopłacone,
etykiety kurierskie się nie generują albo numer przesyłki nie wraca do klienta,
faktury nie powstają albo powstają podwójnie,
w panelu integracji widać czerwony status lub komunikat o błędzie autoryzacji.

Każdy z tych objawów może mieć kilka przyczyn. Brak zamówień bywa skutkiem wygasłego tokenu, ale też zatrzymanego zadania cron, pełnego dysku serwera albo zmiany statusu, od którego integracja zaczyna pobieranie. Dlatego diagnoza powinna iść według listy, a nie według przeczucia. Przeczucie zwykle prowadzi do restartu, który na chwilę ukrywa objaw i zaciera ślady potrzebne do znalezienia przyczyny.

Lista kontrolna diagnozy integracji krok po kroku

Kolejność kroków ma znaczenie. Zaczynamy od rzeczy najtańszych do sprawdzenia i takich, które najszybciej zawężają obszar poszukiwań. Każdy krok kończy się odpowiedzią tak lub nie, którą warto od razu zapisać w notatce z incydentu:

[#chart:wpr76a]

Krok 1. Zakres i początek awarii

Ustal, który przepływ nie działa: zamówienia, stany, ceny, statusy, dokumenty czy przesyłki. Sprawdź, czy problem dotyczy wszystkich kont i kanałów, czy tylko jednego. Znajdź ostatni rekord, który przeszedł poprawnie, i zapisz jego czas. Ten moment to punkt odniesienia dla logów i dla listy zmian. Jeśli przestały spływać zamówienia tylko z jednego konta Allegro, przyczyna niemal na pewno leży po stronie tego konta lub jego autoryzacji, a nie w kodzie całej integracji.

Krok 2. Logi i kody odpowiedzi

Otwórz logi integracji z okolic momentu awarii i odczytaj dokładny kod odpowiedzi HTTP oraz treść błędu zwróconą przez API. Komunikat w panelu sklepu, np. „Błąd synchronizacji”, zwykle ukrywa szczegóły. Kod 401 prowadzi w stronę autoryzacji, 429 w stronę limitów, a kody 5xx w stronę awarii po drugiej stronie. Jeśli w logach nie ma żadnych wpisów z czasu awarii, problemem może być sam proces, który przestał się uruchamiać.

Krok 3. Czy proces w ogóle się uruchamia

Wiele integracji działa cyklicznie: zadanie cron albo kolejka zadań co kilka minut pobiera zmiany. Sprawdź, kiedy zadanie uruchomiło się ostatnio, czy nie zawiesza się w połowie i czy serwer ma wolne miejsce na dysku. W WooCommerce zadania w tle widać w WooCommerce > Status > Zaplanowane akcje (Scheduled Actions), gdzie można odfiltrować akcje zakończone błędem i odczytać ich log (stan na czerwiec 2026 - sprawdź aktualną dokumentację WooCommerce).

[#tip] Prowadź notatkę z incydentu od pierwszej minuty: czas zgłoszenia, ostatni poprawny rekord, sprawdzone kroki i ich wynik. Taka notatka skraca diagnozę, gdy do problemu dołącza kolejna osoba, i staje się gotowym materiałem do analizy po awarii.

Bezpłatna konsultacja programistyczna

Potrzebujesz programisty do sklepu, integracji lub automatyzacji?

Wycena zadania w 24 h w dni robocze
Integracje, API, feedy i poprawki w sklepie
Rozliczenie godzinowe albo za projekt

Konsultację poprowadzi Łukasz Palej, Technical Implementation Expert

Zobacz szczegóły usługi →

Krok 4. Autoryzacja - tokeny, klucze i uprawnienia

Błędy 401 i 403 to sygnał, że integracja straciła prawo dostępu albo próbuje sięgnąć po zasób, do którego nie ma uprawnień. Sprawdź, czy token lub klucz API nie wygasł, czy nikt nie zmienił hasła, nie usunął powiązanej aplikacji albo nie wygenerował nowego klucza w miejsce starego. W Allegro tokeny tracą ważność m.in. po zmianie hasła lub e-maila konta i po usunięciu aplikacji z listy powiązanych aplikacji - szczegółowo opisujemy to we wpisie token API Allegro - jak go odnawiać i dlaczego integracja przestaje działać.

Krok 5. Zmiany z ostatnich dni po obu stronach

Integracje rzadko psują się same. Zestaw listę zmian z kilku dni przed awarią: aktualizacje wtyczek i platformy, nowa wersja modułu, zmiana serwera, domeny lub certyfikatu SSL, nowe statusy zamówień, nowe metody dostawy, zmiany w produktach i ich identyfikatorach. Sprawdź też drugą stronę, czyli komunikaty i listę zmian w dokumentacji API producenta. Platformy wersjonują API i wycofują starsze wersje lub pola, a integracja, której nikt nie aktualizował, przestaje działać w dniu wyłączenia starej wersji.

Krok 6. Limity zapytań i wydajność

Kod 429 oznacza, że integracja wysyła zbyt wiele zapytań w danym czasie. Zdarza się to po imporcie dużej liczby produktów, masowej zmianie cen albo wtedy, gdy kilka narzędzi korzysta z tego samego konta. Sprawdź, czy integracja respektuje informację o czasie ponowienia i czy nie powtarza zapytań natychmiast w pętli. Przekroczenia czasu odpowiedzi (timeout) mogą z kolei wynikać z przeciążenia serwera sklepu albo ze zbyt dużych porcji danych w jednym zapytaniu.

Krok 7. Kolejki, webhooki i dane

Jeśli proces działa, autoryzacja jest poprawna, a limity nie są przekroczone, przyczyny szukaj w mechanizmie dostarczania i w samych danych. Webhooki potrafią zostać wyłączone przez platformę po serii nieudanych dostarczeń. WooCommerce automatycznie wyłącza webhook po ponad pięciu kolejnych nieudanych próbach, a za błąd uznaje każdą odpowiedź inną niż 2xx, 301 lub 302. Shopify ponawia nieudane wywołania do ośmiu razy w ciągu czterech godzin, a gdy błędy się utrzymują, usuwa subskrypcję (stan na czerwiec 2026 - sprawdź aktualną dokumentację WooCommerce i Shopify). Więcej o bezpiecznym odbiorze takich powiadomień piszemy we wpisie webhooki w e-commerce - do czego służą. W danych szukaj nowych wartości, których nie przewiduje mapowanie: nowego statusu, metody dostawy, stawki VAT albo wariantu bez SKU.

Kody błędów HTTP w integracji sklepu - co oznaczają

Kod odpowiedzi to najszybsza wskazówka, w którą stronę iść. Poniższa tabela zbiera kody spotykane najczęściej w integracjach e-commerce i pierwszy krok, który warto wykonać po ich zobaczeniu w logach.

Kod	Co zwykle oznacza	Pierwszy krok
400	Błędne dane w zapytaniu, np. brak wymaganego pola	Porównaj wysyłane dane z dokumentacją i ostatnią zmianą mapowania
401	Brak tokenu albo nieważny token lub klucz	Sprawdź ważność i odświeżanie tokenu, w razie potrzeby autoryzuj ponownie
403	Brak uprawnień do zasobu	Sprawdź zakres uprawnień klucza i konto, do którego należy zasób
404	Zasób nie istnieje albo zmienił się adres	Sprawdź identyfikator, wersję API i adres endpointu
409 lub 422	Konflikt albo dane niezgodne z regułami odbiorcy	Sprawdź duplikaty, stany i walidację po stronie odbiorcy
429	Przekroczony limit zapytań	Zwolnij tempo, wprowadź kolejkę i ponowienia z opóźnieniem
5xx	Błąd po stronie serwera odbiorcy	Sprawdź status usługi, ponów później, nie wysyłaj danych w pętli

Kody z grupy 4xx najczęściej oznaczają problem po stronie integracji lub danych, więc ponawianie tego samego zapytania niczego nie zmieni. Kody 5xx i przekroczenia czasu zwykle są przejściowe, dlatego dobrze zaprojektowana integracja ponawia je z rosnącym odstępem i dopiero po kilku nieudanych próbach zgłasza alarm.

Gdzie szukać logów integracji w WooCommerce, Shopify, PrestaShop i Allegro

Każda platforma zapisuje ślady pracy integracji w innym miejscu. Warto wiedzieć, gdzie są, zanim dojdzie do awarii, bo część logów jest usuwana po określonym czasie:

[#chart:wpr76c]

WooCommerce pokazuje logi w WooCommerce > Status > Logi, a dostarczenia webhooków zapisuje pod źródłem „webhooks-delivery”. Domyślnie logi są przechowywane przez 30 dni. W PrestaShop dziennik zdarzeń znajdziesz w Parametrach zaawansowanych, w sekcji Logi. W Shopify statystyki dostarczeń webhooków aplikacji pokazuje panel deweloperski. Allegro udostępnia dziennik zdarzeń zamówień, z którego można pobrać zdarzenia z ostatnich 60 dni (stan na czerwiec 2026 - sprawdź aktualną dokumentację platform). Do tego dochodzą logi serwera i własne logi integracji, o ile ktoś je zaprojektował.

Najczęstsze przyczyny awarii integracji i jak je naprawić

W przeglądach integracji powtarza się kilka scenariuszy. Poniżej zebraliśmy je razem z objawem, który zgłasza sklep, prawdopodobną przyczyną i poprawką:

[#chart:wpr76b]

Przykład: zamówienia z Allegro spływają bez adresu dostawy

Częsty przypadek, który wygląda jak awaria, a jest błędem logiki. Integracja pobiera zamówienie zaraz po zakupie, zanim kupujący opłaci je i uzupełni formularz dostawy. Według dokumentacji Allegro adres dostawy i dane do faktury są widoczne dopiero przy zdarzeniu READY_FOR_PROCESSING, a wcześniejsze zdarzenia, takie jak BOUGHT czy FILLED_IN, mogą pojawić się w innej kolejności niż zaszły (stan na czerwiec 2026 - sprawdź aktualną dokumentację Allegro API). Poprawka nie polega na restarcie, tylko na zmianie warunku: integracja tworzy zamówienie do realizacji dopiero po zdarzeniu gotowości do obsługi i za każdym razem pobiera aktualne dane zamówienia. Takie błędy wychodzą zwykle po zmianie integratora albo nowej wersji modułu, dlatego krok 5 z listy jest tu kluczowy.

[#uwaga] Nie importuj brakujących zamówień ręcznie, zanim nie poznasz przyczyny i nie naprawisz integracji. Gdy integracja wznowi pracę, często sama pobierze zaległe dane, a ręcznie dodane zamówienia staną się duplikatami - z podwójnymi fakturami, etykietami i dwukrotnie zdjętymi stanami.

Po naprawie integracji - jak uzupełnić dane bez duplikatów

Naprawa nie kończy pracy. Trzeba jeszcze sprawdzić, czy wszystkie dane z okresu awarii dotarły na miejsce. Bezpieczna kolejność wygląda tak:

Zapisz okres awarii: od ostatniego poprawnego rekordu do momentu naprawy.
Porównaj liczbę zamówień, dokumentów lub przesyłek w systemie źródłowym i docelowym za ten okres.
Sprawdź, czy integracja pamięta punkt, w którym skończyła, np. identyfikator ostatniego zdarzenia, i pobierze zaległości sama.
Braki uzupełnij przez integrację, a nie ręcznie, żeby zachować identyfikatory i powiązania między systemami.
Zweryfikuj stany magazynowe w kanałach sprzedaży, bo sprzedaż z okresu awarii mogła ich nie zdjąć.
Dopisz do notatki z incydentu przyczynę, poprawkę i zmianę, która zapobiegnie powtórce.

Ostatni punkt jest najważniejszy na przyszłość. Jeśli awarię wykrył klient, a nie system, integracji brakuje alertów. Jeśli przyczyną była zmiana w API, potrzebny jest ktoś, kto śledzi komunikaty producenta. Jeśli winne było mapowanie, warto dodać walidację, która zatrzyma nieznaną wartość i powiadomi zespół, zamiast przepuszczać błędne dane do kolejnych systemów.

Jak Vinson pomaga, gdy integracja przestała działać

Programiści Vinson diagnozują i naprawiają integracje sklepów z marketplace, ERP, kurierami i bramkami płatności. Przechodzimy listę kontrolną na Twoich logach, ustalamy przyczynę, naprawiamy kod lub konfigurację i pilnujemy, żeby zaległe zamówienia trafiły na miejsce bez duplikatów. Po naprawie proponujemy zmiany, które skrócą kolejną awarię: alerty, czytelne logi i walidację danych. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Co zrobić, gdy integracja sklepu z Allegro przestała pobierać zamówienia?

Sprawdź w logach kod odpowiedzi z ostatnich zapytań do Allegro i datę ostatniego udanego odświeżenia tokenu. Najczęstszą przyczyną jest wygasły lub unieważniony token, np. po zmianie hasła do konta. Po ponownej autoryzacji upewnij się, że integracja pobrała zamówienia z całego okresu przerwy.

Jak sprawdzić, dlaczego integracja nie działa, bez programisty?

Możesz samodzielnie ustalić zakres awarii, czas ostatniego poprawnego rekordu i listę zmian z ostatnich dni, a także odczytać komunikat błędu w panelu i w logach platformy. Te informacje bardzo przyspieszają pracę programisty. Naprawę kodu i autoryzacji lepiej zostawić osobie, która zna integrację.

Co oznacza błąd 429 w integracji?

Kod 429 oznacza przekroczenie limitu zapytań do API w danym czasie. Integracja powinna wtedy zwolnić, odczekać i ponowić zapytanie, a nie powtarzać go od razu. Częste błędy 429 to sygnał, że trzeba zmienić sposób synchronizacji, np. wprowadzić kolejkę i większe odstępy między zapytaniami.

Dlaczego webhook przestał przychodzić do sklepu?

Platformy wyłączają lub usuwają webhooki po serii nieudanych dostarczeń - WooCommerce po ponad pięciu kolejnych błędach, a Shopify, gdy błędy utrzymują się mimo ponowień w ciągu czterech godzin (stan na czerwiec 2026 - sprawdź aktualną dokumentację). Sprawdź, czy adres odbiorcy działa i odpowiada kodem 2xx, a potem włącz lub utwórz webhook ponownie.

Czy po naprawie integracji zaległe zamówienia pobiorą się same?

To zależy od integracji. Jeśli zapamiętuje ostatnie przetworzone zdarzenie, zwykle pobierze zaległości sama. Jeśli pobiera tylko dane z ostatnich godzin, część zamówień trzeba uzupełnić osobnym przebiegiem, dlatego zawsze porównaj liczbę zamówień w obu systemach za okres awarii.

Integracja, która przestała działać, prawie zawsze zostawia ślady w logach, kodach błędów i liście zmian - wystarczy przejść je po kolei, zamiast zgadywać. Podstawy łączenia systemów przypominamy we wpisie integracja API sklepu internetowego - jak to działa. Jeśli chcesz, żeby diagnozę i naprawę przeprowadził zespół, który robi to na co dzień, sprawdź wsparcie programistyczne Vinson.