Import produktów PrestaShop z CSV: typowe błędy i kiedy wybrać inną drogę
Import produktów PrestaShop z CSV to wciąż najlepszy sposób na setki i tysiące pozycji. Najczęściej psuje się na pięciu rzeczach: kodowaniu znaków, separatorze, zdjęciach z cudzych serwerów, kombinacjach i dopasowaniu do istniejących produktów. Przy kilkudziesięciu nowych produktach z listy dostawcy szybciej dodasz je w rozmowie z Claude, jako szkice do sprawdzenia.
Autor: Sani. Sani buduje moduł TellMyShop i na co dzień pracuje z zapleczem sklepów PrestaShop.
Aktualizacja: · 4 min czytania
Kiedy CSV, a kiedy rozmowa?
Decyduje liczba produktów i to, jak bardzo każdy z nich wymaga pracy. Plik wygrywa skalą. Rozmowa wygrywa tam, gdzie lista od dostawcy jest niepełna i produkt trzeba dopisać: opis, kategorię, cenę z narzutem.
| Import CSV | Rozmowa z Claude | |
|---|---|---|
| Liczba produktów | setki i tysiące | kilka do kilkudziesięciu naraz |
| Przygotowanie | arkusz w formacie PrestaShop, mapowanie kolumn | wklejasz listę tak, jak przyszła |
| Opisy | takie, jakie są w pliku | Claude pisze opis na podstawie danych z listy |
| Zdjęcia | adresy w kolumnie, serwer pobiera je w trakcie | do 10 zdjęć na produkt z publicznych adresów https |
| Kombinacje | osobny plik i osobny import | tworzysz je w panelu |
| Gdy coś pójdzie źle | poprawiasz plik i importujesz ponownie | każdy produkt cofniesz z historii zmian |
| Wersja | wbudowane w PrestaShop | płatna wersja TellMyShop |
Jeśli co tydzień dostajesz od hurtowni plik z dwoma tysiącami pozycji, zostań przy imporcie albo module integracji. Rozmowa z Claude nie zastąpi stałej synchronizacji z hurtownią.
Dlaczego import CSV się sypie?
Bo format pliku musi zgadzać się z tym, czego oczekuje PrestaShop, co do znaku. Najczęstsze objawy i ich przyczyny:
- Krzaki zamiast polskich liter. Plik nie jest zapisany w UTF-8.
- Wszystko w jednej kolumnie. Separator w pliku jest inny niż w ustawieniach importu, na przykład przecinek zamiast średnika.
- Brak zdjęć po imporcie. Serwer sklepu nie może pobrać plików spod podanych adresów albo kończy mu się czas.
- Nadpisane produkty. Import dopasowuje wiersze po ID albo po indeksie i trafia w inny produkt niż trzeba. Taki przypadek opisuje zgłoszenie na GitHubie PrestaShop.
- Błędy przy kombinacjach. Kombinacje wymagają osobnego pliku, a nawet przykładowy plik potrafił kończyć się błędami, co pokazuje inne zgłoszenie.
Format kolumn i kolejne kroki opisuje dokumentacja importu PrestaShop. Polskie omówienie typowych problemów, w tym timeoutów serwera, ma HelpGuru.
Jak bezpiecznie zaimportować plik CSV?
Najpierw mała próba, potem całość.
- Zrób kopię bazy. Import zmienia wiele produktów naraz i nie ma przycisku cofnij.
- Zapisz plik jako CSV UTF-8 i sprawdź separator w ustawieniach importu.
- Zaimportuj pięć wierszy. W panelu wejdź w Zaawansowane > Importuj, wybierz typ Produkty i wgraj plik testowy.
- Sprawdź te pięć produktów w sklepie. Nazwa, cena netto i brutto, kategoria, zdjęcia.
- Zaimportuj resztę. Przy dużym pliku podziel go na części, żeby nie przekroczyć limitu czasu serwera.
- Przebuduj indeks filtrów, jeśli sklep ich używa. Import zwykle tego nie robi. Więcej w tekście o tym, dlaczego filtry PrestaShop nie działają.
- Wypisz braki. Produkty bez zdjęć, EAN albo opisu po imporcie widać dopiero na liście braków.
Co zrobić, gdy import nie wgrywa zdjęć?
Sprawdzić jeden adres zdjęcia z pliku, zanim zaczniesz szukać błędu w PrestaShop. Otwórz go w przeglądarce w oknie prywatnym. Jeśli zamiast samego zdjęcia widzisz stronę z podglądem, prośbę o logowanie albo błąd, serwer sklepu też go nie pobierze.
Typowe przyczyny są cztery:
- adres prowadzi do strony z galerią w chmurze, a nie do pliku JPG albo PNG,
- serwer dostawcy pozwala pobierać zdjęcia tylko zalogowanym klientom,
- adres zaczyna się od http, a serwer dostawcy przekierowuje go w nietypowy sposób,
- zdjęć jest tak dużo, że import kończy się po limicie czasu serwera.
Ostatni przypadek rozwiązuje podział pliku na mniejsze części albo wyższy limit czasu u hostingu. Wymagania serwera dla PrestaShop opisuje dokumentacja dla developerów. Gdy zdjęcia są ważniejsze niż reszta danych, zaimportuj produkty bez nich, a zdjęcia dodaj w drugim kroku.
Jak dodać produkty z listy dostawcy w rozmowie?
Wklejasz listę, opisujesz zasady, a Claude dodaje produkty jeden po drugim jako wyłączone szkice. Najpierw pokazuje plan i podgląd każdego produktu.
Wklejam listę 12 rękawic od dostawcy. Dodaj je do kategorii Rękawice robocze, ceny z listy plus 35%, napisz krótkie opisy i dodaj zdjęcia z linków. Jeszcze ich nie włączaj.
Sprawdziłem indeksy. 2 produkty z listy już są w sklepie, pomijam je. Plan: 10 nowych produktów, wyłączonych. Podgląd pierwszego:
będzie: Rękawice nitrylowe Grip, rozmiar 9
będzie: Cena: 18,90 zł brutto (z listy 14,00 zł, plus 35%)
będzie: Kategoria: Rękawice robocze, EAN z listy, stan 40 szt.
będzie: Opis: 3 zdania o materiale, chwycie i zastosowaniu
będzie: Zdjęcia: 2 z podanych adresów
Opis bez słowa „najlepsze”. Reszta w porządku, dodawaj.
Poprawione. Dodam produkty po kolei, każdy zapiszę po twojej zgodzie.
Dodawanie produktów i gotowe zadanie Nowe produkty z listy są w wersji płatnej, bo zmieniają sklep od pierwszego kroku. Przykład prośby to nowe produkty z listy od dostawcy. Każdy nowy produkt to osobny zapis, a domyślny limit to 60 zapisów na godzinę. Dlatego rozmowa ma sens przy dziesiątkach, a nie tysiącach. Szczegóły wersji w cenniku.
Co sprawdzić po każdym imporcie?
Listę braków, zanim zrobi to klient. W darmowym Audycie Claude pokaże produkty bez zdjęć, bez EAN i z pustym opisem, z referencją i kategorią. Przykład takiej prośby: produkty bez zdjęć, EAN albo producenta.
Pytania i odpowiedzi
Dlaczego po imporcie CSV polskie znaki zamieniają się w krzaki?
Plik zapisano w innym kodowaniu niż UTF-8, najczęściej w kodowaniu Windows z Excela. PrestaShop czyta go jako UTF-8 i polskie litery się psują. Zapisz plik ponownie jako CSV UTF-8 albo otwórz go w arkuszu, który pozwala wybrać kodowanie przy zapisie, i zaimportuj jeszcze raz.
Dlaczego import CSV nie wgrywa zdjęć?
Najczęściej serwer sklepu nie może pobrać pliku spod podanego adresu. Adres wymaga logowania, prowadzi do strony z podglądem zamiast do samego pliku albo serwer dostawcy blokuje pobieranie. Do tego dochodzą limity czasu na serwerze przy dużej liczbie zdjęć. Sprawdź jeden adres w przeglądarce w oknie prywatnym.
Ile produktów doda Claude w jednej rozmowie?
Kilka do kilkudziesięciu. Każdy nowy produkt to osobny zapis, a moduł domyślnie pozwala na 60 zapisów na godzinę. Zdjęcia dodaje się osobno, do 10 na produkt. Przy setkach i tysiącach pozycji import pliku jest szybszy i to on jest właściwym narzędziem.
Czy nowe produkty od razu pojawią się w sklepie?
Nie. Produkty dodane przez Claude startują wyłączone, jako szkice. Sprawdzasz je w panelu, poprawiasz, co trzeba, i włączasz. Przy włączaniu moduł ostrzega o brakach, na przykład o braku zdjęcia albo stanu. Produktu z ceną 0 nie da się włączyć, więc przypadkowo darmowy towar nie trafi do sprzedaży.
Czy dodawanie produktów działa w darmowym Audycie?
Nie. Audyt tylko czyta sklep, więc nie tworzy produktów. Możesz w nim sprawdzić, które produkty po imporcie nie mają zdjęć, EAN albo opisu. Dodawanie produktów i gotowe zadanie Nowe produkty z listy wymagają wersji płatnej, bo zmieniają sklep od pierwszego kroku.
PrestaShop jest zastrzeżonym znakiem towarowym PrestaShop SA. Claude jest znakiem towarowym Anthropic. TellMyShop nie jest powiązany z żadną z tych firm.