Jak zintegrować WooCommerce z Allegro przez BaseLinker – kompletny poradnik 2026

Zanim wejdziemy w szczegóły techniczne, warto zrozumieć, dlaczego ta architektura wygrywa z bezpośrednią wtyczką Allegro do WooCommerce. Bezpośrednia integracja (np. WP Desk Allegro Pro) działa w prostych sklepach z 50–200 produktami i jednym pracownikiem. Powyżej tej skali zaczynają się problemy – limit API Allegro 9000 wywołań na godzinę, brak hub-a do zarządzania innymi marketplace'ami, ręczne wystawianie etykiet kurierskich. BaseLinker rozwiązuje to systemowo.

Korzyść 1 – jeden panel zamiast pięciu zakładek. W BaseLinkerze zarządzasz produktami, ofertami Allegro, zamówieniami z WooCommerce, eBay, Empik, fakturami i wysyłkami z jednego ekranu. Klient zamawia na Allegro o 23:15, zamówienie spływa do BaseLinkera w 30–60 sekund, generuje się faktura w Fakturowni, etykieta InPost trafia do drukarki o 8:00 rano. Z 50–100 zamówieniami dziennie oszczędność czasu to 3–5 godzin pracy magazynowej tygodniowo (źródło: badanie operacyjne BaseLinker 2025) [1].

Korzyść 2 – koniec z oversellingiem. Najczęstsze koszmar sklepu sprzedającego na Allegro i własnym sklepie – sprzedaż tego samego produktu dwa razy. BaseLinker pilnuje magazynu w czasie rzeczywistym: każde zamówienie z Allegro zmniejsza stan w WC i odwrotnie, co minimalizuje ryzyko nadsprzedaży (typowy SLA synchronizacji to 30–120 sekund w zależności od planu i obciążenia kolejki).

Korzyść 3 – łatwy multi-channel scaling. Raz skonfigurowany BaseLinker pozwala dodać Amazon DE/CZ, Empik Marketplace, Erli, eBay czy nawet TikTok Shop bez przepisywania logiki sklepu. Mapowanie nowego marketplace'u to 2–6 godzin pracy, nie 80 jak przy bezpośredniej integracji.

Korzyść 4 – automatyzacja procesów post-purchase. Akcje automatyczne BaseLinkera odpalają się po statusie zamówienia: wystaw fakturę → zarezerwuj towar → wygeneruj etykietę → zmień status w Allegro na "Wysłane" → wyślij mail z trackingiem. To pipeline, który u 100-zamówieniowego sklepu zastępuje pół etatu pracownika.

Korzyść 5 – dane do podejmowania decyzji. BaseLinker daje raporty marżowości per kanał (Allegro vs WC), bestsellery z ostatnich 7/30/90 dni i analizę kosztów wysyłki (Allegro Smart! vs etykieta własna). Bez tego trudno sensownie zarządzać marketplace'ami, gdzie marża zjada prowizja 8–18% [2]. Sklep, który dopiero startuje, warto na wstępie zaplanować właśnie pod multi-channel – sprawdź nasz poradnik startu sklepu internetowego w 2026.

To nie jest narzędzie dla każdego – jeśli masz 5 zamówień miesięcznie i 20 produktów, wystarczy ci ręczna obsługa. Ale od ok. 50 zamówień miesięcznie i 100+ produktów BaseLinker zaczyna się zwracać już w pierwszym miesiącu wdrożenia. Pokrewny artykuł, który tłumaczy to liczbowo, to nasz cennik automatyzacji fakturowania sklepu.

Zanim dotkniesz BaseLinkera, sprawdź środowisko. To etap, który widzimy najczęściej zawalony – klient kupuje plan BaseLinker, instaluje wtyczkę, a sklep zwraca błąd 500 albo timeout. Powody są prawie zawsze te same.

WooCommerce minimum 8.0 (rekomendowane 9.x). Starsze wersje WC mają zbugowane REST API, które rozjeżdża się przy synchronizacji wariantów (typowy objaw – produkt-rodzic ma stan, warianty pokazują zero). WordPress minimum 6.4, PHP 8.1+, MySQL 5.7 lub MariaDB 10.3. Hosting shared u taniego dostawcy (typu nazwa.pl czy home.pl) nie poradzi sobie z 200+ zamówieniami dziennie – limit zapytań API zostanie wyczerpany w pół godziny.

Hosting – realny benchmark. Dla sklepu z 50–200 zamówień/dzień rekomendujemy VPS minimum 4 GB RAM, 4 vCPU, NVMe SSD. Dobre opcje to CyberFolks (od 60 zł/mc), LH.pl Business albo Zenbox VPS. Powyżej 500 zamówień/dzień – dedykowany serwer lub managed hosting WC (od 400 zł/mc). NIE używaj OVH SoYouStart bez fachowca, NIE używaj cPanel-shared z limitem inode 250k. Szczegółowe rekomendacje hostingu pod sklep w naszym poradniku hostingu WooCommerce 2026 i na stronie hosting sklepu internetowego.

Konto Allegro – wymagania API. Do integracji potrzebujesz konta firmowego z aktywnym Allegro Pro albo Allegro Business (od ok. 49 zł/mc), bo tylko one mają dostęp do REST API w pełnym zakresie. Konto musi mieć dane firmowe potwierdzone (KRS/CEIDG, NIP) i historię sprzedaży co najmniej 30 dni – świeże konta dostają restrykcje API. W panelu Allegro Apps Developer [3] zarejestruj aplikację z odpowiednimi scope'ami: allegro:api:profile:read, allegro:api:sale:offers:read/write, allegro:api:orders:read, allegro:api:billing:read. Bez tego BaseLinker dostanie 403 przy próbie synchronizacji.

WooCommerce REST API – klucze read/write. W WC → Ustawienia → Zaawansowane → REST API wygenerujesz parę consumer_key + consumer_secret. Uprawnienia Read/Write, użytkownik to admin sklepu albo dedykowane konto "BaseLinker Integration". Trzymaj te klucze w menedżerze haseł – wycieknięte dają pełen dostęp do produktów, zamówień i klientów (RODO!).

SSL Let's Encrypt + HTTP/2. BaseLinker odmawia połączenia do sklepów na HTTP albo z wygasłym certyfikatem. Brzmi banalnie, ale 5% wdrożeń u nas zaczyna się od "dlaczego nie łączy?" – odpowiedź to wygasłe Let's Encrypt. Skonfiguruj auto-renewal na poziomie hostingu i monitoruj uptimerobotem [4].

Jeśli czegoś z tej listy brakuje – zatrzymaj się i napraw, zanim ruszysz dalej. Inaczej zmarnujesz 5–10 godzin na debugowanie czegoś, co jest problemem hostingu, nie BaseLinkera. To zadanie pokrywa nasza usługa migracji i integracji WooCommerce, a dla istniejących sklepów polecamy też optymalizację WooCommerce przed startem integracji.

To rdzeń całego poradnika – proces, który wykonujemy w naszych projektach wdrożenia integracji BaseLinker przy każdym sklepie. Trzymaj się kolejności, każdy etap zależy od poprzedniego.

Etap 1 – założenie konta BaseLinker. Wejdź na baselinker.com i załóż konto firmowe (osobiste też działa, ale przy zwrotach VAT zmienisz na firmowe). Plan Start jest darmowy do 100 zamówień miesięcznie i wystarczy do testów. Większość naszych klientów wybiera plan Standard (29 zł/mc, do 500 zamówień/mc) – cennik 2026 [5].

Etap 2 – instalacja wtyczki BaseLinker w WooCommerce. Plugin baselinker-connect dostępny darmowo w repo WordPress.org [6]. Po instalacji w WC → BaseLinker wklejasz consumer_key i consumer_secret z REST API. Test połączenia powinien zwrócić zielone "OK" w 2–3 sekundy. Jeśli zwraca timeout – problem z hostingiem albo z mod_security blokującym requesty REST (typowe na home.pl).

Etap 3 – dodanie WooCommerce jako magazynu w BaseLinkerze. W panelu BaseLinker → Integracje → Magazyny → Dodaj → WooCommerce. Wklejasz URL sklepu (https://twojsklep.pl, koniecznie z HTTPS), klucze REST i wybierasz tryb synchronizacji. Polecamy zacząć od "WooCommerce jest źródłem prawdy" – BaseLinker tylko pobiera produkty i stany, nie nadpisuje cen w WC. To bezpieczniejsze przy pierwszej integracji.

Etap 4 – pierwsza synchronizacja katalogu. BaseLinker zaciągnie produkty z WC do swojego magazynu. Dla 500 produktów to 5–10 minut, dla 5000 produktów to 1–2 godziny (zależy od liczby wariantów i zdjęć). W tym czasie nic NIE zmieniaj w WC – synchronizacja jest atomowa. Po zakończeniu zobaczysz listę produktów w panelu BaseLinker → Magazyn.

Etap 5 – autoryzacja Allegro przez OAuth 2.0. W BaseLinker → Integracje → Marketplace → Dodaj → Allegro. Wciskasz "Połącz", otwiera się okno logowania Allegro, akceptujesz uprawnienia aplikacji. Otrzymujesz access_token (ważny 12 godzin) i refresh_token (ważny 365 dni) – BaseLinker odświeża je automatycznie, ale jeśli zmienisz hasło Allegro, token wygasa i trzeba autoryzować ponownie [7].

Etap 6 – konfiguracja kont sprzedażowych Allegro. Możesz mieć kilka kont (np. core brand + outlet) podłączonych pod jeden BaseLinker. W każdym koncie ustawiasz domyślną kategorię, formę dostawy (Smart! / standard), warunki gwarancji, politykę zwrotów (14 dni). To ustawienia domyślne dla nowych ofert – pojedyncze produkty można nadpisać.

Etap 7 – mapowanie kategorii Allegro do produktów WC. Opisane szczegółowo w sekcji 4 – to najtrudniejszy etap, zostaw sobie 2–6 godzin na 100 produktów.

Etap 8 – konfiguracja synchronizacji stanów. BaseLinker → Magazyn → Reguły sync. Ustaw: WooCommerce ↔ BaseLinker co 60–120 sekund, BaseLinker → Allegro co 60 sekund, Allegro → BaseLinker → WC dla zakupów: real-time przez webhooki (po ich włączeniu w panelu Allegro Developer).

Etap 9 – import zamówień Allegro do WooCommerce. BaseLinker → Zamówienia → Akcje automatyczne. Reguła "Po zaksięgowaniu wpłaty w Allegro → utwórz zamówienie w WC ze statusem ‚Przetwarzane'". Pierwszy import testowy zrób na małej kwocie (zamów u siebie z drugiego konta Allegro za 5 zł).

Etap 10 – podłączenie kurierów i faktur. Integracja InPost (token API z paczkomaty.pl), DPD (login + hasło + FID), Pocztex (umowa z Pocztą Polską). Faktury – Fakturownia (klucz API z panelu) albo iFirma (login + hasło + identyfikator). Po włączeniu akcji automatycznych zamówienia obsługują się same aż do momentu pakowania.

Każdy z tych 10 etapów wykonujemy w ciągu 8–20 godzin samodzielnej pracy albo 6–15 godzin agencyjnej (sprawniej, bo nie szukamy w dokumentacji). Pełny zakres prac i koszty rozpisujemy w cenniku integracji BaseLinker. Jeśli wolisz samodzielnie i z gotowym scenariuszem do skopiowania, sprawdź też poradnik konfiguracji BaseLinker DIY + cennik agencji.

Ten etap zwykle decyduje, czy projekt skończy się w tygodniu czy w trzech. Allegro w 2026 ma ponad 8500 kategorii, każda z własnym zestawem parametrów obowiązkowych: EAN/GTIN, marka, model, kolor, rozmiar, materiał, gwarancja, kraj produkcji. Twoje produkty WooCommerce mają zwykle kilkanaście atrybutów. Trzeba je do siebie dopasować, inaczej oferty nie wejdą lub zostaną odrzucone z błędem 422 Unprocessable Entity.

Etap A – wybór głównej kategorii Allegro. W BaseLinker → Marketplace → Allegro → Mapowanie kategorii. Wybierasz kategorię WC (np. "Buty damskie") i przypisujesz docelową kategorię Allegro (np. "Moda → Buty damskie → Sandały"). Im głębsza kategoria Allegro, tym mniej parametrów obowiązkowych musisz mapować, ale węższa widoczność oferty.

Etap B – mapowanie atrybutów na parametry. Każdy parametr Allegro wymaga źródła wartości. Trzy opcje:
- Z atrybutu WC – jeśli masz atrybut "Kolor: czerwony" w WC, mapujesz na parametr "Kolor" Allegro. Wartości muszą być zgodne ze słownikiem Allegro (czerwony, nie "red") – BaseLinker zwykle podpowiada mapowanie automatyczne, ale przy 50% produktów trzeba ręcznie poprawić.
- Wartość stała – np. "Marka: TwojaMarka" dla wszystkich produktów. Działa dla jednomarkowych sklepów.
- Wartość dynamiczna z pola własnego – własny meta-field WC, np. _ean mapowany na parametr "EAN".

Etap C – obsługa wariantów (rozmiar, kolor). WooCommerce ma produkty z wariantami (np. T-shirt w 5 rozmiarach × 3 kolory = 15 wariantów). Allegro daje dwa modele wystawiania:
- Jedna oferta z wariantami (multi-variant listing) – widoczne dla kupującego jako jedna oferta z dropdownem. Wymaga atrybutu "Rozmiar" lub "Kolor" jako wariantotwórczego (Allegro ogranicza do max 2 takich parametrów).
- Osobne oferty per wariant – każda kombinacja to oddzielne ID Allegro. Lepsza widoczność SEO, ale 15× więcej ofert do zarządzania.

W praktyce wybieramy multi-variant dla mody, butów, akcesoriów. Osobne oferty dla elektroniki (każdy model = inny EAN = inna oferta).

Etap D – zdjęcia produktów. Allegro w 2026 wymaga minimum 1 zdjęcia 1000×1000 px (rekomendowane 1600×1600), białe lub jasne tło, max 10 zdjęć/oferta, max 4 MB każde. Zdjęcia z WC są automatycznie pobierane przez BaseLinkera, ale muszą być public-accessible (nie ukryte za logowaniem!) i mieć rozdzielczość minimum 800×800 px. Jeśli twoje zdjęcia są mniejsze – Allegro odrzuca ofertę.

Etap E – opisy produktów (Allegro EditEditor). Od 2024 roku Allegro wymaga opisów w formacie własnego edytora (EditEditor) – HTML nie jest akceptowany. BaseLinker konwertuje opisy WC do tego formatu automatycznie, ale zaawansowane elementy (tabele, iframe, JavaScript) są wycinane. Sprawdź u siebie 5 losowych ofert po konwersji, zanim wystawisz wszystkie.

Etap F – ceny i marża per kanał. Typowa praktyka – ceny na Allegro o 8–18% wyższe niż w sklepie (pokrycie prowizji marketplace). BaseLinker pozwala ustawić mnożnik per kategoria (np. wszystkie buty +12%, wszystkie ubrania +10%). Pamiętaj o cenie minimalnej dla każdej kategorii Allegro – algorytm odrzuca oferty poniżej.

Najczęstsze pułapki:
- Brakujący EAN/GTIN – wymagany w 80% kategorii Allegro, brak = błąd parameter.id.not_found
- Brak rozmiaru w sandałach – warianty są techniczne wymagane, błąd missing.variant.parameter
- Tytuł powyżej 75 znaków – Allegro tnie, algorytm moderacji 2024+ obniża pozycje
- Frazy zakazane ("gratis", "promocja", "najtańszy w Polsce") – auto-moderacja blokuje
- Cena poniżej minimum kategorii – błąd price.below.minimum

Realny czas na mapowanie 100 produktów to 4–8 godzin przy doświadczeniu. Pierwsze wdrożenie – nawet 20 godzin. Stąd nasza propozycja w cenniku integracji BaseLinker obejmuje gotowe mapowanie 200–500 produktów. Dla branż wymagających rozbudowanych wariantów (np. moda, obuwie) mamy też dedykowany szablon w poradniku sklepu WC dla branży modowej.

Po skonfigurowaniu mapowania wchodzimy w mięso: jak BaseLinker pilnuje, żeby dane między WC, BaseLinkerem i Allegro były spójne. To kluczowa kwestia – błąd na tym etapie kosztuje realnie. Klient kupuje na Allegro produkt, który masz tylko 1 sztukę, jednocześnie inny kupuje na sklepie – musisz anulować jedno z zamówień i zapłacić Allegro karę 1% wartości jako "brak realizacji".

Architektura synchronizacji BaseLinker. BaseLinker działa jak hub w gwiazdce: WC, Allegro, eBay, Amazon, kurierzy, fakturówki – wszystko łączy się bezpośrednio z BaseLinkerem, nie między sobą. To znaczy, że BaseLinker jest single source of truth dla stanów, cen i statusów. Każda zmiana w WC trafia do BaseLinkera w 60–120 sekund (interval konfigurowalny), a stamtąd do Allegro w 30–60 sekund [8].

Tryb 1 – real-time przez webhooki (rekomendowany od 2024). Allegro od 2024 obsługuje webhooki zdarzeń sprzedażowych (order.new, order.changed). Po włączeniu w panelu Allegro Developer i podaniu URL endpointu BaseLinkera, zamówienia spływają w 5–15 sekund od kliknięcia "Kupuję" przez klienta. To minimalizuje okno czasowe oversellingu praktycznie do zera.

Tryb 2 – polling co X sekund. Fallback, gdy webhooki nie są dostępne (np. plan BaseLinker bez webhooków lub Allegro Sandbox). BaseLinker pyta API Allegro co 30/60/300 sekund o nowe zamówienia i zmiany. W planie Standard (29 zł/mc) interval to 5 min, w Premium (89 zł/mc) – 60 sekund. Polling 5 minut daje 5-minutowe okno na overselling – akceptowalne dla sklepów z niskim wolumenem, niebezpieczne powyżej 100 zamówień dziennie.

Sync stanów magazynowych w obie strony. Reguła "WC → BaseLinker → Allegro" działa po edycji produktu w WC. Reguła odwrotna "Allegro → BaseLinker → WC" odpala się po sprzedaży na Allegro (zmniejsza stan w WC). Skonfiguruj jeden kierunek jako master, inaczej dostaniesz race condition, gdzie obie strony zmniejszają stan jednocześnie i klient kupuje 3 sztuki przy realnym stanie 1.

Limity API – fakt życia z Allegro. Allegro REST API ma limit 9000 wywołań/godzinę per aplikacja [9]. To wystarcza dla 5000–10000 ofert i 200 zamówień/dzień, ale przy 50000+ produktów limit się kończy w 30 minut. Rozwiązanie: synchronizuj batch-em (raz na 4 godziny pełny refresh + real-time webhook delta), nie po jednym produkcie. BaseLinker robi to automatycznie w planach Premium i Enterprise.

Co się stanie, gdy synchronizacja padnie? Po 5 minutach bez kontaktu z Allegro BaseLinker wysyła alert mailem do administratora. Po 30 minutach automatycznie blokuje sprzedaż nowych ofert (żeby nie sprzedawać starych cen). Po godzinie powiadamia, że potrzeba interwencji człowieka. Monitorujemy to u klientów przez UptimeRobot [4] – integracja, której Allegro nie ma w panelu.

Stress test przed go-live. Przed włączeniem produkcji uruchom 50 zamówień testowych w środowisku sandbox Allegro. Sprawdź, czy stany się aktualizują, faktury generują, etykiety drukują. Tydzień na testy oszczędza miesiąc gaszenia pożarów po starcie. Ten test to standardowy element naszych wdrożeń integracji BaseLinker. Jeśli architektura sklepu wymaga dodatkowo automatyzacji zwrotów albo specyficznej logiki promocji – sprawdź też naszą usługę automatyzacji procesów e-commerce.

Teraz najciekawszy fragment – co dzieje się od momentu kliknięcia "Kupuję" na Allegro do dostarczenia paczki. Cały pipeline da się ustawić tak, że nie wymaga ręcznej akcji aż do momentu zaadresowania paczki w magazynie. Oto jak to składamy u klientów.

Krok 1 – klient płaci na Allegro. Allegro Pay, BLIK, karta, przelew tradycyjny. Zamówienie ma status "Opłacone" w Allegro po średnio 2 minutach dla Allegro Pay/BLIK, do 24 godzin dla przelewu tradycyjnego.

Krok 2 – webhook do BaseLinkera. Allegro wysyła event order.checkout.completed do endpointu BaseLinkera (np. https://api.baselinker.com/webhooks/allegro). BaseLinker pobiera dane zamówienia – produkty, cena, dane klienta, adres dostawy, forma płatności – i zapisuje w bazie jako nowe zamówienie. To trwa 5–15 sekund.

Krok 3 – walidacja i przypisanie magazynu. BaseLinker sprawdza, czy produkt istnieje w magazynie WC, czy stan jest wystarczający (zmniejsza go o ilość zamówioną), czy adres dostawy jest poprawny (walidacja kodu pocztowego). Jeśli coś jest nie tak – flaguje zamówienie do ręcznej weryfikacji.

Krok 4 – akcja automatyczna "utwórz w WC". Reguła "Po przypisaniu magazynu → utwórz zamówienie w WooCommerce ze statusem ‚Przetwarzane' i metodą płatności ‚Allegro'". Zamówienie pojawia się w WC → Zamówienia w identycznym formacie jak każde inne. W meta-fieldach trzymamy _allegro_order_id i _baselinker_id dla łączności.

Krok 5 – wystawienie faktury. Reguła "Po utworzeniu zamówienia → wystaw fakturę w Fakturowni" (lub iFirmie, wFirmie, InFakcie). BaseLinker przekazuje dane firmowe klienta (NIP, nazwa firmy), pozycje zamówienia, stawkę VAT. Faktura PDF wraca jako załącznik i jest wysyłana mailem klientowi automatycznie [10].

Krok 6 – generowanie etykiety wysyłkowej. Reguła "Po wystawieniu faktury → wygeneruj etykietę kurierską". Wybór kuriera zwykle na podstawie metody dostawy z Allegro – Allegro Smart! → InPost Paczkomat, "Standard kurier" → DPD lub Pocztex. Etykieta PDF pobiera się do BaseLinkera i czeka w kolejce drukowania.

Krok 7 – pakowanie i odprawa. Pracownik magazynu loguje się do BaseLinkera, klika "Pakuj kolejne", dostaje listę produktów do skompletowania (warehouse picking). Po spakowaniu skanuje kod kreskowy etykiety – BaseLinker zmienia status zamówienia na "Wysłane" w WC, w Allegro i wysyła klientowi mail z numerem śledzenia.

Krok 8 – feedback i finalizacja. Po 14 dniach od wysyłki Allegro pyta klienta o ocenę. Jeśli pozytywna – zostaje na koncie i wpływa na pozycję ofert. Jeśli negatywna – BaseLinker flaguje zamówienie do obsługi reklamacji, której flow można też zautomatyzować (auto-zwrot Allegro Pay, auto-RMA w WC).

Realny benchmark czasowy: u naszych klientów cały pipeline od kliknięcia "Kupuję" do wysłania etykiety do drukarki to 2–5 minut. Bez BaseLinkera – w najlepszym razie 10–15 minut pracy pracownika. Przy 100 zamówieniach dziennie to 8–17 godzin oszczędności tygodniowo – tyle ile etat. Wprost odpowiada to liczbom z naszej usługi migracji i integracji WooCommerce, gdzie zawsze prezentujemy klientowi precyzyjny ROI. Pełne case po stronie kosztów rozkładamy też w analizie kosztów sklepu WooCommerce i w artykule cennik migracji sklepu na WooCommerce.

Wysyłka to jeden z dwóch głównych konsumentów czasu w sklepie e-commerce (drugi to zamówienia). BaseLinker integruje się z 30+ przewoźnikami w Polsce, ale realnie 95% sklepów używa 3–4: InPost (paczkomaty + kurier), DPD, Pocztex i Allegro One. Oto jak to ustawić sensownie.

InPost (Paczkomat + kurier). Najpopularniejsza opcja w polskim e-commerce 2026 (50%+ rynku B2C). Integracja BaseLinker ↔ InPost wymaga konta klienckiego z umową przesyłki + token API z panelu paczkomaty.pl [11]. Po wpięciu klucza i ID magazynu nadawczego etykiety generują się automatycznie. Koszt etykiety InPost Paczkomat to 9,99–13 zł netto, kurier 14–17 zł netto (cennik 2026, zależny od umowy).

DPD i Pocztex. DPD wymaga umowy z fakturą (od 50 zł netto/mc opłaty stałej + 11–14 zł/paczka), Pocztex podobnie. Konfiguracja w BaseLinker → Integracje → Kurierzy. Po wpięciu zwykle DPD obsługuje paczki ciężkie (>10 kg) i przesyłki kurierskie do firm, Pocztex jest fallbackiem do mniej oczywistych lokalizacji (małe miejscowości bez paczkomatu).

Allegro Smart! Specyficzna usługa – darmowa dostawa dla kupującego, ale sprzedawca nie wybiera przewoźnika. Allegro samo decyduje (InPost, DPD, ORLEN Paczka). Sprzedawca dostaje etykietę zwrotną przez API Allegro, którą BaseLinker importuje i przekazuje do drukarki. Allegro Smart! podnosi konwersję ofert o 30–50% (badanie Allegro 2025) [12], ale obniża marżę – koszt logistyki spada na sprzedawcę.

Reguły automatyczne wyboru kuriera. Najczęstsza konfiguracja u naszych klientów:
- Allegro Smart! → etykieta Allegro (automatycznie wybrana przez Allegro)
- Allegro "dostawa standardowa" + waga < 25 kg → InPost Kurier
- Allegro "dostawa standardowa" + waga > 25 kg → DPD
- Sklep WC + paczkomat → InPost Paczkomat
- Sklep WC + kurier → DPD lub Pocztex (zależnie od regionu)

Reguły piszesz raz w BaseLinker → Akcje automatyczne i obsługują 95% zamówień. Pozostałe 5% (nietypowe lokalizacje, gabaryty XL) flagujesz do ręcznej obsługi.

Drukowanie etykiet hurtem. BaseLinker pozwala pobrać 50–500 etykiet jednym kliknięciem jako PDF. Drukowane na taśmie termicznej (Zebra GK420d, Brother QL-820NWB – około 1000 zł za drukarkę) – kosztuje to 0 zł za etykietę vs ~0,10 zł za druk laserowy z tonerem. Dla 200 paczek dziennie to 600 zł oszczędności miesięcznie.

Śledzenie i informowanie klientów. Numer trackingowy InPost/DPD wraca przez API i jest automatycznie wysyłany do klienta mailem z BaseLinkera + dodawany do statusu Allegro. Klient widzi link "Śledź paczkę", redukuje liczbę zapytań do supportu ("gdzie jest moja paczka?") o szacunkowo 60–70% (typowy efekt obserwowany u klientów po wdrożeniu automatyzacji statusów).

Zwroty i reklamacje. BaseLinker wspiera generowanie etykiet zwrotnych InPost (klient płaci 9,99 zł albo sklep pokrywa). Reklamacje z Allegro spływają jako oddzielne dyskusje w BaseLinkerze i można je obsłużyć z poziomu panelu (odpowiedź klientowi, akceptacja zwrotu, zmiana statusu). To istotne, bo Allegro od 2024 monitoruje czas reakcji na reklamacje – powyżej 24 godzin obniża pozycje twoich ofert. Jeśli chcesz mierzyć wpływ tej automatyzacji na konwersję, pomocny będzie nasz audyt konwersji sklepu WooCommerce.

Po 100+ wdrożeniach widzimy te same problemy w tych samych miejscach. Oto top 10, z którymi spotykasz się prędzej czy później, plus konkretne rozwiązania.

1. Refresh token wygasł ("401 invalid_grant"). Standardowo refresh_token Allegro żyje 365 dni, ale wygasa szybciej, jeśli zmienisz hasło Allegro albo użytkownik konta odmówi dostępu aplikacji. Rozwiązanie: w BaseLinker → Integracje → Allegro → "Połącz ponownie", autoryzuj OAuth. Trwa to 2 minuty, jeśli wiesz, co robisz.

2. Limit API 9000/godzinę ("429 too_many_requests"). Pojawia się przy 50000+ ofertach albo intensywnej edycji. Rozwiązanie: zmniejsz częstotliwość sync z 60s do 300s, albo upgraduj plan BaseLinker do Premium (priorytetowa kolejka API).

3. Stany rozjeżdżają się między WC a Allegro. Klasyk – masz produkt z wariantami, jeden wariant się sprzedaje na Allegro, BaseLinker zmienia stan produktu-rodzica w WC, ale wariant w WC ma własny stan, który nie został zaktualizowany. Rozwiązanie: w BaseLinker → Magazyn → Ustawienia włącz "Synchronizuj stany wariantów osobno".

4. Oferty Allegro odrzucane – brak parametru EAN. 80% kategorii Allegro 2026 wymaga EAN/GTIN. Rozwiązanie: dodaj pole _ean jako meta WC, zmapuj w BaseLinkerze na parametr Allegro. Jeśli nie masz EAN-ów – kup za 10 zł sztuka na producentbarcodes.pl albo zarejestruj własną pulę EAN w GS1 Polska [13].

5. Zdjęcia za małe ("images.too_small"). Allegro wymaga minimum 800×800 px, w 2026 algorytm faworyzuje 1600×1600. Rozwiązanie: regeneruj miniaturki w WC pluginem Regenerate Thumbnails, w futurze fotografuj 2000×2000 px.

6. Tytuł ma frazę zakazaną ("title.banned_word"). Allegro w 2024 wprowadziło algorytmicznego moderatora tytułów – odrzuca "gratis", "najtaniej", "promocja", "!", "NEW!", "SUPER". Rozwiązanie: regex-em wyczyść tytuły przed wystawieniem (BaseLinker ma "Reguły transformacji tytułów").

7. Cena poniżej minimum kategorii ("price.below.minimum"). Niektóre kategorie mają minimum (np. "Telefony komórkowe" – 50 zł). Rozwiązanie: w BaseLinkerze ustaw alert "Cena niższa niż 50 zł" lub ręcznie weryfikuj produkty <50 zł.

8. Duplikaty ofert po reimport. Robisz "reimportuj wszystko" bez usunięcia poprzednich – Allegro tworzy nowe oferty, stare zostają. Rozwiązanie: zawsze przed reimportem zrób kopię, zaznacz "zakończ stare oferty" i monitoruj 24 godziny.

9. Webhook nie odpala (zamówienia spływają z opóźnieniem 5 min). Endpoint webhook BaseLinkera blokowany przez Cloudflare/WAF albo Allegro przestało dostawać 200 OK i wyłączyło hook. Rozwiązanie: w panelu Allegro Developer → Webhooks sprawdź delivery status, w BaseLinkerze logi przychodzących wywołań.

10. Faktura nie generuje się w Fakturowni. Typowo: brak NIP w danych klienta (Allegro nie wymaga NIP od kupującego prywatnego), reguła automatyczna ustawiona "tylko z NIP". Rozwiązanie: dodaj fallback "bez NIP → wystaw paragon zamiast faktury".

Pełna lista 30+ błędów z BaseLinkera jest w naszym osobnym poradniku o błędach integracji BaseLinker. Jeśli utknąłeś na konkretnym, zwykle szybciej niż grzebać samemu, opłaca się napisać do nas – większość problemów rozwiązujemy w 30–60 minut, bo widzieliśmy je 10 razy. Dla pilnych sytuacji (np. sklep stoi w sezonie sprzedażowym) mamy szybką ścieżkę przez pomoc techniczną WooCommerce.

Sklepy oszczędzają na BaseLinkerze dwie rzeczy: godziny pracy i utracone zamówienia. Policzmy to konkretnie na trzech profilach klientów, z którymi pracujemy.

Profil A – mały sklep, 30 zamówień dziennie (900/mc).
- Plan BaseLinker Standard: 29 zł/mc
- Wdrożenie KC Mobile: 5990 zł (jednorazowo, pakiet Start)
- Ręczna obsługa zamówienia: ok. 3 min (kopiowanie adresu, faktura, etykieta)
- Z BaseLinker: ok. 30 sek (klik "pakuj", druk)
- Oszczędność: 2,5 min × 900 zam. = 37,5 godz./mc
- Przy stawce 30 zł/godz. = 1125 zł/mc oszczędności pracy
- ROI wdrożenia: 5990 zł / (1125 - 29) zł = 5,5 miesiąca

Profil B – średni sklep, 100 zamówień dziennie (3000/mc).
- Plan BaseLinker Premium: 89 zł/mc
- Wdrożenie KC Mobile: 9990 zł (pakiet Pro)
- Oszczędność czasu: 2,5 min × 3000 = 125 godz./mc
- Plus mniejsze ryzyko oversellingu: zwykle 1–3 zamówień miesięcznie do anulowania (kary Allegro ~50–200 zł, plus utracona marża ~30–150 zł)
- Oszczędność pracy: 125 × 30 = 3750 zł/mc
- Oszczędność oversellingu: ok. 500 zł/mc
- ROI: 9990 / (4250 - 89) = 2,4 miesiąca

Profil C – duży sklep, 500 zamówień dziennie (15 000/mc).
- Plan BaseLinker Enterprise: 199 zł/mc
- Wdrożenie KC Mobile: 19 990 zł (pakiet Enterprise + 3 marketplace'y)
- Oszczędność: praktycznie nie da się tego robić ręcznie – BaseLinker jest warunkiem koniecznym, nie opcją
- Etat pracownika magazynu, który dzięki BaseLinkerowi nie jest potrzebny: 5000 zł/mc brutto + ZUS
- ROI: 19 990 / (5000 - 199) = 4,2 miesiąca

Niewymierne korzyści dodatkowo. Skalowanie biznesu (możliwość dodania nowego marketplace'u w 1 dzień zamiast 2 tygodni), spokój operacyjny (mniej pożarów), dane do decyzji marketingowych (które produkty schodzą gdzie), gotowość na Black Friday (BaseLinker wytrzymuje 10× normalnego ruchu). Tego nie da się zmierzyć w pieniądzach, ale w naszym doświadczeniu to często ważniejsze niż oszczędność godzin – właściciel sklepu odzyskuje wieczory i weekendy.

Kiedy NIE warto wdrażać BaseLinkera? Jeśli masz mniej niż 20 zamówień miesięcznie i nie planujesz skalowania – ręczna obsługa wystarczy. Plan Start (darmowy) i tak ma sens jako rezerwa na przyszłość, ale wdrożenie agencyjne za 5–10 tys. zł zwróci się dopiero przy poważnej skali.

Sprawdź to na własnych danych. Wrzuć liczby do prostego pliku Excel: liczba zamówień miesięcznie × średni czas ręcznej obsługi × twoja stawka godzinowa. Jeśli wychodzi mniej niż 1000 zł/mc – ręczna obsługa jest tańsza. Powyżej – zacznij planować BaseLinker. Możemy też policzyć ROI na twoich danych w 30 minut bezpłatnej konsultacji.

Pytanie, które pada w każdej rozmowie z klientem. Trzy uczciwe odpowiedzi w zależności od profilu.

Setup samodzielny – kiedy ma sens. Jeśli masz <100 produktów, <30 zamówień miesięcznie, znasz angielski (dokumentacja BaseLinker i Allegro Developer częściowo po angielsku), masz 20–40 godzin wolnego czasu na naukę i testy. Plan Start BaseLinker (darmowy) + wtyczka WP (darmowa) + konto Allegro Pro (49 zł/mc) = bariera wejścia ok. 50 zł/mc. Spodziewaj się 2–4 tygodni walki z pierwszymi błędami (znajdziesz tutaj w sekcji 8), ale zrobisz to za darmo. Realny czas pracy własnej: 30–60 godzin.

Setup mieszany – agencja stawia, ty utrzymujesz. Najczęstszy wybór klientów ze średnich sklepów (50–500 zamówień miesięcznie). Agencja konfiguruje BaseLinkera, mapuje 100–500 produktów, robi 10–50 testowych zamówień, dokumentuje proces. Ty obsługujesz codzienność. Cena u nas: 5990–14 990 zł w zależności od liczby produktów i marketplace'ów [14]. Trwa 5–15 dni roboczych. Po zakończeniu mamy 30-dniowe wsparcie hotline – pytasz, my pomagamy, bez dodatkowych opłat.

Setup pełny + opieka miesięczna. Dla sklepów 200+ zamówień/dzień. Wdrożenie + miesięczna opieka (monitoring synchronizacji, naprawa błędów, dodawanie nowych marketplace'ów, optymalizacja akcji automatycznych). Cena u nas: od 9990 zł setup + 990 zł/mc opieka. Wszystkie zmiany Allegro API obsługujemy bez dodatkowych kosztów – tylko realny czas wykluczany z miesięcznego pakietu (zwykle 5–10 godz./mc).

Co dostajesz w naszej usłudze integracji BaseLinker:
- Audyt techniczny WooCommerce i hostingu (1 godz.)
- Konfigurację BaseLinkera (konto, plan, integracje)
- Mapowanie produktów do kategorii Allegro (do 500 SKU w pakiecie Pro)
- Konfigurację automatycznego importu zamówień
- Integrację z Fakturownia/iFirma
- Konfigurację 2–4 kurierów (InPost, DPD, Pocztex, Allegro One)
- 15–50 zamówień testowych w sandbox/production
- Szkolenie zespołu (2 godz. online, nagranie + dokumentacja PDF)
- 30 dni wsparcia hotline (pytania bez ograniczeń)

Co NIE jest wliczone (informacja, bez której klient się czuje oszukany):
- Licencja BaseLinkera (klient kupuje na swoje konto)
- Konto Allegro Pro (klient ma własne)
- Konto Fakturownia/iFirma (klient ma własne lub kupuje)
- Umowa z InPost/DPD (klient negocjuje stawki)
- Migracja danych z innego marketplace integratora (np. Apilo → BaseLinker) – płatne osobno

Częste pytanie: "Czy mogę wam zlecić TYLKO mapowanie kategorii, samodzielnie skonfigurować resztę?" Tak. Robimy to za 1990–3990 zł (zależnie od liczby produktów). Klient daje nam dostęp do BaseLinkera, my mapujemy w 2–5 dni, ty masz gotowe.

Jeśli waha się pomiędzy "sam czy z agencją" – zwykle decydujący czynnik to koszt godziny twojej pracy. Jeśli prowadzisz firmę zarabiającą 200–500 zł/godz., 30 godzin na samodzielne wdrożenie BaseLinkera kosztuje cię 6000–15000 zł – tyle, co agencja, plus wynosisz 30 godzin do tyłu w marketingu i sprzedaży. Najbardziej kosztowna decyzja to próba zrobienia tego samodzielnie, gdy nie masz na to czasu i kompetencji – to droga do projektu, który ciągnie się 3 miesiące i kończy fragmentarycznie.

Zacznij od bezpłatnej konsultacji. Wyślij nam URL sklepu i listę kanałów, na których chcesz sprzedawać. W 30 minut powiemy, co jest realnym kosztem, co pułapką, czy w ogóle warto. Formularz kontaktowy albo telefon 604 939 140.

Integracja WooCommerce + Allegro + BaseLinker to większy temat niż jeden artykuł. Jeśli ten poradnik ci pomógł, mamy więcej materiałów rozwijających konkretne wątki – wszystkie napisane na podstawie realnych wdrożeń w polskich sklepach.

Zaczynasz od podstaw BaseLinkera:
- BaseLinker – pełny poradnik dla sklepów online: czym jest, dla kogo, jak działa
- Ile kosztuje BaseLinker w 2026: cennik 2026, plany Start, Standard, Premium, Enterprise
- BaseLinker vs Apilo vs IAI – porównanie: który multi-channel hub wybrać

Allegro jako kanał sprzedaży:
- Allegro dla sklepów online – pełny poradnik: jak zacząć, Allegro Pro, prowizje
- Jak skonfigurować Allegro w sklepie WC: bezpośrednia integracja bez BaseLinkera
- Ile kosztuje sprzedaż na Allegro: prowizje, opłaty stałe, koszty ukryte

Konkretne problemy techniczne:
- BaseLinker + Allegro – błędy i rozwiązania: top 8 błędów z dokładną diagnostyką
- Problemy z Allegro w sklepie – pełny przewodnik: OAuth, oferty, stany, ceny
- Problemy z BaseLinkerem – diagnostyka: limit API, race conditions, webhooki

Ekosystem WooCommerce i sklepu:
- Sklepy internetowe na WooCommerce: nasza usługa wdrożeń, od projektu do go-live
- Migracje i integracje WooCommerce: cennik 2026 dla każdego scenariusza
- Cennik integracji BaseLinker: trzy widełki w zależności od skali sklepu
- Opieka WordPress + WooCommerce: monitoring, aktualizacje, hotline 24h
- Audyt sklepu internetowego: techniczna ocena gotowości pod multi-channel
- Sklep B2B dla hurtowni: dedykowane wdrożenia z BaseLinkerem dla B2B
- Cennik integracji BaseLinker + WooCommerce + Allegro 2026: rozszerzona analiza budżetu

Co możesz zrobić w ciągu najbliższych 72 godzin?
1. Załóż darmowe konto BaseLinker i przejdź onboarding (30 min)
2. Sprawdź wymagania techniczne swojego WC (sekcja 2 tego artykułu)
3. Wypisz listę 5 najważniejszych produktów do sprzedaży na Allegro i zmapuj ich kategorie ręcznie w panelu Allegro
4. Zarezerwuj 4 godziny na testowy setup w sandbox – jeśli się zatnie, wiesz, że potrzebujesz pomocy
5. Jeśli zatniesz się na mapowaniu lub OAuth – napisz do nas, zwykle rozwiązujemy w 30 min na callu

Integracja WooCommerce + Allegro + BaseLinker to nie jest rocket science, ale ma dużo małych pułapek, na których łatwo stracić tydzień. W KC Mobile robimy to od 2019 roku, mamy gotowe playbooks i mapowania, i zwykle uruchamiamy nowy sklep w ciągu 1–2 tygodni od podpisania umowy. Jeśli widzisz, że twój czas jest zbyt drogi na samodzielne wdrożenie – zgłoś się po wycenę. Pierwsza konsultacja zawsze bezpłatnie, niezależnie czy zlecisz nam projekt, czy nie.