Import produktów do PrestaShop z CSV - mapowanie pól, zdjęcia i kombinacje bez błędów

Mapowanie kolumn w imporcie PrestaShop

Po wgraniu pliku przyciskiem przesyłania (Upload) albo wyborze pliku wgranego wcześniej przez FTP do katalogu importu klikasz przejście do kolejnego kroku (Next step). Na ekranie mapowania nad każdą kolumną pliku jest lista rozwijana z polami PrestaShop. Ekran pokazuje kilka kolumn naraz, a między kolejnymi przechodzisz strzałkami. W polu wierszy do pominięcia (Rows to skip) wpisujesz liczbę wierszy nagłówka, zwykle 1. Pola oznaczone gwiazdką są wymagane.

Mapowanie warto zapisać. Wpisz nazwę i kliknij zapis, a przy kolejnym imporcie tego samego formatu wczytasz konfigurację przyciskiem wczytania (Load). To oszczędza czasu przy regularnych aktualizacjach cen czy stanów i ogranicza pomyłki, w których kolumna z ceną zakupu trafia do ceny sprzedaży. Najczęściej mapowane pola produktu to:

• Indeks i nazwa - identyfikacja produktu i nazwa widoczna dla klienta.

• Kategorie (Categories (x,y,z...)) - lista kategorii rozdzielona separatorem wielu wartości. Najbezpieczniej podawać ID istniejących kategorii.

• Cena i reguła podatkowa - cena w domyślnej walucie i ID grupy reguł podatkowych.

• Ilość, kody EAN, waga - dane potrzebne do sprzedaży, wysyłki i feedów.

• Cechy (Feature (Name:Value:Position:Customized)) - np. Materiał:bawełna:0, kilka cech rozdzielonych przecinkiem.

• Zdjęcia (Image URLs (x,y,z...)) - pełne adresy URL, rozdzielone przecinkiem.

Duże pliki i wgrywanie przez FTP

Przy dużych plikach przesyłanie przez przeglądarkę bywa zawodne. Dokumentacja opisuje drugą drogę: plik wgrywasz przez FTP do podkatalogu import w katalogu panelu administracyjnego, a potem wybierasz go z historii plików (Choose from history / FTP) na stronie importu. Pamiętaj, że katalog panelu ma po instalacji zmienioną, unikalną nazwę. Na czas importu dużego katalogu sklep pracuje intensywniej, dlatego najlepiej uruchamiać go poza godzinami największego ruchu, a przed startem zrobić kopię zapasową bazy danych.

Aktualizacja cen i stanów z pliku

Import przydaje się nie tylko przy zakładaniu katalogu. Gdy dostawca przysyła cennik w arkuszu, możesz przygotować plik z kolumnami indeksu, ceny i ilości, włączyć klucz w postaci indeksu i zaktualizować tylko te dane. Przed pierwszą taką aktualizacją sprawdź na kopii sklepu, czy pola, których nie zmapowałeś, zostają bez zmian, i czy produkty nie zmieniają statusu aktywności. Przy regularnych aktualizacjach, np. codziennych, ręczny import szybko staje się uciążliwy - wtedy lepiej sprawdza się moduł importu z harmonogramem, integrator albo integracja przez API.

Zdjęcia produktów z URL w imporcie PrestaShop

PrestaShop nie importuje zdjęć z dysku Twojego komputera. W kolumnie zdjęć podajesz pełne adresy URL, z których sklep pobierze pliki podczas importu. Według kodu kontrolera importu produkt ma pola adresów zdjęć (Image URLs (x,y,z...)), tekstów alternatywnych (Image alt texts (x,y,z...)) i usuwania istniejących zdjęć (Delete existing images (0 = No, 1 = Yes)). Pierwszy adres na liście zwykle staje się zdjęciem głównym produktu.

Przy zdjęciach sprawdź trzy rzeczy. Po pierwsze, czy serwer, na którym leżą pliki, pozwala na ich pobranie - adresy wymagające logowania nie zadziałają. Po drugie, czy przy aktualizacji nie dublujesz zdjęć: jeśli importujesz ten sam plik drugi raz bez usuwania istniejących zdjęć, produkt może dostać kolejny komplet. Po trzecie, czas importu. Generowanie miniatur dla tysięcy zdjęć obciąża serwer, dlatego dokumentacja przewiduje opcję pominięcia regeneracji miniatur (Skip thumbnails regeneration), a dla dużych importów opcję powiadomienia e-mailem o zakończeniu (Send notification email).

[#tip] Duży katalog importuj partiami, np. po kilkaset produktów, i zacznij od pliku z pięcioma wierszami. Jeśli mały import przejdzie bez błędów, a produkty wyglądają dobrze w panelu i w sklepie, dopiero wtedy wgrywaj resztę.

Import kombinacji w PrestaShop krok po kroku

Kombinacje importujesz osobnym plikiem, po produktach. Według kodu kontrolera importu każdy wiersz wskazuje produkt przez ID (Product ID) albo indeks (Product Reference) i opisuje wariant w dwóch wymaganych kolumnach. Kolumna atrybutów (Attribute (Name:Type:Position)) zawiera nazwę grupy atrybutów, typ i pozycję, np. Kolor:color:0,Rozmiar:select:1. Kolumna wartości (Value (Value:Position)) zawiera wartości w tej samej kolejności, np. Czarny:0,M:1. Przykładowy plik z dokumentacji pokazuje też indeks wariantu, kody EAN13, cenę zakupu, wpływ na cenę i wagę, ilość, ilość minimalną, oznaczenie kombinacji domyślnej i zdjęcia.

Każda kombinacja powinna mieć własny, unikalny indeks i kod EAN, bo po nich integracje łączą warianty z ofertami na marketplace'ach i pozycjami w feedach. Wartości atrybutów zapisuj dokładnie tak jak w katalogu - literówka może utworzyć nową wartość zamiast przypisać istniejącą. Jak zaplanować atrybuty i wpływ na cenę, opisujemy we wpisie Kombinacje produktów w PrestaShop - jak skonfigurować warianty, ceny i stany magazynowe.

[#przyklad] Bluza w dwóch kolorach i trzech rozmiarach to sześć wierszy w pliku kombinacji. Każdy wiersz ma ten sam indeks produktu, kolumnę atrybutów Kolor:color:0,Rozmiar:select:1 i inną wartość, np. Granatowy:0,L:2, a do tego własny indeks wariantu, EAN, ilość i ewentualny wpływ na cenę. Jeden wiersz oznaczasz jako kombinację domyślną. Dane są przykładowe.

Najczęstsze błędy przy imporcie produktów do PrestaShop

Po imporcie PrestaShop wyświetla listę błędów i ostrzeżeń. Dokumentacja radzi poprawić plik i zaimportować go ponownie. Najczęstsze objawy i ich przyczyny zebraliśmy w zestawieniu:

[#chart:prs20b]

Jakość importu łatwo zmierzyć prostym wskaźnikiem: odsetkiem wierszy z błędami. Licz go po każdej partii i nie przechodź do kolejnej, dopóki wynik nie spadnie do zera w testowym pliku:

[#chart:prs20c]

Co sprawdzić w sklepie po imporcie?

Komunikat o zakończeniu importu nie oznacza, że produkty są gotowe do sprzedaży. Po każdej partii przejrzyj kilka losowych produktów:

1. czy nazwa, opis i cena brutto zgadzają się z plikiem,

2. czy produkt jest w dobrej kategorii głównej i ma właściwą grupę reguł podatkowych,

3. czy zdjęcia się wyświetlają i nie są zdublowane,

4. czy kombinacje mają poprawne stany, indeksy i zdjęcia,

5. czy produkt jest aktywny i widoczny na stronie kategorii.

Jeśli znajdziesz błąd, popraw go w pliku, a nie ręcznie w panelu. Tylko wtedy kolejny import tego samego pliku nie przywróci starej, błędnej wartości, a arkusz pozostanie wiarygodnym źródłem danych dla całego katalogu.

Import a filtry, feedy i integracje

Import zmienia dane, z których korzystają inne części sklepu. Po większym imporcie przebuduj indeksy w module wyszukiwania fasetowego, żeby filtry ceny i atrybutów pokazywały aktualne dane - jak to zrobić, piszemy w tekście Kategorie i filtry w PrestaShop - struktura katalogu i nawigacja fasetowa w sklepie. Sprawdź też feedy reklamowe i integracje z marketplace'ami, bo zmiana indeksów lub kategorii może rozłączyć produkty z ofertami.

[#checklista] Import CSV w PrestaShop przed startem: kopia zapasowa bazy, plik w UTF-8 z separatorem średnika, jeden typ danych i jeden język, kategorie zaimportowane przed produktami, unikalne indeksy produktów i kombinacji, zdjęcia pod publicznymi adresami URL, zapisane mapowanie kolumn, test na pięciu wierszach, import partiami, przegląd błędów, przebudowa indeksów filtrów.

Jak Vinson pomaga z importem produktów w PrestaShop

W Vinson wdrażamy, rozwijamy i utrzymujemy sklepy na PrestaShop. Przy imporcie danych zajmujemy się całym procesem, od arkusza po sprawdzenie produktów w sklepie:

• przygotowujemy pliki produktów, kategorii i kombinacji według formatu PrestaShop,

• porządkujemy indeksy, kody EAN i słowniki atrybutów przed importem,

• importujemy duże katalogi partiami i weryfikujemy wyniki,

• ustawiamy regularne aktualizacje cen i stanów z plików, hurtowni lub Base - jesteśmy certyfikowanym partnerem Base.

Szczegóły współpracy znajdziesz na stronie sklep na PrestaShop z Vinson.

Najczęściej zadawane pytania

Jak zaimportować produkty do PrestaShop z pliku CSV?

Wejdź w parametry zaawansowane, sekcję importu, wybierz typ danych Produkty, język i separatory, wgraj plik i przejdź do kolejnego kroku. Przypisz kolumny do pól PrestaShop, ustaw liczbę wierszy do pominięcia i uruchom import. Przed produktami zaimportuj kategorie.

Jaki separator i kodowanie ma mieć plik CSV dla PrestaShop?

Dokumentacja zaleca średnik jako separator pól i kodowanie UTF-8, a gdy to niemożliwe - ISO-8859-1. Domyślny separator wielu wartości, np. kilku kategorii lub zdjęć, to przecinek. Pierwszy wiersz pliku powinien zawierać nazwy kolumn.

Jak zaimportować zdjęcia produktów do PrestaShop?

W kolumnie adresów zdjęć podaj pełne adresy URL plików, rozdzielone przecinkiem. Sklep pobierze zdjęcia podczas importu, więc muszą być dostępne publicznie. Przy ponownym imporcie zdecyduj, czy usunąć istniejące zdjęcia, żeby ich nie zdublować.

Jak zaimportować kombinacje w PrestaShop?

Najpierw zaimportuj produkty, potem osobny plik kombinacji. Każdy wiersz wskazuje produkt przez ID lub indeks i zawiera kolumnę atrybutów w formacie nazwa:typ:pozycja oraz kolumnę wartości w formacie wartość:pozycja. Każdy wariant powinien mieć własny indeks i EAN.

Dlaczego import w PrestaShop tworzy duplikaty produktów?

Najczęściej plik nie ma kolumny ID, a opcja używania indeksu jako klucza jest wyłączona, więc każdy wiersz tworzy nowy produkt. Włącz klucz w postaci indeksu i upewnij się, że indeksy w pliku są unikalne i zgodne z tymi w sklepie.

Dobrze przygotowany import CSV w PrestaShop oszczędza dni ręcznego dodawania produktów i daje czysty katalog pod filtry, feedy i marketplace'y. Jeśli masz duży katalog, kombinacje albo dane z hurtowni do przeniesienia, sprawdź wdrożenie sklepu na PrestaShop z Vinson - zaczniemy od przeglądu Twojego pliku z produktami.