Mapowanie kategorii i parametrów na Arena.pl - jak uniknąć błędów przy imporcie ofert

Miłosz Brzegowy
Miłosz Brzegowy
Head of Growth and Demand Generation
Mapowanie kategorii i parametrów na Arena.pl - jak uniknąć błędów przy imporcie ofert
Mapowanie kategorii i parametrów na Arena.pl to przypisanie każdej kategorii z Twojego sklepu, integratora lub ERP do najniższej pasującej kategorii Arena.pl oraz połączenie cech produktu z atrybutami, które Arena.pl definiuje osobno dla każdej kategorii. Błędy przy imporcie ofert biorą się najczęściej ze zbyt ogólnej kategorii, brakujących lub niepasujących wartości atrybutów, niepoprawnych grup wariantowych, zakazanych fraz w nazwie i pustych opisów.
Kategoria na Arena.pl decyduje o więcej niż miejscu w drzewie. Od niej zależą stawka prowizji, lista atrybutów, możliwość połączenia produktów w grupę wariantową i to, czy kupujący znajdzie ofertę. W tym wpisie zbieramy zasady z centrum pomocy i regulaminu Arena.pl, dokumentacji API i integratorów, a potem pokazujemy praktyczną metodę mapowania, która ogranicza poprawki po imporcie. Zalecenia z wdrożeń wyraźnie oddzielamy od zasad platformy.
[#wazne] W skrócie: na Arena.pl produkt powinien trafić do najniższej możliwej kategorii, co najmniej trzeciego rzędu, a jego atrybuty muszą pasować do listy zdefiniowanej dla tej kategorii. Kategoria wpływa na prowizję - według kalkulatora Arena.pl od 2,68% w Elektronice do 10,9% m.in. w Modzie i Zdrowiu - a przy błędnej kategorii Arena.pl może naliczyć prowizję prawidłową (stan na październik 2026 - sprawdź aktualny cennik i regulamin). W Vinson przygotowujemy mapowanie kategorii i atrybutów tak, żeby oferty przechodziły import bez błędów.
Mapowanie kategorii na Arena.pl - co to jest i dlaczego decyduje o imporcie
Mapowanie kategorii to tabela reguł, która mówi integracji, do której kategorii Arena.pl ma trafić produkt z danej kategorii Twojego systemu. Mapowanie parametrów robi to samo dla cech produktu: łączy np. Twój kolor i jego wartości z atrybutem i listą wartości Arena.pl. Drzewa kategorii w sklepie i na marketplace prawie nigdy nie są takie same, więc bez mapowania integracja albo nie wystawi produktu, albo wystawi go w złym miejscu. Mapowanie przygotowujesz raz, ale integracja korzysta z niego przy każdym imporcie i każdej aktualizacji. Błąd w jednej regule powiela się więc na wszystkich produktach danej kategorii, a poprawka jednej reguły naprawia je wszystkie naraz.
Zasady po stronie Arena.pl łatwo zapamiętać. Opis Panelu Sprzedawcy w centrum pomocy zaleca przypisanie produktowi najniższej możliwej kategorii, minimum trzeciego rzędu, bo im precyzyjniejsza kategoria, tym łatwiej kupującym znaleźć produkt. Regulamin sprzedawcy wymaga wskazania kategorii odpowiedniej ze względu na rodzaj i przeznaczenie towaru i zastrzega, że administrator może zmienić kategorię bez informowania sprzedawcy. Jeśli błędna kategoria obniżyła prowizję, Arena.pl może naliczyć prowizję prawidłową, także po wystawieniu faktury (stan na październik 2026 - sprawdź aktualny regulamin).
Kategoria, atrybuty i widoczność oferty
Kategoria i atrybuty wpływają też na to, gdzie oferta się pokaże. Opis Panelu Sprzedawcy wiąże precyzyjną kategorię z łatwiejszym wyszukiwaniem i wyższym pozycjonowaniem w wynikach wyszukiwarki, a zasady jakości ofert Arena.pl podają, że dodanie atrybutów wpływa na atrakcyjność oferty i jej pozycję na listingu (stan na październik 2026 - sprawdź aktualne zasady). Z naszej praktyki na marketplace'ach atrybuty zasilają też filtry, więc produkt z pustym rozmiarem czy materiałem łatwo wypada z wyników zawężonych przez kupującego. To ryzyko warto założyć także na Arena.pl, zwłaszcza w odzieży, motoryzacji i elektronice.
Kategoria a prowizja na Arena.pl
Po okresie startowym prowizja na Arena.pl zależy od kategorii. Kalkulator na stronie dla sprzedawców, ze stawkami ustalonymi 06.10.2026, podaje je dla ośmiu kategorii głównych, a strona określa ogólny zakres jako od 5% do 20%. Dla kategorii nietypowych kalkulator nie podaje stawki i pokazuje wycenę indywidualną (stan na październik 2026 - sprawdź aktualny cennik i regulamin):
[#chart:arn24a]
Prowizja jest liczona od wartości produktów i wysyłki brutto, a niezależnie od niej obowiązuje opłata transakcyjna - według regulaminu od 03.07.2026 jest to 1,49%, nie mniej niż 1,85 zł brutto. Szczegóły stawek, promocji 0% na start i pozostałych opłat opisujemy we wpisie prowizje Arena.pl - stawki według kategorii. Dla mapowania wniosek jest jeden: dodaj do tabeli mapowań kolumnę ze stawką kategorii głównej. Od razu zobaczysz, które grupy produktów będą droższe w sprzedaży, i nie przypiszesz towaru do kategorii z niższą prowizją na próbę - regulamin przewiduje w takim przypadku dopłatę różnicy.
Stawka to także argument przy wyborze asortymentu na start. Jeśli mapowanie pokazuje, że część katalogu trafi do kategorii z wyższą prowizją, a marża na tych produktach jest niska, lepiej wystawić je później, po sprawdzeniu sprzedaży w kategoriach, w których zarabiasz więcej. To decyzja handlowa, ale tabela mapowań z kolumną prowizji pozwala ją podjąć na danych, a nie na wyczucie.
Uważaj na okres startowy. Przez pierwsze 3 miesiące sprzedaży - według regulaminu promocji 100 dni od dnia następującego po pozytywnej weryfikacji - prowizja wynosi 0% niezależnie od kategorii, ale promocja nie obejmuje opłaty transakcyjnej (stan na październik 2026 - sprawdź aktualny regulamin promocji). Błędy w mapowaniu nie kosztują wtedy prowizji, więc łatwo je przeoczyć. Wychodzą dopiero po zakończeniu promocji, na pierwszej fakturze ze stawkami kategorii. Dlatego sprawdź kategorie jeszcze w okresie 0%.
Mapowanie kategorii i parametrów na Arena.pl to przypisanie każdej kategorii z Twojego sklepu, integratora lub ERP do najniższej pasującej kategorii Arena.pl oraz połączenie cech produktu z atrybutami, które Arena.pl definiuje osobno dla każdej kategorii. Błędy przy imporcie ofert biorą się najczęściej ze zbyt ogólnej kategorii, brakujących lub niepasujących wartości atrybutów, niepoprawnych grup wariantowych, zakazanych fraz w nazwie i pustych opisów.
Kategoria na Arena.pl decyduje o więcej niż miejscu w drzewie. Od niej zależą stawka prowizji, lista atrybutów, możliwość połączenia produktów w grupę wariantową i to, czy kupujący znajdzie ofertę. W tym wpisie zbieramy zasady z centrum pomocy i regulaminu Arena.pl, dokumentacji API i integratorów, a potem pokazujemy praktyczną metodę mapowania, która ogranicza poprawki po imporcie. Zalecenia z wdrożeń wyraźnie oddzielamy od zasad platformy.
[#wazne] W skrócie: na Arena.pl produkt powinien trafić do najniższej możliwej kategorii, co najmniej trzeciego rzędu, a jego atrybuty muszą pasować do listy zdefiniowanej dla tej kategorii. Kategoria wpływa na prowizję - według kalkulatora Arena.pl od 2,68% w Elektronice do 10,9% m.in. w Modzie i Zdrowiu - a przy błędnej kategorii Arena.pl może naliczyć prowizję prawidłową (stan na październik 2026 - sprawdź aktualny cennik i regulamin). W Vinson przygotowujemy mapowanie kategorii i atrybutów tak, żeby oferty przechodziły import bez błędów.
Mapowanie kategorii na Arena.pl - co to jest i dlaczego decyduje o imporcie
Mapowanie kategorii to tabela reguł, która mówi integracji, do której kategorii Arena.pl ma trafić produkt z danej kategorii Twojego systemu. Mapowanie parametrów robi to samo dla cech produktu: łączy np. Twój kolor i jego wartości z atrybutem i listą wartości Arena.pl. Drzewa kategorii w sklepie i na marketplace prawie nigdy nie są takie same, więc bez mapowania integracja albo nie wystawi produktu, albo wystawi go w złym miejscu. Mapowanie przygotowujesz raz, ale integracja korzysta z niego przy każdym imporcie i każdej aktualizacji. Błąd w jednej regule powiela się więc na wszystkich produktach danej kategorii, a poprawka jednej reguły naprawia je wszystkie naraz.
Zasady po stronie Arena.pl łatwo zapamiętać. Opis Panelu Sprzedawcy w centrum pomocy zaleca przypisanie produktowi najniższej możliwej kategorii, minimum trzeciego rzędu, bo im precyzyjniejsza kategoria, tym łatwiej kupującym znaleźć produkt. Regulamin sprzedawcy wymaga wskazania kategorii odpowiedniej ze względu na rodzaj i przeznaczenie towaru i zastrzega, że administrator może zmienić kategorię bez informowania sprzedawcy. Jeśli błędna kategoria obniżyła prowizję, Arena.pl może naliczyć prowizję prawidłową, także po wystawieniu faktury (stan na październik 2026 - sprawdź aktualny regulamin).
Kategoria, atrybuty i widoczność oferty
Kategoria i atrybuty wpływają też na to, gdzie oferta się pokaże. Opis Panelu Sprzedawcy wiąże precyzyjną kategorię z łatwiejszym wyszukiwaniem i wyższym pozycjonowaniem w wynikach wyszukiwarki, a zasady jakości ofert Arena.pl podają, że dodanie atrybutów wpływa na atrakcyjność oferty i jej pozycję na listingu (stan na październik 2026 - sprawdź aktualne zasady). Z naszej praktyki na marketplace'ach atrybuty zasilają też filtry, więc produkt z pustym rozmiarem czy materiałem łatwo wypada z wyników zawężonych przez kupującego. To ryzyko warto założyć także na Arena.pl, zwłaszcza w odzieży, motoryzacji i elektronice.
Kategoria a prowizja na Arena.pl
Po okresie startowym prowizja na Arena.pl zależy od kategorii. Kalkulator na stronie dla sprzedawców, ze stawkami ustalonymi 06.10.2026, podaje je dla ośmiu kategorii głównych, a strona określa ogólny zakres jako od 5% do 20%. Dla kategorii nietypowych kalkulator nie podaje stawki i pokazuje wycenę indywidualną (stan na październik 2026 - sprawdź aktualny cennik i regulamin):
[#chart:arn24a]
Prowizja jest liczona od wartości produktów i wysyłki brutto, a niezależnie od niej obowiązuje opłata transakcyjna - według regulaminu od 03.07.2026 jest to 1,49%, nie mniej niż 1,85 zł brutto. Szczegóły stawek, promocji 0% na start i pozostałych opłat opisujemy we wpisie prowizje Arena.pl - stawki według kategorii. Dla mapowania wniosek jest jeden: dodaj do tabeli mapowań kolumnę ze stawką kategorii głównej. Od razu zobaczysz, które grupy produktów będą droższe w sprzedaży, i nie przypiszesz towaru do kategorii z niższą prowizją na próbę - regulamin przewiduje w takim przypadku dopłatę różnicy.
Stawka to także argument przy wyborze asortymentu na start. Jeśli mapowanie pokazuje, że część katalogu trafi do kategorii z wyższą prowizją, a marża na tych produktach jest niska, lepiej wystawić je później, po sprawdzeniu sprzedaży w kategoriach, w których zarabiasz więcej. To decyzja handlowa, ale tabela mapowań z kolumną prowizji pozwala ją podjąć na danych, a nie na wyczucie.
Uważaj na okres startowy. Przez pierwsze 3 miesiące sprzedaży - według regulaminu promocji 100 dni od dnia następującego po pozytywnej weryfikacji - prowizja wynosi 0% niezależnie od kategorii, ale promocja nie obejmuje opłaty transakcyjnej (stan na październik 2026 - sprawdź aktualny regulamin promocji). Błędy w mapowaniu nie kosztują wtedy prowizji, więc łatwo je przeoczyć. Wychodzą dopiero po zakończeniu promocji, na pierwszej fakturze ze stawkami kategorii. Dlatego sprawdź kategorie jeszcze w okresie 0%.
- Analiza ofert i kategorii
- Ceny i warunki dostawy na tle konkurencji
- Plan zwiększenia sprzedaży
Audyt przygotuje Miłosz Brzegowy, Head of Growth and Demand GenerationJak Arena.pl definiuje kategorie i atrybuty
Lista kategorii i atrybutów jest dostępna w API Arena.pl. Dokumentacja v4 zaleca pobranie wszystkich kategorii metodą wyszukiwania kategorii, stronicując po 100 pozycji, i podaje, że w każdej kategorii są wypisane dostępne w niej atrybuty. Każda kategoria może mieć inne atrybuty - przykład z dokumentacji to koszule damskie i męskie, które mają oddzielnie zdefiniowane rozmiary. Atrybuty i ich wartości są sprawdzane względem wybranej kategorii, część atrybutów jest oznaczona jako możliwa do użycia w wariantach, a zmiana kategorii uruchamia ponowną walidację grupy wariantowej (stan na październik 2026 - sprawdź aktualną dokumentację).
Dwie zasady z dokumentacji API dotyczą mapowania wprost. Od 28.10.2026 produkt wysłany do kategorii-gałęzi, czyli takiej, która ma podkategorie, jest zapisywany w jej podkategorii „Pozostałe”, jeśli taka istnieje - dokumentacja podkreśla, że oferta powinna trafić do liścia drzewa. Aktualizacja bez pola kategorii jej nie zmienia. Druga zasada: w Panelu Sprzedawcy można zablokować zmianę kategorii dla produktu, żeby automatyczny import jej nie nadpisywał. Kategoria przesłana wtedy przez API jest ignorowana. Dlatego po każdej większej zmianie mapowania sprawdź na kilku produktach, czy kategoria na Arena.pl faktycznie się zmieniła.
Jak przygotować mapowanie kategorii krok po kroku
Poniższa kolejność łączy wymagania Arena.pl z praktyką wdrożeń integracji marketplace. Sprawdza się niezależnie od tego, czy mapujesz w integratorze, module sklepu, czy we własnej integracji z API:
[#chart:arn24b]
Tabelę mapowań prowadź w jednym arkuszu dla całej firmy. Poza kategorią sklepu i kategorią Arena.pl warto mieć w niej identyfikator kategorii Arena.pl, pełną ścieżkę, listę atrybutów wymaganych w danej kategorii, sposób ich uzupełnienia, stawkę prowizji kategorii głównej i osobę, która zatwierdziła regułę. Taki arkusz to nasza praktyka, a nie wymóg Arena.pl, ale przy kolejnych zmianach w drzewie kategorii pozwala szybko sprawdzić, które reguły trzeba poprawić. Przy pracy nad tabelą pomagają proste zasady:
Mapuj do liścia, nie do gałęzi. Kategoria „Pozostałe” to rozwiązanie awaryjne, a nie docelowe miejsce dla całej grupy produktów.
Jedna kategoria główna na produkt. Powiązania w Base działają tylko dla głównej kategorii magazynowej, więc produkt z kilkoma kategoriami w sklepie dostanie kategorię Arena.pl z tej głównej.
Wyjątki mapuj na poziomie produktu. W Base reguły dla produktu mają pierwszeństwo przed regułami kategorii, a te przed ustawieniami konta.
Wartości atrybutów tłumacz słownikiem. Granatowy, navy i ciemnoniebieski ze sklepu muszą trafić do jednej wartości z listy Arena.pl.
Nie wybieraj kategorii pod niższą prowizję. Regulamin pozwala Arena.pl skorygować taką prowizję i zażądać dopłaty.
Gdzie mapujesz kategorie - Base, PrestaShop, IdoSell i API
Miejsce i sposób mapowania zależą od narzędzia, przez które wystawiasz oferty. Najważniejsze różnice z dokumentacji zebraliśmy w tabeli (stan na październik 2026 - sprawdź aktualną dokumentację narzędzi):
| Narzędzie | Gdzie mapujesz | Na co uważać |
|---|---|---|
| BaseLinker (Base) | Kategorie i parametry (ulubione kategorie, reguły parametrów) oraz Powiązania | Parametry Arena.pl synchronizują się raz dziennie; reguły parametrów osobno dla każdego katalogu |
| Moduł PrestaShop | Mapowanie kategorii i atrybutów w konfiguracji modułu | Przy wariantowaniu produkt musi mieć zmapowaną kategorię i wszystkie jej atrybuty |
| IdoSell | Kategoria towaru w panelu sklepu | Towar bez kategorii nie jest eksportowany na Arena.pl |
| Własna integracja z API | Pola categoryId i attributes produktu | Gałąź zapisuje się jako „Pozostałe”; blokada w Panelu ignoruje przesłaną kategorię |
| Panel Sprzedawcy | Edycja produktu i grupy wariantowe | Ręczne zmiany może nadpisać kolejny import, jeśli kategoria nie jest zablokowana |
Najwięcej szczegółów konfiguracji modułu, w tym kolejność mapowania statusów, przewoźników, kategorii i atrybutów, opisujemy we wpisie PrestaShop i Arena.pl - integracja. W Base pamiętaj, że nowy atrybut dodany na Arena.pl pojawi się w module dopiero po dziennej synchronizacji parametrów. Jeśli zmiana nie dotrze w ciągu 24 godzin, dokumentacja Base zaleca kontakt z jej obsługą klienta.
Parametry, atrybuty i warianty - najczęstsze błędy przy imporcie ofert na Arena.pl
Najwięcej odrzuconych lub źle wyświetlanych ofert dotyczy wariantów. Według centrum pomocy Arena.pl grupa wariantowa jest poprawna, gdy zawiera od 2 do 100 produktów, w tym co najmniej 2 dostępne do zakupu, wszystkie produkty należą do jednej kategorii, ma poprawnie zdefiniowany co najmniej 1 parametr, a kombinacje wybranych parametrów są unikalne. Parametrem może być wygląd (Kolor/Wzór ze zdjęciem, tylko jako parametr 1) albo atrybut - ale tylko taki, który mają uzupełniony wszystkie produkty w grupie, i nie każdy atrybut się do tego nadaje. Grupa z produktami z różnych kategorii jest uznawana za nieprawidłową i nie wyświetla się na stronie produktu (stan na październik 2026 - sprawdź aktualną instrukcję).
Przy imporcie przez API grupy wariantowe tworzy się po przypisaniu produktom kategorii i atrybutów. Dokumentacja zaleca sprawdzenie po utworzeniu, czy pole z przyczyną nieważności grupy jest puste, i nadawanie automatycznym grupom nazw w formacie auto_ z identyfikatorem grupy w sklepie, co ułatwia późniejszą synchronizację. Typowe objawy błędnego mapowania i poprawki zebraliśmy na diagramie:
[#chart:arn24c]
Nazwy i opisy, które zatrzymują import
Mapowanie kategorii to nie wszystko - oferta może odpaść na treści. Standard oferty w regulaminie ogranicza nazwę do 75 znaków, bez znaków encji HTML i bez pisania wielkimi literami, a Panel Sprzedawcy rekomenduje nazwy do 70 znaków. Od 08.09.2026 nazwa nie może zawierać fraz z katalogu fraz zakazanych prowadzonego przez Arena.pl: nowa oferta jest wtedy odrzucana, a istniejąca - wyłączana i znika z wyszukiwarki. Od 29.09.2026 API odrzuca produkty z pustym opisem (stan na październik 2026 - sprawdź aktualną dokumentację i regulamin).
[#uwaga] Zasady jakości ofert Arena.pl wymagają, by produkt miał kod EAN lub kod producenta - produkty bez nich są prezentowane z niższym priorytetem. Tytuł ma definiować produkt, a nie jego zalety, więc słowa w rodzaju „najtańszy”, „okazja” czy „gratis” usuń z nazw jeszcze przed mapowaniem.
Kontrola po imporcie - jak sprawdzić, czy mapowanie działa
Po pierwszym imporcie przejrzyj po kilka ofert z każdej kategorii głównej tak, jak widzi je kupujący: ścieżkę kategorii, atrybuty w karcie produktu, warianty i nazwę. Sprawdź w Panelu Sprzedawcy listę grup wariantowych - widać tam status każdej grupy i liczbę produktów niedostępnych. Po pierwszych zamówieniach porównaj prowizje w zakładce Finanse - Rachunek ze stawką, której spodziewasz się dla danej kategorii. Rozbieżność to najszybszy sygnał, że produkt trafił do innej kategorii, niż zakłada tabela mapowań.
Mapowanie nie jest jednorazowe. Arena.pl dodaje i zmienia kategorie oraz atrybuty, a w Base nowe parametry pojawiają się po dziennej synchronizacji. Raz w miesiącu przejrzyj produkty w kategoriach „Pozostałe” i oferty z błędami w logach integracji. Wyznacz też właściciela tabeli mapowań - osobę, która zatwierdza nowe reguły, gdy w sklepie pojawia się kategoria albo dostawca z innym nazewnictwem cech. Bez niej po kilku miesiącach tabela przestaje odpowiadać temu, co faktycznie robi integracja. Jak podobne problemy wyglądają w innych narzędziach, pokazujemy we wpisie o błędach przy dopasowaniu katalogu do kategorii marketplace w xSale.
Jak Vinson pomaga przygotować mapowanie kategorii na 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 przygotowujemy katalog do importu:
Tabela mapowań kategorii z identyfikatorami, ścieżkami i stawkami prowizji.
Słowniki wartości atrybutów i reguły parametrów w integratorze lub module sklepu.
Grupy wariantowe, nazwy i opisy zgodne ze Standardem oferty.
Import próbny oraz kontrola ofert i prowizji po pierwszych zamówieniach.
Najczęściej zadawane pytania
Jak wybrać kategorię produktu na Arena.pl?
Wybierz najniższą możliwą kategorię, która opisuje rodzaj i przeznaczenie produktu - Panel Sprzedawcy zaleca minimum trzeci rząd. Listę kategorii i ich atrybutów pobierzesz przez API albo przejrzysz w integratorze, np. w module Arena.pl w Base.
Czy kategoria wpływa na prowizję na Arena.pl?
Tak. Prowizja zależy od kategorii - według kalkulatora ze stawkami z 06.10.2026 wynosi np. 2,68% w Elektronice, 8,87% w Domu i ogrodzie i 10,9% w Modzie (stan na październik 2026 - sprawdź aktualny cennik i regulamin). Przy błędnej kategorii Arena.pl może naliczyć prowizję prawidłową.
Dlaczego mój produkt trafił do kategorii „Pozostałe” na Arena.pl?
Najczęściej integracja wysłała kategorię-gałąź zamiast liścia. Od 28.10.2026 API zapisuje taki produkt w podkategorii „Pozostałe” danej gałęzi, jeśli ona istnieje. Popraw mapowanie tak, żeby wskazywało najniższą kategorię, i zaktualizuj produkty.
Dlaczego Arena.pl odrzuca atrybuty produktu przy imporcie?
Atrybuty i ich wartości są sprawdzane względem kategorii, a każda kategoria ma własną listę. Pobierz atrybuty i dozwolone wartości dla docelowej kategorii i przetłumacz wartości ze sklepu słownikiem mapowań.
Czy Arena.pl może zmienić kategorię mojego produktu?
Tak. Regulamin sprzedawcy pozwala administratorowi zmienić kategorię towaru bez informowania sprzedawcy. Niezależnie od tego w Panelu Sprzedawcy możesz zablokować zmianę kategorii produktu przez API, żeby automatyczny import nie nadpisywał kategorii ustawionej ręcznie.
Chcesz zaimportować oferty na Arena.pl bez odrzuconych atrybutów, rozbitych wariantów i niespodzianek w prowizjach? Zobacz, jak prowadzimy kompleksową obsługę sprzedaży na Arena.pl - od tabeli mapowań po kontrolę pierwszych zamówień.
Jak Arena.pl definiuje kategorie i atrybuty
Lista kategorii i atrybutów jest dostępna w API Arena.pl. Dokumentacja v4 zaleca pobranie wszystkich kategorii metodą wyszukiwania kategorii, stronicując po 100 pozycji, i podaje, że w każdej kategorii są wypisane dostępne w niej atrybuty. Każda kategoria może mieć inne atrybuty - przykład z dokumentacji to koszule damskie i męskie, które mają oddzielnie zdefiniowane rozmiary. Atrybuty i ich wartości są sprawdzane względem wybranej kategorii, część atrybutów jest oznaczona jako możliwa do użycia w wariantach, a zmiana kategorii uruchamia ponowną walidację grupy wariantowej (stan na październik 2026 - sprawdź aktualną dokumentację).
Dwie zasady z dokumentacji API dotyczą mapowania wprost. Od 28.10.2026 produkt wysłany do kategorii-gałęzi, czyli takiej, która ma podkategorie, jest zapisywany w jej podkategorii „Pozostałe”, jeśli taka istnieje - dokumentacja podkreśla, że oferta powinna trafić do liścia drzewa. Aktualizacja bez pola kategorii jej nie zmienia. Druga zasada: w Panelu Sprzedawcy można zablokować zmianę kategorii dla produktu, żeby automatyczny import jej nie nadpisywał. Kategoria przesłana wtedy przez API jest ignorowana. Dlatego po każdej większej zmianie mapowania sprawdź na kilku produktach, czy kategoria na Arena.pl faktycznie się zmieniła.
Jak przygotować mapowanie kategorii krok po kroku
Poniższa kolejność łączy wymagania Arena.pl z praktyką wdrożeń integracji marketplace. Sprawdza się niezależnie od tego, czy mapujesz w integratorze, module sklepu, czy we własnej integracji z API:
[#chart:arn24b]
Tabelę mapowań prowadź w jednym arkuszu dla całej firmy. Poza kategorią sklepu i kategorią Arena.pl warto mieć w niej identyfikator kategorii Arena.pl, pełną ścieżkę, listę atrybutów wymaganych w danej kategorii, sposób ich uzupełnienia, stawkę prowizji kategorii głównej i osobę, która zatwierdziła regułę. Taki arkusz to nasza praktyka, a nie wymóg Arena.pl, ale przy kolejnych zmianach w drzewie kategorii pozwala szybko sprawdzić, które reguły trzeba poprawić. Przy pracy nad tabelą pomagają proste zasady:
Mapuj do liścia, nie do gałęzi. Kategoria „Pozostałe” to rozwiązanie awaryjne, a nie docelowe miejsce dla całej grupy produktów.
Jedna kategoria główna na produkt. Powiązania w Base działają tylko dla głównej kategorii magazynowej, więc produkt z kilkoma kategoriami w sklepie dostanie kategorię Arena.pl z tej głównej.
Wyjątki mapuj na poziomie produktu. W Base reguły dla produktu mają pierwszeństwo przed regułami kategorii, a te przed ustawieniami konta.
Wartości atrybutów tłumacz słownikiem. Granatowy, navy i ciemnoniebieski ze sklepu muszą trafić do jednej wartości z listy Arena.pl.
Nie wybieraj kategorii pod niższą prowizję. Regulamin pozwala Arena.pl skorygować taką prowizję i zażądać dopłaty.
Gdzie mapujesz kategorie - Base, PrestaShop, IdoSell i API
Miejsce i sposób mapowania zależą od narzędzia, przez które wystawiasz oferty. Najważniejsze różnice z dokumentacji zebraliśmy w tabeli (stan na październik 2026 - sprawdź aktualną dokumentację narzędzi):
| Narzędzie | Gdzie mapujesz | Na co uważać |
|---|---|---|
| BaseLinker (Base) | Kategorie i parametry (ulubione kategorie, reguły parametrów) oraz Powiązania | Parametry Arena.pl synchronizują się raz dziennie; reguły parametrów osobno dla każdego katalogu |
| Moduł PrestaShop | Mapowanie kategorii i atrybutów w konfiguracji modułu | Przy wariantowaniu produkt musi mieć zmapowaną kategorię i wszystkie jej atrybuty |
| IdoSell | Kategoria towaru w panelu sklepu | Towar bez kategorii nie jest eksportowany na Arena.pl |
| Własna integracja z API | Pola categoryId i attributes produktu | Gałąź zapisuje się jako „Pozostałe”; blokada w Panelu ignoruje przesłaną kategorię |
| Panel Sprzedawcy | Edycja produktu i grupy wariantowe | Ręczne zmiany może nadpisać kolejny import, jeśli kategoria nie jest zablokowana |
Najwięcej szczegółów konfiguracji modułu, w tym kolejność mapowania statusów, przewoźników, kategorii i atrybutów, opisujemy we wpisie PrestaShop i Arena.pl - integracja. W Base pamiętaj, że nowy atrybut dodany na Arena.pl pojawi się w module dopiero po dziennej synchronizacji parametrów. Jeśli zmiana nie dotrze w ciągu 24 godzin, dokumentacja Base zaleca kontakt z jej obsługą klienta.
Parametry, atrybuty i warianty - najczęstsze błędy przy imporcie ofert na Arena.pl
Najwięcej odrzuconych lub źle wyświetlanych ofert dotyczy wariantów. Według centrum pomocy Arena.pl grupa wariantowa jest poprawna, gdy zawiera od 2 do 100 produktów, w tym co najmniej 2 dostępne do zakupu, wszystkie produkty należą do jednej kategorii, ma poprawnie zdefiniowany co najmniej 1 parametr, a kombinacje wybranych parametrów są unikalne. Parametrem może być wygląd (Kolor/Wzór ze zdjęciem, tylko jako parametr 1) albo atrybut - ale tylko taki, który mają uzupełniony wszystkie produkty w grupie, i nie każdy atrybut się do tego nadaje. Grupa z produktami z różnych kategorii jest uznawana za nieprawidłową i nie wyświetla się na stronie produktu (stan na październik 2026 - sprawdź aktualną instrukcję).
Przy imporcie przez API grupy wariantowe tworzy się po przypisaniu produktom kategorii i atrybutów. Dokumentacja zaleca sprawdzenie po utworzeniu, czy pole z przyczyną nieważności grupy jest puste, i nadawanie automatycznym grupom nazw w formacie auto_ z identyfikatorem grupy w sklepie, co ułatwia późniejszą synchronizację. Typowe objawy błędnego mapowania i poprawki zebraliśmy na diagramie:
[#chart:arn24c]
Nazwy i opisy, które zatrzymują import
Mapowanie kategorii to nie wszystko - oferta może odpaść na treści. Standard oferty w regulaminie ogranicza nazwę do 75 znaków, bez znaków encji HTML i bez pisania wielkimi literami, a Panel Sprzedawcy rekomenduje nazwy do 70 znaków. Od 08.09.2026 nazwa nie może zawierać fraz z katalogu fraz zakazanych prowadzonego przez Arena.pl: nowa oferta jest wtedy odrzucana, a istniejąca - wyłączana i znika z wyszukiwarki. Od 29.09.2026 API odrzuca produkty z pustym opisem (stan na październik 2026 - sprawdź aktualną dokumentację i regulamin).
[#uwaga] Zasady jakości ofert Arena.pl wymagają, by produkt miał kod EAN lub kod producenta - produkty bez nich są prezentowane z niższym priorytetem. Tytuł ma definiować produkt, a nie jego zalety, więc słowa w rodzaju „najtańszy”, „okazja” czy „gratis” usuń z nazw jeszcze przed mapowaniem.
Kontrola po imporcie - jak sprawdzić, czy mapowanie działa
Po pierwszym imporcie przejrzyj po kilka ofert z każdej kategorii głównej tak, jak widzi je kupujący: ścieżkę kategorii, atrybuty w karcie produktu, warianty i nazwę. Sprawdź w Panelu Sprzedawcy listę grup wariantowych - widać tam status każdej grupy i liczbę produktów niedostępnych. Po pierwszych zamówieniach porównaj prowizje w zakładce Finanse - Rachunek ze stawką, której spodziewasz się dla danej kategorii. Rozbieżność to najszybszy sygnał, że produkt trafił do innej kategorii, niż zakłada tabela mapowań.
Mapowanie nie jest jednorazowe. Arena.pl dodaje i zmienia kategorie oraz atrybuty, a w Base nowe parametry pojawiają się po dziennej synchronizacji. Raz w miesiącu przejrzyj produkty w kategoriach „Pozostałe” i oferty z błędami w logach integracji. Wyznacz też właściciela tabeli mapowań - osobę, która zatwierdza nowe reguły, gdy w sklepie pojawia się kategoria albo dostawca z innym nazewnictwem cech. Bez niej po kilku miesiącach tabela przestaje odpowiadać temu, co faktycznie robi integracja. Jak podobne problemy wyglądają w innych narzędziach, pokazujemy we wpisie o błędach przy dopasowaniu katalogu do kategorii marketplace w xSale.
Jak Vinson pomaga przygotować mapowanie kategorii na 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 przygotowujemy katalog do importu:
Tabela mapowań kategorii z identyfikatorami, ścieżkami i stawkami prowizji.
Słowniki wartości atrybutów i reguły parametrów w integratorze lub module sklepu.
Grupy wariantowe, nazwy i opisy zgodne ze Standardem oferty.
Import próbny oraz kontrola ofert i prowizji po pierwszych zamówieniach.
Najczęściej zadawane pytania
Jak wybrać kategorię produktu na Arena.pl?
Wybierz najniższą możliwą kategorię, która opisuje rodzaj i przeznaczenie produktu - Panel Sprzedawcy zaleca minimum trzeci rząd. Listę kategorii i ich atrybutów pobierzesz przez API albo przejrzysz w integratorze, np. w module Arena.pl w Base.
Czy kategoria wpływa na prowizję na Arena.pl?
Tak. Prowizja zależy od kategorii - według kalkulatora ze stawkami z 06.10.2026 wynosi np. 2,68% w Elektronice, 8,87% w Domu i ogrodzie i 10,9% w Modzie (stan na październik 2026 - sprawdź aktualny cennik i regulamin). Przy błędnej kategorii Arena.pl może naliczyć prowizję prawidłową.
Dlaczego mój produkt trafił do kategorii „Pozostałe” na Arena.pl?
Najczęściej integracja wysłała kategorię-gałąź zamiast liścia. Od 28.10.2026 API zapisuje taki produkt w podkategorii „Pozostałe” danej gałęzi, jeśli ona istnieje. Popraw mapowanie tak, żeby wskazywało najniższą kategorię, i zaktualizuj produkty.
Dlaczego Arena.pl odrzuca atrybuty produktu przy imporcie?
Atrybuty i ich wartości są sprawdzane względem kategorii, a każda kategoria ma własną listę. Pobierz atrybuty i dozwolone wartości dla docelowej kategorii i przetłumacz wartości ze sklepu słownikiem mapowań.
Czy Arena.pl może zmienić kategorię mojego produktu?
Tak. Regulamin sprzedawcy pozwala administratorowi zmienić kategorię towaru bez informowania sprzedawcy. Niezależnie od tego w Panelu Sprzedawcy możesz zablokować zmianę kategorii produktu przez API, żeby automatyczny import nie nadpisywał kategorii ustawionej ręcznie.
Chcesz zaimportować oferty na Arena.pl bez odrzuconych atrybutów, rozbitych wariantów i niespodzianek w prowizjach? Zobacz, jak prowadzimy kompleksową obsługę sprzedaży na Arena.pl - od tabeli mapowań po kontrolę pierwszych zamówień.


Miłosz Brzegowy
Head of Growth and Demand Generation
Buduje strategie wzrostu i wejścia na nowe kanały sprzedaży. Łączy dane, kanały i treści w przewidywalny system.
Buduje strategie wzrostu i wejścia na nowe kanały sprzedaży. Łączy dane, kanały i treści w przewidywalny system.
Sprzedaż na Arena
Miłosz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
Napisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Miłosz Brzegowy, Head of Growth and Demand GenerationNapisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Miłosz Brzegowy, Head of Growth and Demand Generation