BaseLinker nie działa? Diagnostyka stanów i zamówień

Zapisz godzinę ostatniej poprawnej operacji i pierwszego zauważonego błędu. Sprawdź, czy problem dotyczy jednego produktu, jednego kanału czy całego panelu. Wybierz jeden przykład do diagnozy: numer oferty, identyfikator zamówienia albo produkt z wariantem. Porównywanie przypadkowych rekordów utrudnia odtworzenie tego, co rzeczywiście się stało.

Oficjalny status Base pomaga sprawdzić zgłoszone incydenty. Brak komunikatu nie wyklucza jednak problemu z Twoim sklepem, konkretnym kontem marketplace lub zewnętrznym dostawcą. Zapisz pełny komunikat błędu, ale usuń z niego dane klienta i sekrety przed przekazaniem dalej.

Zanotuj też ostatnie zmiany: migrację sklepu, nowe klucze, zmianę statusów lub edycję reguły. Zbieżność w czasie jest tropem, nie dowodem przyczyny. Jeśli podejrzewasz podwójną wysyłkę, wstrzymaj wykonanie tej konkretnej operacji do wyjaśnienia.

Najpierw ustal, który system zarządza stanem. Sklep, magazyn Base i ERP nie powinny samodzielnie nadpisywać tej samej informacji bez ustalonego kierunku. Porównaj ilość w źródle z ilością przypisaną do oferty. Sprawdź ID produktu, ID wariantu i powiązanie; zgodna nazwa nie dowodzi, że systemy wskazują ten sam towar.

Dokumentacja synchronizacji stanów Base wskazuje ustawienia Integracje → Konto Marketplace → Stany oraz logi wyszukiwane numerem oferty. Opisuje częstotliwości co 8 godzin, co godzinę i na żywo. Tryb na żywo nie jest dostępny w Freemium. Nie oznacza to jednej gwarantowanej liczby sekund dla całej drogi od sklepu do marketplace.

Jeżeli log nie pokazuje oczekiwanej zmiany, sprawdź progi aktualizacji i ustawienie braku działania przy zmianie ilości. Jeżeli pokazuje błąd, przejdź do jego treści zamiast zwiększać częstotliwość odpytywania. W FAQ synchronizacji producent wymienia również połączenie sklepu oraz ograniczenie liczby kończonych ofert.

Nie usuwaj powiązania jako pierwszego kroku. Najpierw zapisz istniejące identyfikatory i potwierdź, gdzie leży rozbieżność. Gdy problem wynika z samego projektu przepływu, wróć do poradnika konfiguracji Base. Zmiana jednego mapowania powinna zakończyć się kontrolą konkretnej oferty, a nie masowym przepięciem asortymentu.

Sprawdź również, czy produkt nadal istnieje w magazynie. Usunięcie pozycji zrywa powiązanie oferty i zatrzymuje jej synchronizację. Ustawienie ilości na zero to inna operacja: pozwala zadziałać skonfigurowanej regule braku towaru. Takie rozróżnienie opisuje podlinkowane FAQ Base; samo zniknięcie produktu nie jest poleceniem zakończenia oferty.

Pobieranie zamówienia ze sklepu do Base i przekazywanie zamówienia z Base do sklepu to różne czynności. Zanim sprawdzisz klucze, nazwij kierunek, który nie działa. Ustal numer źródłowy zamówienia i sprawdź, czy widzisz właściwy kanał oraz zakres dat. Brak rekordu na jednej liście nie wystarcza, aby uznać import za nieskuteczny.

Przy pobieraniu ze sklepu porównaj dostępność połączenia, ustawienia integracji i rzeczywisty status zamówienia w sklepie. Jeśli problem pojawił się po migracji, sprawdź adres oraz autoryzację. Nie zakładaj od razu, że każdy token wygasł. Błąd może wystąpić wcześniej, na przykład podczas połączenia z adresem sklepu.

Przy przekazywaniu do sklepu zastosowanie mają inne kontrole. FAQ Base dotyczące sklepów wskazuje włączenie przekazywania, potwierdzenie zamówienia oraz właściwe ID produktu i wariantu z odpowiedniego magazynu. Samo SKU wpisane w opisie nie zastępuje tych powiązań.

Porównaj jedno poprawnie przekazane zamówienie z jednym błędnym. Różnica w wariancie, statusie albo pochodzeniu produktu daje lepszy punkt zaczepienia niż ponowne pobranie wszystkich rekordów. Przed ponowieniem sprawdź zewnętrzny numer i historię, aby nie rozpocząć obsługi tego samego zakupu drugi raz.

Jeżeli w połączonym zamówieniu brakuje numeru paczkomatu lub innego pola dostawy, najpierw ustal kierunek przekazania danych: z WooCommerce do Base czy odwrotnie. Sprawdź obsługę tego pola w oficjalnej wtyczce Base dla sklepu i w używanym rozszerzeniu dostaw. Zakres wtyczki opisuje poradnik konfiguracji. Ponowne przesłanie całego zamówienia nie zastępuje kontroli brakującego pola.

Ustal, który system zwraca odpowiedź. Kod widoczny w Base może pochodzić ze sklepu, marketplace lub własnego konektora. HTTP 401 kieruje uwagę na uwierzytelnienie, 403 na odmowę dostępu, a 500 na błąd po stronie serwera. Żaden z tych kodów samodzielnie nie mówi, którą konkretnie opcję trzeba zmienić.

Zapisz adres usługi bez sekretów, czas wystąpienia i treść odpowiedzi. Administrator sklepu powinien porównać tę próbę z logami aplikacji oraz zabezpieczeń. Jeśli filtr blokuje prawidłowe żądanie, korekta powinna dotyczyć rozpoznanej reguły. Wyłączenie ochrony całego sklepu pozostawia problem niewyjaśniony i nie jest procedurą naprawczą.

Dokumentacja Base API podaje limit 100 żądań na minutę i zaleca przekazywanie tokenu w nagłówku X-BLToken. Własna integracja musi uwzględniać współdzielone obciążenie konta, kolejkę oraz ponawianie z odpowiednim odstępem. Tworzenie kolejnych tokenów nie jest udokumentowanym sposobem zwiększenia limitu.

Programista powinien też sprawdzić, co stało się po przerwaniu odpowiedzi. Brak odpowiedzi w określonym czasie nie dowodzi, że zlecenie nie zostało zapisane. Ponowienie odczytu i ponowienie utworzenia przesyłki mają inne skutki. Właśnie dlatego diagnostyka musi uwzględniać identyfikator operacji oraz jej stan po stronie odbiorcy.

Najpierw sprawdź wykonane działania, dopiero później porządkuj rekordy. Dwa wpisy na liście mogą już mieć osobne etykiety, wiadomości albo dokumenty. Usunięcie lub połączenie rekordu nie cofa automatycznie tych skutków u przewoźnika czy w systemie dokumentowym.

Przy etykiecie odczytaj błąd dostawcy i porównaj metodę dostawy, dane adresowe oraz wymagane parametry przesyłki. Nie poprawiaj danych klienta na podstawie domysłu. Jeżeli brakuje informacji niezbędnej do nadania, zlecenie wymaga wyjaśnienia przed wysyłką.

Przy dokumentach ustal, czy wystawia je Base, czy połączony system. Producent opisuje oba scenariusze w pomocy dotyczącej dokumentów sprzedaży. Jeżeli dokument już powstał, sposób poprawienia rozbieżności musi uwzględniać przyjęty obieg dokumentów. Nie twórz kolejnego tylko dlatego, że pierwszego nie widać od razu na ekranie zamówienia.

Otwórz historię konkretnego zamówienia i odtwórz kolejność zdarzeń. Sprawdź, czy zdarzenie wystąpiło po włączeniu reguły, czy spełniono jej warunki i czy wcześniejsza operacja nie zakończyła się błędem. Sama obecność reguły w konfiguracji nie potwierdza jej wykonania dla danego zamówienia.

Dokumentacja akcji automatycznych wyjaśnia, że reguły nie działają wstecz. Warunki reguł uruchamianych tym samym zdarzeniem są sprawdzane równocześnie. Nie buduj więc zależności na założeniu, że pierwsza reguła zmieni dane, a druga natychmiast oceni już ich nową wartość.

Sprawdź dostępne dla danej operacji zatrzymanie po błędzie i działanie po błędzie. Zapisz, jaki wynik ma zostać osiągnięty: zmiana statusu, utworzenie dokumentu czy wiadomość. To pozwala odróżnić uruchomienie reguły od skutecznego wykonania jej zadania.

Nie klonuj i nie kasuj akcji jako uniwersalnej naprawy. Zachowaj jej identyfikator oraz materiał do porównania, a poprawkę sprawdź na wydzielonym przypadku. Gdy problem dotyczy powtarzania reguły, kontrola musi również wykazać, że drugi przebieg nie tworzy kolejnej przesyłki lub dokumentu. Dopiero taki wynik potwierdza, że usunięto przyczynę, a nie tylko objaw.

Producent ujmuje tę zasadę wprost: "Akcje nie działają wstecz." Cytat pochodzi z podlinkowanej dokumentacji automatyzacji Base. Dodanie poprawnej reguły nie oznacza więc, że wcześniejsze zamówienia zostały nią obsłużone.

Dobre zgłoszenie opisuje oczekiwany wynik oraz to, co faktycznie nastąpiło. Dodaj numer zamówienia lub oferty, godzinę ze strefą czasową, nazwę integracji, zanonimizowany komunikat i ostatnią zmianę. W przypadku automatyzacji podaj również ID akcji. Nie przesyłaj kluczy API w zwykłym opisie problemu ani pełnych danych kupujących na zrzutach.

Zapisz wszystkie dotychczasowe próby naprawy. Specjalista musi wiedzieć, czy ktoś ponawiał import, generował etykietę albo zmieniał mapowanie. Jeśli sprzedaż lub wysyłki są zablokowane, zgłoś wpływ biznesowy od razu; nie ma uniwersalnego uzasadnienia, by czekać dobę przed kontaktem.

Zakres diagnozy wpływa na wycenę. Sam abonament omówiliśmy w cenniku korzystania z Base, a prace konfiguracyjne na stronie integracji BaseLinker. Gdy przyczyna leży w platformie sprzedażowej, naprawa może wymagać również zmian w sklepie internetowym.

Perspektywa KC Mobile: proponujemy rozliczać diagnozę także przez warunek odbioru: określone zamówienie przechodzi właściwą ścieżkę, stan trafia do wskazanej oferty, a ponowienie nie powiela skutków. To propozycja sposobu pracy, nie obietnica czasu naprawy. Przekaż nam opis problemu, aby ustalić zakres dalszych działań. Na początek wystarczy sklep lub platforma oraz konkretny objaw. Dodatkowe identyfikatory i logi można uzupełnić podczas diagnozy.