Integracja Shopera z hurtownią – import XML i automatyczna aktualizacja stanów

Mateusz Piotrowicz
Mateusz Piotrowicz
Technical & Logistics Expert
Integracja Shopera z hurtownią – import XML i automatyczna aktualizacja stanów

Integracja Shopera z hurtownią pozwala sprzedawać tysiące produktów bez ręcznego dodawania każdej karty i bez codziennego przepisywania cen oraz stanów magazynowych. Hurtownia udostępnia plik XML lub CSV z ofertą, a integrator regularnie go pobiera, dodaje Twoją marżę i aktualizuje produkty w sklepie. Dzięki temu klient widzi aktualną dostępność, a Ty nie sprzedajesz towaru, którego dostawca już nie ma. To fundament modelu dropshipping, ale też wygodne rozwiązanie dla sklepów, które kupują towar na magazyn od kilku dostawców.
W tym poradniku wyjaśniamy, jak działa import XML z hurtowni, jakie są sposoby połączenia Shopera z dostawcą, jak skonfigurować marże, filtry i przedziały stanów, o czym pamiętać przy współpracy z hurtownią i jakich błędów unikać. Opis opieramy na pomocy Shopera i dokumentacji integracji aktualnej w październiku 2026 r. Funkcje i ceny poszczególnych aplikacji się zmieniają, dlatego przed wyborem sprawdź ich aktualne warunki w App Store Shopera.
Jak działa integracja sklepu z hurtownią
Każda integracja z hurtownią opiera się na tym samym schemacie. Hurtownia publikuje plik z bazą produktów – najczęściej pod stałym adresem internetowym – i regularnie go aktualizuje. Integrator pobiera ten plik, odczytuje z niego dane i przenosi je do sklepu: tworzy nowe produkty, zmienia ceny, aktualizuje stany i ukrywa pozycje, które zniknęły z oferty dostawcy.
Plik produktowy – zawiera kody produktów, nazwy, opisy, ceny hurtowe, stany magazynowe, zdjęcia, kategorie i producentów.
Format – zwykle XML, rzadziej CSV; część hurtowni udostępnia też dane przez API.
Schemat – układ znaczników w pliku; popularne są m.in. schemat Ceneo i schemat IOF, ale wiele hurtowni ma własne formaty.
Częstotliwość aktualizacji – od kilku razy dziennie po raz na dobę; od niej zależy, jak aktualne będą stany w Twoim sklepie.
Integrator – aplikacja lub system, który łączy plik z Shoperem i wykonuje aktualizacje według harmonogramu.
Wykres – droga danych z pliku hurtowni do produktów w sklepie Shoper. [#chart:sh18]
Jeśli masz jednorazowo do dodania listę produktów, nie potrzebujesz od razu integracji. Wystarczy import z pliku CSV opisany w artykule import produktów do Shopera z pliku CSV. Integracja ma sens wtedy, gdy ceny i stany u dostawcy zmieniają się regularnie, a Ty chcesz, żeby sklep nadążał za nimi bez ręcznej pracy.
Sposoby połączenia Shopera z hurtownią
Integrację z hurtowniami w Shoperze zapewniają przede wszystkim aplikacje z App Store i zewnętrzne systemy do zarządzania sprzedażą. Pomoc Shopera prowadzi też wykaz dostępnych integracji z hurtowniami. Wybór zależy od tego, z iloma dostawcami współpracujesz, czy sprzedajesz także na marketplace’ach i jak bardzo nietypowe są pliki Twoich hurtowni.
Sposób | Jak działa | Dla kogo |
Aplikacja integracyjna z App Store | Instalujesz aplikację w panelu i wybierasz hurtownię z listy obsługiwanych dostawców | Sklep z jedną lub kilkoma hurtowniami, sprzedaż głównie w sklepie |
Apilo | Hurtownie podłączasz w module Towary i usługi > Hurtownie, produkty trafiają do Shopera i innych kanałów | Sprzedaż w sklepie i na marketplace’ach, kilka hurtowni |
Base | Pliki hurtowni importujesz do magazynu Base, który synchronizuje się z Shoperem | Firmy z wieloma kanałami sprzedaży i rozbudowanymi automatyzacjami |
Import CSV w panelu | Ręczny import i aktualizacja produktów profilem CSV | Mały katalog, rzadkie zmiany cen i stanów |
Integracja dedykowana | Skrypt programisty korzystający z API Shopera | Nietypowe pliki, specyficzne reguły, duży katalog |
Wykres – najczęstsze sposoby połączenia sklepu z dostawcą. [#chart:sh18b]
Aplikacje z App Store Shopera
W App Store znajdziesz kilka aplikacji do integracji z hurtowniami – zarówno ogólne, obsługujące długą listę dostawców, jak i dedykowane konkretnym hurtowniom. Przykładem z pomocy Shopera jest aplikacja Integracja z hurtowniami ASI VeroSoft: instalujesz ją w zakładce Dodatki i integracje > Aplikacje, wybierasz wersję miesięczną lub roczną, a po instalacji konfigurujesz połączenie w zakładce Moje aplikacje według instrukcji w trzech krokach (szczegóły w artykule pomocy Integracja z hurtowniami ASI VeroSoft). Większość aplikacji integracyjnych to płatne abonamenty, więc ich koszt dolicz do budżetu sklepu – ogólne zasady opisaliśmy w artykule ile kosztuje sklep na Shoperze.
Według pomocy Shopera aplikacja Integracja z hurtowniami w pakiecie z Apilo obsługuje import danych z plików XML i CSV oraz przez API, modyfikowanie cen o stałą wartość lub procent, przenoszenie kategorii z pliku, ograniczanie pobierania według minimalnego stanu, przedziału cenowego, kategorii lub producentów, a także zamianę stanów na ustalone przedziały. Import może być wykonywany dwa lub trzy razy dziennie – szczegóły zależą od wersji aplikacji.
Apilo
Apilo to system do zarządzania sprzedażą wielokanałową, z którym Shoper ma gotową integrację. Hurtownie podłączasz w zakładce Towary i usługi > Hurtownie: wybierasz kafelek dostawcy, wklejasz ścieżkę do pliku XML lub CSV otrzymaną od hurtowni i ustawiasz reguły importu. Produkty trafiają najpierw do magazynu Apilo, a stamtąd do Shopera i na inne kanały, np. Allegro. Jeśli hurtowni nie ma na liście, pomoc Shopera wskazuje, że plik w schemacie Ceneo lub IOF podłączysz bez dodatkowych opłat, a w innych przypadkach można zamówić odpłatne podłączenie. Opis znajdziesz w artykule pomocy integracja Apilo z hurtowniami.
Shoper oferuje też aplikację Pakiet 3 Hurtownie – Apilo. Według opisu w pomocy obejmuje ona możliwość podpięcia trzech hurtowni spośród ponad 200 dostawców, nielimitowaną liczbę kanałów sprzedaży, do 50 000 ofert, do 500 zamówień miesięcznie i dwóch użytkowników. Limity i cenę sprawdź w App Store przed zakupem, bo mogą się zmienić.
Base
Jeśli już korzystasz z Base albo planujesz sprzedaż w wielu kanałach, hurtownie możesz podłączyć bezpośrednio w Base, a Shopera połączyć z Base jako jeden ze sklepów. Konfigurację połączenia sklepu opisaliśmy w artykule integracja Shopera z Base, a sam import plików od dostawców – w tekście integracja hurtowni z BaseLinkerem.
Integracja Shopera z hurtownią pozwala sprzedawać tysiące produktów bez ręcznego dodawania każdej karty i bez codziennego przepisywania cen oraz stanów magazynowych. Hurtownia udostępnia plik XML lub CSV z ofertą, a integrator regularnie go pobiera, dodaje Twoją marżę i aktualizuje produkty w sklepie. Dzięki temu klient widzi aktualną dostępność, a Ty nie sprzedajesz towaru, którego dostawca już nie ma. To fundament modelu dropshipping, ale też wygodne rozwiązanie dla sklepów, które kupują towar na magazyn od kilku dostawców.
W tym poradniku wyjaśniamy, jak działa import XML z hurtowni, jakie są sposoby połączenia Shopera z dostawcą, jak skonfigurować marże, filtry i przedziały stanów, o czym pamiętać przy współpracy z hurtownią i jakich błędów unikać. Opis opieramy na pomocy Shopera i dokumentacji integracji aktualnej w październiku 2026 r. Funkcje i ceny poszczególnych aplikacji się zmieniają, dlatego przed wyborem sprawdź ich aktualne warunki w App Store Shopera.
Jak działa integracja sklepu z hurtownią
Każda integracja z hurtownią opiera się na tym samym schemacie. Hurtownia publikuje plik z bazą produktów – najczęściej pod stałym adresem internetowym – i regularnie go aktualizuje. Integrator pobiera ten plik, odczytuje z niego dane i przenosi je do sklepu: tworzy nowe produkty, zmienia ceny, aktualizuje stany i ukrywa pozycje, które zniknęły z oferty dostawcy.
Plik produktowy – zawiera kody produktów, nazwy, opisy, ceny hurtowe, stany magazynowe, zdjęcia, kategorie i producentów.
Format – zwykle XML, rzadziej CSV; część hurtowni udostępnia też dane przez API.
Schemat – układ znaczników w pliku; popularne są m.in. schemat Ceneo i schemat IOF, ale wiele hurtowni ma własne formaty.
Częstotliwość aktualizacji – od kilku razy dziennie po raz na dobę; od niej zależy, jak aktualne będą stany w Twoim sklepie.
Integrator – aplikacja lub system, który łączy plik z Shoperem i wykonuje aktualizacje według harmonogramu.
Wykres – droga danych z pliku hurtowni do produktów w sklepie Shoper. [#chart:sh18]
Jeśli masz jednorazowo do dodania listę produktów, nie potrzebujesz od razu integracji. Wystarczy import z pliku CSV opisany w artykule import produktów do Shopera z pliku CSV. Integracja ma sens wtedy, gdy ceny i stany u dostawcy zmieniają się regularnie, a Ty chcesz, żeby sklep nadążał za nimi bez ręcznej pracy.
Sposoby połączenia Shopera z hurtownią
Integrację z hurtowniami w Shoperze zapewniają przede wszystkim aplikacje z App Store i zewnętrzne systemy do zarządzania sprzedażą. Pomoc Shopera prowadzi też wykaz dostępnych integracji z hurtowniami. Wybór zależy od tego, z iloma dostawcami współpracujesz, czy sprzedajesz także na marketplace’ach i jak bardzo nietypowe są pliki Twoich hurtowni.
Sposób | Jak działa | Dla kogo |
Aplikacja integracyjna z App Store | Instalujesz aplikację w panelu i wybierasz hurtownię z listy obsługiwanych dostawców | Sklep z jedną lub kilkoma hurtowniami, sprzedaż głównie w sklepie |
Apilo | Hurtownie podłączasz w module Towary i usługi > Hurtownie, produkty trafiają do Shopera i innych kanałów | Sprzedaż w sklepie i na marketplace’ach, kilka hurtowni |
Base | Pliki hurtowni importujesz do magazynu Base, który synchronizuje się z Shoperem | Firmy z wieloma kanałami sprzedaży i rozbudowanymi automatyzacjami |
Import CSV w panelu | Ręczny import i aktualizacja produktów profilem CSV | Mały katalog, rzadkie zmiany cen i stanów |
Integracja dedykowana | Skrypt programisty korzystający z API Shopera | Nietypowe pliki, specyficzne reguły, duży katalog |
Wykres – najczęstsze sposoby połączenia sklepu z dostawcą. [#chart:sh18b]
Aplikacje z App Store Shopera
W App Store znajdziesz kilka aplikacji do integracji z hurtowniami – zarówno ogólne, obsługujące długą listę dostawców, jak i dedykowane konkretnym hurtowniom. Przykładem z pomocy Shopera jest aplikacja Integracja z hurtowniami ASI VeroSoft: instalujesz ją w zakładce Dodatki i integracje > Aplikacje, wybierasz wersję miesięczną lub roczną, a po instalacji konfigurujesz połączenie w zakładce Moje aplikacje według instrukcji w trzech krokach (szczegóły w artykule pomocy Integracja z hurtowniami ASI VeroSoft). Większość aplikacji integracyjnych to płatne abonamenty, więc ich koszt dolicz do budżetu sklepu – ogólne zasady opisaliśmy w artykule ile kosztuje sklep na Shoperze.
Według pomocy Shopera aplikacja Integracja z hurtowniami w pakiecie z Apilo obsługuje import danych z plików XML i CSV oraz przez API, modyfikowanie cen o stałą wartość lub procent, przenoszenie kategorii z pliku, ograniczanie pobierania według minimalnego stanu, przedziału cenowego, kategorii lub producentów, a także zamianę stanów na ustalone przedziały. Import może być wykonywany dwa lub trzy razy dziennie – szczegóły zależą od wersji aplikacji.
Apilo
Apilo to system do zarządzania sprzedażą wielokanałową, z którym Shoper ma gotową integrację. Hurtownie podłączasz w zakładce Towary i usługi > Hurtownie: wybierasz kafelek dostawcy, wklejasz ścieżkę do pliku XML lub CSV otrzymaną od hurtowni i ustawiasz reguły importu. Produkty trafiają najpierw do magazynu Apilo, a stamtąd do Shopera i na inne kanały, np. Allegro. Jeśli hurtowni nie ma na liście, pomoc Shopera wskazuje, że plik w schemacie Ceneo lub IOF podłączysz bez dodatkowych opłat, a w innych przypadkach można zamówić odpłatne podłączenie. Opis znajdziesz w artykule pomocy integracja Apilo z hurtowniami.
Shoper oferuje też aplikację Pakiet 3 Hurtownie – Apilo. Według opisu w pomocy obejmuje ona możliwość podpięcia trzech hurtowni spośród ponad 200 dostawców, nielimitowaną liczbę kanałów sprzedaży, do 50 000 ofert, do 500 zamówień miesięcznie i dwóch użytkowników. Limity i cenę sprawdź w App Store przed zakupem, bo mogą się zmienić.
Base
Jeśli już korzystasz z Base albo planujesz sprzedaż w wielu kanałach, hurtownie możesz podłączyć bezpośrednio w Base, a Shopera połączyć z Base jako jeden ze sklepów. Konfigurację połączenia sklepu opisaliśmy w artykule integracja Shopera z Base, a sam import plików od dostawców – w tekście integracja hurtowni z BaseLinkerem.
- Przegląd sklepu, szablonu i konfiguracji
- Integracje z marketplace'ami, płatnościami i wysyłką
- Plan zwiększenia konwersji sklepu
Konfiguracja importu z hurtowni krok po kroku
Szczegóły różnią się w zależności od integratora, ale ustawienia, które musisz przemyśleć, są wszędzie podobne. Poniżej kolejność, którą stosujemy przy wdrożeniach.
Ustal warunki z hurtownią – sama aktywacja integracji nie oznacza współpracy. Najpierw podpisz umowę, ustal ceny, sposób zamawiania, terminy wysyłki i zasady zwrotów.
Pozyskaj link do pliku – hurtownia przekaże adres pliku XML lub CSV, czasem z loginem i hasłem.
Zainstaluj integrator – aplikację z App Store albo połącz Shopera z Apilo lub Base.
Ustaw prefiks kodów – dodaj przedrostek do kodów produktów z danej hurtowni, żeby te same produkty od różnych dostawców się nie myliły.
Wybierz zakres – kategorie, producentów, przedział cen i minimalny stan, od którego produkt trafia do sklepu.
Zaplanuj kategorie – zdecyduj, czy przenosisz drzewo kategorii z hurtowni, czy przypisujesz produkty do własnych kategorii.
Ustaw marżę – narzut procentowy lub kwotowy na cenę z pliku.
Określ reguły stanów – np. przedziały, w których niski stan zamieniasz na zero.
Zdecyduj, co z usuniętymi produktami – ukrycie, wyzerowanie stanu albo usunięcie.
Uruchom import testowy – na jednej kategorii, a dopiero potem na całej ofercie.
[#tip] Prefiks w kodach produktów to drobiazg, który oszczędza wiele problemów. Przy dwóch hurtowniach z tym samym produktem bez prefiksu integracja może nadpisywać dane jednego dostawcy danymi drugiego. Prefiks pozwala też szybko wyfiltrować w panelu wszystkie produkty od danej hurtowni.
Marża, ceny netto i przedziały stanów
Hurtownie zwykle podają w pliku ceny netto. Integrator dolicza do nich Twoją marżę – procentowo, kwotowo albo według progów – a sklep wyświetla cenę brutto z właściwą stawką VAT. Sprawdź dokładnie, czy cena w pliku jest netto czy brutto, i przelicz kilka produktów ręcznie przed uruchomieniem importu. Przy przeliczeniach przyda się nasz kalkulator VAT.
Ustawienie | Przykład | Po co |
Narzut procentowy | +35% do ceny netto z pliku | Prosta marża dla całej oferty |
Narzut kwotowy | +15 zł do każdego produktu | Pokrycie kosztów obsługi przy tanich produktach |
Progi cenowe | Inna marża do 50 zł, inna powyżej | Konkurencyjne ceny drogich i opłacalność tanich produktów |
Przedziały stanów | Stan 0–5 w hurtowni = 0 w sklepie | Bufor bezpieczeństwa przed sprzedażą bez towaru |
Minimalny stan | Pobieraj tylko produkty ze stanem od 3 szt. | Mniej pozycji, które szybko znikają z oferty |
Przedział cen | Pobieraj produkty od 20 do 500 zł netto | Oferta dopasowana do profilu sklepu |
Przedziały stanów to jedno z najważniejszych zabezpieczeń. Plik hurtowni jest aktualizowany co kilka godzin, a w tym czasie te same produkty sprzedają inne sklepy. Jeśli hurtownia ma na stanie dwie sztuki, a Ty pokazujesz je jako dostępne, ryzykujesz zamówienie, którego nie zrealizujesz. Ustawienie, że stan od 0 do 5 jest traktowany jak 0, ogranicza ten problem kosztem nieco mniejszej oferty. Więcej o mechanizmach synchronizacji piszemy w artykule synchronizacja stanów w BaseLinkerze.
[#uwaga] Narzut doliczony automatycznie do cen z hurtowni nie uwzględnia kosztów, które ponosisz poza ceną zakupu: prowizji operatora płatności, kosztów dostawy w promocjach, zwrotów i reklam. Policz marżę na kilku typowych zamówieniach, zanim ustawisz jeden narzut dla całej oferty.
Kategorie, opisy i zdjęcia z hurtowni
Integratory zwykle pozwalają przenieść drzewo kategorii z pliku hurtowni albo przypisać produkty do wybranej kategorii nadrzędnej. Kategorie hurtowni bywają jednak nazwane po swojemu, mają skróty i dziwne podziały. Jeśli zależy Ci na czytelnym sklepie i ruchu z Google, lepiej mapować kategorie dostawcy na własne drzewo – jak je zaplanować, pokazujemy w artykule kategorie w Shoperze.
Opisy i zdjęcia z hurtowni są wygodne, ale te same treści ma każdy sklep współpracujący z danym dostawcą. Dla wyszukiwarki oznacza to powielone treści, a dla klienta – brak powodu, żeby kupić akurat u Ciebie. Przy najważniejszych produktach warto przepisać opisy, dodać własne zdjęcia i uzupełnić dane, których hurtownia nie podaje. Upewnij się też, że przy aktualizacjach integracja nie nadpisze Twoich poprawionych opisów danymi z pliku.
Współpraca z hurtownią – o czym pamiętać
Integracja techniczna to połowa pracy. Druga połowa to zasady współpracy, które warto ustalić na piśmie przed startem sprzedaży.
Działalność gospodarcza – większość hurtowni oczekuje, że prowadzisz firmę; sprawdź warunki przed podpisaniem umowy.
Częstotliwość aktualizacji pliku – zapytaj, jak często hurtownia odświeża stany i ceny, szczególnie w sezonie.
Jakość danych – sprawdź zdjęcia, opisy, kody EAN i dane producenta potrzebne do porównywarek i obowiązków GPSR.
Ochrona danych osobowych – w dropshippingu przekazujesz hurtowni dane klientów. Pomoc Shopera przypomina, że sklep jest administratorem danych, a hurtownia podmiotem przetwarzającym, więc potrzebna jest odpowiednia umowa powierzenia.
Zwroty i reklamacje – kto przyjmuje zwrot, na jaki adres i w jakim terminie hurtownia rozlicza reklamację.
Wysyłka w Twoim imieniu – czy paczka wychodzi bez faktury i materiałów hurtowni, z Twoimi danymi jako nadawcy.
[#przyklad] Typowy scenariusz: sklep z artykułami dla domu współpracuje z dwiema hurtowniami. Pierwsza wysyła towar bezpośrednio do klienta, druga dostarcza produkty na magazyn sklepu. Obie są podłączone przez jeden integrator z prefiksami kodów H1 i H2, narzutem 40% dla tańszych produktów i 25% dla droższych, a stany od 0 do 3 są zerowane. Produkty trafiają do własnego drzewa kategorii, a 50 bestsellerów ma przepisane opisy i własne zdjęcia.
Dropshipping czy zakup na magazyn
Integracja z hurtownią sprawdza się w dwóch modelach. W dropshippingu nie kupujesz towaru z wyprzedzeniem – po złożeniu zamówienia przekazujesz je hurtowni, a ta wysyła paczkę bezpośrednio do klienta. W modelu magazynowym kupujesz towar na własny magazyn, a integracja służy głównie do szybkiego dodania produktów, aktualizacji cen zakupu i informacji o dostępności u dostawcy.
Kryterium | Dropshipping | Zakup na magazyn |
Zamrożony kapitał | Brak lub minimalny | Towar kupowany z góry |
Kontrola nad wysyłką | Mniejsza – pakuje hurtownia | Pełna – pakujesz sam |
Czas dostawy | Zależny od hurtowni | Zwykle krótszy |
Marża | Zwykle niższa | Zwykle wyższa przy większych zakupach |
Ryzyko braków | Wyższe – stany zmieniają się u dostawcy | Niższe – znasz swój stan |
Rola integracji | Kluczowa: stany, ceny, przekazanie zamówień | Pomocnicza: dodawanie produktów i ceny zakupu |
Wiele sklepów łączy oba modele: bestsellery trzyma na magazynie, a szeroki asortyment uzupełnia produktami z dropshippingu. Wtedy szczególnie ważne jest, żeby klient widział realny czas wysyłki dla każdego produktu. W Shoperze ustawisz go w polu czasu dostawy na karcie produktu, o czym piszemy w artykule dodawanie produktów w Shoperze.
Najczęstsze problemy z integracją hurtowni
Sprzedaż produktów, których nie ma – zbyt rzadka aktualizacja pliku lub brak przedziałów stanów.
Ceny poniżej kosztów – pomylenie ceny netto z brutto w pliku albo błędnie ustawiony narzut.
Bałagan w kategoriach – automatyczne przeniesienie drzewa hurtowni bez mapowania.
Nadpisane opisy – aktualizacja z pliku zastępuje poprawione treści.
Zdublowane produkty – ten sam produkt od dwóch dostawców bez prefiksów kodów.
Brakujące zdjęcia – linki w pliku przestały działać albo serwer hurtowni blokuje pobieranie.
Po uruchomieniu integracji przez pierwsze tygodnie sprawdzaj dziennik importu, porównuj losowe produkty z ofertą hurtowni i obserwuj zamówienia anulowane z powodu braku towaru. To najszybszy sposób, żeby wyłapać błędy w ustawieniach, zanim odbiją się na opiniach klientów.
[#checklista] Przed startem: umowa z hurtownią; link do aktualnego pliku; wybrany integrator; prefiks kodów; filtry kategorii, producentów i cen; mapowanie kategorii; narzut sprawdzony na kilku produktach; przedziały stanów; reguła dla usuniętych produktów; ochrona własnych opisów; umowa powierzenia danych; zasady zwrotów; import testowy na jednej kategorii.
Najczęściej zadawane pytania
Jak połączyć sklep Shoper z hurtownią?
Najczęściej przez aplikację integracyjną z App Store Shopera albo przez system do sprzedaży wielokanałowej, np. Apilo lub Base. W każdym przypadku potrzebujesz od hurtowni linku do pliku XML lub CSV z ofertą.
Czy integracja z hurtownią jest płatna?
Większość aplikacji integracyjnych działa w modelu abonamentowym, a systemy wielokanałowe mają własne cenniki. Aktualne ceny sprawdź w App Store Shopera i na stronach integratorów.
Jak często aktualizują się stany i ceny?
Zależy to od hurtowni i integratora. Hurtownia może odświeżać plik kilka razy dziennie albo raz na dobę, a integrator pobiera go według ustawionego harmonogramu, np. dwa lub trzy razy dziennie.
Co zrobić, gdy hurtowni nie ma na liście integracji?
Zapytaj hurtownię, czy udostępnia plik w popularnym schemacie, np. Ceneo lub IOF. Taki plik obsłuży wiele integratorów. W pozostałych przypadkach zostaje płatne podłączenie u dostawcy integracji lub rozwiązanie dedykowane.
Jak uniknąć sprzedaży produktów niedostępnych w hurtowni?
Ustaw częstą aktualizację stanów, przedziały, w których niski stan jest traktowany jak zero, i regułę ukrywania produktów usuniętych z pliku. Regularnie sprawdzaj anulowane zamówienia.
Czy mogę korzystać z kilku hurtowni jednocześnie?
Tak. Większość integratorów obsługuje wiele hurtowni. Stosuj prefiksy kodów produktów, żeby dane od różnych dostawców się nie mieszały.
Podsumowanie
Integracja Shopera z hurtownią to sposób na dużą, aktualną ofertę bez ręcznej pracy. Kluczem jest dobry plik od dostawcy, właściwie dobrany integrator i przemyślane ustawienia: prefiksy kodów, marże liczone od ceny netto, przedziały stanów, mapowanie kategorii i ochrona własnych opisów. Zanim uruchomisz import na całej ofercie, ustal zasady współpracy z hurtownią i przetestuj integrację na jednej kategorii.
Jeśli chcesz połączyć sklep z kilkoma dostawcami, zsynchronizować stany z marketplace’ami albo przenieść obsługę do wdrożenia Base, jako autoryzowany partner Shoper dobierzemy integrator i skonfigurujemy import – sprawdź ofertę wdrożenia i rozwoju sklepu Shoper.
Konfiguracja importu z hurtowni krok po kroku
Szczegóły różnią się w zależności od integratora, ale ustawienia, które musisz przemyśleć, są wszędzie podobne. Poniżej kolejność, którą stosujemy przy wdrożeniach.
Ustal warunki z hurtownią – sama aktywacja integracji nie oznacza współpracy. Najpierw podpisz umowę, ustal ceny, sposób zamawiania, terminy wysyłki i zasady zwrotów.
Pozyskaj link do pliku – hurtownia przekaże adres pliku XML lub CSV, czasem z loginem i hasłem.
Zainstaluj integrator – aplikację z App Store albo połącz Shopera z Apilo lub Base.
Ustaw prefiks kodów – dodaj przedrostek do kodów produktów z danej hurtowni, żeby te same produkty od różnych dostawców się nie myliły.
Wybierz zakres – kategorie, producentów, przedział cen i minimalny stan, od którego produkt trafia do sklepu.
Zaplanuj kategorie – zdecyduj, czy przenosisz drzewo kategorii z hurtowni, czy przypisujesz produkty do własnych kategorii.
Ustaw marżę – narzut procentowy lub kwotowy na cenę z pliku.
Określ reguły stanów – np. przedziały, w których niski stan zamieniasz na zero.
Zdecyduj, co z usuniętymi produktami – ukrycie, wyzerowanie stanu albo usunięcie.
Uruchom import testowy – na jednej kategorii, a dopiero potem na całej ofercie.
[#tip] Prefiks w kodach produktów to drobiazg, który oszczędza wiele problemów. Przy dwóch hurtowniach z tym samym produktem bez prefiksu integracja może nadpisywać dane jednego dostawcy danymi drugiego. Prefiks pozwala też szybko wyfiltrować w panelu wszystkie produkty od danej hurtowni.
Marża, ceny netto i przedziały stanów
Hurtownie zwykle podają w pliku ceny netto. Integrator dolicza do nich Twoją marżę – procentowo, kwotowo albo według progów – a sklep wyświetla cenę brutto z właściwą stawką VAT. Sprawdź dokładnie, czy cena w pliku jest netto czy brutto, i przelicz kilka produktów ręcznie przed uruchomieniem importu. Przy przeliczeniach przyda się nasz kalkulator VAT.
Ustawienie | Przykład | Po co |
Narzut procentowy | +35% do ceny netto z pliku | Prosta marża dla całej oferty |
Narzut kwotowy | +15 zł do każdego produktu | Pokrycie kosztów obsługi przy tanich produktach |
Progi cenowe | Inna marża do 50 zł, inna powyżej | Konkurencyjne ceny drogich i opłacalność tanich produktów |
Przedziały stanów | Stan 0–5 w hurtowni = 0 w sklepie | Bufor bezpieczeństwa przed sprzedażą bez towaru |
Minimalny stan | Pobieraj tylko produkty ze stanem od 3 szt. | Mniej pozycji, które szybko znikają z oferty |
Przedział cen | Pobieraj produkty od 20 do 500 zł netto | Oferta dopasowana do profilu sklepu |
Przedziały stanów to jedno z najważniejszych zabezpieczeń. Plik hurtowni jest aktualizowany co kilka godzin, a w tym czasie te same produkty sprzedają inne sklepy. Jeśli hurtownia ma na stanie dwie sztuki, a Ty pokazujesz je jako dostępne, ryzykujesz zamówienie, którego nie zrealizujesz. Ustawienie, że stan od 0 do 5 jest traktowany jak 0, ogranicza ten problem kosztem nieco mniejszej oferty. Więcej o mechanizmach synchronizacji piszemy w artykule synchronizacja stanów w BaseLinkerze.
[#uwaga] Narzut doliczony automatycznie do cen z hurtowni nie uwzględnia kosztów, które ponosisz poza ceną zakupu: prowizji operatora płatności, kosztów dostawy w promocjach, zwrotów i reklam. Policz marżę na kilku typowych zamówieniach, zanim ustawisz jeden narzut dla całej oferty.
Kategorie, opisy i zdjęcia z hurtowni
Integratory zwykle pozwalają przenieść drzewo kategorii z pliku hurtowni albo przypisać produkty do wybranej kategorii nadrzędnej. Kategorie hurtowni bywają jednak nazwane po swojemu, mają skróty i dziwne podziały. Jeśli zależy Ci na czytelnym sklepie i ruchu z Google, lepiej mapować kategorie dostawcy na własne drzewo – jak je zaplanować, pokazujemy w artykule kategorie w Shoperze.
Opisy i zdjęcia z hurtowni są wygodne, ale te same treści ma każdy sklep współpracujący z danym dostawcą. Dla wyszukiwarki oznacza to powielone treści, a dla klienta – brak powodu, żeby kupić akurat u Ciebie. Przy najważniejszych produktach warto przepisać opisy, dodać własne zdjęcia i uzupełnić dane, których hurtownia nie podaje. Upewnij się też, że przy aktualizacjach integracja nie nadpisze Twoich poprawionych opisów danymi z pliku.
Współpraca z hurtownią – o czym pamiętać
Integracja techniczna to połowa pracy. Druga połowa to zasady współpracy, które warto ustalić na piśmie przed startem sprzedaży.
Działalność gospodarcza – większość hurtowni oczekuje, że prowadzisz firmę; sprawdź warunki przed podpisaniem umowy.
Częstotliwość aktualizacji pliku – zapytaj, jak często hurtownia odświeża stany i ceny, szczególnie w sezonie.
Jakość danych – sprawdź zdjęcia, opisy, kody EAN i dane producenta potrzebne do porównywarek i obowiązków GPSR.
Ochrona danych osobowych – w dropshippingu przekazujesz hurtowni dane klientów. Pomoc Shopera przypomina, że sklep jest administratorem danych, a hurtownia podmiotem przetwarzającym, więc potrzebna jest odpowiednia umowa powierzenia.
Zwroty i reklamacje – kto przyjmuje zwrot, na jaki adres i w jakim terminie hurtownia rozlicza reklamację.
Wysyłka w Twoim imieniu – czy paczka wychodzi bez faktury i materiałów hurtowni, z Twoimi danymi jako nadawcy.
[#przyklad] Typowy scenariusz: sklep z artykułami dla domu współpracuje z dwiema hurtowniami. Pierwsza wysyła towar bezpośrednio do klienta, druga dostarcza produkty na magazyn sklepu. Obie są podłączone przez jeden integrator z prefiksami kodów H1 i H2, narzutem 40% dla tańszych produktów i 25% dla droższych, a stany od 0 do 3 są zerowane. Produkty trafiają do własnego drzewa kategorii, a 50 bestsellerów ma przepisane opisy i własne zdjęcia.
Dropshipping czy zakup na magazyn
Integracja z hurtownią sprawdza się w dwóch modelach. W dropshippingu nie kupujesz towaru z wyprzedzeniem – po złożeniu zamówienia przekazujesz je hurtowni, a ta wysyła paczkę bezpośrednio do klienta. W modelu magazynowym kupujesz towar na własny magazyn, a integracja służy głównie do szybkiego dodania produktów, aktualizacji cen zakupu i informacji o dostępności u dostawcy.
Kryterium | Dropshipping | Zakup na magazyn |
Zamrożony kapitał | Brak lub minimalny | Towar kupowany z góry |
Kontrola nad wysyłką | Mniejsza – pakuje hurtownia | Pełna – pakujesz sam |
Czas dostawy | Zależny od hurtowni | Zwykle krótszy |
Marża | Zwykle niższa | Zwykle wyższa przy większych zakupach |
Ryzyko braków | Wyższe – stany zmieniają się u dostawcy | Niższe – znasz swój stan |
Rola integracji | Kluczowa: stany, ceny, przekazanie zamówień | Pomocnicza: dodawanie produktów i ceny zakupu |
Wiele sklepów łączy oba modele: bestsellery trzyma na magazynie, a szeroki asortyment uzupełnia produktami z dropshippingu. Wtedy szczególnie ważne jest, żeby klient widział realny czas wysyłki dla każdego produktu. W Shoperze ustawisz go w polu czasu dostawy na karcie produktu, o czym piszemy w artykule dodawanie produktów w Shoperze.
Najczęstsze problemy z integracją hurtowni
Sprzedaż produktów, których nie ma – zbyt rzadka aktualizacja pliku lub brak przedziałów stanów.
Ceny poniżej kosztów – pomylenie ceny netto z brutto w pliku albo błędnie ustawiony narzut.
Bałagan w kategoriach – automatyczne przeniesienie drzewa hurtowni bez mapowania.
Nadpisane opisy – aktualizacja z pliku zastępuje poprawione treści.
Zdublowane produkty – ten sam produkt od dwóch dostawców bez prefiksów kodów.
Brakujące zdjęcia – linki w pliku przestały działać albo serwer hurtowni blokuje pobieranie.
Po uruchomieniu integracji przez pierwsze tygodnie sprawdzaj dziennik importu, porównuj losowe produkty z ofertą hurtowni i obserwuj zamówienia anulowane z powodu braku towaru. To najszybszy sposób, żeby wyłapać błędy w ustawieniach, zanim odbiją się na opiniach klientów.
[#checklista] Przed startem: umowa z hurtownią; link do aktualnego pliku; wybrany integrator; prefiks kodów; filtry kategorii, producentów i cen; mapowanie kategorii; narzut sprawdzony na kilku produktach; przedziały stanów; reguła dla usuniętych produktów; ochrona własnych opisów; umowa powierzenia danych; zasady zwrotów; import testowy na jednej kategorii.
Najczęściej zadawane pytania
Jak połączyć sklep Shoper z hurtownią?
Najczęściej przez aplikację integracyjną z App Store Shopera albo przez system do sprzedaży wielokanałowej, np. Apilo lub Base. W każdym przypadku potrzebujesz od hurtowni linku do pliku XML lub CSV z ofertą.
Czy integracja z hurtownią jest płatna?
Większość aplikacji integracyjnych działa w modelu abonamentowym, a systemy wielokanałowe mają własne cenniki. Aktualne ceny sprawdź w App Store Shopera i na stronach integratorów.
Jak często aktualizują się stany i ceny?
Zależy to od hurtowni i integratora. Hurtownia może odświeżać plik kilka razy dziennie albo raz na dobę, a integrator pobiera go według ustawionego harmonogramu, np. dwa lub trzy razy dziennie.
Co zrobić, gdy hurtowni nie ma na liście integracji?
Zapytaj hurtownię, czy udostępnia plik w popularnym schemacie, np. Ceneo lub IOF. Taki plik obsłuży wiele integratorów. W pozostałych przypadkach zostaje płatne podłączenie u dostawcy integracji lub rozwiązanie dedykowane.
Jak uniknąć sprzedaży produktów niedostępnych w hurtowni?
Ustaw częstą aktualizację stanów, przedziały, w których niski stan jest traktowany jak zero, i regułę ukrywania produktów usuniętych z pliku. Regularnie sprawdzaj anulowane zamówienia.
Czy mogę korzystać z kilku hurtowni jednocześnie?
Tak. Większość integratorów obsługuje wiele hurtowni. Stosuj prefiksy kodów produktów, żeby dane od różnych dostawców się nie mieszały.
Podsumowanie
Integracja Shopera z hurtownią to sposób na dużą, aktualną ofertę bez ręcznej pracy. Kluczem jest dobry plik od dostawcy, właściwie dobrany integrator i przemyślane ustawienia: prefiksy kodów, marże liczone od ceny netto, przedziały stanów, mapowanie kategorii i ochrona własnych opisów. Zanim uruchomisz import na całej ofercie, ustal zasady współpracy z hurtownią i przetestuj integrację na jednej kategorii.
Jeśli chcesz połączyć sklep z kilkoma dostawcami, zsynchronizować stany z marketplace’ami albo przenieść obsługę do wdrożenia Base, jako autoryzowany partner Shoper dobierzemy integrator i skonfigurujemy import – sprawdź ofertę wdrożenia i rozwoju sklepu Shoper.


Mateusz Piotrowicz
Technical & Logistics Expert
Optymalizuje logistykę, magazyn i wysyłki sprzedawców. Skupia się na kosztach i terminowości dostaw.
Optymalizuje logistykę, magazyn i wysyłki sprzedawców. Skupia się na kosztach i terminowości dostaw.
Wdrożenie i rozwój sklepu Shoper
Mateusz 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!
Masz pytania? Chętnie porozmawiamy!

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."