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

Mateusz Piotrowicz

Mateusz Piotrowicz

Technical & Logistics Expert

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.

Bezpłatna konsultacja Shoper
Zamów bezpłatną konsultację i odkryj możliwości Shopera
  • 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.

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

  2. Pozyskaj link do pliku – hurtownia przekaże adres pliku XML lub CSV, czasem z loginem i hasłem.

  3. Zainstaluj integrator – aplikację z App Store albo połącz Shopera z Apilo lub Base.

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

  5. Wybierz zakres – kategorie, producentów, przedział cen i minimalny stan, od którego produkt trafia do sklepu.

  6. Zaplanuj kategorie – zdecyduj, czy przenosisz drzewo kategorii z hurtowni, czy przypisujesz produkty do własnych kategorii.

  7. Ustaw marżę – narzut procentowy lub kwotowy na cenę z pliku.

  8. Określ reguły stanów – np. przedziały, w których niski stan zamieniasz na zero.

  9. Zdecyduj, co z usuniętymi produktami – ukrycie, wyzerowanie stanu albo usunięcie.

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

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

  2. Pozyskaj link do pliku – hurtownia przekaże adres pliku XML lub CSV, czasem z loginem i hasłem.

  3. Zainstaluj integrator – aplikację z App Store albo połącz Shopera z Apilo lub Base.

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

  5. Wybierz zakres – kategorie, producentów, przedział cen i minimalny stan, od którego produkt trafia do sklepu.

  6. Zaplanuj kategorie – zdecyduj, czy przenosisz drzewo kategorii z hurtowni, czy przypisujesz produkty do własnych kategorii.

  7. Ustaw marżę – narzut procentowy lub kwotowy na cenę z pliku.

  8. Określ reguły stanów – np. przedziały, w których niski stan zamieniasz na zero.

  9. Zdecyduj, co z usuniętymi produktami – ukrycie, wyzerowanie stanu albo usunięcie.

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

Czy ten artykuł był pomocny? Oceń go
Bądź pierwszą osobą, która oceni

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.

★★★★★
Współpracowałeś z Vinson?
Twoja opinia pomoże innym sprzedawcom wybrać sprawdzoną agencję. Zajmie Ci to minutę.
Oceń nas na Trustpilot →
Potrzebujesz pomocy z tym tematem?

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ń
4,9/5 ze 140 opiniiAutoryzowany partner Shoper
Mateusz Piotrowicz – Technical & Logistics Expert
Mateusz PiotrowiczTechnical & Logistics Expert

Przeczytaj także

Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.

1 / 1

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

ZADZWOŃ

574 944 685

ADRES

Kazimierza Wielkiego 7/7

32-700 Bochnia