Problemy z BaseLinker -- 10 najczestszych bledow i jak je naprawic w 2026

Zanim rzucisz sie do naprawiania, sprawdz trzy rzeczy. Po pierwsze: odwiedz status.base.com -- moze to awaria po stronie BaseLinker, nie Twoja. Strona pokazuje status API, panelu, synchronizacji i poszczegolnych integracji w czasie rzeczywistym. Mozesz subskrybowac alerty e-mail.

Po drugie: przejdz do zakladki z logami bledow w panelu BaseLinker. Kazde nieudane polaczenie jest rejestrowane z kodem bledu, timestampem i nazwa integracji. To najszybszy sposob na zawezenie przyczyny.

Po trzecie: sprawdz, czy problem nie pojawil sie tuz po aktualizacji systemu. BaseLinker regularnie wprowadza zmiany, ktore moga chwilowo zepsusc istniejace automatyzacje. Hotfixy pojawiaja sie zwykle w ciagu 24 godzin.

To zdecydowanie najczesciej zglaszany problem. Sprzedajesz produkt na Allegro, a stan w WooCommerce sie nie zmniejsza -- albo odwrotnie. Efekt: podwojna sprzedaz i niezadowolony klient.

Przyczyny: zbyt dlugi interwal synchronizacji (domyslnie bywa ustawiony na 15-30 minut, przy duzym ruchu to za wolno), bledne powiazania produktow z ofertami na marketplace'ach, chwilowe problemy z API Allegro.

Rozwiazanie krok po kroku:
1. Przejdz do Integracje i sprawdz interwal synchronizacji -- ustaw na 5 minut lub krotszy
2. W zakladce Produkty, Powiazania zweryfikuj, czy kazdy produkt jest poprawnie powiazany z oferta
3. Wymus reczna synchronizacje i obserwuj logi
4. Jesli problem dotyczy konkretnego produktu -- usun powiazanie i stworz je od nowa

Dla sklepow z ponad 50 zamowieniami dziennie synchronizacja co 5 minut to minimum. Przy 200+ zamowieniach rozwaz synchronizacje w czasie rzeczywistym (dostepna w planie Business).

Zamowienie zlozone na Allegro nie pojawia sie w panelu BaseLinker. Albo pojawia sie z kilkuminutowym opoznieniem, ktore dezorganizuje obsluge.

Najczestszy winowajca: wygasniecie tokenu autoryzacyjnego Allegro. Tokeny maja ograniczony czas zycia i trzeba je okresowo odswiezac.

Rozwiazanie:
1. Przejdz do Integracje, Allegro, Ustawienia
2. Kliknij Przetestuj polaczenie -- jesli blad, kliknij Ponowna autoryzacja
3. Zaloguj sie na konto Allegro i potwierdz uprawnienia
4. Po ponownym polaczeniu zamowienia zaczna sie pobierac w ciagu kilku minut

Druga przyczyna: zmiana ustawien na koncie Allegro (np. nowy adres e-mail) moze uniewazniac autoryzacje. Sprawdz rowniez, czy konto Allegro nie jest zablokowane lub ograniczone.

Wiecej o integracji BaseLinker z WooCommerce w osobnym poradniku.

Kody bledow HTTP to codziennosc integracji API. Oto co oznaczaja i jak je naprawic:

Blad 401 (Unauthorized): nieprawidlowy lub wygasly klucz API. Wygeneruj nowy klucz w panelu marketplace'u lub WooCommerce (sciezka: Ustawienia, Zaawansowane, REST API) i podmien go w BaseLinker.

Blad 403 (Forbidden): brak uprawnien. Sprawdz, czy klucz API ma uprawnienia Zapis/Odczyt. Niektore wtyczki bezpieczenstwa (Wordfence, Sucuri) moga blokowac zapytania API -- dodaj IP BaseLinker do whitelisty.

Blad 500 (Internal Server Error): problem po stronie serwera -- moze byc Twojego sklepu lub marketplace'u. Sprawdz error_log na serwerze hostingowym. Czeste przyczyny: przekroczony limit pamieci PHP, zbyt krotki max_execution_time.

Limit API: BaseLinker ogranicza kazdy token do 100 zapytan na minute. Jesli uzywasz wielu integracji na jednym kluczu, moga sie nawzajem blokowac. Rozwiazanie: stworz oddzielne klucze API dla roznych integracji.

Zamowienie pojawia sie w BaseLinker dwa razy (lub wiecej). Kazdy duplikat to ryzyko podwojnej wysylki i strata na kosztach kuriera.

Przyczyny: zdublowane webhooki -- marketplace wysyla powiadomienie o zamowieniu, BaseLinker je przetwarza, a potem przychodzi drugie powiadomienie (np. po aktualizacji statusu platnosci). Druga przyczyna: reczne pobranie zamowien podczas aktywnej synchronizacji automatycznej.

Rozwiazanie:
1. Sprawdz konfiguracje webhookow w panelu marketplace'u -- usun duplikaty
2. Nie uzywaj recznego pobierania zamowien jesli automatyczna synchronizacja jest wlaczona
3. W BaseLinker wlacz opcje deduplikacji (Ustawienia, Zaawansowane) -- system automatycznie wykrywa i laczy duplikaty
4. Jesli duplikaty juz powstaly, polacz je recznie przez opcje Scal zamowienia

Etykieta InPost, DPD czy DHL nie generuje sie lub generuje sie z bledem. To blokuje wysylke i opoznia obsluge.

Czeste przyczyny:
- Nieprawidlowe dane adresowe klienta (brak kodu pocztowego, bledny numer telefonu)
- Przekroczony limit wymiarow lub wagi paczki
- Wygasly token integracji z firma kurierska
- Nieprawidlowy format numeru telefonu (BaseLinker wymaga prefiksu +48)

Rozwiazanie: sprawdz dane adresowe zamowienia -- uzupelnij brakujace pola. Zweryfikuj parametry paczki (wymiary, waga). Odswież polaczenie z firma kurierska w sekcji Integracje. Przy problemach z InPost upewnij sie, ze wybrany paczkomat istnieje i jest aktywny (Paczkomaty sa czasem tymczasowo wylaczane).

Autoakcje to serce BaseLinker -- gdy przestaja dzialac, caly przeplyw zamowien sie zatrzymuje. Nagle nie generuja sie etykiety, nie wychodza SMS-y, nie zmieniaja sie statusy.

Diagnostyka:
1. Przejdz do zakladki Automatyzacje i sprawdz logi kazdej akcji
2. Sprawdz, czy warunki wyzwalania sa nadal aktualne -- czesta przyczyna to zmiana nazwy statusu zamowienia, ktora nie pasuje do warunku
3. Zweryfikuj, czy polaczenie z integracja (np. kurierem) jest aktywne

Rozwiazanie: zaktualizuj warunki wyzwalania, jesli zmienily sie statusy. Tymczasowo wylacz i ponownie wlacz akcje -- to wymusza ponowna rejestracje w systemie. Przy bardziej zlozonych problemach sklonuj akcje, usun stara i przetestuj nowa na pojedynczym zamowieniu.

Cena produktu na Allegro rozni sie od ceny w sklepie WooCommerce -- mimo ze w BaseLinker ustawiles te sama kwote. Problem narasta przy promocjach i zmianach cennikow.

Przyczyny: opóźnienia w synchronizacji cen, bledne mapowanie wariantow produktowych (wariant A w sklepie jest powiazany z wariantem B na Allegro), roznice w konfiguracji walut lub VAT miedzy kanalami.

Rozwiazanie: sprawdz mapowanie wariantow w zakladce Produkty. Zweryfikuj ustawienia cen per kanal -- BaseLinker pozwala ustawic rozne marze dla kazdego marketplace'u. Przy duzych zmianach cenowych uzyj masowej aktualizacji zamiast recznej edycji pojedynczych produktow.

Panel laduje sie wolno, operacje trwają wiecznosc, raporty generuja sie minutami. To nie zawsze wina BaseLinker.

Mozliwe przyczyny: zbyt duza liczba aktywnych zakladek w przegladarce (kazda zuzywa pamiec), cache przegladarki pelen starych danych, problemy z polaczeniem internetowym, przeciazony serwer BaseLinker (sprawdz status.base.com).

Rozwiazanie: wyczysc cache przegladarki, zamknij niepotrzebne zakladki, sprobuj innej przegladarki. Jesli problem dotyczy konkretnych raportow -- ograncz zakres dat. Generowanie raportu za rok jest 10x wolniejsze niz za ostatni miesiac.

BaseLinker regularnie wprowadza aktualizacje -- nowe funkcje, zmiany w API, poprawki bezpieczenstwa. Czasem te zmiany psuja istniejace konfiguracje.

Co robic:
1. Po kazdej wiekszej aktualizacji sprawdz, czy autoakcje dzialaja poprawnie
2. Przetestuj synchronizacje z kazdym kanalem -- jedno testowe zamowienie wystarczy
3. Jesli zauważysz problem tuz po aktualizacji, poczekaj 24h -- hotfixy pojawiaja sie szybko
4. Jesli problem trwa dluzej, zglos go do supportu z informacja o dokladnym momencie wystapienia

BaseLinker publikuje changelog na stronie z aktualizacjami -- warto go sledzic, zeby wiedziec, co sie zmienilo i czy moze to wplynac na Twoja konfiguracje.

Klienci nie dostaja e-maili lub SMS-ow o statusie zamowienia. To psuje doswiadczenie zakupowe i generuje zapytania do obslugi klienta.

Przyczyny: zle skonfigurowane szablony powiadomien w BaseLinker, brak kredytow SMS (usluga platna), powiadomienia e-mail trafiaja do spam, blad w warunku wyzwalajacym automatyczna akcje.

Rozwiazanie: sprawdz konfiguracje powiadomien w zakladce Automatyzacje. Upewnij sie, ze szablony maja prawidlowe placeholdery (np. {{numer_zamowienia}}, {{numer_sledzenia}}). Dla e-maili ustaw SPF i DKIM na domenie nadawcy. Dla SMS-ow sprawdz saldo kredytow w panelu.

Samodzielna diagnostyka ma swoje granice. Skontaktuj sie ze specjalista gdy: problem trwa dluzej niz 48 godzin mimo prob naprawy, dotyczy bezpieczenstwa (wyciek danych, nieautoryzowany dostep), blokuje sprzedaz (niedzialajace platnosci, zamowienia nie sa pobierane), albo masz zlozzona konfiguracje wielokanałowa i nie jesteś pewien, gdzie lezy przyczyna.

Koszt naprawy przez agencje e-commerce: jednorazowa interwencja 200-800 zl, pelny audyt i rekonfiguracja 1 500-5 000 zl. To czesto tansze niz dniowy przestoj w sprzedazy.

Potrzebujesz pomocy z BaseLinker? Skontaktuj sie z nami -- diagnozujemy przyczyne, naprawiamy integracje i konfigurujemy system tak, zeby problemy nie wracaly. Wdrazamy 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.