Jak radzic sobie z problemami z BaseLinker w e-commerce?

To zdecydowanie najczesciej zglaszany problem. Synchronizacja między BaseLinker a Allegro nagle przestaje dzialac, nowe zamowienia nie splywaja, stany magazynowe sie rozjezdzaja.

Przyczyna bywa banalna – token API Allegro wygasl lub zostal uniewazniony. Tokeny maja ograniczony czas zycia (wygasaja co 12 godzin, ale BaseLinker odswierza je automatycznie) i wymagaja aktywnego połączenia. Zmiana hasla na Allegro albo cofniecie uprawnien aplikacji automatycznie uniewaznia token.

Checklista diagnostyczna:
1. Wejdz w BaseLinker do zakladki Integracje > Allegro
2. Kliknij Odnow połączenie – system przekieruje Cie na strone Allegro
3. Zaloguj sie i potwierdz uprawnienia aplikacji
4. Wroc do BaseLinker i sprawdz status połączenia – powinien byc zielony
5. Wymus reczna synchronizacje, zeby nadrobic zaleglosci

Drugi czesty problem to mapowanie wariantow. Produkty z wariantami (rozmiar, kolor) często sie gubja między platformami. BaseLinker laczy warianty po SKU – jesli na Allegro masz inny kod niz w swoim sklepie WooCommerce, system nie polaczy tych produktow i będzie je traktowac jako osobne pozycje. Rozwiązanie: ujednolic kody SKU na wszystkich platformach. Więcej o integracji znajdziesz w poradniku BaseLinker + WooCommerce.

Kiedy BaseLinker zwraca blad API, kod bledu mowi dokladnie, co sie dzieje. Znajomosc tych kodow oszczedza godziny szukania na slepo.

401 Unauthorized – przeterminowany lub nieprawidlowy token API. Najczestszy blad. Rozwiązanie: odnow połączenie z dana platforma w zakladce Integracje. Jesli chodzi o API BaseLinker (Base.com), wygeneruj nowy token w Moje konto > API.

403 Forbidden – brak uprawnien. Token jest ważny, ale nie ma dostepu do danej operacji. Sprawdz, czy przy generowaniu tokenu nadales wszystkie potrzebne uprawnienia (odczyt zamowien, zapis stanow itp.).

500 Internal Server Error – problem po stronie BaseLinker lub polaczonej platformy. Tu niewiele możesz zrobic. Sprawdz oficjalna strone statusu Base.com. Jesli blad powtarza sie przez więcej niz godzine, pisz do supportu.

Timeout – przekroczony czas oczekiwania na odpowiedz. Może wynikac z przeciazenia serwera, zbyt duzego zapytania (np. synchronizacja 10 000 produktow na raz) lub problemow sieciowych. Sprobuj zmniejszyc porcje danych w synchronizacji.

Limity API – BaseLinker pozwala na 100 requestow na minute na konto. Przekroczenie skutkuje chwilowa blokada (kod 429). Jesli uzywasz własnych skryptow laczacych sie z API, dodaj opoznienia między zapytaniami.

Duplikaty zamowien to problem, który potrafi naprawde namieszac – podwojne wysyłki, podwojne faktury, niezadowoleni klienci. Na forach Allegro to jeden z najczesciej zglaszanych bledow.

Skad sie biora duplikaty:
- Podwojne webhooki – platforma sprzedazowa wysyla powiadomienie o zamowieniu dwa razy (np. z powodu timeout przy pierwszym połączeniu)
- Brak deduplikacji – BaseLinker nie rozpoznaje, ze to samo zamowienie już istnieje
- Reczny import + automatyczna synchronizacja – ktos importuje zamowienia recznie, a jednoczesnie dziala sync automatyczny

Jak temu zapobiec:
1. W autohandlerze dodaj warunek sprawdzajacy, czy zamowienie o danym numerze zewnetrznym już istnieje
2. Nigdy nie mieszaj importu recznego z automatycznym – wybierz jedno
3. Sprawdz, czy nie masz zduplikowanych integracji (np. dwa połączenia z tym samym kontem Allegro)
4. Jesli duplikaty już powstaly – usun je recznie i sprawdz logi, zeby znalezc przyczyne

Szczegoly konfiguracji BaseLinker znajdziesz w artykule o konfiguracji BaseLinker.

Klient zaplacil, ale w BaseLinker zamowienie nadal widnieje jako nieoplacone. Albo odwrotnie – platnosc zostala zwrocona, a system tego nie odnotowal. Oba scenariusze prowadza do chaosu.

Przyczyna? Webhook z systemu platnosci nie dociera do BaseLinker. Może chodzic o zly URL callbackowy, blokade firewalla albo blad po stronie operatora.

Co sprawdzic:
- URL webhooka w panelu PayU lub Przelewy24 – musi dokladnie odpowiadac temu, co podaje BaseLinker
- Reczny test webhooka (PayU ma opcje Send test notification w panelu merchantowym)
- Czy serwer Twojego sklepu internetowego nie blokuje połączen przychodzacych z IP operatora platnosci
- Logi BaseLinker (Ustawienia > Logi) – znajdziesz tam dokladny czas i treść ostatnich webhookow

Więcej o konfigurowaniu platnosci online w sklepie znajdziesz w osobnym poradniku.

Probujesz wygenerowac etykiete InPost z poziomu BaseLinker i dostajesz blad. Albo etykieta sie generuje, ale z niepoprawnymi danymi adresowymi. Frustrujace, bo blokuje fizyczna wysyłke.

Najczestsze przyczyny:
- Nieprawidlowy format numeru telefonu odbiorcy (InPost wymaga 9 cyfr bez kierunkowego)
- Brak lub bledny kod pocztowy
- Przekroczony limit paczek na koncie InPost
- Niezgodnosc wymiarow paczki z wybranym typem usługi (np. gabaryt C do paczkomatu, który go nie obsluguje)

Jak to rozwiązać:
1. Sprawdz mapowanie pol w BaseLinker – wejdz w Integracje > InPost > Mapowanie i upewnij sie, ze pola adresowe sa prawidlowo przypisane
2. Wlacz walidacje danych przed generowaniem etykiet – BaseLinker może automatycznie sprawdzac poprawnosc kodu pocztowego i numeru telefonu
3. Przy problemach z limitem paczek skontaktuj sie z opiekunem konta InPost

Jesli wysylasz duzo paczek dziennie, rozwaz automatyzacje procesow – skrypty potrafia wychwytywac bledne dane zanim trafia do systemu kurierskiego.

Sprzedajesz na Allegro, własnym sklepie na WooCommerce i może jeszcze na Empik Marketplace. BaseLinker powinien synchronizowac stany między tymi kanalami, ale czasem robi to z opoznieniem lub blednie. Efekt? Sprzedajesz produkt, ktorego już nie masz.

Skad sie biora rozbieznosci:
- Opoznienie synchronizacji – standardowo BaseLinker odpytuje platformy co 5-15 minut. Przy intensywnej sprzedazy ten odstep bywa za dlugi
- Reczne korekty stanow na jednej platformie, które nie propaguja sie na pozostale
- Zmiany stanow poza BaseLinker – np. sprzedaz stacjonarna, zwroty przetworzone bezposrednio w panelu Allegro
- Bledy w mapowaniu produktow – ten sam produkt ma różne SKU na różnych platformach i BaseLinker ich nie laczy

Jak to naprawic:
- Ujednolic SKU na wszystkich platformach – to fundament prawidlowej synchronizacji
- Skrocic interwal synchronizacji do minimum (w planie Professional można ustawic co 1 minute)
- Nigdy nie edytowac stanow bezposrednio na platformach sprzedazowych – zawsze przez BaseLinker
- Wlaczyc bufor bezpieczeństwa (np. 2 sztuki rezerwowe), zeby uniknac oversellingu przy opoznieniu synca

Lepiej zapobiegac niz leczyc. BaseLinker oferuje kilka narzedzi, które pomagaja wychwycic problemy zanim stana sie krytyczne.

Alerty email o bledach automatycznych akcji. W zakladce Autohandler możesz skonfigurowac powiadomienia email o każdym bledzie. Ustaw osobny adres (np. [email protected]), zeby nie ginelo to w skrzynce ogolnej.

Regularne sprawdzanie tokenow API. Raz w miesiacu wejdz w zakladke Integracje i sprawdz status połączen. Zielona kropka to OK, czerwona wymaga uwagi. Szczególnie ważne przy Allegro, gdzie token potrafi sie rozlaczyc po aktualizacji regulaminu.

Backup konfiguracji autohandlera. BaseLinker nie ma wbudowanego eksportu regul. Rob screenshoty lub dokumentuj reguly w arkuszu kalkulacyjnym. Przy przypadkowym usunieciu reguly odtworzenie z pamieci to koszmar.

Monitoring stanow magazynowych. Ustaw alert na produkty spadajace poniżej progu minimalnego. Możesz to zrobic przez autohandler z warunkiem Stan magazynowy < X.

Sprawdzanie strony statusu. Base.com ma oficjalna strone statusu systemu. Dodaj ja do zakladek – zanim zaczniesz debugowac, sprawdz, czy problem nie jest po ich stronie.

Jesli potrzebujesz pomocy przy konfiguracji monitoringu, skontaktuj sie z nami.

BaseLinker sprawdza sie dobrze do okolo 2000-3000 zamowien miesiecznie. Powyżej tej granicy niektorzy sprzedawcy zaczynaja odczuwac ograniczenia – wolniejsza synchronizacja, limity API, brak zaawansowanej analityki.

Sygnaly, ze potrzebujesz czegos więcej:
- Synchronizacja stanow trwa dluzej niz 5 minut mimo najkrotszego interwalu
- Potrzebujesz zaawansowanego zarządzania magazynem (lokalizacje, partie, numery seryjne)
- Chcesz integrowac sie z systemem ERP (np. Comarch, Subiekt GT)

Alternatywy do rozwazenia:
- Sellasist – od 299 zl/mies. za 10 000 zamowien, dobra analityka, integracja z polskimi marketplace'ami
- SellIntegro – specjalizuje sie w integracji z systemami ERP (Comarch, Optima, Subiekt). Więcej w porownaniu integratorow
- Apilo – latwiejszy w obsludze niz BaseLinker, ale mniej elastyczny. Sprawdz integracje Apilo z WooCommerce

Zanim podejmiesz decyzje, skonsultuj sie ze specjalista, który oceni, czy Twoj obecny setup da sie jeszcze zoptymalizowac, czy faktycznie czas na zmiane narzedzia. Więcej o kosztach BaseLinker znajdziesz w artykule o cenach BaseLinker.