Wróć na blog

Jak przygotować bazę produktów do Allegro?

15.06.2026 27 min czytania

Baza produktów przygotowana pod Allegro powinna zawierać znacznie więcej niż nazwę, cenę i stan magazynowy. Kluczowe są poprawne SKU, GTIN/EAN, marka, kod producenta, model, właściwa kategoria, parametry, warianty, zdjęcia oraz spójny opis. Dobrze uporządkowane dane ułatwiają łączenie ofert z Katalogiem produktów Allegro, ograniczają błędy przy masowym wystawianiu i pozwalają później sprawnie synchronizować ceny, stany oraz zamówienia z ERP lub systemem magazynowym.

Dobra baza produktów do Allegro powinna jednoznacznie identyfikować każdy wariant i zawierać komplet danych potrzebnych do Katalogu produktów. Najważniejsze są SKU, GTIN/EAN, kategoria, parametry, zdjęcia i spójność danych.

Przy kilku produktach można wystawiać oferty ręcznie i poprawiać dane na bieżąco. Problem zaczyna się wtedy, gdy firma chce opublikować:

  • 500 produktów,
  • 5 000 produktów,
  • kilkadziesiąt tysięcy SKU,
  • wiele wariantów kolorystycznych i rozmiarowych,
  • ten sam asortyment jednocześnie w sklepie internetowym, ERP i Allegro.

W takiej sytuacji jakość sprzedaży na marketplace zaczyna zależeć od jakości bazy produktowej.

Jeżeli w źródłowych danych znajdują się:

  • niepoprawne kody EAN,
  • przypadkowe nazwy,
  • brakujące parametry,
  • duplikaty SKU,
  • pomieszane warianty,
  • niewłaściwe zdjęcia,

integracja nie rozwiąże problemu.

Ona jedynie szybciej przeniesie błędne dane do Allegro.

Dlatego właściwa kolejność powinna wyglądać tak:

porządek w bazie produktów → mapowanie danych → połączenie z Katalogiem Allegro → wystawianie ofert → synchronizacja stanów i cen.

Produkt, oferta i pozycja magazynowa to nie zawsze to samo

To jedno z najważniejszych rozróżnień.

W wewnętrznym systemie możesz mieć produkt:

T-shirt Classic

ale faktycznie sprzedajesz:

  • czarny / S,
  • czarny / M,
  • czarny / L,
  • biały / S,
  • biały / M,
  • biały / L.

Z punktu widzenia magazynu jest to:

6 różnych pozycji.

Każda może mieć:

  • własny SKU,
  • własny GTIN,
  • własny stan,
  • osobne zdjęcia,
  • osobny rozmiar,
  • osobny kolor.

Nie wystarczy więc utworzyć jednej kartoteki:

T-shirt Classic – stan 180 szt.

System musi wiedzieć przykładowo:

SKUKolorRozmiarStan
TSH-BLK-SczarnyS20
TSH-BLK-MczarnyM45
TSH-BLK-LczarnyL35
TSH-WHT-SbiałyS18
TSH-WHT-MbiałyM40
TSH-WHT-LbiałyL22

Dopiero taka struktura pozwala poprawnie synchronizować sprzedaż.

Zacznij od jednego unikalnego SKU dla każdego wariantu

SKU jest wewnętrznym identyfikatorem produktu.

Przykład:

BUT-NIKE-PEG41-BLK-43

Może oznaczać:

  • buty Nike,
  • model Pegasus 41,
  • kolor czarny,
  • rozmiar 43.

SKU powinien być:

  • unikalny,
  • trwały,
  • jednoznaczny,
  • niezależny od tytułu oferty.

Nie zmieniaj SKU tylko dlatego, że zmieniasz nazwę marketingową produktu.

Zły przykład

W bazie istnieją:

BUT001

oraz drugi produkt:

BUT001

W sklepie internetowym może jeszcze dać się z tym funkcjonować.

Przy integracji z Allegro może pojawić się problem z:

  • synchronizacją stanów,
  • aktualizacją cen,
  • pobieraniem zamówień,
  • wskazaniem właściwego wariantu.

Jedna pozycja magazynowa powinna mieć jeden jednoznaczny identyfikator.

Nie używaj tytułu Allegro jako identyfikatora

Tytuł może się zmienić.

Przykładowo dziś:

Buty Nike Pegasus 41 męskie czarne 43

a za miesiąc:

Nike Pegasus 41 buty do biegania czarne rozmiar 43

To nadal ten sam produkt.

Dlatego powiązanie:

produkt ↔ Allegro

powinno opierać się na trwałych identyfikatorach, a nie na nazwie.

W systemie warto przechowywać między innymi:

SKU wewnętrzny → GTIN → ID produktu Allegro → ID oferty Allegro.

SKU i EAN/GTIN to nie to samo

To częsty błąd.

SKU

Tworzysz samodzielnie na potrzeby swojej firmy.

GTIN

Globalny identyfikator produktu.

W Europie najczęściej spotykany jest GTIN-13, powszechnie określany jako EAN.

Allegro wskazuje GTIN jako jeden z kluczowych parametrów służących do identyfikowania produktów w Katalogu.

Przykład:

SKU: KUBEK-WHT-350

GTIN: 5901234567890

To dwa różne pola i warto przechowywać oba.

Nie wymyślaj przypadkowych kodów EAN

Jeżeli produkt posiada oficjalny GTIN producenta, trzeba używać właściwego numeru przypisanego do konkretnego produktu.

Nie powinno się kopiować kodu:

  • z podobnego produktu,
  • z innego wariantu,
  • z większego opakowania,
  • z aukcji konkurencji.

GTIN ma identyfikować konkretny produkt.

Pomyłka może spowodować połączenie oferty z nieodpowiednim produktem w Katalogu.

Allegro przy kontroli ofert porównuje między innymi GTIN, podstawowe parametry produktu, zdjęcia oraz zgodność kategorii.

Każdy wariant może wymagać osobnego GTIN

Załóżmy:

koszulka występuje w rozmiarach:

S, M, L.

Jeżeli producent przypisał każdemu wariantowi osobny GTIN, baza powinna wyglądać:

SKURozmiarGTIN
TSH-01-SSGTIN A
TSH-01-MMGTIN B
TSH-01-LLGTIN C

Nie należy wpisywać jednego kodu produktu do wszystkich wariantów tylko po to, aby uprościć bazę.

Zadbaj o markę, producenta, model i kod producenta

W zależności od kategorii Allegro może wykorzystywać różne parametry identyfikujące produkt.

Szczególnie ważne są:

  • GTIN,
  • marka,
  • producent,
  • kod producenta,
  • model.

Allegro wskazuje GTIN, markę lub producenta, kod producenta i model jako jedne z najważniejszych danych produktowych.

Dlatego kartoteka:

Wiertarka niebieska 18V

jest zdecydowanie za uboga.

Lepiej:

Typ: wiertarko-wkrętarka
Marka: XYZ
Model: ABC18
Kod producenta: ABC18-002
GTIN: ...
Napięcie: 18 V
Kolor: niebieski

Takie dane znacznie łatwiej dopasować do struktury marketplace.

Jedna kolumna „nazwa” to za mało

Bardzo częsty problem wygląda tak:

SKUNazwa
1001Nike Air Max czarne męskie 43

Wszystkie informacje znajdują się w jednym polu.

Człowiek rozumie tę nazwę.

System niekoniecznie wie, że:

marka = Nike

model = Air Max

kolor = czarny

płeć = mężczyzna

rozmiar = 43

Dlatego bazę produktową warto rozbić na pola strukturalne.

Jak powinien wyglądać podstawowy rekord produktu?

Przykładowa struktura:

PolePrzykład
SKUNIKE-AM-BLK-43
GTIN5901234567890
NazwaNike Air Max
MarkaNike
ModelAir Max
Kod producentaABC123
Kategoria własnaButy sportowe
Kategoria Allegrowłaściwa kategoria marketplace
Kolorczarny
Rozmiar43
Płećmężczyzna
Stannowy
Cena399
Stan magazynowy12
VATwłaściwa stawka
Zdjęcie główneplik / URL źródłowy
Pozostałe zdjęcialista
Opistreść
ID produktu Allegropo powiązaniu
ID oferty Allegropo wystawieniu

W zależności od branży pól może być znacznie więcej.

Kategoria Allegro powinna być osobnym polem

Twoja wewnętrzna struktura kategorii może wyglądać:

Sport → Obuwie → Bieganie → Mężczyźni

ale Allegro korzysta z własnego drzewa kategorii.

Nie należy zakładać, że:

moja kategoria = kategoria Allegro.

W systemie najlepiej przechowywać:

kategoria wewnętrzna

oraz osobno:

ID kategorii Allegro.

Mapowanie kategorii znacznie przyspiesza wystawianie

Jeżeli masz 3 000 produktów w kategorii:

Etui do telefonów

nie chcesz ręcznie wybierać kategorii przy każdej ofercie.

Tworzysz mapowanie:

Etui do telefonów → odpowiednia kategoria Allegro.

Następnie produkty z tej grupy mogą być automatycznie kierowane do właściwej kategorii.

Ale mapowanie trzeba wykonywać ostrożnie.

Pod jedną wewnętrzną kategorią mogą znajdować się produkty, które w Allegro powinny trafić do kilku różnych miejsc.

Wybierz możliwie dokładną kategorię

W Allegro struktura kategorii ma formę drzewa. Przy integracjach API oferta produktowa jest tworzona w kategorii końcowej, czyli tzw. liściu drzewa.

Nie wystarczy więc zapisać:

Elektronika.

Trzeba określić możliwie dokładne miejsce produktu.

Ma to znaczenie również dlatego, że od kategorii zależą:

  • dostępne parametry,
  • parametry wymagane,
  • sposób prezentacji produktu,
  • filtrowanie ofert.

Parametry są jednym z najważniejszych elementów bazy

Dla telewizora mogą to być:

  • przekątna ekranu,
  • rozdzielczość,
  • technologia wyświetlacza,
  • Smart TV,
  • liczba HDMI.

Dla butów:

  • marka,
  • model,
  • rozmiar,
  • kolor,
  • materiał,
  • płeć.

Dla wiertarki:

  • moc,
  • napięcie,
  • maksymalny moment obrotowy,
  • liczba biegów.

Parametry zależą od kategorii, dlatego nie ma jednego uniwersalnego zestawu dla wszystkich produktów.

Allegro udostępnia dla poszczególnych kategorii odpowiedni zestaw parametrów, również poprzez API.

Nie ograniczaj się do parametrów obowiązkowych

Załóżmy, że do wystawienia wystarczy uzupełnić pięć parametrów.

Nie oznacza to, że pozostałe są zbędne.

Parametry pomagają klientowi:

  • znaleźć produkt,
  • zastosować filtry,
  • porównać oferty,
  • potwierdzić, że kupuje właściwy wariant.

Allegro również wskazuje, że kompletne parametry pomagają kupującym w wyszukiwaniu produktu.

Dlatego dobra zasada brzmi:

uzupełniaj wszystkie parametry, dla których posiadasz wiarygodne dane.

Nie:

uzupełniaj tylko absolutne minimum.

Nie zgaduj wartości parametrów

Jeżeli nie wiesz, czy urządzenie ma:

Bluetooth 5.2 czy 5.3,

nie wybieraj wartości losowo.

Nieprawidłowy parametr może:

  • wprowadzać klienta w błąd,
  • powodować zwroty,
  • prowadzić do złego powiązania produktu,
  • tworzyć niespójność z opisem.

Lepszy jest brak nieobowiązkowego parametru niż fałszywa informacja.

Parametry zapisuj jako dane, a nie fragment opisu

Zły model:

Kolor: czarny, materiał: stal, długość: 50 cm

wszystko w polu:

opis.

Lepszy:

kolor = czarny

materiał = stal

długość = 50 cm

oraz niezależnie:

opis = tekst dla klienta.

Dzięki temu system może automatycznie mapować dane do parametrów Allegro.

Ujednolić jednostki jeszcze przed integracją

W bazie możesz znaleźć:

  • 1 kg,
  • 1000 g,
  • 1.000kg,
  • 1KG,
  • kilogram,
  • 1000 gramów.

Dla człowieka oznaczają to samo.

Dla automatycznego importu niekoniecznie.

Warto ujednolicić:

  • masę,
  • długość,
  • pojemność,
  • moc,
  • napięcie,
  • rozmiary.

Przykład:

waga_kg = 1

zamiast wpisywania dowolnego tekstu:

około jednego kilograma.

Ujednolić również słowniki wartości

Przykład koloru:

  • Czarny,
  • czarny,
  • black,
  • CZ,
  • czarn.,
  • Czarny mat.

Przed integracją warto ustalić standard.

Przykładowo:

kolor wewnętrzny = BLACK

a mapowanie:

BLACK → czarny.

Dzięki temu 10 000 produktów nie generuje dziesiątek wariantów tego samego znaczenia.

Oddziel dane produktowe od danych oferty

To bardzo ważne.

Dane produktu

Opisują rzecz:

  • marka,
  • model,
  • GTIN,
  • kolor,
  • wymiary,
  • materiał.

Dane oferty

Opisują sposób sprzedaży:

  • cena,
  • liczba dostępnych sztuk,
  • czas wysyłki,
  • cennik dostawy,
  • warunki sprzedaży.

Cena produktu może się zmienić.

Produkt nadal pozostaje tym samym produktem.

Dlatego baza nie powinna mieszać:

czym jest produkt

z:

jak obecnie go sprzedajemy.

Katalog produktów Allegro zmienia sposób myślenia o ofertach

Na Allegro oferty są powiązywane z produktami znajdującymi się w Katalogu produktów.

Katalog zbiera dane takie jak:

  • parametry,
  • zdjęcia,
  • nazwy,
  • opisy produktów.

W praktyce oznacza to, że przed wystawieniem warto najpierw odpowiedzieć:

Czy ten produkt istnieje już w Katalogu Allegro?

Jeżeli tak, oferta powinna zostać połączona z właściwym produktem.

Jeżeli nie, może być konieczne dostarczenie danych pozwalających utworzyć nowy produkt.

Allegro automatycznie sprawdza również poprawność połączenia oferty z Katalogiem.

Nie łącz produktu „na siłę”

Wyobraźmy sobie:

Twój produkt:

Smartfon XYZ 256 GB czarny

Katalog:

Smartfon XYZ 128 GB czarny

Wyglądają niemal identycznie.

Nie są jednak tym samym produktem.

Połączenie oferty z niewłaściwym rekordem może prowadzić do sytuacji, w której:

  • tytuł mówi 256 GB,
  • katalog mówi 128 GB,
  • parametry są niespójne,
  • klient nie wie, co rzeczywiście kupuje.

Najważniejszą zasadą jest:

produkt w bazie i produkt w Katalogu muszą oznaczać dokładnie tę samą rzecz.

Przechowuj ID produktu Allegro

Po prawidłowym dopasowaniu dobrze zapisać relację:

SKU → ID produktu Allegro.

Dzięki temu nie trzeba przy każdym kolejnym wystawieniu ponownie próbować rozpoznawać produktu po:

  • nazwie,
  • GTIN,
  • modelu.

Przykład:

SKUGTINAllegro Product ID
ABC-001590...001ID-1
ABC-002590...002ID-2

To szczególnie ważne przy dużej bazie.

Przechowuj również ID oferty

Produkt i oferta mają różne identyfikatory.

Jeden produkt może być związany z konkretną ofertą sprzedaży.

System powinien pamiętać:

SKU → produkt Allegro → oferta Allegro.

Dzięki temu wiadomo, którą ofertę należy aktualizować, gdy zmieni się:

  • cena,
  • stan,
  • dostępność,
  • sposób sprzedaży.

Warianty projektuj już na poziomie kartoteki

Dobra struktura wariantów:

produkt nadrzędny: T-shirt Classic

warianty:

  • czarny / S,
  • czarny / M,
  • czarny / L,
  • biały / S,
  • biały / M,
  • biały / L.

Każdy wariant posiada własne:

  • SKU,
  • GTIN, jeśli został mu przypisany,
  • stan,
  • wartości parametrów.

Allegro tworzy obecnie warianty produktowe automatycznie na podstawie danych z Katalogu produktów i parametrów charakterystycznych dla kategorii.

Nie traktuj różnych modeli jako wariantów

Wariantem może być przykładowo:

ten sam model buta w różnych rozmiarach.

Ale niekoniecznie:

Nike Model A

i:

Nike Model B.

To dwa różne produkty.

Podobnie:

  • telefon 2025 i telefon 2026,
  • laptop podstawowy i gamingowy,
  • różne konstrukcje tego samego rodzaju produktu

nie powinny być sztucznie łączone jako warianty tylko dlatego, że wyglądają podobnie.

Ważna zmiana w Allegro: stare oferty wielowariantowe zostały zastąpione

Od 14 kwietnia 2026 r. Allegro wyłączyło stare zasoby API służące do tworzenia i obsługi ofert wielowariantowych. Platforma wskazuje, że zastępują je automatycznie tworzone warianty produktowe oparte na Katalogu produktów.

Jeżeli więc przygotowujesz nową integrację w 2026 roku, nie warto projektować bazy według starego mechanizmu ręcznego tworzenia zestawów ofert wielowariantowych.

Znacznie ważniejsza jest:

poprawna struktura produktów i wariantów w Katalogu.

Nazwę produktu zapisuj osobno od tytułu oferty

To również nie musi być dokładnie to samo.

Nazwa bazowa

Nike Pegasus 41

Dane

kolor: czarny
rozmiar: 43
płeć: mężczyzna

Tytuł oferty

Nike Pegasus 41 buty męskie czarne rozmiar 43

Dzięki temu możesz w przyszłości zmienić sposób tworzenia tytułów bez przebudowy całej kartoteki.

Jak przygotować tytuły ofert?

Aktualne zasady Allegro przewidują dla tytułu oferty maksymalnie 75 znaków, a minimalnie 12 znaków i trzy słowa. Allegro zaleca umieszczanie najważniejszych słów opisujących produkt na początku.

Nie warto wpisywać:

HIT SUPER PROMOCJA NAJTANIEJ !!! BUTY NIKE

Lepiej:

Nike Pegasus 41 buty do biegania męskie czarne 43

Tytuł powinien przede wszystkim jednoznacznie informować:

co klient kupuje.

Nie zapisuj marketingowych dodatków w głównej nazwie produktu

Zły rekord:

PROMOCJA!!! Super mocny blender XYZ NAJTANIEJ

Jeżeli później produkt trafi:

  • do Allegro,
  • sklepu,
  • faktury,
  • magazynu,
  • feedu reklamowego,

taka nazwa będzie problematyczna.

Lepsza nazwa bazowa:

Blender XYZ 1200 W

Informacje marketingowe powinny być tworzone niezależnie dla kanału sprzedaży.

Zdjęcia powinny być przypisane do konkretnego produktu lub wariantu

Wyobraźmy sobie:

produkt:

Kubek czerwony

a zdjęcie:

Kubek niebieski.

Nawet jeżeli model jest identyczny, dane są niespójne.

Allegro wykorzystuje zdjęcia również podczas weryfikacji zgodności oferty z produktem w Katalogu.

Dlatego baza powinna umożliwiać powiązanie:

SKU → właściwe zdjęcia.

Wybierz zdjęcie główne

Nie przechowuj tylko folderu:

produkt_123 / 25 zdjęć.

System powinien wiedzieć:

zdjęcie główne = 01

zdjęcie 2 = 02

zdjęcie 3 = 03

Dzięki temu przy automatycznym wystawianiu zachowana zostanie właściwa kolejność.

Pilnuj wymagań dotyczących zdjęć

Aktualne zasady Allegro wskazują między innymi, że dłuższy bok zdjęcia powinien mieć co najmniej 500 pikseli. W galerii konta firmowego w standardowych kategoriach można dodać do 16 zdjęć.

Warto więc już w bazie przechowywać zdjęcia o jakości wystarczającej dla marketplace.

Unikaj plików:

  • bardzo małych,
  • rozmytych,
  • przypadkowo skompresowanych,
  • zawierających niepotrzebne elementy.

Zdjęcia powinny zgadzać się z parametrami

Jeżeli parametr:

kolor = czerwony,

zdjęcie powinno przedstawiać czerwony wariant.

Jeżeli sprzedajesz:

opakowanie 10 sztuk,

grafika nie powinna sugerować, że klient otrzymuje 50 sztuk.

Spójność należy sprawdzać w całym rekordzie:

nazwa ↔ GTIN ↔ parametry ↔ zdjęcia ↔ opis.

Opis powinien być strukturą, nie ścianą HTML

Jeżeli baza będzie obsługiwać wiele kanałów sprzedaży, nie warto przechowywać wyłącznie jednego ogromnego opisu przygotowanego specjalnie pod sklep internetowy.

Lepiej posiadać elementy:

Krótki opis

1–3 zdania.

Najważniejsze zalety

Lista cech.

Opis główny

Rozwinięcie.

Dane techniczne

Strukturalne parametry.

Zawartość zestawu

Lista elementów.

Zastosowanie

Informacja, do czego przeznaczony jest produkt.

Na tej podstawie system może budować odpowiednią prezentację dla poszczególnych kanałów.

Opis musi być zgodny z konkretną ofertą

Allegro wymaga, aby opis dotyczył sprzedawanego produktu i był spójny między innymi z parametrami oraz zdjęciami. Nie należy w nim umieszczać przypadkowych słów kluczowych ani opisywać innych wariantów tylko w celu zwiększenia widoczności.

Dlatego nie twórz jednego opisu:

dostępne kolory: biały, czerwony, czarny, niebieski

jeżeli dana oferta dotyczy wyłącznie:

wariantu czarnego.

Zestawy i wielopaki oznacz jako osobne typy

Przykład:

Produkt jednostkowy

Szampon 500 ml

Wielopak

Szampon 500 ml × 3

Zestaw

Szampon + odżywka

To nie są identyczne oferty.

Baza powinna rozróżniać:

produkt pojedynczy

wielopak

zestaw.

W przypadku zestawu dobrze przechowywać również jego skład:

ZestawElementLiczba
ZESTAW-01SZAMPON-011
ZESTAW-01ODZYWKA-011

Dzięki temu można później prawidłowo aktualizować dostępność zestawu na podstawie stanów jego elementów.

Uważaj na jednostki sprzedaży

Produkt może być magazynowany:

1 sztuka

ale sprzedawany:

karton 12 sztuk.

Jeżeli system tego nie rozróżnia, po jednym zamówieniu może odjąć:

1 sztukę

zamiast:

12 sztuk.

W bazie warto przechowywać:

jednostka magazynowa

oraz:

przelicznik jednostki sprzedaży.

Przykład:

1 karton = 12 sztuk.

Cena powinna być oddzielona od danych opisowych

Nie wpisuj:

Kubek czerwony – 29,99 zł

jako nazwy produktu.

Cena jest zmienna.

Powinna znajdować się w osobnym polu.

To samo dotyczy:

  • promocji,
  • ceny minimalnej,
  • ceny Allegro,
  • ceny sklepowej.

Firma może przecież stosować inne ceny w różnych kanałach.

Zaprojektuj źródło prawdy dla ceny

Jeżeli produkt istnieje w:

  • ERP,
  • sklepie,
  • Allegro,
  • integratorze,

trzeba zdecydować:

który system jest nadrzędny?

Przykład:

ERP jest źródłem ceny bazowej, integrator ustala cenę Allegro według reguły.

Można wtedy zastosować:

cena Allegro = cena bazowa + prowizja/założona marża kanału

lub własny cennik.

Najgorszy model wygląda tak:

czasami zmieniamy cenę w ERP, czasami na Allegro, czasami w sklepie.

Po pewnym czasie nikt nie wie, która cena jest właściwa.

To samo dotyczy stanów magazynowych

Powinien istnieć jeden główny stan.

Przykładowo:

WMS → stan źródłowy

a następnie:

WMS → sklep

WMS → Allegro

WMS → inne marketplace'y.

Nie należy ręcznie zmieniać stanów w każdym miejscu, jeżeli system ma automatycznie je synchronizować.

Warto zastosować bufor magazynowy

Masz fizycznie:

10 sztuk.

Możesz jednak publikować na Allegro:

8 sztuk.

Bufor:

2 sztuki.

Pomaga to ograniczyć ryzyko oversellingu, szczególnie gdy kilka kanałów sprzedaży korzysta z tego samego magazynu.

Przykładowa reguła:

stan Allegro = max(stan dostępny – bufor, 0).

Nie wysyłaj do Allegro całego stanu fizycznego

Magazyn:

100 sztuk

z czego:

  • 20 zarezerwowanych,
  • 5 uszkodzonych,
  • 10 zablokowanych.

Stan możliwy do sprzedaży:

65 sztuk.

To właśnie dostępność, a nie fizyczna liczba na regale, powinna stanowić punkt wyjścia do synchronizacji.

Przygotuj pole VAT

Baza powinna przechowywać właściwe informacje podatkowe potrzebne przy sprzedaży i dokumentowaniu transakcji.

Nie zakładaj, że:

wszystkie produkty mają tę samą stawkę.

Jeżeli firma sprzedaje różne grupy towarów, stawki mogą się różnić.

Dane podatkowe powinny być przypisane do właściwej kartoteki produktu lub właściwej reguły podatkowej.

Produkty używane wymagają poprawnego stanu

Parametr:

Stan

nie jest dekoracją.

Nie należy wystawiać produktu używanego jako:

nowy,

tylko dlatego, że taka wartość poprawia sprzedaż.

Informacje w parametrach muszą odpowiadać rzeczywistemu przedmiotowi. Allegro wprost wskazuje, że błędne określenie stanu może naruszać zasady ofert.

Przy dużej bazie potrzebujesz walidatora

Wyobraźmy sobie import:

25 000 produktów.

Ręczne sprawdzenie wszystkich rekordów jest praktycznie niemożliwe.

System powinien automatycznie zgłaszać:

Błąd

brak SKU.

Błąd

powtórzony GTIN.

Ostrzeżenie

brak zdjęcia.

Błąd

brak wymaganej wartości parametru.

Ostrzeżenie

opis krótszy niż ustalone minimum.

Błąd

wariant nie posiada przypisanego produktu nadrzędnego.

Błąd

nieznana kategoria Allegro.

Wtedy człowiek zajmuje się wyjątkami zamiast sprawdzać ręcznie cały katalog.

Wprowadź status gotowości produktu

Bardzo praktyczne rozwiązanie:

Roboczy

produkt nie jest jeszcze kompletny.

Do uzupełnienia

brakuje wymaganych danych.

Gotowy do Allegro

przeszedł walidację.

Wystawiony

oferta jest aktywna.

Błąd

Allegro odrzuciło lub zakwestionowało dane.

Pozwala to szybko odpowiedzieć:

Ile produktów możemy dzisiaj wystawić?

zamiast:

Chyba większość jest już gotowa.

Minimalna walidacja przed publikacją

Dla każdego SKU sprawdź:

  • czy SKU jest unikalny,
  • czy GTIN jest prawidłowy, jeżeli jest wymagany lub dostępny,
  • czy marka jest właściwa,
  • czy model jest właściwy,
  • czy kod producenta jest właściwy,
  • czy produkt ma odpowiednią kategorię,
  • czy wymagane parametry są uzupełnione,
  • czy wariant posiada właściwe cechy,
  • czy zdjęcia dotyczą dokładnie tego produktu,
  • czy opis jest spójny,
  • czy cena jest ustawiona,
  • czy istnieje stan dostępny,
  • czy produkt został właściwie powiązany z Katalogiem Allegro.

Nie poprawiaj ręcznie tysięcy produktów na Allegro

To jeden z najczęstszych błędów organizacyjnych.

Schemat:

ERP → integracja → Allegro

ale następnie pracownik poprawia na Allegro:

  • tytuł,
  • parametry,
  • ceny,
  • zdjęcia.

Przy kolejnej synchronizacji integrator może nadpisać poprawki.

Albo odwrotnie:

zmiana pozostanie tylko na Allegro i baza źródłowa nadal będzie błędna.

Dobra zasada:

Jeżeli błąd dotyczy danych źródłowych produktu, popraw go w źródle.

Dzięki temu poprawka działa również przy kolejnym wystawieniu.

Warto prowadzić osobne mapowanie Allegro

Nie wszystkie pola w ERP muszą być identyczne z polami marketplace.

Można utworzyć warstwę:

dane źródłowe → mapowanie Allegro → oferta.

Przykład:

ERP:

kolor = granat

Allegro:

kolor = niebieski

Jeżeli Allegro w danej kategorii korzysta z określonego słownika, integrator może wykonać mapowanie automatycznie.

Nie zapisuj ID parametrów na sztywno bez kontroli zmian

Struktura kategorii i parametrów marketplace może się zmieniać.

Integracja powinna potrafić:

  • pobierać aktualne parametry,
  • wykrywać nowe wymagania,
  • informować o brakujących mapowaniach.

Nie warto zakładać:

skonfigurowaliśmy kategorię pięć lat temu, więc będzie działać zawsze.

Marketplace jest zewnętrznym systemem i jego model danych może ewoluować.

Jak przygotować arkusz produktów do pierwszego importu?

Jeżeli nie korzystasz jeszcze z PIM lub ERP, można rozpocząć od dobrze przygotowanego arkusza.

Przykładowe kolumny:

Pole
SKU
GTIN/EAN
Nazwa
Marka
Producent
Model
Kod producenta
Kategoria własna
ID kategorii Allegro
Produkt nadrzędny
Wariant
Kolor
Rozmiar
Materiał
Stan produktu
Cena
Stawka VAT
Stan magazynowy
Bufor
Zdjęcie 1
Zdjęcie 2
Zdjęcie 3
Opis krótki
Opis
ID produktu Allegro
ID oferty Allegro
Status

Dodatkowe parametry warto trzymać w osobnych kolumnach właściwych dla konkretnej kategorii.

Nie twórz jednej gigantycznej tabeli z 500 parametrami

Buty potrzebują innych pól niż:

  • telewizory,
  • kosmetyki,
  • opony,
  • części samochodowe.

Jeżeli katalog jest duży, można stworzyć:

Tabelę główną

Dane wspólne.

Tabelę kategorii

Mapowanie kategorii.

Tabelę parametrów

Parametry produktowe.

Tabelę zdjęć

Relacja produkt → zdjęcia.

Tabelę wariantów

Relacje między produktami.

Taki model jest bardziej elastyczny niż arkusz posiadający setki pustych kolumn.

PIM może być lepszy niż zwykły ERP

ERP świetnie przechowuje:

  • SKU,
  • ceny,
  • stany,
  • dokumenty,
  • koszty.

Nie każdy ERP dobrze nadaje się jednak do przechowywania:

  • wielu zdjęć,
  • rozbudowanych opisów,
  • danych marketingowych,
  • setek parametrów,
  • tłumaczeń.

Przy bardzo dużym katalogu można wykorzystać PIM:

Product Information Management.

Przykładowa architektura:

ERP → ceny i stany

PIM → dane produktowe

integrator → Allegro

Nie jest to jednak konieczne przy kilku czy kilkuset prostych produktach.

Jak podejść do bazy 10 000 produktów?

Nie zaczynaj od:

wystawiamy wszystko.

Najpierw wykonaj audyt.

Podziel katalog przykładowo:

Grupa A

produkty kompletne.

Grupa B

brak GTIN.

Grupa C

brak parametrów.

Grupa D

brak zdjęć.

Grupa E

duplikaty.

Grupa F

produkty wycofane.

Może się okazać, że z 10 000 kartotek:

6 800 jest gotowych,

2 000 wymaga prostego uzupełnienia,

700 wymaga pracy ze zdjęciami,

500 w ogóle nie powinno być wystawianych.

To znacznie bezpieczniejszy model wdrożenia.

Najpierw przetestuj kilkanaście produktów

Wybierz reprezentatywną próbkę:

  • prosty produkt,
  • produkt z wariantami,
  • produkt bez GTIN,
  • zestaw,
  • produkt z wieloma parametrami,
  • produkt o dużej liczbie zdjęć.

Dopiero po poprawnym przejściu całego procesu:

baza → integracja → Katalog → oferta → zamówienie → zmiana stanu

rozpoczynaj masowe wystawianie.

Test kończy się dopiero po zamówieniu

Samo pojawienie się oferty na Allegro nie oznacza, że integracja działa prawidłowo.

Wykonaj testowe zamówienie i sprawdź:

  1. czy zamówienie zostało pobrane,
  2. czy rozpoznano odpowiedni SKU,
  3. czy stan się zmniejszył,
  4. czy zmiana trafiła do pozostałych kanałów,
  5. czy cena jest prawidłowa,
  6. czy wariant jest właściwy,
  7. czy dokument sprzedaży zostanie utworzony dla odpowiedniego produktu.

Dopiero wtedy wiadomo, że cały obieg działa.

Najczęstsze błędy podczas przygotowywania bazy do Allegro

Jeden SKU dla kilku wariantów

Uniemożliwia precyzyjną synchronizację.

Niepoprawne EAN-y

Powodują problemy z identyfikacją produktu.

Wszystkie cechy zapisane w nazwie

System nie może ich łatwo mapować.

Brak kategorii Allegro

Każda oferta wymaga później ręcznej obsługi.

Tylko obowiązkowe parametry

Produkt jest słabiej opisany i trudniejszy do filtrowania.

Jeden opis dla wszystkich wariantów

Prowadzi do niespójności.

Zdjęcia różnych wersji produktu

Klient może nie wiedzieć, który wariant kupuje.

Brak źródła prawdy dla stanu

Powstaje overselling.

Ręczne zmiany na Allegro

Dane zaczynają się różnić od systemu źródłowego.

Brak przechowywania Allegro Product ID

Ten sam produkt jest wielokrotnie rozpoznawany od początku.

Brak walidacji przed importem

Błędy pojawiają się dopiero podczas masowego wystawiania.

Jak przygotować bazę produktów do Allegro krok po kroku?

Krok 1. Usuń duplikaty

Każdy rzeczywisty wariant powinien występować jednoznacznie.

Krok 2. Nadaj SKU

Jeden wariant = jeden SKU.

Krok 3. Uzupełnij GTIN

Tam, gdzie produkt posiada właściwy kod.

Krok 4. Rozbij dane na pola

Oddziel:

  • markę,
  • model,
  • kolor,
  • rozmiar,
  • materiał,
  • pozostałe cechy.

Krok 5. Uporządkuj warianty

Zbuduj relację:

produkt nadrzędny → warianty.

Krok 6. Zmapuj kategorie Allegro

Nie polegaj wyłącznie na nazwach własnych kategorii.

Krok 7. Pobierz wymagane parametry

Sprawdź je dla konkretnych kategorii.

Krok 8. Uzupełnij zdjęcia

Każde SKU powinno posiadać właściwe materiały.

Krok 9. Przygotuj opis

Opis powinien dotyczyć dokładnie sprzedawanego produktu.

Krok 10. Ustal źródło cen

Zdecyduj, skąd Allegro ma pobierać cenę.

Krok 11. Ustal źródło stanów

Najczęściej powinien to być ERP lub system magazynowy.

Krok 12. Zastosuj walidację

Produkt niespełniający kryteriów nie powinien zostać automatycznie wystawiony.

Krok 13. Powiąż z Katalogiem Allegro

Sprawdź, czy produkt już istnieje.

Krok 14. Zapisz identyfikatory Allegro

Product ID i Offer ID powinny wrócić do systemu.

Krok 15. Przetestuj zamówienie

Sprawdź pełny obieg.

Dopiero później skaluj wystawianie.

Przykład dobrze przygotowanego produktu

Załóżmy, że sprzedajesz buty.

Dane podstawowe

SKU: RUN-PEG41-BLK-43
GTIN: właściwy kod GTIN
Marka: Nike
Model: Pegasus 41
Kod producenta: XYZ
Typ: buty do biegania

Wariant

Kolor: czarny
Rozmiar: 43
Płeć: mężczyzna

Sprzedaż

Cena: 499
Stan: 14
Bufor: 2
Stan publikowany: 12

Allegro

Kategoria: przypisana
Parametry: kompletne
Produkt Allegro: powiązany
Oferta Allegro: wystawiona

Materiały

Zdjęcie główne: czarny wariant
Galeria: właściwy wariant
Opis: tylko produkt sprzedawany w tej ofercie

Taki rekord można bezpiecznie automatyzować.

Przykład złej bazy

PoleDane
Kod123
NazwaNike buty różne kolory promocja
EANbrak
Rozmiarw nazwie
Kolorw nazwie
Zdjęciawspólny folder
Stan200
Wariantybrak rozróżnienia

W magazynie faktycznie znajduje się:

  • 20 szt. rozmiaru 41,
  • 50 szt. rozmiaru 42,
  • 10 szt. rozmiaru 43,
  • kilka kolorów.

Takiej kartoteki nie należy „ratować” skomplikowaną integracją.

Najpierw trzeba poprawić dane.

Najważniejsza zasada

Automatyzuj dopiero uporządkowane dane.

Jeżeli baza jest dobra, integracja może automatycznie:

  • wystawiać produkty,
  • aktualizować ceny,
  • synchronizować stany,
  • pobierać zamówienia,
  • rozpoznawać warianty,
  • aktualizować oferty.

Jeżeli baza jest zła, automatyzacja będzie jedynie produkowała błędy na większą skalę.

Podsumowanie

Przygotowanie bazy produktów do Allegro powinno rozpocząć się jeszcze przed wystawieniem pierwszej oferty.

Podstawą jest jednoznaczne rozpoznawanie produktów.

Dlatego każdy wariant powinien posiadać:

SKU → GTIN → dane produktowe → kategorię → parametry → zdjęcia → opis.

Po połączeniu z Allegro dochodzą:

Allegro Product ID → Allegro Offer ID.

Najważniejsze jest zachowanie spójności.

Jeżeli baza mówi:

kolor czarny,

zdjęcie nie może przedstawiać wariantu czerwonego.

Jeżeli GTIN identyfikuje model 128 GB, opis nie może mówić o 256 GB.

Jeżeli w magazynie dostępnych jest pięć sztuk, Allegro nie powinno sprzedawać pięćdziesięciu.

Dobrze zaprojektowana baza produktowa pozwala przejść od ręcznego wystawiania pojedynczych aukcji do automatycznego zarządzania tysiącami ofert.

I właśnie dlatego przed rozpoczęciem dużej sprzedaży na marketplace warto zainwestować najpierw w:

jakość danych, a dopiero później w automatyzację.

FAQ – przygotowanie bazy produktów do Allegro

Jakie dane są najważniejsze przy przygotowaniu produktów do Allegro?

Minimum to jednoznaczny SKU, nazwa produktu, właściwy GTIN, jeżeli produkt go posiada, marka, model, kod producenta, kategoria, wymagane parametry, cena, stan, zdjęcia oraz opis. Zakres będzie zależał od kategorii.

Czy SKU i EAN to ten sam numer?

Nie. SKU jest wewnętrznym identyfikatorem używanym przez sprzedawcę. GTIN/EAN jest standardowym identyfikatorem produktu funkcjonującym na rynku.

Czy każdy wariant powinien mieć osobny SKU?

Tak. Jeżeli dwa warianty mają osobne stany magazynowe i można je niezależnie kupić, powinny być jednoznacznie rozpoznawane w systemie.

Czy każdy wariant musi mieć osobny EAN?

Jeżeli producent lub właściciel marki przypisał poszczególnym wariantom osobne numery GTIN, należy używać właściwego numeru dla każdego z nich.

Czy produkt musi mieć EAN, aby można było sprzedać go na Allegro?

Zależy to od produktu i kategorii. Nie należy jednak generować lub kopiować przypadkowego numeru wyłącznie po to, aby wypełnić pole. Jeżeli GTIN jest wymagany, powinien rzeczywiście identyfikować sprzedawany produkt.

Czy mogę mieć inną kategorię w ERP niż na Allegro?

Tak. Jest to normalna sytuacja. Najlepiej przechowywać własną kategorię oraz osobne mapowanie do konkretnej kategorii Allegro.

Czy warto uzupełniać nieobowiązkowe parametry?

Tak, jeżeli posiadasz wiarygodne dane. Parametry pomagają kupującym znaleźć i porównać produkty oraz korzystać z filtrów.

Czy parametry Allegro są takie same dla każdej kategorii?

Nie. Zestaw parametrów zależy od kategorii produktu.

Czy nazwa produktu musi być taka sama jak tytuł oferty?

Nie. W bazie warto posiadać stabilną nazwę produktu oraz niezależnie generować tytuł dostosowany do Allegro.

Ile znaków może mieć tytuł oferty Allegro?

Obecnie tytuł może mieć maksymalnie 75 znaków. Musi mieć co najmniej 12 znaków i trzy słowa.

Czy można wpisywać w tytule „promocja”, „hit” albo „najtaniej”?

Allegro odradza i ogranicza tego rodzaju marketingowe dodatki w tytułach. Tytuł powinien przede wszystkim jednoznacznie opisywać sprzedawany przedmiot.

Ile zdjęć mogę dodać do oferty?

Na koncie firmowym w standardowych kategoriach Allegro umożliwia obecnie dodanie do 16 zdjęć. Szczegółowe wymagania mogą zależeć od rodzaju oferty i kategorii.

Czy zdjęcie musi przedstawiać konkretny wariant?

Powinno być zgodne z oferowanym przedmiotem. Jeżeli oferta dotyczy wariantu czarnego, zdjęcie nie powinno sugerować, że klient otrzyma czerwony.

Czy mogę stworzyć jeden opis dla wszystkich kolorów?

Jeżeli poszczególne kolory są osobnymi produktami lub ofertami, opis powinien odpowiadać dokładnie temu wariantowi, którego dotyczy dana oferta.

Co to jest Katalog produktów Allegro?

To baza produktów wykorzystywana przez Allegro do grupowania i identyfikowania towarów. Zawiera między innymi parametry, zdjęcia oraz inne dane produktowe.

Czy należy zapisywać ID produktu Allegro w ERP lub integratorze?

Tak. Jeżeli system to umożliwia, zapisanie powiązania pomiędzy własnym SKU a identyfikatorem produktu Allegro ogranicza konieczność ponownego wyszukiwania i dopasowywania tego samego produktu.

Czy Product ID i Offer ID oznaczają to samo?

Nie. Product ID identyfikuje produkt w Katalogu, natomiast Offer ID konkretną ofertę sprzedaży.

Jak obecnie działają warianty na Allegro?

Allegro tworzy warianty produktowe automatycznie na podstawie Katalogu produktów i parametrów charakterystycznych dla danej kategorii. Stare mechanizmy API służące do samodzielnego zarządzania ofertami wielowariantowymi zostały wyłączone 14 kwietnia 2026 r.

Skąd Allegro powinno pobierać stan magazynowy?

Najlepiej z jednego ustalonego systemu źródłowego, np. ERP lub WMS. Stan publikowany powinien uwzględniać rezerwacje, blokady i ewentualny bufor bezpieczeństwa.

Czy warto stosować bufor stanów?

Przy sprzedaży wielokanałowej często jest to dobre rozwiązanie. Zmniejsza ryzyko sprzedaży ostatnich sztuk jednocześnie w kilku kanałach.

Czy Excel wystarczy do przygotowania bazy?

Przy kilkuset produktach może wystarczyć dobrze zaprojektowany arkusz. Przy dziesiątkach tysięcy produktów, wielu parametrach, wariantach i zdjęciach wygodniejszy może być ERP, PIM lub dedykowany system zarządzania produktami.

Co zrobić przed masowym wystawieniem produktów?

Najpierw przetestuj kilka reprezentatywnych produktów i cały obieg – od importu danych aż po testowe zamówienie oraz zmniejszenie stanu magazynowego.

Jaki jest największy błąd podczas przygotowywania bazy do Allegro?

Próba automatyzowania nieuporządkowanych danych. Jeśli SKU się powtarzają, GTIN-y są błędne, warianty nie są rozdzielone, a parametry znajdują się wyłącznie w opisach, integracja nie naprawi bazy. Jedynie przeniesie jej problemy do Allegro.

Wystawiaj faktury zgodne z KSeF

Załóż darmowe konto w fakturbox i zacznij w kilka minut.