WooCommerce 11.2: import po GTIN, EAN lub ISBN bez duplikatów

Aby aktualizować produkty po GTIN, EAN lub ISBN, w zapowiedzianym WooCommerce 11.2 trzeba włączyć Update existing products i zmapować kolumnę z kodem na właściwe pole. Dopasowanie po takim identyfikatorze działa, gdy wiersz nie zawiera ID ani SKU; pierwszeństwo mają ID, następnie SKU. Tak opisują zmianę oficjalne informacje przed wydaniem.

Rekomenduję odrzucić z pliku aktualizacji wiersze bez identyfikatora i najpierw przetestować niewielką próbkę. Samo zaznaczenie aktualizacji nie powinno zastępować kontroli danych.

W skrócie

Przed importem porównaj kody z pliku dostawcy z kodami zapisanymi w sklepie.
Do próby wybierz zarówno poprawny wiersz, jak i przypadek bez dopasowania.
Oddziel aktualizację obecnego katalogu od dodawania nowych pozycji.
Po imporcie sprawdź konkretne produkty, a nie tylko komunikat o zakończeniu.

Czy WooCommerce 11.2 jest już wydany?

Stan weryfikacji: 5 października 2026 r. Oficjalna lista wydań wskazuje WooCommerce 11.1.2 jako wersję stabilną. Lista wydań WooCommerce.

Zapowiedź 11.2 opublikowano 21 września 2026 r. Udostępnia ona wersję beta i podaje 6 października 2026 r. jako początek planowanego tygodnia wydania, a nie potwierdzenie publikacji wersji stabilnej tego dnia. WooCommerce 11.2.0 Pre-release notes.

Przed wdrożeniem rekomenduję ponownie sprawdzić komunikat o finalnym wydaniu i przeprowadzić próbę na kopii sklepu. Poniższy poradnik łączy standardową procedurę importu z zasadami dopasowania zapowiedzianymi dla nowej wersji.

Jak przygotować kody i plik CSV

GTIN jest identyfikatorem produktu w systemie GS1. GTIN-12 określa się także jako UPC, a GTIN-13 jako EAN lub JAN; ISBN służy identyfikacji książek. Wyjaśnienie GS1.

WooCommerce ma wbudowane pole globalnego identyfikatora, opisane również w dokumentacji GTIN. Dokumentacja WooCommerce: GTIN. Rekomenduję sprawdzić, czy kod dostawcy jest zapisany właśnie w tym polu produktu, zanim zaczniesz aktualizację po kodzie.

Zalecana kontrola przed importem

Przygotowując plik wyłącznie do aktualizacji, rekomenduję:

Porównać wartości znak po znaku. Sprawdź początkowe zera, spacje i zapis kodu w gotowym pliku. Nie poprawiaj numerów na podstawie podobnej nazwy produktu.
Wyłączyć puste wiersze identyfikacyjne. Odłóż pozycje bez kodu do ręcznego wyjaśnienia zamiast uzupełniać je przypadkową wartością.
Zweryfikować powtórzenia. Dla każdego powtarzającego się kodu ustal, której pozycji ma dotyczyć aktualizacja.
Ograniczyć zakres zmian. Jeśli celem jest aktualizacja ceny, nie dołączaj do próby nowych opisów, zdjęć i przebudowy wariantów.
Przygotować punkt odniesienia. Zachowaj kopię sklepu oraz zestawienie produktów objętych próbą, z ich dotychczasowymi cenami i stanami.

Jeśli chcesz testować dopasowanie wyłącznie po kodzie, rekomenduję przygotować osobny plik bez ID i SKU. Nie usuwaj tych kolumn z pliku roboczego, dopóki nie potwierdzisz, że wszystkie przeznaczone do aktualizacji pozycje mają właściwy kod w sklepie.

Import CSV krok po kroku

Nazwy elementów interfejsu poniżej zachowują angielskie brzmienie z oficjalnych źródeł.

Przygotuj CSV z danymi produktów i zapisz go w kodowaniu UTF-8. Przygotowanie CSV.
Otwórz Products > All Products i wybierz Import. Procedura aktualizacji.
Przez Choose File wskaż plik, następnie zaznacz Update existing products. Procedura aktualizacji.
Wybierz Continue i sprawdź Column mapping. Mapowanie kolumn. Dla kolumny z kodem wybierz pole GTIN, UPC, EAN, or ISBN, którego taką nazwę potwierdza kod importera WooCommerce.
Popraw pozostałe mapowania; kolumny do pominięcia oznacz jako Do not import. Procedura aktualizacji.
Wybierz Run the importer i zaczekaj na zakończenie. Nie odświeżaj strony ani jej nie opuszczaj podczas importu. Procedura aktualizacji.

Po próbie rekomenduję otworzyć każdy objęty nią produkt i porównać zmienione wartości z plikiem. Dopiero po zgodnym wyniku przejdź do pozostałych pozycji.

Kiedy wiersz zostanie pominięty, a kiedy powstanie produkt?

Poniższe przypadki dotyczą aktualizacji po globalnym identyfikatorze przy braku ID i SKU. Reguły opisuje wdrożona zmiana w repozytorium WooCommerce.

Sytuacja	Zachowanie opisane w zmianie
Kod pasuje do istniejącego produktu o zgodnym typie	Aktualizacja istniejącego produktu.
Kod niepusty po normalizacji nie ma dopasowania	Pominięcie wiersza zamiast tworzenia produktu.
Komórka z kodem jest pusta lub wartość po normalizacji staje się pusta, np. `n/a`	Traktowanie jako brak identyfikatora; wiersz produktu może utworzyć nowy produkt mimo włączonej aktualizacji.
Dopasowany produkt ma inny typ niż wiersz	Odrzucenie dopasowania.

Pusty kod i niepusty kod bez dopasowania dają różne wyniki. Pomijanie dotyczy kodów, które po normalizacji pozostają niepuste i nie mają dopasowania; wartość taka jak n/a staje się pustym identyfikatorem, więc przy braku ID i SKU wiersz produktu może utworzyć nowy produkt mimo zaznaczenia Update existing products. Końcowy kod PR #67940. Rekomenduję odłożyć przed importem wiersze z wartościami, które po normalizacji stają się puste. Dlatego rekomenduję nie traktować pustej komórki jako sposobu na bezpieczne pominięcie produktu.

Jeśli w katalogu występują powtarzające się identyfikatory, implementacja porządkuje wyszukiwanie według ID, aby wybór dopasowania był powtarzalny. Opis implementacji. Rekomenduję rozstrzygnąć takie powtórzenia przed importem, zamiast pozostawiać wybór rekordów mechanizmowi dopasowania.

Uwaga na nowe warianty

Dokumentacja wskazuje wyjątek obowiązujący od WooCommerce 11.1: niedopasowany wiersz wariantu może utworzyć nowy wariant podczas aktualizacji, jeśli Parent wskazuje istniejący produkt wariantowy, wiersz ma SKU lub zmapowany kod oraz atrybuty i wartości już obecne u rodzica. Dokumentacja aktualizacji i wariantów.

Rekomenduję testować warianty osobno. Jeśli celem jest wyłącznie zmiana cen lub stanów istniejących pozycji, wyłącz z próbki wiersze przeznaczone do dodawania wariantów.

Co sprawdzić, gdy aktualizacja się nie uda

Oficjalna dokumentacja zaleca zacząć od logu importu przy brakujących lub pominiętych produktach. Rozwiązywanie problemów z importem.

Następnie rekomenduję porównać pominięty wiersz z konkretnym rekordem sklepu: identyfikator, typ produktu oraz wybrane mapowanie kolumn. Zanotuj przyczynę dla każdej pozycji i popraw plik przed kolejną próbą. Nie wyłączaj trybu aktualizacji tylko po to, by wymusić przetworzenie nierozpoznanego wiersza. Najpierw ustal, czy ma on aktualizować obecny produkt, czy świadomie utworzyć nowy.