Import produktów z CSV w Shoperze: co sprawdzić przed importem i po nim

Import otwierasz z listy produktów: Produkty → Wszystkie → Więcej → Importuj. W oknie wybierasz profil importu, wersję językową sklepu i plik, a potem klikasz Importuj (Shoper Learn, „Jak zaimportować produkty z pliku CSV?”). Wszystko niżej pochodzi z naszych importów na sklepie testowym Shopera z 12 i 20 września 2026.

Przed importem: nagłówek musi powtarzać profil

Profil importu to lista pól w ustalonej kolejności, widoczna na stronie profilu. Shoper porównuje z nią nagłówek pliku pozycja po pozycji i zatrzymuje się na pierwszej różnicy. Plik z kolumną ean wstawioną na drugie miejsce odbił się tak:

Nazwy pól profilu się nie zgadzają. Pole w pliku: 'ean', oczekiwano: 'active'

Dwie pułapki w nagłówku:

• Zdjęcia mają numer. W nagłówku stoi images 1, nie images. Sam images kończy się komunikatem Pole w pliku: 'images', oczekiwano: 'images 1'.
• Kod EAN przyjmuje tylko profil, który go ma. Na naszym sklepie testowym były trzy profile: „Aktualizacja cen” (sześć pól), „Dodawanie i aktualizacja produktów (bez Kodu kreskowego)” i „Dodawanie i aktualizacja produktów (z Kodem kreskowym)”. Kod EAN wchodzi tylko tym ostatnim — w nagłówku to kolumna barcode.

Te profile czytały plik CSV w UTF-8, ze średnikiem między polami i znakiem > między poziomami kategorii. To ustawienia profilu i da się je zmienić.

Po imporcie: licznik liczy wiersze, rozstrzyga dziennik

Po imporcie Shoper pokazuje trzy liczby: Wykrytych produktów, Zaimportowanych produktów i Pominiętych. „Zaimportowany” znaczy tu „przetworzony”: wiersz, który zaktualizował produkt już istniejący, liczy się tak samo jak wiersz, który dodał nowy. W naszym teście ekran pokazał „Zaimportowanych produktów: 2”, a w katalogu przybył jeden produkt. Wiersz odrzucony liczy się jako pominięty.

Co stało się z każdym wierszem, mówi szczegółowy dziennik zdarzeń pod podsumowaniem. Trzy rodzaje wpisów:

Wpis w dzienniku	Co znaczy
Product '…' matched to id '…'	wiersz zaktualizował produkt, który już był w sklepie
Trying to add product '…', potem New object id: …	wiersz dodał nowy produkt
ERR : Field '…' is not valid: …	wiersz odrzucony; po dwukropku stoi przyczyna

Odrzucenie dotyczy wiersza, nie pliku. W naszym teście pierwszy, poprawny wiersz został zapisany, a dwa następne, z błędnym kodem EAN, odrzucone. Ekran podsumowania nie mówi, których produktów brakuje — to widać dopiero w dzienniku. Dwa odrzucenia, które widzieliśmy:

• Field 'price' is not valid: '0' jest mniejsza od '0' — cena 0 zł, której Shoper nie przyjmuje, chyba że sklep sprzedaje produkty bezpłatne (produkt bez ceny w Shoperze);
• Field 'ean' is not valid: Wymagany jest poprawny kod kreskowy — kod EAN w złym formacie, także z niewidocznym znakiem na końcu.

Ten sam kod dwa razy: drugi wiersz nadpisuje pierwszy

Kod produktu jest dla importu kluczem: wiersz z kodem, który sklep już zna, aktualizuje ten produkt. Dotyczy to także dwóch wierszy z tym samym kodem w jednym pliku. W naszym teście dały jeden produkt, z nazwą i ceną z drugiego wiersza, a licznik pokazał oba jako zaimportowane.

Plik od hurtowni albo sklejony z kilku list sprawdź przed importem pod kątem powtórzonych kodów, na przykład formatowaniem warunkowym duplikatów w arkuszu.

Niewidoczny znak w kodzie: drugi produkt z tym samym kodem

Shoper nie pozwala, żeby dwa produkty miały ten sam kod, ale porównuje kody znak po znaku — także te znaki, których nie widać. Kod z twardą spacją albo ze znakiem zerowej szerokości na końcu jest dla niego innym kodem. W naszym teście plik z kodem i z tym samym kodem zakończonym twardą spacją utworzył dwa osobne produkty, a twarda spacja zapisała się w polu kodu. Ze znakiem zerowej szerokości było tak samo.

W panelu oba kody wyglądają identycznie. Sklep ma dwa produkty, a Ty, hurtownia i integracje widzicie jeden kod. Takie znaki przychodzą z arkuszy kalkulacyjnych i z kodów kopiowanych ze stron internetowych, a funkcja usuwania zbędnych spacji w arkuszu twardej spacji nie usuwa. Przy krótkiej liście najpewniej wpisać kody ręcznie.

Kod EAN tej pułapki nie ma: Shoper sprawdza jego format, więc wiersz z niewidocznym znakiem w kodzie kreskowym odrzuca.

Kategorie po nazwie: druga kategoria o tej samej nazwie

Nazwy kategorii w Shoperze nie muszą być unikalne. W naszym teście plik podawał w kolumnie kategorii samą nazwę „Talerze”, choć taka kategoria już była. Import jej nie dopasował i założył drugą o tej samej nazwie — dlaczego, nie ustaliliśmy. Po imporcie z kategoriami przejrzyj listę kategorii, czy nie ma dwóch o tej samej nazwie.

Co sprawdzić na liście produktów

Lista Produkty → Wszystkie ma filtry, które pokażą typowe braki po imporcie, m.in. aktywność (produkty zaimportowane jako wyłączone) i „posiadające zdjęcia”. Produkty i warianty bez kodu EAN zobaczysz, dokładając kolumnę Kod kreskowy przyciskiem Wybierz kolumny i sortując po niej — szczegóły na stronie Kod EAN w Shoperze.

Co z tego sprawdza Merchlint

Merchlint, aplikacja do audytu katalogu z Shoper App Store, co noc przechodzi cały katalog, więc skutki importu widać w najbliższym audycie: niewidoczne znaki w kodzie i nazwie, dwa produkty z tym samym kodem (także takie, które różni tylko niewidoczny znak), produkty bez kodu EAN i z tym samym kodem EAN, produkty poza kategoriami. Przy każdym znalezisku stoi kwota ze sprzedaży, a osobna lista pokazuje, co zmieniło się od poprzedniego audytu. W sklepie niczego nie zmienia, tylko czyta.