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).
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.
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.
Zalety: dane zostają w sklepie, jednorazowy koszt licencji zamiast abonamentu zewnętrznej platformy, pełna kontrola nad mapowaniem, marżą i cyklem aktualizacji.
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.
Ceny rynkowe (czerwiec 2026): od ok. 399 zł (X13) przez ok. 860–1 720 zł (PrestaShow, rozliczenie w euro) po 2 599 zł (Astrabit) — plus częste dopłaty za instalację, multistore i AI.
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. Dobry moduł importu obsługuje je wszystkie, bo nie zawsze masz wpływ na to, co dostarcza dostawca.
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 1Wskaż ź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.
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 3Ustaw 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 4Uruchom 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)
Jednorazowy import to dopiero początek. Realna wartość pojawia się przy automatycznej synchronizacji: ceny i stany magazynowe odświeżają się według harmonogramu, więc nie sprzedajesz produktu, którego hurtownia nie ma, i nie tracisz marży, gdy dostawca podniesie cenę zakupu.
Stany magazynowe: aktualizacja co 30–60 minut chroni przed sprzedażą niedostępnych produktów i nadsprzedażą.
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: wyłączane lub oznaczane jako niedostępne zamiast usuwane, by nie tracić adresów URL i pozycji w Google.
Opisy produktów generowane przez AI
Hurtownie dostarczają zwykle ubogie albo identyczne dla wszystkich sklepów opisy. To problem SEO: setki sklepów z tym samym tekstem to duplicate content, który Google traktuje jako treść niskiej jakości. Generowanie unikalnych opisów AI podczas importu rozwiązuje to systemowo.
Unikalna treść dla każdego produktu na podstawie nazwy, cech i kategorii z feedu — bez ręcznego przepisywania.
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.
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: jednorazowa licencja modułu, abonament platformy zewnętrznej albo praca programisty. Ceny rynkowe modułów importu w czerwcu 2026 zaczynają się od ok. 399 zł (X13), przez ok. 860–1 720 zł (PrestaShow, rozliczenie w euro), po 2 599 zł (Astrabit) — do tego często dochodzą dopłaty za instalację, multistore i generowanie opisów AI.
Import hurtowni do PrestaShop sprowadza się do czterech decyzji: jaką metodą (moduł, platforma, własny skrypt), z jakiego formatu (XML/CSV/JSON/XLSX/API), jak zmapować pola i jaką przyjąć politykę cen oraz aktualizacji. Dobrze ustawiony import działa potem sam — przez CRON odświeża ceny i stany, a opcjonalne opisy AI rozwiązują problem duplicate content z hurtowni.
import hurtowni prestashop
integracja hurtowni prestashop
import xml prestashop
import csv prestashop
dropshipping prestashop
synchronizacja cen i stanów prestashop
opisy produktów ai
FAQ
Najczęściej zadawane pytania
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.
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.
Tak. Po wdrożeniu importu ustawia się harmonogram CRON, który odświeża stany co 30–60 minut, a ceny przelicza przez Twoje reguły marży. Dzięki temu nie sprzedajesz produktów niedostępnych w hurtowni i nie tracisz marży, gdy dostawca zmieni cenę zakupu.
ionCube to rozszerzenie PHP służące do szyfrowania kodu, którym zabezpieczona jest część komercyjnych modułów. Wymaga zgodnej wersji na serwerze i potrafi blokować działanie modułu po aktualizacji PHP. Moduł importu bez ionCube jest odporniejszy na zmiany środowiska i nie wymaga dodatkowej konfiguracji serwera.
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.
Moduły importu kosztują od ok. 399 zł (X13) przez ok. 860–1 720 zł (PrestaShow) po 2 599 zł (Astrabit), często z dopłatami za instalację, multistore i opisy AI. Alternatywą jest abonament platformy typu BaseLinker lub jednorazowa praca programisty przy własnej integracji. Koszt zależy od liczby hurtowni i potrzebnej automatyzacji.
Bezpłatna konsultacja
Porozmawiajmy o Twoim projekcie
Opisz, czego potrzebujesz — zaproponujemy zakres, technologię i realny harmonogram. Bez zobowiązań.
24–48 hCzas odpowiedzi
100%Wycena indywidualna
0 złBez zobowiązań
kontakt
Masz projekt lub pytanie? Napisz do nas
Opisz, czego potrzebujesz — strony, sklepu, integracji czy wsparcia technicznego. Odpowiemy z konkretnymi propozycjami i orientacyjną wyceną, zwykle w ciągu jednego dnia roboczego.
