Import hurtowni do PrestaShop (XML/CSV/API) - poradnik integracji 2026

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

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.

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. Pełną listę integracji znajdziesz w sekcji moduły i 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. Jeśli potrzebujesz wsparcia po wdrożeniu, zobacz też opiekę nad sklepem 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ą.