Logi i kolejki zamówień w integracji - jak znaleźć zgubione zamówienie

Jak znaleźć zgubione zamówienie krok po kroku

Poniższa kolejność sprawdza się przy większości integracji, niezależnie od tego, czy zamówienia płyną z marketplace do sklepu, ze sklepu do ERP, czy do operatora magazynu:

1. Potwierdź zamówienie w systemie źródłowym: identyfikator, status, czas zakupu i płatności.

2. Sprawdź, czy integracja odebrała zdarzenie lub pobrała zamówienie - szukaj identyfikatora w logu odbioru.

3. Sprawdź kolejkę: czy zadanie dla tego zamówienia czeka, zakończyło się błędem albo trafiło do zadań nieprzetworzonych.

4. Odczytaj log przetwarzania: kod odpowiedzi systemu docelowego i treść błędu.

5. Sprawdź filtry: czy status, kanał, metoda dostawy lub magazyn nie wykluczają zamówienia z przetwarzania.

6. Sprawdź system docelowy pod identyfikatorem zewnętrznym - zamówienie mogło trafić tam pod innym numerem.

7. Po znalezieniu przyczyny przetwórz zamówienie ponownie przez integrację i sprawdź, czy nie powstał duplikat.

Zamówienia z Allegro - dziennik zdarzeń

Integracje z Allegro pobierają zmiany w zamówieniach z dziennika zdarzeń. Dokumentacja wymienia zdarzenia takie jak BOUGHT, FILLED_IN, READY_FOR_PROCESSING, BUYER_CANCELLED czy AUTO_CANCELLED. Adres dostawy i dane do faktury są dostępne dopiero przy READY_FOR_PROCESSING, a zdarzenia mogą przychodzić w innej kolejności, niż zaszły. Z dziennika można pobrać zdarzenia z ostatnich 60 dni, a lista zamówień obejmuje ostatnie 12 miesięcy i jest sortowana po dacie zakupu, więc zamówienie opłacone później nie pojawi się na jej początku (stan na sierpień 2026 - sprawdź aktualną dokumentację Allegro API). Jeśli integracja czyta tylko początek listy zamówień zamiast dziennika, spóźnione płatności łatwo jej umykają.

Przy poszukiwaniach sprawdź też, jaki identyfikator ostatniego zdarzenia zapisała integracja i czy pobiera kolejne porcje od tego miejsca. Jeśli punkt startowy przeskoczył, np. po ręcznej zmianie w bazie albo przywróceniu starszej kopii, część zdarzeń mogła zostać pominięta. Dokumentacja Allegro podaje też, że powtórzone zdarzenia można rozpoznać po typie i czasie wystąpienia, co pomaga odróżnić duplikat od nowego zdarzenia (stan na sierpień 2026 - sprawdź aktualną dokumentację Allegro API).

Zamówienia w WooCommerce - zaplanowane akcje i logi

Wiele wtyczek integracyjnych WooCommerce korzysta z mechanizmu zaplanowanych akcji. Znajdziesz je w WooCommerce > Status > Zaplanowane akcje, gdzie można filtrować akcje zakończone błędem i przeglądać ich log. Logi WooCommerce są w WooCommerce > Status > Logi, a dostarczenia webhooków mają osobne źródło „webhooks-delivery”. Domyślnie logi są przechowywane przez 30 dni (stan na sierpień 2026 - sprawdź aktualną dokumentację WooCommerce). Zamówienie zgłoszone po miesiącu może więc nie mieć już śladu w logach, jeśli nikt nie wydłużył tego okresu.

Zamówienia opłacone online - powiadomienia operatora płatności

Osobna kategoria to zamówienia, które są w sklepie, ale wiszą jako nieopłacone, choć klient zapłacił. Status płatności zmienia zwykle powiadomienie wysyłane przez operatora na adres sklepu. Jeśli adres nie odpowiadał, odrzucił powiadomienie przez błąd weryfikacji albo powiadomienie trafiło na stary adres po migracji, zamówienie nie zmieni statusu i nie trafi do realizacji. Zacznij od sprawdzenia statusu transakcji w panelu operatora, a potem historii powiadomień i logu odbioru w sklepie. Zasady ponawiania powiadomień różnią się między operatorami, dlatego sprawdź je w dokumentacji swojej bramki.

Gdzie najczęściej giną zamówienia w integracji

Z przeglądów integracji wynika, że zamówienia giną w kilku powtarzalnych miejscach. Tabela pokazuje objaw i sposób sprawdzenia:

Najtrudniejsze są przypadki bez błędu. Zamówienie pominięte przez filtr nie zostawia w logu czerwonego wpisu, bo z punktu widzenia integracji wszystko poszło zgodnie z regułami. Dlatego dobre logi zapisują także decyzję o pominięciu z jej powodem, np. „status poza zakresem pobierania”.

[#chart:wpr78b]

Jak projektować logi i kolejki, żeby zamówienia nie ginęły

Większości opisanych problemów można uniknąć już na etapie projektu integracji. Zasady, które stosujemy przy budowie i przeglądach:

• Identyfikator w każdym wpisie - każda linia logu zawiera identyfikator zamówienia ze źródła i, jeśli istnieje, z systemu docelowego.

• Statusy w kolejce - zadanie ma status oczekujące, w trakcie, zakończone lub błąd, a nie znika po pobraniu.

• Ponowienia z opóźnieniem - błędy przejściowe są ponawiane z rosnącym odstępem, a nie w pętli.

• Miejsce na nieprzetworzone - zadania po ostatniej próbie trafiają do osobnej listy z alertem, a nie do kosza.

• Idempotencja - ponowne przetworzenie tego samego zdarzenia nie tworzy drugiego zamówienia.

• Zapis decyzji o pominięciu - log mówi, dlaczego zamówienie nie zostało przetworzone.

• Uzgadnianie - okresowe porównanie listy zamówień w obu systemach wyłapuje to, co umknęło.

Kolejka nie zawsze jest potrzebna. W małej integracji z kilkoma zamówieniami dziennie bezpośrednie przetwarzanie może wystarczyć, pod warunkiem że błędy są zapisywane i ponawiane. Kiedy kolejka daje realną przewagę, pokazuje porównanie:

[#chart:wpr78c]

Kolejka i zadania nieprzetworzone mają sens tylko wtedy, gdy ktoś na nie patrzy. Alert o każdym zadaniu, które trafiło na listę nieprzetworzonych, i o rosnącym wieku najstarszego zadania w kolejce to minimum. Jak ustawić takie alerty, opisujemy we wpisie monitoring integracji i alerty o błędach. Zasady odbioru webhooków z kolejką i obsługą duplikatów omawiamy z kolei w artykule webhooki w e-commerce - do czego służą.

[#uwaga] Logi integracji zamówień często zawierają dane osobowe klientów: imiona, adresy, telefony. Zapisuj tylko to, co jest potrzebne do diagnozy, ogranicz dostęp do logów i ustal czas ich przechowywania. Szczegółowe obowiązki wynikające z RODO warto omówić z prawnikiem lub inspektorem ochrony danych.

Ponowne przetworzenie zamówienia - jak nie zrobić duplikatu

Znalezienie zamówienia to połowa pracy. Druga połowa to bezpieczne przetworzenie go jeszcze raz. Najczęstszy błąd to ręczne dodanie zamówienia w systemie docelowym, podczas gdy integracja po chwili przetworzy je sama, bo zadanie wciąż było w kolejce. Bezpieczniej jest:

• najpierw usunąć przyczynę błędu, np. dodać brakujące mapowanie albo poprawić dane produktu,

• sprawdzić, czy zamówienie nie istnieje już w systemie docelowym pod identyfikatorem zewnętrznym,

• ponowić zadanie w kolejce albo uruchomić ponowne pobranie dla tego jednego zamówienia,

• po przetworzeniu sprawdzić stany magazynowe, dokument sprzedaży i etykietę.

Jeśli integracja nie ma możliwości ponowienia pojedynczego zamówienia, warto ją dodać. To jedna z funkcji, która najbardziej skraca obsługę zgłoszeń, a jej koszt jest niewielki w porównaniu z ręcznym poprawianiem danych w kilku systemach.

Zgubione zamówienia przy magazynie zewnętrznym

Przy współpracy z operatorem logistycznym droga zamówienia wydłuża się o kolejny system i kolejne potwierdzenia. Zamówienie może dotrzeć do operatora, ale zostać wstrzymane z powodu braku towaru albo nieznanego SKU, a informacja o tym nie wraca do sklepu. Warto wtedy logować także potwierdzenia przyjęcia od operatora i status realizacji. Jak zaplanować taki przepływ, opisujemy we wpisie integracja z fulfillmentem 3PL - przepływ zamówień i stanów.

Jak Vinson pomaga odnaleźć zgubione zamówienia

Programiści Vinson analizują logi i kolejki integracji, odnajdują zamówienia, które utknęły między systemami, i przetwarzają je ponownie bez duplikatów. Następnie usuwamy przyczynę: poprawiamy filtry i mapowanie, dodajemy identyfikatory do logów, kolejkę z ponowieniami, listę zadań nieprzetworzonych i alerty. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Jak znaleźć zamówienie, które nie dotarło z marketplace do sklepu?

Ustal identyfikator zamówienia w marketplace i szukaj go kolejno w logu odbioru integracji, w kolejce zadań, w logu przetwarzania i w sklepie pod identyfikatorem zewnętrznym. Miejsce, w którym ślad się urywa, wskazuje przyczynę: brak odbioru, błąd przetwarzania albo pominięcie przez filtr.

Co to jest kolejka w integracji zamówień?

To bufor zadań, z którego proces przetwarzający pobiera je po kolei. Kolejka pozwala szybko przyjąć dane, przetwarzać je w tle i ponawiać zadania zakończone błędem przejściowym, zamiast je tracić.

Czym jest dead letter queue?

To osobne miejsce na zadania, których nie udało się przetworzyć mimo kilku prób. Zamiast znikać, czekają tam na sprawdzenie przez człowieka. Każde zadanie, które tam trafia, powinno uruchamiać alert, a po usunięciu przyczyny błędu zadanie można ponowić bez ręcznego przepisywania danych do systemu docelowego.

Dlaczego zamówienie z Allegro zniknęło i pojawiło się pod innym numerem?

Gdy kupujący łączy kilka zakupów w jedną płatność, Allegro tworzy nowe zamówienie z nowym identyfikatorem, a wcześniejsze usuwa (stan na sierpień 2026 - sprawdź aktualną dokumentację Allegro API). Integracja powinna to rozpoznawać, inaczej zamówienie wygląda na zgubione albo zdublowane.

Jak długo przechowywać logi integracji?

Co najmniej tak długo, jak trwa wykrycie typowego problemu, np. reklamacja klienta po kilku tygodniach. W WooCommerce domyślny okres to 30 dni i można go zmienić (stan na sierpień 2026 - sprawdź aktualną dokumentację WooCommerce). Przy logach z danymi osobowymi okres przechowywania warto ustalić z prawnikiem.

Zgubione zamówienie to zwykle zamówienie, którego nikt nie umie szybko prześledzić. Identyfikatory w logach, kolejka z ponowieniami i lista zadań nieprzetworzonych sprawiają, że poszukiwania trwają minuty, a nie dni. Jeśli w Twojej integracji zamówienia giną bez śladu, sprawdź wsparcie programistyczne Vinson.