Jak importować produkty do sklepu internetowego?

Import produktów do sklepu internetowego polega na przeniesieniu danych z pliku CSV lub XML do bazy sklepu. Najważniejszym etapem jest mapowanie pól, czyli przypisanie kolumn pliku do konkretnych informacji w systemie, takich jak nazwa, cena, SKU, opis czy zdjęcia. Dzięki temu można dodać setki produktów szybciej i z mniejszą liczbą błędów niż przy ręcznym uzupełnianiu formularzy.

Na czym polega import produktów?

Plik importowy jest tabelą albo uporządkowanym dokumentem zawierającym dane o produktach. Samo przesłanie go do panelu administracyjnego nie wystarczy. Sklep musi wiedzieć, która kolumna zawiera nazwę, która cenę, a która kod produktu. Temu służy mapowanie.

W praktyce wskazujesz na przykład, że kolumna „product_name” odpowiada polu „Nazwa produktu”, „price” – cenie brutto, a „sku” – numerowi katalogowemu. Jeśli źródło danych pochodzi z hurtowni, jego układ zwykle nie odpowiada bezpośrednio strukturze sklepu. Przed importem trzeba więc usunąć zbędne kolumny, zmienić nazwy nagłówków albo przygotować reguły przekształcania danych.

Produkty powinny mieć unikalny identyfikator. Najczęściej jest nim SKU, numer katalogowy albo EAN. Identyfikator pozwala rozpoznać istniejący produkt podczas późniejszej aktualizacji. Bez niego system może utworzyć duplikaty zamiast zmienić cenę lub stan magazynowy.

Najczęściej używane pola przedstawia poniższa tabela:

CSV czy XML – który format wybrać?

Wybór formatu zależy od źródła danych i częstotliwości zmian. CSV przypomina tabelę z arkusza kalkulacyjnego, dlatego łatwo otworzyć go w Excelu lub innym edytorze. XML ma bardziej rozbudowaną strukturę i często służy jako feed produktowy udostępniany przez hurtownię.

CSV wymaga ustalenia separatora, na przykład przecinka, średnika albo tabulatora. W polskich plikach często spotyka się średnik. XML nie korzysta z separatorów kolumn, ale importer musi znać strukturę dokumentu i wiedzieć, gdzie znajdują się poszczególne dane.

Jak importować produkty krok po kroku?

Dokładne nazwy przycisków zależą od platformy, ale logika procesu jest podobna w większości systemów:

1. Przygotuj plik – zbierz nazwy, ceny, identyfikatory, opisy, kategorie, zdjęcia i stany magazynowe w układzie możliwym do odczytania przez importer.
2. Oczyść dane – usuń zbędne kolumny, powtarzające się rekordy i informacje, których sklep nie obsługuje. Pliki z hurtowni często wymagają takiego przygotowania.
3. Zweryfikuj format – sprawdź kodowanie, separator, format cen, zapis wag oraz sposób wskazywania zdjęć i kategorii.
4. Zmapuj pola – przypisz każdą kolumnę do odpowiadającego jej pola w sklepie. W tym miejscu określasz między innymi, która kolumna jest nazwą, ceną, SKU i opisem.
5. Wykonaj import testowy – użyj niewielkiej próbki, na przykład kilku lub kilkunastu produktów, aby sprawdzić rezultat na kartach produktów.
6. Uruchom import właściwy – po poprawnym teście załaduj pełny plik i sprawdź raport błędów oraz liczbę dodanych produktów.

Przed kliknięciem przycisku importu sprawdź przygotowanie pliku według krótkiej listy:

• Kodowanie UTF-8 – chroni polskie znaki przed zamianą na niezrozumiałe symbole.
• Poprawny separator – każda kolumna musi być rozdzielana zgodnie z ustawieniem importera.
• Unikalne SKU lub EAN – identyfikatory nie powinny powtarzać się między różnymi produktami.
• Poprawne ceny i liczby – usuń zbędne spacje oraz sprawdź, czy system przyjmuje przecinek lub kropkę dziesiętną.
• Sprawdzone adresy zdjęć – grafiki muszą być dostępne dla systemu i zapisane bez przypadkowych znaków.
• Mała próbka testowa – najpierw zaimportuj ograniczoną liczbę rekordów.

Opisy wymagające HTML trzeba sprawdzić pod kątem zgodności z edytorem sklepu. Niektóre platformy przyjmują podstawowe znaczniki, inne oczekują czystego tekstu. Błędny kod może zniekształcić wygląd karty produktu.

Import jednorazowy a synchronizacja danych

Import jednorazowy służy do początkowego dodania asortymentu albo większej paczki nowych produktów. Synchronizacja działa inaczej. Jej zadaniem jest cykliczne sprawdzanie źródła i aktualizowanie istniejących rekordów, na przykład cen, stanów magazynowych lub stawek VAT.

Do aktualizacji system musi wiedzieć, którego produktu dotyczy zmiana. Dlatego SKU, numer katalogowy lub EAN powinien pozostać stały w pliku źródłowym i w sklepie. Zmiana identyfikatora może spowodować potraktowanie rekordu jako nowego produktu.

Automatyczną synchronizację często uruchamia się za pomocą zadań CRON. Serwer pobiera wtedy plik według ustalonego harmonogramu i przekazuje go importerowi. Częstotliwość zależy od szybkości zmian w ofercie, możliwości platformy i dostawcy danych.

Notka ekspercka: zanim ustawisz zadanie CRON, wykonaj ręczną aktualizację na małej próbce. Automatyzacja powtarza również błędy, więc niepoprawne mapowanie może cyklicznie nadpisywać dane w sklepie.

W modelu dropshipping synchronizacja stanów i cen ma szczególne znaczenie, ponieważ produkty znajdują się w magazynie hurtowni. Sam feed XML nie gwarantuje jednak bezproblemowej integracji. Czasem wymaga oczyszczenia, przeliczenia cen, dopasowania kategorii albo połączenia pól z kilku źródeł.

Najczęstsze problemy podczas importu

Nieudany import zwykle wynika z niezgodności struktury pliku z ustawieniami systemu. Najczęściej pojawiają się następujące problemy:

• Polskie znaki wyświetlają się nieprawidłowo z powodu innego kodowania niż UTF-8.
• Kolumny przesuwają się, ponieważ plik używa przecinka, a importer oczekuje średnika albo tabulatora.
• Powtarzające się SKU lub EAN powodują duplikowanie produktów albo błędne aktualizacje.
• Ceny nie są rozpoznawane przez spacje, nieprawidłowy separator dziesiętny lub dopisek waluty.
• Zdjęcia nie wczytują się, gdy adresy są niedostępne albo zawierają niedozwolone znaki.
• Kod HTML w opisie powoduje błędy lub zaburza wygląd strony produktu.

Jeśli plik z hurtowni jest niekompatybilny z platformą, można przygotować go ręcznie w arkuszu kalkulacyjnym. Przy dużych i regularnie aktualizowanych plikach lepszym rozwiązaniem bywa skrypt albo dedykowany moduł integracyjny. Najważniejsze jest jednak zachowanie stałych identyfikatorów i poprawne mapowanie pól, bo to one decydują, czy import utworzy właściwe produkty oraz czy późniejsze aktualizacje trafią do odpowiednich rekordów.