Import produktów do sklepu z Excela i CSV - przygotowanie danych i narzędzia

Zapis do CSV - kodowanie UTF-8, separator i liczby

Największa liczba nieudanych importów to nie błędy w danych, tylko błędy zapisu. Dokumentacja importera WooCommerce wprost zaleca kodowanie UTF-8 i sprawdzenie pliku po zapisie z arkusza. Shopify w opisie pliku CSV produktów wymaga zapisu w UTF-8 ze znakami końca linii w stylu LF (stan na czerwiec 2026 - sprawdź aktualną dokumentację). Plik w innym kodowaniu kończy się nieczytelnymi znakami w miejscu polskich liter w tytułach i opisach.

Drugi problem to separator. Arkusz z polskimi ustawieniami regionalnymi często zapisuje CSV ze średnikiem jako separatorem i przecinkiem w liczbach. Importer, który oczekuje przecinka, odczyta wtedy cały wiersz jako jedną kolumnę albo podzieli cenę 49,99 na dwie wartości. Rozwiązania są dwa: zapisać plik w formacie oczekiwanym przez sklep albo przygotować plik skryptem, który pilnuje separatora i formatu liczb niezależnie od ustawień komputera.

Trzecia pułapka to otwieranie gotowego CSV w arkuszu tylko po to, żeby go obejrzeć. Przy ponownym zapisie arkusz może zmienić format dat, usunąć zera wiodące z kodów i zamienić długie liczby na zapis naukowy. Plik po eksporcie lepiej sprawdzać w edytorze tekstu albo prostym skryptem.

[#przyklad] Prosty test duplikatów SKU w Pythonie (plik z separatorem średnika): import csv; rows = list(csv.DictReader(open('produkty.csv', encoding='utf-8-sig'), delimiter=';')); skus = [r['SKU'].strip() for r in rows]; print({s for s in skus if skus.count(s) > 1}). Kodowanie utf-8-sig odczyta też plik zapisany z BOM.

Import produktów CSV w WooCommerce i Shopify - jak działają importery

Wbudowany importer WooCommerce automatycznie mapuje rozpoznane kolumny na pola produktu, a resztę można przypisać ręcznie albo pominąć opcją niezaimportowania kolumny. Przy aktualizacji istniejących produktów WooCommerce dopasowuje wiersze po ID lub SKU, a wiersz z ID, którego nie ma w sklepie, jest pomijany. Warianty mają typ variation i wskazują produkt nadrzędny przez jego ID lub SKU. Dokumentacja zaleca dzielenie dużych plików na mniejsze partie i test małego importu na kopii sklepu (stan na czerwiec 2026 - sprawdź aktualną dokumentację WooCommerce).

Shopify rozpoznaje produkt po uchwycie, czyli fragmencie adresu URL produktu, który nie może zawierać spacji. Warianty to kolejne wiersze z tym samym uchwytem: pierwszy wiersz ma wszystkie dane produktu, następne tylko uchwyt i dane wariantu. Przy imporcie można zaznaczyć nadpisywanie produktów o pasujących uchwytach - bez tego takie produkty są pomijane. Plik CSV produktów nie może przekraczać 15 MB, a produkt ma najwyżej 3 opcje, np. rozmiar, kolor i materiał (stan na czerwiec 2026 - sprawdź aktualną dokumentację Shopify).

Wspólny wniosek dla obu platform: identyfikator jest ważniejszy niż wszystkie pozostałe kolumny. Literówka w SKU albo zmieniony uchwyt to najprostsza droga do duplikatów. Jeśli importujesz z hurtowni lub od dostawcy i dane przychodzą cyklicznie, lepszy od ręcznego CSV bywa automatyczny import, który opisujemy we wpisie import produktów z hurtowni przez XML i API.

Walidacja danych przed importem - co sprawdzić automatycznie

Walidacja to zestaw reguł, które sprawdzają plik przed wysłaniem do sklepu. Nie musi być rozbudowana. Kilka prostych testów wykrywa większość problemów, a wiersze z błędami trafiają do osobnego pliku z opisem przyczyny. Reguły warto podzielić na błędy krytyczne, które zatrzymują wiersz, i ostrzeżenia, które przepuszczają produkt, ale trafiają do listy poprawek.

1. Struktura pliku - czy są wszystkie wymagane kolumny i czy każdy wiersz ma tę samą liczbę pól.

2. Unikalność - czy SKU nie powtarza się w pliku i czy nie koliduje z innym produktem w sklepie.

3. Formaty - czy cena i stan to liczby, czy EAN ma właściwą długość i składa się z cyfr.

4. Powiązania - czy kategoria istnieje w sklepie, a wariant ma produkt nadrzędny.

5. Zasoby - czy adresy zdjęć odpowiadają, zamiast zwracać błąd.

Jakość pliku łatwo mierzyć jednym wskaźnikiem: jaki odsetek wierszy odpada na walidacji. Jeśli z każdą partią maleje, poprawki w danych źródłowych działają.

[#chart:wpr48c]

Najczęstsze błędy przy imporcie produktów i jak je naprawić

Po imporcie warto porównać liczbę wierszy w pliku z liczbą produktów dodanych i zaktualizowanych w raporcie importera. Różnica to wiersze pominięte lub odrzucone. Typowe objawy i ich przyczyny zebraliśmy poniżej:

[#chart:wpr48b]

Jeśli import tworzy duplikaty, nie usuwaj ich od razu hurtem. Najpierw ustal, który rekord jest powiązany z zamówieniami, feedami i integracjami, bo usunięcie niewłaściwego potrafi zerwać powiązania z marketplace. Przy dużych zmianach zrób kopię bazy przed importem i trzymaj plik, z którego importowano, razem z datą. Gdy import jest częścią procesu wystawiania ofert na marketplace, przydadzą się wskazówki z wpisu masowe wystawianie ofert z pliku CSV i API.

Aktualizacja cen i stanów przez import CSV - na co uważać

Import służy nie tylko do dodawania produktów. Wielu sprzedawców raz w tygodniu albo codziennie aktualizuje plikiem ceny i stany. Przy takim imporcie najbezpieczniej wysyłać tylko kolumny, które mają się zmienić, plus identyfikator. Plik z pełnym kompletem kolumn nadpisze też opisy, kategorie i zdjęcia, nawet jeśli ktoś w międzyczasie poprawił je ręcznie w panelu. W praktyce to częsta przyczyna znikających poprawek: zespół poprawia opis w sklepie, a następny import przywraca starą wersję z arkusza.

Druga sprawa to puste komórki. Zależnie od platformy i ustawień importera pusta komórka może zostać zignorowana albo wyczyścić pole w produkcie. Zanim zaczniesz regularne aktualizacje, sprawdź to na jednym produkcie testowym: zaimportuj wiersz z pustą wartością w wybranej kolumnie i zobacz, co stało się z kartą produktu. Ten sam test warto powtórzyć po każdej większej aktualizacji platformy lub rozszerzenia do importu.

Trzecia kwestia to zdjęcia. Importer pobiera je z podanych adresów, więc duża liczba zdjęć wydłuża import i obciąża serwer. Jeśli zdjęcia się nie zmieniły, lepiej nie przesyłać ich przy każdej aktualizacji cen. Przy pierwszym imporcie sprawdź za to, czy adresy zdjęć nie wygasają - linki tymczasowe z dysków w chmurze potrafią działać przez kilka godzin, a potem zwracać błąd, co kończy się produktami bez grafik.

Narzędzia do importu produktów - wbudowany importer, aplikacja czy skrypt

Wbudowany importer platformy wystarczy przy jednorazowym imporcie i katalogu, który mieści się w kilku plikach. Gdy importy są regularne, dane przychodzą od kilku dostawców albo trzeba przeliczać ceny i łączyć je ze stanami, sprawdzają się rozszerzenia do importu albo integrator. Konkretne rozszerzenie dobieraj po aktualnej dokumentacji i opiniach w oficjalnym katalogu platformy, bo ich funkcje i cenniki często się zmieniają.

Własny skrypt lub integracja przez API ma sens, gdy importer w panelu przestaje wystarczać: plik jest zbyt duży, trzeba łączyć dane z kilku źródeł, a wynik każdego wiersza ma trafić do raportu. Skrypt może walidować dane, pobierać zdjęcia, mapować kategorie i wysyłać zmiany przez API sklepu w partiach, z zapisem, który produkt został utworzony, a który zaktualizowany.

[#checklista] Przed importem: kopia bazy sklepu; jeden identyfikator dla produktu i wariantu; kolumny wg szablonu platformy; plik CSV w UTF-8 sprawdzony w edytorze tekstu; walidacja bez błędów krytycznych; test na kilkunastu wierszach; import partiami; porównanie liczby wierszy z raportem importera.

Jak Vinson pomaga przy imporcie produktów do sklepu

Zapewniamy wsparcie programistyczne dla sklepów i sprzedawców: integracje, automatyzacje, poprawki i rozwój sklepów oraz narzędzi. Przy imporcie produktów porządkujemy dane, przygotowujemy pliki zgodne z szablonem WooCommerce, Shopify lub innej platformy, piszemy walidatory i skrypty importu przez API oraz usuwamy duplikaty, które zostały po wcześniejszych importach. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Czy mogę zaimportować produkty do sklepu bezpośrednio z pliku Excel?

Większość platform sklepowych oczekuje pliku CSV, a nie XLSX. Arkusz trzeba więc zapisać jako CSV z kodowaniem UTF-8 i kolumnami zgodnymi z szablonem sklepu. Po zapisie warto sprawdzić plik w edytorze tekstu, bo arkusz potrafi zmienić format liczb i kodów.

Dlaczego po imporcie CSV mam zduplikowane produkty?

Importer nie rozpoznał istniejących produktów po identyfikatorze. W WooCommerce kluczem jest ID lub SKU, a w Shopify uchwyt produktu, więc literówka, spacja albo zmieniony uchwyt powodują utworzenie nowego produktu. Przed kolejnym importem ujednolij identyfikatory i wykonaj test na kilku wierszach.

Jak zaimportować produkty z wariantami?

W Shopify warianty to kolejne wiersze z tym samym uchwytem produktu i wartościami opcji, a w WooCommerce wiersze typu variation z odwołaniem do produktu nadrzędnego po ID lub SKU. Każdy wariant powinien mieć własne SKU. Najpierw sprawdź poprawność jednego produktu z wariantami, potem importuj resztę.

Jaki jest limit rozmiaru pliku CSV przy imporcie produktów?

Zależy od platformy. Shopify podaje limit 15 MB dla pliku CSV produktów, a WooCommerce zależy od ustawień serwera i zaleca dzielenie dużych plików na mniejsze partie (stan na czerwiec 2026 - sprawdź aktualną dokumentację). Przy dużych katalogach import w partiach jest bezpieczniejszy także dlatego, że łatwiej znaleźć błędny wiersz.

Dlaczego polskie znaki w nazwach produktów wyświetlają się źle po imporcie?

Plik został zapisany w innym kodowaniu niż UTF-8. Zapisz arkusz ponownie jako CSV w UTF-8 albo przekonwertuj plik edytorem tekstu, a potem powtórz import dla błędnych produktów. Przed tym zrób kopię bazy, żeby móc cofnąć zmiany.

Import produktów z Excela i CSV staje się powtarzalny, gdy dane mają stałe identyfikatory, plik jest zapisany poprawnie, a walidacja wyłapuje błędy przed importem. Jeśli chcesz zautomatyzować ten proces albo uporządkować katalog po nieudanych importach, sprawdź wsparcie programistyczne Vinson. Jeśli import ma działać przez API sklepu, zacznij od wpisu integracja API sklepu internetowego - jak to działa.