Import produktów z CSV/XML do sklepu krok po kroku

Import produktów z CSV/XML - po co i kiedy

Ręczne dodawanie produktów jeden po drugim ma sens przy kilkunastu pozycjach. Gdy katalog rośnie do setek albo tysięcy indeksów, każda ręczna zmiana ceny czy stanu to godziny pracy i pole do błędów. Import masowy z pliku CSV lub XML rozwiązuje ten problem: przygotowujesz jeden plik z całym katalogiem, mapujesz kolumny na pola produktu i wgrywasz wszystko naraz.

Import przyda Ci się w kilku typowych sytuacjach:

• Start sklepu - masz katalog w arkuszu i chcesz go załadować od razu, zamiast wpisywać ręcznie.
• Współpraca z hurtownią lub dostawcą - dostajesz gotowy feed XML z produktami, cenami i stanami.
• Regularna aktualizacja - codziennie odświeżasz ceny i dostępność z pliku od dostawcy.
• Migracja z innego systemu - eksportujesz katalog ze starego narzędzia i wgrywasz do nowego (o tym więcej w sekcji o migracji).

Zanim zaczniesz, warto wiedzieć, co powinno się znaleźć w danych produktu. Dobrze przygotowana karta produktu importuje się bez poprawek, bo od razu ma komplet informacji.

Przygotowanie pliku CSV lub XML

Jakość importu zaczyna się od pliku. Kilka zasad, które oszczędzą Ci nerwów:

Format i kodowanie. Zapisuj plik w kodowaniu UTF-8, żeby polskie znaki (ą, ć, ę, ł, ń, ó, ś, ź, ż) nie zamieniły się w krzaki. W CSV ustal jeden separator - w Polsce często jest to średnik, bo przecinek koliduje z liczbami dziesiętnymi.

Klucz unikalny w każdym wierszu. Każdy produkt musi mieć identyfikator, po którym system rozpozna, czy to nowa pozycja, czy aktualizacja istniejącej. Najczęściej jest to SKU (Twój wewnętrzny symbol) albo EAN (kod kreskowy). Bez klucza kolejny import stworzy duplikaty.

Spójne formaty danych. Ceny z kropką jako separatorem dziesiętnym (19.99, nie 19,99), stany jako liczby całkowite, waga w jednej jednostce. Puste pole zostaw puste, nie wpisuj myślnika ani „brak".

Minimalny zestaw kolumn, od którego warto zacząć:

Jeśli produkty mają rozmiary lub kolory, potrzebujesz dodatkowej struktury - o tym w sekcji o wariantach.

Mapowanie pól - serce importu

Mapowanie to moment, w którym mówisz systemowi, że kolumna price z Twojego pliku to pole „cena", a stock to „stan magazynowy". Brzmi trywialnie, ale to tu powstaje większość problemów.

Kilka reguł, które warto zapamiętać:

1. Mapuj tylko to, co chcesz zmienić. Jeśli import ma odświeżać wyłącznie ceny i stany, zmapuj tylko te dwie kolumny plus klucz (SKU). Reszta danych w sklepie (opisy, zdjęcia) zostanie nietknięta.
2. Uważaj na typy danych. Cena musi trafić do pola liczbowego, nie tekstowego. Data w formacie, którego system się spodziewa. Zły typ to najczęstsza przyczyna odrzucenia wiersza.
3. Zapisz szablon mapowania. Gdy dostawca zawsze przysyła plik w tym samym układzie, zapisujesz mapowanie raz i kolejne importy idą automatycznie po ustalonym schemacie.

Dobrą praktyką jest testowy import próbki. Zamiast wgrywać od razu 2000 wierszy, wgraj 10, sprawdź, czy dane wpadły na właściwe pola, i dopiero wtedy puść całość. Raport importu pokaże, ile wierszy przeszło, a ile zostało odrzuconych i dlaczego.

Zdjęcia, warianty i dane rozszerzone

Zdjęcia w imporcie masowym podajesz jako adresy URL, a nie same pliki. System pobiera obrazek spod linku podczas importu. Dla kilku zdjęć jednego produktu masz dwie drogi: rozdzielić adresy separatorem w jednej komórce CSV albo skorzystać z XML, gdzie każde zdjęcie to osobny węzeł. Linki muszą być publiczne (bez logowania) i prowadzić do plików w rozsądnej rozdzielczości.

Warianty to produkty z rozmiarami, kolorami lub innymi cechami. W CSV najczęściej modeluje się je tak, że każdy wariant to osobny wiersz z własnym SKU, a wspólny produkt nadrzędny wskazuje kolumna parent_sku albo group_id. XML radzi sobie z tym elegancko przez zagnieżdżenie wariantów wewnątrz produktu. Jeśli sprzedajesz odzież czy obuwie, zajrzyj do artykułu o zarządzaniu wariantami produktów, bo od modelu wariantów zależy, jak później działa magazyn i oferty.

Dane rozszerzone - parametry (materiał, wymiary), oznaczenia (nowość, promocja), przypisania do kategorii marketplace. Im więcej z tego jest już w pliku, tym mniej ręcznej pracy po imporcie. Pamiętaj o stanach magazynowych i buforze bezpieczeństwa - warto zaimportować realny stan pomniejszony o rezerwę, żeby nie sprzedać towaru, którego fizycznie już nie ma.

Cykliczne aktualizacje i integracja katalogu

Jednorazowy import to dopiero początek. W praktyce katalog żyje: ceny się zmieniają, stany spadają po każdej sprzedaży, dochodzą nowe produkty. Dlatego warto rozdzielić dwa scenariusze:

• Import pełny - cały katalog, rzadziej (przy większych zmianach asortymentu, nowej kolekcji, migracji).
• Import różnicowy - tylko ceny i stany, często (codziennie lub kilka razy dziennie), po kluczu SKU/EAN, mapując wyłącznie zmieniane kolumny.

Gdy dostawca udostępnia feed XML pod stałym adresem URL, aktualizacja może pobierać ten plik automatycznie zamiast ręcznego wgrywania. To standardowy model przy współpracy z hurtowniami.

W NavyFlame katalog jest centralnym miejscem, z którego zasilasz magazyn i wystawiasz oferty. Zaimportowane produkty stają się źródłem prawdy dla wielu kanałów jednocześnie - Allegro, eBay, Erli czy własnego sklepu. Naturalnym kolejnym krokiem po imporcie jest eksport katalogu na wiele marketplace, gdzie z jednego zestawu danych tworzysz listingi na wybranych platformach, z mapowaniem kategorii i cenami per kanał. Po publikacji synchronizacja stanów pilnuje, żeby sprzedaż na jednym kanale zdejmowała ilość na pozostałych i nie doszło do oversellingu.

Import to fundament porządku w katalogu. Dobrze przygotowany plik, przemyślane mapowanie i regularne aktualizacje zamieniają godziny ręcznej dłubaniny w kilka minut przy dobrze wydeptanej ścieżce.

Najczęstsze błędy przy imporcie

Na koniec lista pułapek, na których potyka się większość sprzedawców:

• Zły separator lub kodowanie - krzaki zamiast polskich znaków albo cały wiersz w jednej komórce. Zawsze UTF-8 i jeden ustalony separator.
• Brak klucza unikalnego - import bez SKU/EAN tworzy duplikaty przy każdym powtórzeniu.
• Przecinki w cenach - 19,99 zamiast 19.99 rozjeżdża kolumny w CSV.
• Martwe linki do zdjęć - obrazek za logowaniem albo usunięty plik nie pobierze się.
• Nadpisanie opisów przez pusty import - jeśli mapujesz kolumnę opisu, a w pliku jest pusta, możesz skasować gotowe treści. Nie mapuj pól, których nie chcesz ruszać.
• Import bez testu na próbce - wgranie 2000 wierszy naraz bez sprawdzenia mapowania to prosta droga do bałaganu w całym katalogu.

Regularny, powtarzalny import z jednego stałego formatu pliku to jedna z najprostszych rzeczy, które oszczędzają czas w codziennej pracy sklepu i redukują ryzyko pomyłek przy wielu kanałach sprzedaży.

Najczesciej zadawane pytania