Konfiguracja integracji BaseLinker i Arena.pl - kategorie, szablony i powiązania
Po połączeniu konta trzeba powiedzieć BaseLinkerowi, gdzie i jak wystawiać produkty. Dokumentacja Base dzieli to na kilka obszarów w module Arena.pl:
[#chart:arn17b]
W zakładce Kategorie i parametry wybierasz ulubione kategorie Arena.pl, w których będziesz sprzedawać - tylko one pojawią się później na liście w formularzu wystawiania. Tam też tworzysz reguły mapowania parametrów z danych magazynu lub stałych wartości. Według dokumentacji Base parametry synchronizują się raz dziennie. Kategorię wybieraj możliwie szczegółową: od niej zależy widoczność oferty i stawka prowizji, więc błąd na tym etapie kosztuje podwójnie.
Szablony ofert odpowiadają za wygląd opisu. Trzy pierwsze szablony są wbudowane i nie można ich edytować, własny tworzysz przyciskiem „+ Nowy szablon”, wstawiając dane produktu tagami, np. [opis]. Instrukcja Arena.pl zaleca edycję opisów w edytorze wizualnym BaseLinkera, bo domyślny edytor tekstowy przy listach i bardziej złożonym formatowaniu generuje błędny kod opisu. W zakładce Powiązania przypisujesz kategoriom z magazynu kategorię Arena.pl, cennik wysyłek i szablon albo robisz to dla pojedynczych produktów. Pierwszeństwo mają ustawienia produktu, potem kategorii, a na końcu domyślne ustawienia konta (stan na lipiec 2026 - sprawdź aktualną dokumentację Base).
Ustawienia konta - zamówienia, ceny i ilości
W ustawieniach konta Arena.pl w BaseLinkerze najważniejsze są dwie grupy opcji. W części dotyczącej zamówień włączasz pobieranie zamówień, wybierasz status, w którym mają się pojawiać, decydujesz o przekazywaniu numeru nadania i zamówień do sklepu. W ustawieniach wystawiania ustawiasz domyślną kategorię, cennik i szablon, mnożnik ceny lub stałą kwotę dodawaną do ceny oraz maksymalną dostępną ilość w ofercie. Mnożnik przydaje się, gdy chcesz na Arena.pl uwzględnić w cenie prowizję i opłaty - ustaw go świadomie, bo błąd w mnożniku zmienia ceny w całym katalogu jednocześnie.
Wystawianie ofert z BaseLinkera na Arena.pl
Oferty wystawiasz w zakładce Arena.pl - Wystawianie. Najpierw wybierasz magazyn i kategorię, w której są produkty, a potem wystawiasz je pojedynczo przez formularz albo hurtowo przyciskiem „Wystaw zaznaczone (formularz)”. Po kliknięciu „Wystaw oferty” BaseLinker sprawdza, czy formularz jest kompletny, np. czy uzupełniono wszystkie parametry, a oferty trafiają do zakładki Zarządzanie ofertami - W kolejce ze statusem „Oczekuje w kolejce do wysłania”. Według instrukcji Arena.pl zwykle są wystawiane od razu, a przy większym obciążeniu systemu proces może potrwać od kilku minut do około godziny (stan na lipiec 2026 - sprawdź aktualną instrukcję).
Przy pierwszym imporcie nie wystawiaj od razu całego katalogu. Sprawdzona kolejność to kilka produktów z różnych kategorii, kontrola wyglądu ofert na Arena.pl, a dopiero potem reszta. Jeśli masz już oferty wystawione wcześniej ręcznie w Panelu Sprzedawcy, powiąż je z produktami z magazynu w zakładce Zarządzanie ofertami (Operacje - Powiąż z produktami z magazynu) - bez tego nie obejmie ich synchronizacja stanów i cen.
Synchronizacja stanów, cen i zamówień między Arena.pl i BaseLinkerem
Synchronizacja to moment, w którym integracja zaczyna oszczędzać czas, ale tylko wtedy, gdy jest włączona. Dokumentacja Base opisuje osobne moduły:
| Element | Jak działa według dokumentacji Base | Na co uważać |
|---|
| Stany | Moduł Stany aktualizuje ilości w ofertach zgodnie z magazynem; częstotliwość do wyboru, do aktualizacji na żywo | Bez konfiguracji moduł nie wykonuje żadnych działań |
| Ceny | Moduł Ceny aktualizuje ceny ofert, raz dziennie w nocy | Cen wariantów nie synchronizuje - trzeba je zmieniać osobno |
| Zamówienia | Po włączeniu pobierania trafiają do managera zamówień, a stan magazynu spada automatycznie | Logi pobierania sprawdzisz w ustawieniach managera zamówień |
| Statusy | Powiązane statusy przechodzą z Base na Arena.pl | Zmiany nie wracają z Arena.pl do Base |
| Numer nadania | Opcja przekazywania numeru wysyła numer przesyłki na Arena.pl | Może spowalniać generowanie etykiet |
Najważniejsze są stany i numer nadania. Stany chronią przed sprzedażą towaru, którego już nie ma, a numer przesyłki i status „wysłano” są według regulaminu Arena.pl podstawą do zwolnienia środków ze sprzedaży. Jak opóźnione statusy i anulacje wpływają na oceny i wypłaty, opisujemy we wpisie jakość obsługi zamówień na Arena.pl, a o organizacji samej wysyłki - w tekście wysyłka zamówień z Arena.pl.
[#tip] Jeśli sprzedajesz ten sam towar na kilku marketplace'ach, ustaw w Arena.pl maksymalną dostępną ilość niższą niż pełny stan albo zostaw niewielką rezerwę w magazynie. Przy szybko rotujących produktach różnica kilku minut między sprzedażą na Allegro a aktualizacją oferty na Arena.pl może skończyć się anulacją.
Ograniczenia integracji, o których warto wiedzieć
Dokumentacja Base wymienia kilka ograniczeń: szablonu nie zmienisz na już wystawionej ofercie (trzeba ją zdezaktywować i wystawić ponownie albo edytować w panelu Arena.pl), ceny na wystawionych ofertach zmieniasz przez moduł Ceny, opis może mieć maksymalnie 60 tysięcy znaków, a kody EAN muszą mieć poprawny format. Powiązanie kategorii działa tylko dla głównej kategorii magazynowej produktu. Czas realizacji jest parametrem Arena.pl ustawianym w ofercie, a nie ustawieniem całego konta (stan na lipiec 2026 - sprawdź aktualną dokumentację Base).
Z tych ograniczeń wynika praktyczna zasada: wszystko, co da się ustalić przed wystawieniem, ustal przed wystawieniem. Szablon opisu, kategorię i cennik przetestuj na kilku ofertach, bo późniejsza zmiana oznacza ponowne wystawianie. Przy produktach z wariantami zaplanuj osobny sposób aktualizacji cen, skoro moduł Ceny ich nie obejmuje - inaczej po pierwszej zmianie cennika u dostawcy część wariantów zostanie ze starą ceną.
Najczęstsze problemy z integracją BaseLinker i Arena.pl
Większość problemów po uruchomieniu integracji ma swoje źródło w konfiguracji, a nie w samym API. Typowe objawy i pierwsze kroki naprawcze zebraliśmy na diagramie:
[#chart:arn17c]
Przez pierwsze dwa tygodnie codziennie porównuj kilka losowych ofert na Arena.pl z danymi w magazynie BaseLinkera: cenę, stan, czas wysyłki i opis. Jeśli sprzedajesz też przez inne systemy, zobacz, jak to samo zagadnienie wygląda w integracji IdoSell z Arena.pl - przy dwóch źródłach danych łatwo o konflikt stanów.
Jak przygotować katalog w BaseLinkerze pod sprzedaż na Arena.pl
Poniższe wskazówki nie są wymaganiami Arena.pl ani Base, tylko praktyką z wdrożeń integracji marketplace. Sprawdzają się niezależnie od platformy, a przy nowym kanale oszczędzają najwięcej czasu, bo błędy w danych produktowych wychodzą dopiero przy wystawianiu.
Jedna główna kategoria na produkt. Powiązania w Base działają dla głównej kategorii magazynowej, więc produkt przypisany do kilku kategorii „na wszelki wypadek” dostanie kategorię Arena.pl z tej pierwszej. Uporządkuj to przed pierwszym wystawieniem.
Kompletne EAN i parametry. Brak parametru zatrzyma ofertę na walidacji formularza. Zrób listę parametrów wymaganych w Twoich kategoriach Arena.pl i uzupełnij je w magazynie, zamiast poprawiać każdą ofertę osobno.
Opis bez odnośników i haseł spoza oferty. Opis na marketplace powinien opisywać produkt, a nie kierować do sklepu. Jeden szablon dla całego katalogu ułatwia późniejsze zmiany.
Ceny z policzoną marżą. Zanim ustawisz mnożnik ceny, policz marżę z prowizją według kategorii i opłatą transakcyjną. Mnożnik dobrany „na oko” potrafi zjeść zysk na tanich produktach z kosztowną wysyłką.
Czas wysyłki zgodny z magazynem. Czas realizacji to parametr oferty. Ustaw go tak, jak faktycznie pracuje magazyn, a nie tak, jak wygląda najlepiej na liście ofert.
Pierwszy tydzień po podłączeniu konta
W pierwszym tygodniu sprawdzaj codziennie trzy rzeczy: logi pobierania zamówień w managerze zamówień, oferty w kolejce, które nie przeszły walidacji, oraz zgodność stanów kilku losowych produktów. Ustal też, kto w firmie reaguje na błędy integracji i w jakim czasie. Najczęstszy scenariusz problemów to nie awaria, tylko niezauważony komunikat o błędzie, który przez kilka dni blokuje aktualizację części ofert.
Jak Vinson pomaga połączyć BaseLinker z Arena.pl
Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi kompleksowa obsługa sprzedaży na Arena.pl zajmujemy się integracją od strony technicznej i procesowej:
Podłączenie konta Arena.pl w Base, pobranie cenników i ustawienie domyślnych wartości wystawiania.
Mapowanie kategorii i parametrów, przygotowanie szablonu opisu i powiązań dla katalogu.
Konfiguracja modułów Stany i Ceny, pobierania zamówień, statusów i przekazywania numerów nadania.
Test na wybranych produktach i kontrola synchronizacji w pierwszych tygodniach sprzedaży.
Najczęściej zadawane pytania
Czy BaseLinker ma integrację z Arena.pl?
Tak. Arena.pl wymienia BaseLinker (obecnie Base) wśród obsługiwanych integracji. Moduł pozwala wystawiać oferty z magazynu, synchronizować stany, pobierać zamówienia i przekazywać numery przesyłek na Arena.pl.
Gdzie znaleźć klucz API Arena.pl do BaseLinkera?
Login i klucz API znajdziesz w Panelu Sprzedawcy Arena.pl w zakładce Ustawienia sklepu - API. W BaseLinkerze wklejasz je w oknie podłączania konta razem z nazwą konta na Arena.pl.
Dlaczego BaseLinker nie widzi cenników dostawy z Arena.pl?
Cenniki trzeba najpierw utworzyć w Panelu Sprzedawcy Arena.pl, a potem pobrać do BaseLinkera funkcją „Odśwież cenniki” w sekcji Arena - Cenniki wysyłek. Po każdej zmianie cennika na Arena.pl odśwież listę ponownie.
Jak często BaseLinker aktualizuje stany i ceny na Arena.pl?
Według dokumentacji Base częstotliwość aktualizacji stanów wybierasz w module Stany, aż do aktualizacji na żywo, a moduł Ceny aktualizuje ceny raz dziennie w nocy. Oba moduły działają dopiero po konfiguracji i tylko dla ofert powiązanych z produktami z magazynu (stan na lipiec 2026 - sprawdź aktualną dokumentację).
Czy statusy zamówień z Arena.pl wracają do BaseLinkera?
Dokumentacja Base opisuje powiązanie statusów jako jednokierunkowe: zmiany statusu w Base przechodzą na Arena.pl, ale nie odwrotnie. Dlatego status zamówienia z Arena.pl najlepiej zmieniać w Base, a nie w Panelu Sprzedawcy.
Chcesz, żeby oferty, stany i zamówienia z Arena.pl obsługiwały się w BaseLinkerze same? Zobacz, jak prowadzimy kompleksową obsługę sprzedaży na Arena.pl - od podłączenia konta po kontrolę synchronizacji w pierwszych tygodniach sprzedaży.