Integracja hurtowni dropshippingowej z Allegro krok po kroku

Import z hurtowni przez XML lub API, kody EAN, auto-listing i reguły cen decydują o tym, czy dropshipping na Allegro zarabia, czy generuje reklamacje. Oto jak poukładać integrację od strony technicznej.

Integracja hurtowni dropshippingowej z Allegro — na czym naprawdę polega

W skrócie: integracja hurtowni dropshippingowej z Allegro to automatyczny przepływ danych między katalogiem dostawcy a Twoim kontem sprzedażowym. Z hurtowni pobierasz plik XML/CSV albo łączysz się przez API, a system po Twojej stronie zamienia te dane w oferty Allegro, pilnuje stanów magazynowych, aktualizuje ceny i — po sprzedaży — przekazuje zamówienie do realizacji przez dostawcę. Ty nie dotykasz towaru; sterujesz danymi.

Brzmi prosto, ale cały model stoi na czterech filarach, które łatwo zepsuć: poprawnym imporcie danych, kodach EAN (GTIN), regułach cenowych i częstotliwości synchronizacji. Jeśli którykolwiek zawiedzie, efekt jest ten sam — niewidoczne oferty, sprzedaż ze stratą albo zamówienia, których nie da się zrealizować. Ten artykuł rozkłada każdy z filarów na czynniki pierwsze, z konkretami, których zwykle brakuje w poradnikach typu „załóż konto i sprzedawaj”.

Import danych: plik XML/CSV czy API — co wybrać

Hurtownie dropshippingowe udostępniają dane produktowe na dwa sposoby. Pierwszy to plik XML lub CSV — jeden adres URL, pod którym dostawca publikuje pełny katalog: nazwy, opisy, zdjęcia, ceny hurtowe, stany magazynowe i (w dobrym pliku) kody EAN oraz parametry. Drugi to API — interfejs, przez który Twój system odpytuje hurtownię o konkretne dane w czasie zbliżonym do rzeczywistego.

W praktyce oba modele robią to samo — różnią się świeżością danych i tym, jak szybko zareagują na wyczerpanie stanu. Poniższa tabela pokazuje, kiedy który ma sens.

Wniosek jest prosty: przy asortymencie o wolnej rotacji plik XML w zupełności wystarczy. Przy szybko schodzącym towarze i wielu sprzedawcach tej samej hurtowni różnica kilkudziesięciu minut w aktualizacji stanu potrafi oznaczać zamówienie na produkt, którego już nie ma. Niezależnie od metody kluczowe jest jedno pytanie do dostawcy: jak często i w jaki sposób aktualizuje stany — bo integracja jest tak dobra, jak dane, które dostaje na wejściu.

Zanim podłączysz plik — sprawdź jego jakość

Zły plik źródłowy to najczęstsza, a zarazem najbardziej lekceważona przyczyna problemów. Zanim uruchomisz masowy import, przejrzyj kilka rekordów i odpowiedz sobie na pytania:

• Czy każdy produkt ma kod EAN i czy jest to realny GTIN, a nie wewnętrzny numer katalogowy hurtowni?
• Czy warianty (rozmiar, kolor) mają osobne kody EAN, czy jeden EAN na całą rodzinę?
• Czy w pliku jest cena hurtowa (netto) i osobno sugerowana cena detaliczna?
• Czy pole „stan” to liczba sztuk, czy tylko status „dostępny/niedostępny”?
• Czy zdjęcia są linkami do plików, które da się pobrać, a nie miniaturami zablokowanymi hotlinkiem?

Jeśli plik nie odpowiada twierdząco na te pytania, żadna integracja tego nie naprawi — będzie tylko wierniej przenosić błędy na Allegro.

Kody EAN (GTIN) — najczęstsze źródło zablokowanych ofert

Od 1 lipca 2024 roku Allegro wymaga powiązania 100% ofert w większości kategorii z Katalogiem Produktów (tzw. produktyzacja). Oferta, która nie zostanie powiązana z katalogiem, przestaje być widoczna dla kupujących w wynikach wyszukiwania, a z czasem zostaje automatycznie zamknięta. W praktyce to właśnie kod EAN (GTIN) jest kluczem, który łączy Twoją ofertę z kartą produktu w katalogu — dlatego błędy w EAN są w dropshippingu problemem numer jeden.

Allegro traktuje EAN (GTIN) jako „unikalny, globalnie rozpoznawalny numer produktu składający się z 8 do 14 cyfr”. Platforma weryfikuje między innymi, czy pierwsze cyfry numeru (tzw. prefiks) są zgodne z wymaganiami organizacji GS1 — jedynego podmiotu uprawnionego do nadawania kodów GTIN. Jeśli podasz numer nieistniejący, zarezerwowany albo będący wewnętrznym numerem dystrybucyjnym, Allegro zablokuje wystawienie, wznowienie lub edycję oferty i pokaże, dlaczego wartość jest niepoprawna.

Trzy typowe błędy EAN w imporcie z hurtowni

Warto pamiętać, że nie każda kategoria wymaga EAN. Kody GTIN są obowiązkowe w około połowie kategorii (orientacyjnie — zawsze sprawdź aktualny wykaz w pomocy Allegro), głównie dla produktów fabrycznie nowych. Wyłączone bywają kategorie z rękodziełem, antykami, produktami używanymi czy personalizowanymi, które z natury nie mają fabrycznego numeru. W dropshippingu jednak niemal cały asortyment jest nowy i markowy, więc de facto EAN staje się wymogiem.

Zasada praktyczna: EAN to nie formalność, tylko klucz automatyzacji. Jeden błędny numer potrafi wygenerować niewidoczną ofertę, błędne dopasowanie karty i zamówienie, którego nie zrealizujesz. Walidację EAN rób przed wystawieniem, nie po pierwszej reklamacji.

Auto-listing — jak wystawiać oferty automatycznie i bezpiecznie

Auto-listing to funkcja, dzięki której nowe produkty z pliku hurtowni od razu stają się ofertami Allegro, a integrator pobiera parametry i przypisuje kartę produktu z katalogu na podstawie EAN. Kiedy stan spada do zera, oferta jest wygaszana; po uzupełnieniu zapasu — wznawiana. Brzmi jak święty Graal skalowania, ale bez zdroworozsądkowych bezpieczników potrafi wystawić kilka tysięcy słabych ofert w kwadrans.

Zanim włączysz masowe wystawianie, ustaw filtry i reguły:

• Filtr dostępności — wystawiaj tylko produkty ze stanem powyżej progu (np. 3–5 szt.), by nie tworzyć ofert na końcówki.
• Filtr marży — pomijaj pozycje, na których po prowizji i kosztach wysyłki marża spada poniżej ustalonego minimum.
• Mapowanie kategorii — sprawdź, czy kategoria z pliku hurtowni trafia w odpowiednią kategorię Allegro; złe mapowanie to złe parametry i odrzucenia.
• Kontrola jakości opisu — usuwaj z opisów linki, dane kontaktowe hurtowni i sformułowania łamiące regulamin Allegro.

Dobrą praktyką jest start pilotażowy: wystaw najpierw kilkadziesiąt produktów, zweryfikuj, jak wyglądają karty i parametry, a dopiero potem otwieraj integrację na cały katalog. Ta sama logika automatyzacji przydaje się później po stronie realizacji — jak ją poukładać, opisujemy w tekście o automatyzacji zamówień w e-commerce.

Reguły cen — jak liczyć marżę i nie sprzedawać ze stratą

W dropshippingu cena sprzedaży rzadko jest wartością wpisaną ręcznie — częściej to reguła nakładana na cenę hurtową. I tu popełnia się najkosztowniejszy błąd: liczenie marży od ceny zakupu bez uwzględnienia prowizji Allegro i kosztu wysyłki. Efekt to pozornie zyskowna oferta, która realnie dokłada do interesu.

Prowizja Allegro zależy od kategorii i wynosi orientacyjnie od kilku do kilkunastu procent (w praktyce najczęściej w przedziale ok. 2,5–20%; dokładną stawkę dla swojej kategorii sprawdź w cenniku Allegro). Do tego dochodzą koszty wysyłki oraz ewentualne pakiety promocyjne. Dlatego regułę cenową buduj zawsze od ceny minimalnej — poniżej której nie schodzisz, choćby konkurencja zjeżdżała w dół.

Dopiero suma tych składników wyznacza próg, poniżej którego reguła cenowa nie może zejść. Prowizje potrafią zaskoczyć — jeśli chcesz je policzyć dokładnie, zajrzyj do zestawienia prowizji Allegro w 2026 roku.

Repricing i reguły cenowe Allegro

Allegro udostępnia własny mechanizm automatycznego zarządzania cenami. Do dyspozycji masz między innymi regułę „Najniższa cena na Allegro” (dopasowuje cenę do aktualnie najniższej oferty danego produktu, sprawdzanej co godzinę), regułę „Top oferta” oraz „Przelicznik cen” dla rynków zagranicznych, działający na bazie kursów Europejskiego Banku Centralnego. Możesz utworzyć maksymalnie 20 własnych reguł opartych na typach domyślnych.

Każda reguła typu „najniższa cena” wymaga podania zakresu cen — minimalnej i maksymalnej. To właśnie dolna granica chroni Cię przed sprzedażą ze stratą, gdy inni sprzedawcy tej samej hurtowni ruszają wojnę cenową. Reguły nie działają w ofertach objętych kampaniami wpływającymi na cenę (np. AlleObniżka, Allegro Ceny, Smart! Week), o czym warto pamiętać przy planowaniu promocji. Dodatkowo od 18 lutego 2026 roku mechanizm automatycznego Przelicznika cen uruchamia się w pełni automatycznie dla sprzedawców, którzy mają włączoną tę regułę (szczegóły i warunki abonamentowe warto potwierdzić w pomocy Allegro).

MAP i ograniczenia prawne przy narzucaniu cen

Część hurtowni oczekuje utrzymywania minimalnej ceny reklamowanej (MAP). W Polsce stosowanie MAP w ramach umowy producent–dystrybutor jest dopuszczalne, ale podlega prawu ochrony konkurencji. Producent nie może narzucić sztywnej ceny odsprzedaży ani zakazać Ci obniżek — takie ustalenia mogą zostać uznane za niedozwolone porozumienie cenowe (RPM). Sugerowana cena i minimalna cena reklamowa to co innego niż zakaz repricingu. Jeśli hurtownia wymusza sztywną cenę pod groźbą odcięcia dostaw, warto to skonsultować, zamiast bezrefleksyjnie wpisywać ją do reguły.

Synchronizacja stanów i cen — częstotliwość, która ratuje reputację

Najgroźniejszy scenariusz w dropshippingu na Allegro to overselling — sprzedaż produktu, którego hurtownia już nie ma. Kończy się anulowaniem zamówienia, obniżeniem oceny sprzedawcy i, przy powtórzeniach, ograniczeniami konta. Jedyną realną obroną jest częsta i niezawodna synchronizacja stanów.

Nowoczesne integracje odświeżają stany orientacyjnie co 15–60 minut, a przy asortymencie o wysokiej rotacji warto celować w górną częstotliwość. Sprawdź trzy rzeczy: jak często integrator pobiera dane z hurtowni, jak szybko zamyka ofertę po spadku stanu do zera oraz co się dzieje, gdy plik hurtowni chwilowo nie odpowiada (dobry system nie „zeruje” wtedy wszystkich stanów). Mechanikę i pułapki opisaliśmy szerzej w tekstach o synchronizacji stanów magazynowych oraz o tym, jak uniknąć oversellingu.

Gdy sprzedajesz z jednej hurtowni jednocześnie na Allegro i we własnym sklepie, dochodzi kolejna warstwa: te same stany muszą schodzić w obu kanałach. To już temat spójności całego magazynu w modelu wielokanałowym — więcej w poradniku o integracji Allegro i o łączeniu Allegro z magazynem.

Checklista wdrożenia integracji hurtownia → Allegro

Zanim otworzysz integrację na pełny katalog, przejdź tę listę:

1. Potwierdź z hurtownią sposób i częstotliwość aktualizacji danych (XML/CSV vs API).
2. Zweryfikuj jakość pliku: EAN, warianty, ceny netto, realne liczby stanów, pobieralne zdjęcia.
3. Sprawdź, które Twoje kategorie wymagają EAN (GTIN) i czy każdy produkt ma poprawny, unikalny numer.
4. Zmapuj kategorie hurtowni na kategorie Allegro i zweryfikuj wymagane parametry.
5. Ustaw regułę cenową od ceny minimalnej: cena hurtowa + prowizja + wysyłka + marża + bufor na zwroty.
6. Skonfiguruj filtry auto-listingu (próg stanu, minimalna marża, kontrola opisu).
7. Ustaw synchronizację stanów tak często, jak pozwala hurtownia, i zabezpiecz zachowanie przy braku pliku.
8. Zrób pilotaż na kilkudziesięciu produktach, sprawdź karty i parametry, dopiero potem skaluj.

W miarę jak model dojrzewa, warto myśleć o integracji jako o jednym panelu, który spina hurtownię, marketplace, stany i realizację zamówień — dokładnie w tym kierunku idą narzędzia nowej generacji, jak przygotowywany integrator Nimo. Ale nawet najlepsze narzędzie nie zastąpi porządku w danych źródłowych: to od jakości pliku hurtowni zależy, czy automatyzacja zarabia, czy tylko szybciej powiela błędy.

Najczęstsze pytania

Czy do dropshippingu na Allegro muszę mieć własne kody EAN?

Nie nadajesz ich sam — poprawne kody EAN (GTIN) dostarcza producent lub hurtownia, a jedyną uprawnioną organizacją do ich wydawania jest GS1. Twoim zadaniem jest zadbać, by w pliku importu każdy produkt (a przy wariantach każdy wariant) miał poprawny, unikalny numer. W kategoriach objętych produktyzacją bez tego oferta nie zostanie powiązana z katalogiem i stanie się niewidoczna.

Jak często powinny aktualizować się stany magazynowe?

Im częściej, tym mniejsze ryzyko oversellingu. Orientacyjnie nowoczesne integracje odświeżają stany co 15–60 minut; przy szybko rotującym towarze celuj w górną częstotliwość. Kluczowe jest też, jak szybko integrator zamyka ofertę po spadku stanu do zera oraz jak zachowuje się, gdy plik hurtowni chwilowo nie odpowiada.

Czy hurtownia może narzucić mi sztywną cenę sprzedaży na Allegro?

Może zasugerować cenę i ustalić minimalną cenę reklamowaną (MAP), ale w świetle polskiego prawa ochrony konkurencji nie może zakazać Ci obniżek ani narzucić sztywnej ceny odsprzedaży — takie porozumienie może być uznane za niedozwolone. Jeśli dostawca wymusza sztywną cenę pod groźbą odcięcia dostaw, warto to zweryfikować prawnie.

Plik XML czy API — co jest lepsze dla dropshippingu?

Dla asortymentu o wolnej rotacji wystarczy plik XML/CSV. Przy szybko schodzącym towarze i wielu sprzedawcach tej samej hurtowni API zwykle zapewnia świeższe dane i mniejsze ryzyko rozjazdu stanów. Ostatecznie liczy się jednak to, jak często sama hurtownia aktualizuje dane u źródła.

Dlaczego moje oferty z importu są niewidoczne na Allegro?

Najczęstsza przyczyna to brak powiązania z Katalogiem Produktów, czyli w praktyce błędny lub brakujący EAN (GTIN). Od 1 lipca 2024 roku oferty w większości kategorii muszą być powiązane z katalogiem, inaczej znikają z wyników i z czasem są zamykane. Sprawdź, czy EAN jest poprawny, unikalny i zgodny z prefiksem GS1.