Problemy z BaseLinker – 10 najczęstszych błędów i jak je naprawić w 2026

Zanim rzucisz się do naprawiania, sprawdź trzy rzeczy. Po pierwsze: odwiedź status.base.com – może to awaria po stronie BaseLinker, nie Twoja. Strona pokazuje status API, panelu, synchronizacji i poszczególnych integracji w czasie rzeczywistym. Możesz subskrybować alerty e-mail.

Po drugie: przejdź do zakładki z logami błędów w panelu BaseLinker. Każde nieudane połączenie jest rejestrowane z kodem błędu, timestampem i nazwa integracji. To najszybszy sposób na zawężenie przyczyny.

Po trzecie: sprawdź, czy problem nie pojawił się tuż po aktualizacji systemu. BaseLinker regularnie wprowadza zmiany, które mogą chwilowo zepsusc istniejące automatyzacje. Hotfixy pojawiają się zwykle w ciągu 24 godzin.

To zdecydowanie najczęściej zgłaszany problem. Sprzedajesz produkt na Allegro, a stan w WooCommerce się nie zmniejsza – albo odwrotnie. Efekt: podwojna sprzedaż i niezadowolony klient.

Przyczyny: zbyt długi interwał synchronizacji (domyślnie bywa ustawiony na 15-30 minut, przy dużym ruchu to za wolno), błędne powiązania produktów z ofertami na marketplace'ach, chwilowe problemy z API Allegro.

Rozwiązanie krok po kroku:
1. Przejdź do Integracje i sprawdź interwał synchronizacji – ustaw na 5 minut lub krótszy
2. W zakładce Produkty, Powiązania zweryfikuj, czy każdy produkt jest poprawnie powiazany z oferta
3. Wymuś reczna synchronizację i obserwuj logi
4. Jeśli problem dotyczy konkretnego produktu – usuń powiązanie i stwórz je od nowa

Dla sklepów z ponad 50 zamówieniami dziennie synchronizacja co 5 minut to minimum. Przy 200+ zamówieniach rozważ synchronizację w czasie rzeczywistym (dostępna w planie Business).

Zamówienie złożone na Allegro nie pojawia się w panelu BaseLinker. Albo pojawia się z kilkuminutowym opóźnieniem, które dezorganizuje obsługę.

Najczęstszy winowajca: wygaśnięcie tokenu autoryzacyjnego Allegro. Tokeny mają ograniczony czas życia i trzeba je okresowo odświeżać.

Rozwiązanie:
1. Przejdź do Integracje, Allegro, Ustawienia
2. Kliknij Przetestuj połączenie – jeśli błąd, kliknij Ponowna autoryzacja
3. Zaloguj się na konto Allegro i potwierdź uprawnienia
4. Po ponownym połączeniu zamówienia zaczną się pobierać w ciągu kilku minut

Druga przyczyna: zmiana ustawień na koncie Allegro (np. nowy adres e-mail) może uniewazniac autoryzację. Sprawdź również, czy konto Allegro nie jest zablokowane lub ograniczone.

Więcej o integracji BaseLinker z WooCommerce w osobnym poradniku.

Kody błędów HTTP to codzienność integracji API. Oto co oznaczają i jak je naprawić:

Błąd 401 (Unauthorized): nieprawidłowy lub wygasły klucz API. Wygeneruj nowy klucz w panelu marketplace'u lub WooCommerce (sciezka: Ustawienia, Zaawansowane, REST API) i podmień go w BaseLinker.

Błąd 403 (Forbidden): brak uprawnień. Sprawdź, czy klucz API ma uprawnienia Zapis/Odczyt. Niektóre wtyczki bezpieczeństwa (Wordfence, Sucuri) mogą blokować zapytania API – dodaj IP BaseLinker do whitelisty.

Błąd 500 (Internal Server Error): problem po stronie serwera – może być Twojego sklepu lub marketplace'u. Sprawdź error_log na serwerze hostingowym. Częste przyczyny: przekroczony limit pamięci PHP, zbyt krótki max_execution_time.

Limit API: BaseLinker ogranicza każdy token do 100 zapytań na minute. Jeśli używasz wielu integracji na jednym kluczu, mogą się nawzajem blokować. Rozwiązanie: stwórz oddzielne klucze API dla różnych integracji.

Zamówienie pojawia się w BaseLinker dwa razy (lub więcej). Każdy duplikat to ryzyko podwójnej wysyłki i strata na kosztach kuriera.

Przyczyny: zdublowane webhooki – marketplace wysyła powiadomienie o zamówieniu, BaseLinker je przetwarza, a potem przychodzi drugie powiadomienie (np. po aktualizacji statusu płatności). Druga przyczyna: ręczne pobranie zamówień podczas aktywnej synchronizacji automatycznej.

Rozwiązanie:
1. Sprawdź konfigurację webhooków w panelu marketplace'u – usuń duplikaty
2. Nie używaj ręcznego pobierania zamówień jeśli automatyczna synchronizacja jest wlaczona
3. W BaseLinker włącz opcje deduplikacji (Ustawienia, Zaawansowane) – system automatycznie wykrywa i łączy duplikaty
4. Jeśli duplikaty już powstały, połącz je ręcznie przez opcje Scal zamówienia

Etykieta InPost, DPD czy DHL nie generuje się lub generuje się z błędem. To blokuje wysyłkę i opóźnia obsługę.

Częste przyczyny:
- Nieprawidłowe dane adresowe klienta (brak kodu pocztowego, błędny numer telefonu)
- Przekroczony limit wymiarów lub wagi paczki
- Wygasły token integracji z firma kurierska
- Nieprawidłowy format numeru telefonu (BaseLinker wymaga prefiksu +48)

Rozwiązanie: sprawdź dane adresowe zamówienia – uzupełnij brakujące pola. Zweryfikuj parametry paczki (wymiary, waga). Odswież połączenie z firma kurierska w sekcji Integracje. Przy problemach z InPost upewnij się, ze wybrany paczkomat istnieje i jest aktywny (Paczkomaty sa czasem tymczasowo wylaczane).

Autoakcje to serce BaseLinker – gdy przestają działać, cały przepływ zamówień się zatrzymuje. Nagle nie generują się etykiety, nie wychodzą SMS-y, nie zmieniają się statusy.

Diagnostyka:
1. Przejdź do zakładki Automatyzacje i sprawdź logi każdej akcji
2. Sprawdź, czy warunki wyzwalania sa nadal aktualne – częsta przyczyna to zmiana nazwy statusu zamówienia, która nie pasuje do warunku
3. Zweryfikuj, czy połączenie z integracja (np. kurierem) jest aktywne

Rozwiązanie: zaktualizuj warunki wyzwalania, jeśli zmieniły się statusy. Tymczasowo wyłącz i ponownie włącz akcje – to wymusza ponowna rejestracje w systemie. Przy bardziej złożonych problemach sklonuj akcje, usuń stara i przetestuj nowa na pojedynczym zamówieniu.

Cena produktu na Allegro różni się od ceny w sklepie WooCommerce – mimo ze w BaseLinker ustawiłeś te sama kwotę. Problem narasta przy promocjach i zmianach cenników.

Przyczyny: opóźnienia w synchronizacji cen, błędne mapowanie wariantów produktowych (wariant A w sklepie jest powiazany z wariantem B na Allegro), roznice w konfiguracji walut lub VAT między kanałami.

Rozwiązanie: sprawdź mapowanie wariantów w zakładce Produkty. Zweryfikuj ustawienia cen per kanał – BaseLinker pozwala ustawić różne marze dla każdego marketplace'u. Przy dużych zmianach cenowych użyj masowej aktualizacji zamiast ręcznej edycji pojedynczych produktów.

Panel ładuje się wolno, operacje trwają wieczność, raporty generują się minutami. To nie zawsze wina BaseLinker.

Możliwe przyczyny: zbyt duża liczba aktywnych zakładek w przeglądarce (kazda zużywa pamięć), cache przeglądarki pełen starych danych, problemy z połączeniem internetowym, przeciążony serwer BaseLinker (sprawdź status.base.com).

Rozwiązanie: wyczyść cache przeglądarki, zamknij niepotrzebne zakładki, spróbuj innej przeglądarki. Jeśli problem dotyczy konkretnych raportów – ograncz zakres dat. Generowanie raportu za rok jest 10x wolniejsze niż za ostatni miesiąc.

BaseLinker regularnie wprowadza aktualizacje – nowe funkcje, zmiany w API, poprawki bezpieczeństwa. Czasem te zmiany psują istniejące konfigurację.

Co robić:
1. Po każdej większej aktualizacji sprawdź, czy autoakcje działają poprawnie
2. Przetestuj synchronizację z każdym kanałem – jedno testowe zamówienie wystarczy
3. Jeśli zauważysz problem tuż po aktualizacji, poczekaj 24h – hotfixy pojawiają się szybko
4. Jeśli problem trwa dłużej, zgłoś go do supportu z informacja o dokładnym momencie wystąpienia

BaseLinker publikuje changelog na stronie z aktualizacjami – warto go śledzić, żeby wiedzieć, co się zmieniło i czy może to wpłynąć na Twoją konfigurację.

Klienci nie dostają e-maili lub SMS-ow o statusie zamówienia. To psuje doświadczenie zakupowe i generuje zapytania do obsługi klienta.

Przyczyny: zle skonfigurowane szablony powiadomień w BaseLinker, brak kredytów SMS (usługa platna), powiadomienia e-mail trafiają do spam, błąd w warunku wyzwalajacym automatyczna akcje.

Rozwiązanie: sprawdź konfigurację powiadomień w zakładce Automatyzacje. Upewnij się, ze szablony mają prawidłowe placeholdery (np. {{numer_zamówienia}}, {{numer_śledzenia}}). Dla e-maili ustaw SPF i DKIM na domenie nadawcy. Dla SMS-ow sprawdź saldo kredytów w panelu.

Samodzielna diagnostyka ma swoje granicę. Skontaktuj się ze specjalista gdy: problem trwa dłużej niż 48 godzin mimo prób naprawy, dotyczy bezpieczeństwa (wyciek danych, nieautoryzowany dostęp), blokuje sprzedaż (niedziałające płatności, zamówienia nie sa pobierane), albo masz zlozzona konfigurację wielokanałowa i nie jesteś pewien, gdzie leży przyczyna.

Koszt naprawy przez agencje e-commerce: jednorazowa interwencja 200-800 zł, pełny audyt i rekonfiguracja 1 500-5 000 zł. To często tańsze niż dniowy przestój w sprzedaży.

Potrzebujesz pomocy z BaseLinker? Skontaktuj się z nami – diagnozujemy przyczynę, naprawiamy integracje i konfigurujemy system tak, żeby problemy nie wracaly. Wdrażamy i optymalizujemy sklepy internetowe z pelna integracja BaseLinker.

Jeśli ten przewodnik Ci pomógł, sprawdź też powiązane problemy, z którymi mierzą się nasi klienci. Każdy z nich jest opisany diagnostycznie – od symptomów, przez przyczyny, po procedurę naprawy krok po kroku:

• BaseLinker + Allegro – błędy integracji – sprawdź, jak diagnozować i naprawić ten problem krok po kroku.

Nie potrafisz zdiagnozować problemu samodzielnie? Napisz do nas – bezpłatnie ocenimy, z czym masz do czynienia i zasugerujemy najszybszą ścieżkę naprawy. Skontaktuj się przez formularz kontaktowy lub zadzwoń bezpośrednio.

Wiele z tych problemów można rozwiązać samodzielnie – ale gdy brakuje czasu, narzędzi lub utknąłeś na etapie diagnozy, warto zlecić pracę zespołowi który robi to codziennie. W KC Mobile zajmujemy się tym od lat.

Zobacz powiązane usługi i materiały:

• sklep internetowy na WooCommerce
• pozycjonowanie sklepu z meblami
• poradnik Magento dla sklepów
• jak zacząć dropshipping
• PayU vs Przelewy24

Jeśli opis w tym wpisie nie dotyczy dokładnie Twojej sytuacji, napisz do nas – odpowiadamy w ciągu 24 godzin roboczych.

Jeśli te problemy wracają, zwykle przyczyną jest konfiguracja u źródła – wdrażamy i naprawiamy integracje BaseLinker (od 2 999 zł), z gwarancją poprawnej synchronizacji stanów i zamówień.