# Import hurtowni do PrestaShop (XML/CSV/API) - poradnik integracji 2026 > Import produktów z hurtowni to fundament dropshippingu i sklepów wielodostawcowych na PrestaShop. Ten poradnik przeprowadza przez cały proces: wybór metody (moduł, BaseLinker, własny skrypt), formaty feedów (XML, CSV, JSON, XLSX, API), mapowanie pól na katalog, reguły marży i zaokrąglania, automatyczną aktualizację cen i stanów przez CRON, generowanie opisów AI oraz unikanie pułapek (ionCube, multistore, timeouty importu). Autor: Rafał Kędracki (WebAlpha). Opublikowano: 2026-06-20. Zaktualizowano: 2026-06-20. Kanoniczny adres: https://webalpha.pl/blog/import-hurtowni-do-prestashop Około 11 min czytania (szacunek; bez czasu wykonania instrukcji). Sklep, który sprzedaje towar z hurtowni, stoi i upada na imporcie danych. Jeśli ceny i stany aktualizujesz ręcznie, przy kilkuset produktach tracisz na to godziny tygodniowo, a przy kilku tysiącach - po prostu się nie da. Automatyczny import z hurtowni rozwiązuje to raz: produkty wczytują się z feedu (XML, CSV, JSON, XLSX lub API), a ceny i stany odświeżają się według harmonogramu, bez Twojego udziału. Ten poradnik pokazuje, jak zaimportować produkty z hurtowni do PrestaShop 8 i 9 - od wyboru metody i formatu feedu, przez mapowanie pól na katalog, reguły marży i automatyczną aktualizację cen oraz stanów, po generowanie opisów AI i typowe błędy, które potrafią zablokować import na słabszym hostingu. > **Czym jest feed hurtowni:** Feed to plik lub adres, pod którym hurtownia publikuje aktualny katalog: nazwy, ceny netto/brutto, stany magazynowe, EAN, kategorie, zdjęcia. Najczęściej XML lub CSV, rzadziej JSON, XLSX albo dostęp przez API. Import to przetłumaczenie tych pól na pola produktu w PrestaShop i zapisanie ich w katalogu. ## Metody importu hurtowni do PrestaShop Są trzy podejścia do importu z hurtowni. Wybór zależy od liczby hurtowni, częstotliwości aktualizacji i tego, czy zależy Ci na pełnej kontroli nad danymi w sklepie. ### Opcja 1 - dedykowany moduł importu PrestaShop - Moduł zainstalowany w panelu PrestaShop pobiera feed, mapuje pola i zapisuje produkty bezpośrednio w katalogu - bez pośredników. - Możliwe zalety: dane produktowe są przetwarzane w sklepie, a mapowanie, marże i harmonogram konfiguruje się w zakresie modułu. Model licencji, ograniczenia i koszt utrzymania trzeba sprawdzić w aktualnej ofercie. - Na co uważać: część popularnych modułów jest szyfrowana ionCube (dodatkowe rozszerzenie PHP, które potrafi blokować aktualizacje serwera) i liczy multistore jako płatny dodatek. - Przed zakupem porównaj aktualny cennik producenta, okres licencji, aktualizacje, instalację, multistore, obsługiwane formaty i funkcje AI. Nie przenoś historycznej ceny do decyzji bez ponownej weryfikacji źródła. ### Opcja 2 - BaseLinker jako hub - BaseLinker to zewnętrzna platforma, która łączy hurtownie, marketplace'y i sklep w jednym panelu, z własnym systemem automatyzacji. - Zalety: jeden panel do wielu kanałów, rozbudowane reguły zamówień, dobre przy sprzedaży wielokanałowej. - Wady: stały abonament miesięczny, dodatkowa warstwa systemu (awaria BaseLinkera = brak synchronizacji) i dane katalogu przetwarzane poza sklepem. - Sensowny przy 3+ kanałach i dużym wolumenie; do samego importu hurtowni do PrestaShop bywa rozwiązaniem droższym niż dedykowany moduł. ### Opcja 3 - własny skrypt / integracja API - Dedykowany skrypt lub integracja przez Webservice PrestaShop daje pełną elastyczność, ale wymaga programisty i utrzymania. - Uzasadniony przy nietypowym API hurtowni, własnym ERP lub logice, której nie pokrywa żaden gotowy moduł. - Wadą jest koszt utrzymania: każda zmiana w feedzie hurtowni lub aktualizacja PrestaShop może wymagać poprawek w kodzie. ## Formaty feedów - XML, CSV, JSON, XLSX, API Hurtownie udostępniają katalog w różnych formatach. Moduł trzeba dobrać do rzeczywistego XML, CSV, JSON, XLSX lub API dostawcy, a zgodność potwierdzić na próbce - sama lista formatów nie gwarantuje poprawnego mapowania. - XML - najpopularniejszy format feedów hurtowni; elastyczna struktura, dobrze radzi sobie z zagnieżdżonymi danymi (kombinacje, zdjęcia, cechy). - CSV - prosty plik tabelaryczny; szybki, ale gorzej obsługuje dane zagnieżdżone i wymaga uwagi przy separatorach i kodowaniu znaków (UTF-8 vs Windows-1250). - JSON - coraz częściej przy nowoczesnych API; czytelny dla integracji programistycznych. - XLSX - arkusz Excela; wygodny, gdy hurtownia nie ma feedu i wysyła plik mailem (lepiej importować bez konwersji do CSV). - API - bezpośrednie połączenie z systemem hurtowni; daje najświeższe dane, ale wymaga kluczy dostępu i obsługi limitów zapytań. ## Import krok po kroku ### Krok 1: Wskaż źródło i przetestuj połączenie Zacznij od podłączenia źródła: plik lokalny, adres URL feedu, serwer FTP/SFTP lub API hurtowni. Przed czymkolwiek innym przetestuj połączenie - dobry moduł pobierze próbkę i pokaże, że dane się wczytują. Na tym etapie nic nie zapisuje się do katalogu. To tylko podgląd, który pozwala ocenić, czy feed jest kompletny (czy zawiera EAN, ceny netto, stany) zanim cokolwiek zaimportujesz. - Wybierz typ źródła: plik / URL / FTP / API - Wklej adres feedu lub dane dostępowe - Uruchom test połączenia i podgląd próbki danych - Sprawdź kompletność pól: EAN, cena, stan, kategoria, zdjęcia ### Krok 2: Zmapuj pola feedu na pola PrestaShop Mapowanie to serce importu: łączysz pola z feedu (np. 'nazwa', 'cena_netto', 'ilosc', 'ean') z polami produktu w PrestaShop. PrestaShop ma kilkadziesiąt pól docelowych - od nazwy, opisów i cen, przez kategorie i producentów, po cechy, atrybuty, kombinacje i pola SEO. Jeśli nazwy pól w feedzie nie pasują wprost do PrestaShop, użyj przekształceń: prefiks/sufiks, wyszukaj-i-zamień, wyrażenia regularne, łączenie kilku pól w jedno albo szablon nazwy. Wartości stałe pozwalają np. ustawić jedną markę dla całego feedu. Część modułów (w tym HurtoSync) potrafi zaproponować mapowanie automatycznie na podstawie próbki pliku - to oszczędza czas przy hurtowniach spoza gotowych list. - Połącz pola feedu z polami PrestaShop w edytorze mapowania - Dodaj przekształcenia tam, gdzie dane wymagają oczyszczenia - Ustaw klucz identyfikujący produkt (najlepiej EAN lub referencja) - Zdecyduj, które pola moduł nadpisuje przy każdym imporcie ### Krok 3: Ustaw ceny, marżę i zaokrąglanie Cena z hurtowni to zwykle cena zakupu - do sklepu trafia z marżą. Skonfiguruj marżę globalnie lub progami cenowymi (np. produkty 10–15 zł → marża 30%, 15–50 zł → 20%, powyżej → 12%), uwzględnij VAT i wybierz politykę zaokrąglania (końcówki .99, w górę, w dół). Jeśli sprzedajesz w wielu walutach, włącz kursy NBP lub własne przeliczniki. Ustal też, co dzieje się z produktem, który zniknął z feedu: wyłączenie, ukrycie lub wyzerowanie stanu - zawsze z bezpiecznikiem przed masowym zniknięciem oferty. - Skonfiguruj marżę (globalną lub progami cenowymi) - Ustaw zaokrąglanie końcówek cen - Włącz kursy walut, jeśli importujesz ceny w innej walucie - Zdefiniuj zachowanie dla produktów znikających z feedu ### Krok 4: Uruchom dry-run, potem import i CRON Przed pełnym importem uruchom symulację (dry-run): zobaczysz, ile produktów zostanie utworzonych, zaktualizowanych lub pominiętych - bez zapisywania czegokolwiek. To ostatni moment, żeby wyłapać błędne mapowanie. Gdy wynik symulacji jest poprawny, uruchom import na żywo, a następnie ustaw harmonogram CRON: np. ceny i stany co 30–60 minut, pełny import raz dziennie. Dzięki temu katalog odświeża się automatycznie, bez Twojego udziału. - Uruchom dry-run i sprawdź podsumowanie zmian - Wykonaj pierwszy import na żywo na małej partii produktów - Zweryfikuj produkty w katalogu (ceny, stany, kategorie, zdjęcia) - Ustaw CRON: częsta aktualizacja cen/stanów, rzadszy pełny import ## Automatyczna aktualizacja cen i stanów Jednorazowy import to dopiero początek. Cykliczna synchronizacja może skrócić opóźnienie zmian cen i stanów, ale nie usuwa go całkowicie: częstotliwość feedu, kolejka, niedostępność API i błędne dane nadal tworzą ryzyko. Dlatego ustalamy bufor, reguły marży, alerty oraz obsługę wyjątków. - Stany magazynowe: częstotliwość dobierz do aktualności źródła i limitów API; synchronizacja co 30–60 minut ogranicza, lecz nie eliminuje ryzyka nadsprzedaży. - Ceny zakupu: przeliczane przez Twoje reguły marży, z zachowaniem polityki zaokrąglania i promocji ustawionych ręcznie. - Nowe produkty z feedu: opcjonalnie dodawane automatycznie lub wstrzymywane do akceptacji, żeby katalog nie rósł w niekontrolowany sposób. - Wycofane produkty: decyzja zależy od następcy, ruchu i linków - użyteczna karta archiwalna, 301 do rzeczywistego odpowiednika albo właściwy status 404/410. > **Uwaga na CRON i timeouty:** Duże feedy (kilkadziesiąt tysięcy produktów) potrafią przekroczyć limit czasu wykonania PHP na współdzielonym hostingu. Import powinien działać partiami (batch) przez CRON wywoływany po stronie serwera, a nie w przeglądarce - inaczej proces przerwie się w połowie i katalog zostanie w stanie częściowym. ## Opisy produktów generowane przez AI Feed może zawierać opis identyczny z ofertą innych sklepów albo zbyt mało informacji dla kupującego. AI może przygotować szkic na podstawie danych produktu, lecz nie rozwiązuje problemu samodzielnie: potrzebne są poprawne fakty, reguły jakości, kontrola człowieka i ocena, czy strona wnosi własną wartość. - Szkice treści dla produktów na podstawie nazwy, cech i kategorii z feedu - z kontrolą jakości przed publikacją. - Spójny ton i struktura w całym katalogu (nagłówki, listy zalet, sekcja parametrów). - Uzupełnianie meta title i meta description, które hurtownie zwykle pomijają. - Moduł HurtoSync pisze opisy potrójnym silnikiem AI - generuje warianty i wybiera najlepszy zamiast jednego sztywnego szablonu. ## ionCube i multistore - dwie częste pułapki Wybierając moduł importu, zwróć uwagę na dwie rzeczy, które łatwo przeoczyć przy zakupie, a które potrafią uprzykrzyć życie później. - ionCube - wiele komercyjnych modułów jest szyfrowanych tym rozszerzeniem PHP. Wymaga zgodnej wersji na serwerze i bywa, że po aktualizacji PHP moduł przestaje działać do czasu aktualizacji loadera. Moduł bez ionCube jest odporniejszy na zmiany środowiska. - Multistore - jeśli prowadzisz kilka sklepów na jednej instalacji PrestaShop, sprawdź, czy import obejmuje multistore w cenie. Część modułów liczy to jako płatny dodatek (kilkaset złotych), co podnosi realny koszt wdrożenia. Jeśli zależy Ci na rozwiązaniu bez ionCube i z multistore w cenie, takie podejście stosujemy we wdrożeniach opartych o [moduł integracji PrestaShop z hurtowniami](https://webalpha.pl/sklep/integracja-prestashop-hurtownie). Pełną listę integracji znajdziesz w sekcji [moduły i integracje PrestaShop](https://webalpha.pl/sklepy-internetowe/moduly-integracje-prestashop). ## Dropshipping na PrestaShop Import hurtowni to fundament dropshippingu: nie magazynujesz towaru, tylko sprzedajesz produkty dostawcy, a zamówienia realizuje hurtownia. Bez automatycznej synchronizacji cen i stanów ten model się nie spina - dlatego solidny import jest tu warunkiem koniecznym, a nie dodatkiem. - Stany muszą odświeżać się często, bo sprzedajesz towar, którego fizycznie nie masz. - Marża i zaokrąglanie decydują o rentowności - przy dropshippingu pracujesz na cudzych cenach zakupu. - Przy kilku hurtowniach naraz potrzebujesz osobnych profili importu z własnymi regułami i harmonogramem. - Warto rozdzielić produkty po dostawcy (np. przez producenta lub cechę), żeby zarządzać dostępnością i zwrotami. ## Typowe błędy i jak ich uniknąć - Złe kodowanie znaków - feed w Windows-1250 wczytany jako UTF-8 daje 'krzaki' w nazwach. Ustaw kodowanie źródła przed importem. - Brak unikalnego klucza - import po nazwie zamiast po EAN/referencji tworzy duplikaty przy każdej drobnej zmianie nazwy w hurtowni. - Import w przeglądarce - duży feed przerwany timeoutem PHP zostawia katalog w stanie częściowym. Używaj importu partiami przez CRON. - Nadpisywanie ręcznych zmian - jeśli moduł nadpisuje opisy i ceny przy każdym imporcie, tracisz lokalne korekty. Wyłącz nadpisywanie pól, które edytujesz ręcznie. - Usuwanie zamiast wyłączania - kasowanie produktów znikających z feedu niszczy adresy URL i pozycje SEO. Wyłączaj lub ukrywaj. - Brak dry-run - pierwszy import na całym katalogu bez symulacji potrafi rozjechać ceny w całym sklepie. ## Ile kosztuje import hurtowni do PrestaShop Koszt zależy od modelu: licencji modułu, abonamentu platformy albo wdrożenia dedykowanego. Porównuj aktualne oferty w tej samej dacie i zakresie: instalację, liczbę źródeł i sklepów, aktualizacje, formaty, wsparcie, limity oraz funkcje AI. Historyczne ceny konkurentów nie są publikowane tu jako bieżący benchmark. Nasz moduł i pełną kalkulację (z multistore w cenie i bez ionCube) opisujemy na stronie [Integracja PrestaShop z hurtowniami](https://webalpha.pl/sklep/integracja-prestashop-hurtownie). Jeśli potrzebujesz wsparcia po wdrożeniu, zobacz też [opiekę nad sklepem PrestaShop](https://webalpha.pl/sklepy-internetowe/opieka-prestashop). ## Podsumowanie Import hurtowni do PrestaShop wymaga decyzji o metodzie, formacie, mapowaniu oraz polityce cen i aktualizacji. CRON może cyklicznie uruchamiać zadania, lecz potrzebuje logów, alertów i obsługi wyjątków. AI może przygotować szkice opisów; ich poprawność, unikalna wartość i zgodność z produktem wymagają kontroli przed publikacją. ## Potrzebujesz importu z hurtowni do PrestaShop? W WebAlpha wdrażamy import hurtowni do PrestaShop 8 i 9: analizujemy próbkę feedu, mapujemy pola na katalog, ustawiamy marże, automatyczne ceny i stany oraz harmonogram CRON. Korzystamy z własnego modułu HurtoSync - bez ionCube, z multistore w cenie i opcjonalnym generowaniem opisów AI. [Sprawdź integrację PrestaShop z hurtownią](https://webalpha.pl/sklep/integracja-prestashop-hurtownie) ## Najczęstsze pytania (FAQ) ### Jak zaimportować produkty z hurtowni do PrestaShop? Podłącz źródło danych (plik, URL, FTP lub API hurtowni), zmapuj pola feedu na pola produktu w PrestaShop, ustaw marżę i zaokrąglanie cen, uruchom symulację (dry-run), a po weryfikacji import na żywo. Na końcu ustaw harmonogram CRON, aby ceny i stany aktualizowały się automatycznie. Najprościej zrobić to dedykowanym modułem importu zainstalowanym w panelu PrestaShop. ### Jakie formaty feedów obsługuje import do PrestaShop? Najczęściej XML i CSV, a poza tym JSON, XLSX oraz bezpośrednie API hurtowni. XML najlepiej radzi sobie z danymi zagnieżdżonymi (kombinacje, zdjęcia, cechy), CSV jest prostszy, a API daje najświeższe dane kosztem konfiguracji dostępu. Dobry moduł obsługuje wszystkie te formaty. ### Czy ceny i stany magazynowe aktualizują się automatycznie? Można ustawić harmonogram CRON, ale częstotliwość dobieramy do aktualności feedu, limitów API i czasu importu. Cykliczne odświeżanie oraz reguły marży ograniczają opóźnienie, lecz nie eliminują nadsprzedaży ani ryzyka błędnej ceny; potrzebne są logi, alerty i obsługa wyjątków. ### Czym jest ionCube i dlaczego ma znaczenie przy module importu? ionCube Loader jest zależnością części komercyjnych modułów i wymaga wersji zgodnej z PHP oraz zakodowanym pakietem. Brak tej zależności upraszcza jeden element środowiska, ale nie gwarantuje kompatybilności modułu po zmianie PHP; przed aktualizacją sprawdź pełną macierz wymagań. ### Czy import hurtowni nadaje się do dropshippingu? Tak - import hurtowni to fundament dropshippingu na PrestaShop. Kluczowa jest częsta automatyczna synchronizacja stanów (sprzedajesz towar, którego nie magazynujesz) oraz reguły marży na cenach zakupu. Przy wielu dostawcach prowadzi się osobne profile importu z własnymi harmonogramami. ### Ile kosztuje wdrożenie importu hurtowni do PrestaShop? Porównaj aktualną licencję modułu, abonament huba i koszt integracji dedykowanej w tym samym zakresie. Na cenę wpływają liczba źródeł i sklepów, formaty, harmonogram, instalacja, wsparcie, migracja konfiguracji oraz funkcje AI. Bieżące ceny WebAlpha są w publicznym cenniku; konkurencyjne wymagają weryfikacji u producenta w dniu decyzji.