Jak masowo importować produkty do WooCommerce

Opcja 1: wbudowany importer CSV WooCommerce

WooCommerce zawiera importer i eksporter produktów w formacie CSV. W panelu WordPress przejdź do Produkty → Wszystkie produkty i wybierz Importuj. Prześlij plik CSV, przypisz jego kolumny do pól WooCommerce i uruchom import. Zaznaczenie opcji „Update existing products” pozwala aktualizować produkty dopasowane po ID lub SKU zamiast tworzyć duplikaty.

• Najpierw wyeksportuj jeden istniejący produkt i użyj tego pliku jako szablonu — pokazuje dokładne nazwy kolumn oczekiwane przez Twój sklep.
• Typowe kolumny to Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images oraz Attribute 1 name / Attribute 1 value(s).
• Zdjęcia są importowane z adresów URL, więc muszą być publicznie dostępne w czasie importu.
• Produkty zmienne wymagają wiersza nadrzędnego typu „variable” i jednego wiersza na każdy wariant, który odwołuje się do produktu nadrzędnego.
• Bardzo duże pliki mogą przekraczać limit czasu na hostingu współdzielonym — podziel je na partie po kilkaset wierszy.

Opcja 2: wtyczki importu

Wtyczki importu firm trzecich dodają funkcje, których brakuje w importerze podstawowym: zaplanowane lub cykliczne importy z pliku produktowego dostawcy, obsługę XML, reguły transformacji pól i lepszą obsługę bardzo dużych plików. Mają sens, gdy dostawca regularnie przysyła zaktualizowane pliki z cenami i stanami magazynowymi.

Wtyczki nadal oczekują ustrukturyzowanych danych wejściowych. Jeśli dostawca przekazuje pliki PDF zamiast pliku produktowego, wtyczka nie zdejmuje z Ciebie pracy związanej z zamianą tych plików PDF w wiersze.

Opcja 3: REST API WooCommerce

Programiści i narzędzia integracyjne mogą tworzyć produkty przez REST API WooCommerce, w tym przez punkt końcowy wsadowy, który tworzy lub aktualizuje wiele produktów w jednym żądaniu. Pasuje to do zautomatyzowanych procesów i aplikacji, które tworzą produkty bezpośrednio, bez etapu CSV.

Doc2Shelf korzysta z tej drogi: po weryfikacji wysyła produkty do WooCommerce jako proste produkty robocze z długimi i krótkimi opisami, abyś mógł je sprawdzić w WooCommerce przed opublikowaniem. Globalne atrybuty filtrów i produkty zmienne konfiguruje się osobno w WooCommerce.

Przygotowanie danych produktów do importu zbiorczego

Niezależnie od metody importu, o wyniku decyduje jakość danych. Przed importem:

• Nadaj każdemu produktowi unikalny SKU — dzięki niemu późniejsze aktualizacje trafiają do właściwego produktu.
• Najpierw utwórz w WooCommerce kategorie i atrybuty globalne, a następnie odwołuj się do nich konsekwentnie.
• Ujednolij specyfikacje: te same jednostki, te same nazwy atrybutów, jedna wartość w komórce.
• Pisz prawdziwe opisy zamiast wklejać tekst dostawcy; platformy handlowe i wyszukiwarki nagradzają unikalne treści.
• Przy pierwszym uruchomieniu importuj produkty jako wersje robocze — ustaw Published na -1 (0 oznacza produkty prywatne) — a następnie sprawdź próbkę przed opublikowaniem całości.

Gdy dostawca przesyła tylko pliki PDF

Wielu dostawców udostępnia karty katalogowe i katalogi jako pliki PDF, a nie pliki produktowe CSV. W takim przypadku wąskim gardłem jest ekstrakcja: ktoś musi przeczytać każdy plik PDF, wypełnić kolumny i napisać opis.

Możesz robić to ręcznie albo wyodrębnić dane za pomocą narzędzia i je zweryfikować. Doc2Shelf odczytuje pliki PDF dostawców, wyodrębnia specyfikacje do weryfikacji, przygotowuje długie i krótkie opisy WooCommerce i tworzy produkty jako wersje robocze przez REST API — zastępując etap arkusza kalkulacyjnego w katalogach opartych na plikach PDF.

Typowe błędy importu w WooCommerce

Jeśli import się nie powiedzie lub daje nieoczekiwane wyniki, sprawdź najpierw:

• Zduplikowane lub brakujące SKU powodujące pomijanie wierszy lub duplikowanie produktów.
• Nieprawidłowe kodowanie pliku — zapisz CSV jako UTF-8, aby znaki diakrytyczne zaimportowały się poprawnie.
• Adresy URL zdjęć, które przekierowują, wymagają logowania lub prowadzą do bardzo dużych plików.
• Niespójnie zapisane ścieżki kategorii (dla kategorii zagnieżdżonych użyj „Nadrzędna > Podrzędna”).
• Warianty, których wartości atrybutów nie zgadzają się z wartościami atrybutów produktu nadrzędnego.

Opis kolumn CSV produktów WooCommerce

Podstawowy importer odczytuje stały zestaw nazw kolumn. Eksport jednego produktu z własnego sklepu daje dokładne nagłówki oczekiwane przez Twoją wersję WooCommerce; poniższa tabela wyjaśnia kolumny najważniejsze przy imporcie zbiorczym. Wymagana jest tylko kolumna Name — każda inna jest opcjonalna, ale katalog zaimportowany bez Type, SKU, cen i kategorii zostawia później dużo pracy ręcznej.

Kolumny z jednostką w nagłówku, takie jak Weight i trzy wymiary, pokazują jednostkę skonfigurowaną w ustawieniach sklepu, więc kopiuj te nagłówki z eksportu zamiast je wpisywać. Dane niestandardowe, które nie mają własnej kolumny, trafiają do kolumny, której nagłówek zaczyna się od meta:, a po nim następuje klucz pola.

Produkty zmienne w pliku CSV: wiersze produktu nadrzędnego i wariantów

Produkt zmienny rozciąga się na kilka wierszy: jeden wiersz produktu nadrzędnego, który definiuje produkt i oferowane wartości atrybutów, oraz po jednym wierszu na każdy wariant, zawierającym cenę, SKU i stan magazynowy jednej kombinacji. Wiersz produktu nadrzędnego ma Type „variable”; każdy wiersz wariantu ma Type „variation” i wskazuje produkt nadrzędny w kolumnie Parent, podając jego SKU lub id: i jego ID.

Kolumny atrybutów łączą wiersze. W produkcie nadrzędnym Attribute 1 value(s) wymienia wszystkie oferowane wartości, oddzielone przecinkami. W każdym wariancie ta sama Attribute 1 name występuje z dokładnie jedną z tych wartości. Pisownia i wielkość liter muszą się zgadzać: wariant z wartością „czerwony” pod produktem nadrzędnym oferującym „Czerwony” może pozostać bez użytecznej wartości atrybutu.

Ustaw Attribute 1 global na 1 w produkcie nadrzędnym i jego wariantach, gdy używasz atrybutu ogólnosklepowego utworzonego w Produkty → Atrybuty — z nim działają nawigacja warstwowa i widżety filtrów. Od WooCommerce 11.1 import aktualizujący może też dodawać nowe warianty do istniejącego produktu zmiennego, więc możesz rozszerzyć asortyment bez odtwarzania produktu nadrzędnego.

• Trzymaj każdy wiersz produktu nadrzędnego nad jego wariantami, aby plik był łatwy do sprawdzenia, a produkt nadrzędny istniał, gdy odwołują się do niego warianty.
• Nadaj każdemu wariantowi własny SKU i cenę; wariantu bez ceny nie można kupić.
• Użyj Attribute 1 default w produkcie nadrzędnym, aby określić, która opcja jest wstępnie wybrana.

Dodawanie zdjęć produktów przez plik CSV

Kolumna Images przyjmuje jeden lub więcej adresów URL zdjęć oddzielonych przecinkami. Pierwszy adres staje się zdjęciem głównym, a pozostałe tworzą galerię produktu w podanej kolejności. Podczas importu WordPress pobiera każdy plik do biblioteki multimediów, więc każdy adres URL musi być w tym momencie publicznie dostępny — bez logowania, bez wygasającego linku do udostępnienia i bez przekierowania na stronę internetową zamiast do pliku.

Zdjęcia są zwykle najwolniejszą częścią importu: kilkaset produktów po pięć zdjęć to ponad tysiąc pobrań. Zmniejsz zdjęcia przed umieszczeniem ich na serwerze, używaj opisowych nazw plików (kettle-red-front.jpg, a nie IMG_0042.jpg) i dziel duże katalogi na mniejsze pliki.

Podstawowy importer nie potrafi ustawić tekstu alternatywnego zdjęć. Dodaj go później w bibliotece multimediów, przez REST API lub za pomocą rozszerzenia importu, które to obsługuje. Wariant ma jedno zdjęcie, więc w wierszu każdego wariantu podawaj co najwyżej jeden adres URL.

Masowe tworzenie produktów przez REST API WooCommerce

REST API to lepsza droga, gdy importy się powtarzają, gdy dane produktów już znajdują się w innym systemie albo gdy nikt nie powinien w ogóle obsługiwać pliku CSV. Jego punkt końcowy wsadowy dla produktów (POST /wp-json/wc/v3/products/batch) przyjmuje operacje tworzenia, aktualizacji i usuwania w jednym żądaniu.

Domyślnie żądanie wsadowe jest ograniczone do 100 obiektów łącznie w operacjach tworzenia, aktualizacji i usuwania. Ten sam limit dotyczy punktów końcowych wsadowych dla wariantów, kategorii, atrybutów i wartości atrybutów. Katalog liczący 1000 produktów wymaga więc co najmniej dziesięciu żądań, a po dodaniu wariantów — więcej.

1. Utwórz klucz REST API z uprawnieniami odczytu i zapisu w WooCommerce → Ustawienia → Zaawansowane → REST API lub pozwól aplikacji zażądać go przez ekran autoryzacji WooCommerce.
2. Najpierw utwórz kategorie, atrybuty globalne i wartości atrybutów oraz zapisz ich identyfikatory.
3. Wysyłaj produkty proste i nadrzędne partiami do 100, z ustawionym statusem wersji roboczej (draft).
4. Utwórz warianty każdego produktu zmiennego przez punkt końcowy wsadowy wariantów tego produktu.
5. Sprawdź wynik dla każdej pozycji w odpowiedzi i ponów tylko te pozycje, które się nie powiodły.
6. Wyrywkowo sprawdź próbkę wersji roboczych w panelu administracyjnym, a następnie opublikuj je.

Wybór wtyczki lub sposobu masowego importu produktów do WooCommerce

Jeśli podstawowy importer nie wystarcza, oceniaj wtyczkę lub rozszerzenie importu po tym, jak obsługuje Twoje dane, a nie po długości listy funkcji, i przed podjęciem decyzji przetestuj je na testowej kopii sklepu (staging) z prawdziwym plikiem dostawcy. Tabela porównuje cztery sposoby, a po niej znajdują się pytania, które warto zadać każdej wtyczce.

• Formaty źródłowe: tylko CSV czy także XML, pliki arkuszy kalkulacyjnych i zdalne feedy pobierane z adresu URL.
• Harmonogram: czy potrafi ponawiać import według harmonogramu, aby pobierać nowe ceny i stany magazynowe.
• Mapowanie i transformacje: zmiana nazw kolumn, dzielenie wartości, przeliczanie jednostek i stosowanie reguł cenowych podczas importu.
• Produkty zmienne: czy niezawodnie tworzy produkty nadrzędne, warianty i atrybuty globalne.
• Zdjęcia: jak je pobiera, czy wykrywa duplikaty i czy ustawia tekst alternatywny.
• Duże pliki: przetwarzanie w tle lub partiami, aby długie importy nie przekraczały limitu czasu.
• Reguły aktualizacji: według jakiego klucza dopasowuje (ID, SKU lub GTIN) i które pola może nadpisywać.

Lista kontrolna przed importem i naprawa błędów

Większość nieudanych importów wynika z pominięcia któregoś kroku przygotowania. Przejdź przez listę kontrolną przed każdym dużym importem, a tabelę wykorzystaj do diagnozowania problemów, które mimo to się pojawią.

1. Wykonaj kopię zapasową bazy danych lub uruchom import na testowej kopii sklepu (staging).
2. Wyeksportuj jeden istniejący produkt i skopiuj jego wiersz nagłówkowy do swojego pliku.
3. Utwórz kategorie, atrybuty globalne i wartości atrybutów, do których odwołuje się plik.
4. Sprawdź, czy każdy SKU jest unikalny, a wartość Parent każdego wariantu odpowiada istniejącemu SKU produktu nadrzędnego.
5. W kolumnach ceny, stanu magazynowego, masy i wymiarów używaj samych liczb.
6. Otwórz próbkę adresów URL zdjęć w oknie prywatnym przeglądarki, aby potwierdzić, że ładują się bez logowania.
7. Ustaw Published na -1, aby produkty trafiły jako wersje robocze.
8. Zapisz plik jako CSV w kodowaniu UTF-8.
9. Zaimportuj dziesięciowierszowy plik testowy, sprawdź wyniki, a następnie zaimportuj resztę partiami.

Testowanie na produktach próbnych przed właściwym importem

Mały plik próbny wychwytuje błędy mapowania, zanim dotkną setek produktów. Zbuduj go na podstawie swojego prawdziwego szablonu, aby nagłówki były identyczne, i oznacz każdy produkt testowy w oczywisty sposób — prefiksem SKU „TEST-” i tagiem „test” — aby później łatwo je znaleźć i usunąć.

Uwzględnij każdy przypadek, który występuje w prawdziwym pliku, nie tylko najłatwiejszy. Zwykle wystarczy około dziesięciu wierszy:

• Jeden produkt prosty z wypełnionymi wszystkimi kolumnami, których zamierzasz używać.
• Jeden produkt zmienny z dwoma atrybutami i co najmniej trzema wariantami.
• Jeden produkt z galerią kilku zdjęć i jeden bez zdjęć.
• Jeden produkt w zagnieżdżonej kategorii, która jeszcze nie istnieje.
• Jeden produkt ze znakami diakrytycznymi, cudzysłowami i przecinkiem w opisie.
• Jeden wiersz, który aktualizuje istniejący produkt po SKU.
• Sprawdź wyniki w panelu administracyjnym i na stronie sklepu — ceny, listy rozwijane wariantów, kolejność zdjęć i strony kategorii — a następnie usuń produkty testowe przed właściwym importem.