Zamówienia Allegro nie pobierają się: diagnostyka

Zapisz konto sprzedawcy, checkoutForm.id, czas zdarzenia i aktualny stan zamówienia. Numer widoczny w lokalnym panelu nie musi być identyfikatorem używanym przez API. Potrzebujesz powiązania obu wartości, aby szukać tej samej operacji w logach integratora i sklepu. Dane odbiorcy nie są dobrym zamiennikiem identyfikatora, ponieważ jedna osoba może złożyć kilka zakupów.

Dokumentacja zamówień Allegro rozróżnia zdarzenia przed finalizacją płatności oraz READY_FOR_PROCESSING. Ten ostatni obejmuje zakończoną płatność albo wybór płatności przy odbiorze lub odbioru osobistego. Konektor może obserwować wcześniejsze zdarzenia, a moment utworzenia lokalnego zamówienia zależy od jego reguł. Nie zakładaj identycznego działania wszystkich narzędzi.

Odczytaj konfigurację harmonogramu i warunek importu. Nie ma jednego kilkunastominutowego okna dla wszystkich integracji. Porównaj ostatni udany przebieg z momentem, w którym zakup spełnił wymagania. Jeżeli reguła nie została spełniona, wyjaśnij oczekiwanie; jeśli została, przejdź do następnego etapu śladu.

Porównaj brakującą sprawę z pobliskim zamówieniem, które przeszło poprawnie. Szukaj różnic w sposobie płatności, ofercie, wariancie, metodzie dostawy i czasie. Jeśli problem dotyczy wszystkich nowych zakupów od określonego momentu, sprawdź wspólną ścieżkę dostępu oraz przetwarzania. To kierunek analizy, a nie dowód konkretnej przyczyny.

Zapisz również ostatnie aktualizacje i zmiany konfiguracji. Szerszy model połączenia opisuje integracja Allegro z WooCommerce. Tutaj nie wybierasz nowego narzędzia: ustalasz, na którym odcinku istniejącego połączenia dowód sukcesu przestaje się zgadzać z oczekiwanym wynikiem.

Jeżeli API odrzuca żądania, zachowaj kod odpowiedzi i komunikat bez tokenów oraz sekretów. Sprawdź właściwe konto, zakres uprawnień i działanie odświeżania dostępu. Access token ma ograniczoną ważność, lecz jego wygaśnięcie nie oznacza automatycznie konieczności ręcznego logowania sprzedawcy. Poprawna integracja powinna obsługiwać przewidziany mechanizm odnowienia.

Allegro opisuje uwierzytelnianie i autoryzację, w tym użycie refresh tokenu i otrzymanie nowej pary tokenów. Weryfikuj, czy aplikacja zachowuje aktualne dane po udanym odświeżeniu. Nie wklejaj wartości do zgłoszenia, repozytorium ani zrzutu ekranu. Do analizy wystarcza wynik operacji i kontekst konta.

Rozróżnij błąd uwierzytelnienia od niewystarczających uprawnień. Ponowne nadanie zgody może być potrzebne w konkretnej sytuacji, ale nie powinno zastępować naprawy wadliwego odświeżania. Zmiana hasła lub 2FA jest informacją z historii konta, nie uniwersalnym dowodem unieważnienia każdego połączenia. Sprawdź odpowiedź usługi i mechanizm używany przez dany konektor.

Sprawdź, czy integracja widziała zdarzenie dotyczące zamówienia. Następnie ustal, czy pobrała jego szczegóły, umieściła zadanie w kolejce i otrzymała wynik zapisu. Każdy z tych kroków może mieć oddzielny log. Komunikat synchronizacja zakończona na poziomie całego przebiegu nie dowodzi, że wszystkie zadania podrzędne zakończyły się powodzeniem.

Kursor wskazuje miejsce, od którego aplikacja kontynuuje odczyt zdarzeń. Zapisz jego wartość i czas przed naprawą. Nie usuwaj go ani nie cofaj globalnie tylko dlatego, że brakuje jednego zamówienia. Jeśli mechanizm potwierdza zdarzenie przed trwałym zapisaniem dalszego zadania, awaria może zostawić lukę wymagającą kontrolowanego odtworzenia.

Oceń zalegające zadania, liczbę prób i ostatni błąd. Odpowiedź 429 kieruje uwagę na limitowanie żądań, a 5xx na błąd usługi lub pośrednika; ich obsługa różni się od problemu danych. Przy automatyzacji procesu potrzebny jest widoczny stan błędu i właściciel reakcji, a nie jedynie cykliczne uruchamianie kolejnego przebiegu.

Dla każdej pozycji zestaw identyfikator oferty, wariant, ilość i cenę z odpowiednikiem w sklepie. Oferta wystawiona inną drogą, usunięty produkt lub przebudowany wariant mogą pozostawić nieaktualne powiązanie. Nie zakładaj jednak, że każdy konektor wtedy pomija produkt: może przerwać import, utworzyć pozycję techniczną albo wymagać decyzji. Odczytaj jego log i dokumentację.

Przy dostawie porównaj identyfikator metody, dane punktu odbioru, kwotę pobrania i koszt przesyłki. Sama nazwa kuriera nie wystarcza do rozróżnienia usług. Przykład pól wymagających uwagi opisuje integracja ORLEN Paczki. Zasady konkretnego przewoźnika sprawdzaj w jego konfiguracji, zamiast kopiować identyfikator między metodami.

Po korekcie mapy porównaj sumę zamówienia i komplet danych do realizacji. Właściwy produkt przy błędnej ilości nadal oznacza niepoprawny import. Nie wybieraj przypadkowego odpowiednika, aby tylko usunąć komunikat błędu. Powiązanie powinno odpowiadać rzeczywiście sprzedanemu wariantowi i być możliwe do wyjaśnienia przez obsługę sklepu.

Przy podobnych zamówieniach porównaj checkoutForm.id oraz lineItem.id. Dokumentacja Allegro opisuje łączenie zakupów przez kupującego, które może zmienić identyfikator końcowego zamówienia. Dlatego nie rozpoznawaj duplikatu wyłącznie po kwocie lub adresie odbiorcy. Nie przypisuj też każdego podziału w lokalnym panelu automatycznie podziałowi przesyłek na platformie.

Ustal, jakie reguły tworzą zamówienia w konektorze i sklepie. Oddziel techniczny podział realizacji od rozliczenia zakupu. Przed scaleniem sprawdź pozycje, płatności i dostawy. Ręczna zmiana numerów lub sum może utrudnić późniejsze powiązanie dokumentów oraz komunikacji z klientem.

Powtórne READY_FOR_PROCESSING jest możliwe. Obsługa powinna być idempotentna, czyli ponowienie tego samego zadania nie może tworzyć drugiej realizacji tej samej operacji. Sprawdź klucz rozpoznawania i zapis wyniku, a także zachowanie po przerwaniu procesu w połowie. To warunek bezpiecznego odtworzenia brakującej sprawy, nie opcjonalny detal techniczny.

Sprawdź oficjalny status API Allegro i odpowiedzi zasobów używanych przez integrację. Komunikat o incydencie powinien zostać zestawiony z czasem i zakresem własnego błędu. Awaria nie musi dotyczyć wszystkich sprzedawców ani każdego endpointu. Brak zgłoszeń na forum nie dowodzi z kolei, że przyczyna znajduje się w sklepie.

Przygotuj pakiet dla wsparcia: środowisko, konto, identyfikator zamówienia, czas ze strefą, kod odpowiedzi, identyfikator żądania i zanonimizowany fragment logu. Dopisz ostatni udany etap oraz wynik porównania z poprawnie obsłużonym zakupem. Nie wysyłaj pełnych danych klientów, tokenów ani całych eksportów, jeśli nie są potrzebne do wyjaśnienia błędu.

Dla wdrożenia sklepu internetowego warto ustalić, kto kontaktuje się z dostawcą konektora, a kto odpowiada za kod sklepu. Przekazywanie zgłoszenia między firmami bez wskazania ostatniego potwierdzonego etapu wydłuża diagnozę. Wspólny identyfikator pozwala rozmawiać o tej samej operacji, zamiast porównywać ogólne statusy paneli.

Przed ponowieniem sprawdź, czy zamówienie nie istnieje pod innym lokalnym statusem oraz czy nie rozpoczęto już jego realizacji. Zachowaj stan i ogranicz zakres do ustalonej sprawy lub zakresu zdarzeń. Nie uruchamiaj ponownego importu całej historii bez sprawdzonej ochrony przed duplikatami. Pozornie brakujący zapis może być opóźniony, a nie utracony.

Próbę wykonaj na kopii lub w sandboxie z atrapami wysyłek, faktur i powiadomień. Sprawdź pojedyncze przetworzenie, powtórne zdarzenie oraz przerwanie po częściowym zapisie. Wynik powinien potwierdzić jedną poprawną realizację i spójne kwoty. Nie twórz prawdziwych etykiet ani zakupów w ramach diagnostyki technicznej.

Po naprawie ustal kontrolę zaległości, błędów odświeżania i mapowań. Opieka godzinowa oraz ewentualne SLA wymagają indywidualnego zakresu. Przez kontakt KC Mobile przekaż opis brakującego etapu i komunikat błędu bez sekretów. Na tej podstawie można określić odpowiedzialność za poprawkę i sposób jej odbioru.