Dlaczego pierwszy import decyduje o porządku na lata
Pierwszy import ustawia strukturę katalogu, której potem trzymają się wszystkie kolejne aktualizacje. Jeśli na starcie powstaną duplikaty, błędne warianty albo rozjechane kategorie, każda następna synchronizacja będzie ten bałagan powielać i pogłębiać.
Dlatego import nie zaczyna się od kliknięcia „wgraj plik”, tylko od sprawdzenia danych wejściowych i wykonania importu testowego. Kilkanaście minut na checklistę oszczędza dni ręcznego prostowania katalogu.
Trzeba ustalić, który system jest główny dla SKU, EAN, stanów, cen, zdjęć i atrybutów. Bez tego każdy import będzie tworzył konflikt.
Ręczne poprawki w sklepie nadpisywane kolejnym importem z Excela, XML albo ERP. Dlatego potrzebne są reguły, logi i kontrola zmian.
Struktura pliku, kodowanie i separatory
Najczęstsze błędy importu nie dotyczą produktów, tylko samego pliku: złe kodowanie (krzaki zamiast polskich znaków), przecinek jako separator przy cenach z przecinkiem dziesiętnym, albo nagłówki kolumn, które nie zgadzają się z mapowaniem.
Zanim spojrzysz na produkty, sprawdź technikalia pliku — to one wywalają import albo cicho psują dane.
- kodowanie UTF-8 (polskie znaki wyświetlają się poprawnie)
- separator kolumn świadomie dobrany (np. średnik przy cenach z przecinkiem)
- spójne nagłówki kolumn zgodne z mapowaniem importu
- brak scalonych komórek, pustych wierszy i ukrytych spacji w wartościach
Produkt główny i warianty muszą mieć spójną relację, rozmiary, kolory, zdjęcia i unikalne identyfikatory. W przeciwnym razie listing, filtry i B2B szybko się sypią.
Importer powinien najpierw pokazać, co zmieni, co pominie i gdzie ma niską pewność. Dopiero potem powinien zapisywać dane do sklepu.
Identyfikatory: SKU, EAN i warianty
Identyfikatory to kręgosłup importu. SKU musi być unikalne i stałe — to po nim system rozpoznaje, czy produkt zaktualizować, czy utworzyć nowy. Powtórzone lub zmieniające się SKU to najszybsza droga do duplikatów albo nadpisanych produktów.
Przy wariantach (rozmiar, kolor) trzeba jasno określić relację produktu głównego i wariantów oraz to, które pola są wspólne, a które różne. Bez tego import potrafi rozbić jeden produkt na kilkanaście osobnych albo skleić różne produkty w jeden.
- SKU unikalne, stałe i obecne w każdym wierszu
- EAN poprawny (długość, brak duplikatów między różnymi produktami)
- jasna relacja produkt główny ↔ warianty (parent/child)
- spójne cechy wariantów: rozmiar, kolor, pojemność
Produkt główny i warianty muszą mieć spójną relację, rozmiary, kolory, zdjęcia i unikalne identyfikatory. W przeciwnym razie listing, filtry i B2B szybko się sypią.
Importer powinien najpierw pokazać, co zmieni, co pominie i gdzie ma niską pewność. Dopiero potem powinien zapisywać dane do sklepu.
Kategorie, atrybuty, ceny i stany
Kategorie z pliku trzeba zmapować na realną strukturę sklepu, a nie tworzyć w locie z dowolnego tekstu — inaczej powstają dziesiątki niemal identycznych kategorii. Atrybuty powinny trafiać do właściwych pól, a nie do opisu.
Ceny i stany wymagają osobnej uwagi: format liczb, waluta, brutto/netto, stawki VAT oraz to, czy import ma nadpisywać stan, czy go pomijać. To częste miejsce cichych błędów, które widać dopiero na sklepie.
- mapowanie kategorii z pliku na istniejące drzewo sklepu
- atrybuty w polach atrybutów, nie wrzucone do opisu
- ceny: format liczb, brutto/netto, waluta, stawki VAT
- stany: ustalone, czy import nadpisuje, czy pomija pole
Produkt główny i warianty muszą mieć spójną relację, rozmiary, kolory, zdjęcia i unikalne identyfikatory. W przeciwnym razie listing, filtry i B2B szybko się sypią.
Importer powinien najpierw pokazać, co zmieni, co pominie i gdzie ma niską pewność. Dopiero potem powinien zapisywać dane do sklepu.
Zawsze najpierw import testowy (dry-run)
Ostatni i najważniejszy krok przed zapisem produkcyjnym to import testowy na próbce kilkudziesięciu rekordów albo tryb dry-run z raportem: ile produktów zostanie utworzonych, ile zaktualizowanych, ile odrzuconych i dlaczego.
Jeśli raport pokazuje nieoczekiwane „utworzy 4000 nowych” zamiast „zaktualizuje 4000 istniejących”, to znak, że coś jest nie tak z mapowaniem SKU — i lepiej dowiedzieć się o tym przed, a nie po zapisie.
- próbka 20–50 rekordów lub pełny dry-run z raportem
- sprawdzenie liczby: nowe vs aktualizowane vs odrzucone
- weryfikacja kilku rekordów ręcznie na sklepie testowym
- kopia/backup katalogu przed pierwszym importem produkcyjnym
Produkt główny i warianty muszą mieć spójną relację, rozmiary, kolory, zdjęcia i unikalne identyfikatory. W przeciwnym razie listing, filtry i B2B szybko się sypią.
Importer powinien najpierw pokazać, co zmieni, co pominie i gdzie ma niską pewność. Dopiero potem powinien zapisywać dane do sklepu.
Co sprawdzić przed podjęciem decyzji?
Ten etap porządkuje rozmowę przed wdrożeniem. Dzięki temu zakres nie opiera się na zgadywaniu, tylko na danych, celu biznesowym i realnym procesie.
Od eksportu obecnych danych i sprawdzenia, które pola są źródłem prawdy: SKU, EAN, cena, stan, kategoria, atrybuty, zdjęcia i warianty.
Mapowanie, walidację, logi, tryb dry-run, raport pominięć, obsługę wyjątków i możliwość powtórzenia operacji bez ręcznego sprzątania.
Gdy wspierają filtry, SEO, integracje, marketplace, B2B i codzienną aktualizację bez tworzenia nowych duplikatów lub konfliktów.
Co przygotować przed rozmową?
Nie potrzebujesz gotowej specyfikacji. Wystarczy kilka konkretów, które pozwalają szybko ocenić realny zakres i nie zgadywać kosztu.
Jak przełożyć to na konkretny projekt?
Najlepszy następny krok to krótka diagnoza: obecna platforma, skala katalogu lub strony, źródła danych, aktualne problemy i oczekiwany efekt biznesowy. Dopiero wtedy można dobrać zakres bez przepalania budżetu na elementy, które nie zdejmą realnej pracy z zespołu.
Najczęstsze pytania w tym temacie
Zależy od źródła. CSV jest prostszy i wystarcza do płaskich danych. XML lepiej obsługuje zagnieżdżenia, warianty i bogate atrybuty. Ważniejsze od formatu jest spójne mapowanie i poprawne identyfikatory.
To prawie zawsze złe kodowanie pliku. Zapisz plik w UTF-8 i upewnij się, że narzędzie importu czyta go jako UTF-8. Krzaki to sygnał, żeby wstrzymać import produkcyjny.
Trzymaj stałe, unikalne SKU i mapuj po nim aktualizacje. Jeśli SKU się zmienia między importami, system nie rozpozna istniejącego produktu i utworzy nowy.
Tak, jeśli na to pozwolisz. Dlatego z góry ustala się, które pola import nadpisuje, a których nie dotyka — zwykle stany i ceny aktualizujemy, a dopracowane opisy i SEO zostawiamy w spokoju.