Przejdź do treści

Jak zwalidować warianty produktów przed importem?

Warianty są jednym z najczęstszych źródeł błędów importu. Problem nie polega tylko na brakującym rozmiarze. System musi wiedzieć, które rekordy należą do jednego modelu, które kombinacje są unikalne, jaki wariant ma stan i EAN oraz co zrobić z niepełną rodziną produktów.

Macierz kombinacji kolor × rozmiar jednej rodziny

macierz rodzinyprzykład
Kolor / rozmiarSMLWynik
CzarnyjestjestbrakCzarny / L: brak
BiałyjestduplikatjestBiały / M: dwa rekordy
Taki widok natychmiast pokazuje brakującą kombinację oraz dwa rekordy opisujące ten sam wariant.
Walidacja wariantów to kontrola rodziny, nie wiersza

Pojedynczy wiersz może być poprawny, a cała rodzina błędna: dwa razy ten sam rozmiar, brakujący kolor, EAN powtórzony między wariantami albo grupa łącząca dwa różne modele.

Objaw w katalogu
  • Zamiast jednej karty z rozmiarami powstało pięć osobnych produktów, część rozmiarów zniknęła, a stan „ostatnia sztuka” pokazuje się przy niedostępnym wariancie.
Pierwszy test
  • Zgrupuj rekordy po variant_group i wypisz macierz kolor × rozmiar.
  • Braki i duplikaty widać wtedy od razu, bez czytania tysiąca wierszy.
01

Przykład brakującego i powtórzonego wariantu

Dla rodziny kolor × rozmiar utwórz macierz – taką jak w otwarciu poradnika. Taki widok natychmiast pokazuje brakującą kombinację oraz dwa rekordy opisujące ten sam wariant.

Fragment raportu: wariant Biały / M

Grupa i wariant
ta sama variant_group, kombinacja Biały / M w dwóch wierszach
Pole i wartość
kolor: Biały, rozmiar: M
Problem
kombinacja atrybutów nie jest unikalna w rodzinie
Decyzja
odrzucono / pominięto / przyjęto z ostrzeżeniem – według poziomu błędu (sekcja 08)
brak
Czarny / L. Nie każda brakująca kombinacja jest błędem — producent może jej nie oferować — ale brak musi być świadomy, a nie wynikać ze zgubionego wiersza.
duplikat
Biały / M: dwa rekordy opisujące ten sam wariant.
konflikt
Pola wspólne sprzeczne między wariantami albo EAN powtórzony między wariantami. Tego macierz kombinacji nie pokazuje – sprawdza go kontrola rodziny (sekcja 08) i kontrola EAN (sekcja 04).

Co sprawdzamy w rodzinie wariantowej

Dwa poziomy

rozdzielenie poziomu produktu głównego i wariantu

Sekcja 02

Kombinacje

unikalność kombinacji atrybutów w obrębie rodziny

Sekcja 08

SKU i EAN

unikalne SKU i własny EAN każdej jednostki sprzedażowej

Sekcje 03–04

Słownik

kontrolowany słownik wartości kolorów i rozmiarów

Sekcja 05

Arkusz z kolumnami rodziny, kombinacji, SKU, EAN, stanu i statusu kontroli. Służy do przejścia rodzin przed importem i zapisania decyzji.

Pobierz macierz kontroli wariantów (CSV)
Tożsamość
produkt główny i wariant, SKU, EAN, słownik atrybutów
Dostępność
ceny i stany na poziomie wariantu
Wygląd
zdjęcia kolorów
02

Produkt główny i wariant nie są tym samym rekordem

Produkt główny opisuje rodzinę: nazwę modelu, opis, kategorię, markę i wspólne zdjęcia. Wariant opisuje konkretną jednostkę sprzedażową, na przykład kolor czarny i rozmiar M. To wariant ma zwykle własne SKU, EAN, stan i czasem cenę. Najostrzej widać to w Magento, gdzie produkt konfigurowalny i jego warianty to osobne byty.

W Shoperze wariant to rekord product-stocks z extended: 1 i wartością opcji; rekord z extended: 0 bez rozmiaru nie jest wariantem, a gdy nosi flagę domyślności, panel pokazuje „0 szt.” przy pełnej rozmiarówce — w jednym katalogu dotyczyło to ok. 11,7 tys. produktów (patrz wariant domyślny w Shoperze po imporcie z BaseLinkera).

Shoper: rekordy product-stocks
"extended": 1 + wartość opcjiwariant"extended": 0 bez rozmiarunie jest wariantem"extended": 0 + flaga domyślnościpanel pokazuje „0 szt.” przy pełnej rozmiarówce
W jednym katalogu dotyczyło to ok. 11,7 tys. produktów.

Jeżeli plik nie rozróżnia tych poziomów, importer może utworzyć osobne karty dla każdego rozmiaru albo przeciwnie — połączyć różne modele w jedną rodzinę.

Model rodziny wariantów na jednym wierszu

wiersz wariantudane przykładowe
variant_groupSKUkolorrozmiarEANstan
MODEL-AMODEL-A-CZARNY-MCzarnyMEAN wariantustan wariantu
variant_group łączy wiersz z produktem głównym, który opisuje rodzinę: nazwę modelu, opis, kategorię, markę i wspólne zdjęcia. SKU, EAN i stan należą do wariantu; kolor i rozmiar to atrybuty różnicujące.
  • identyfikator grupy lub parent_sku
  • SKU każdego wariantu
  • atrybuty różnicujące
  • pola wspólne i pola wariantowe
  • reguła tworzenia nazwy wariantu
03

Każda sprzedawana kombinacja potrzebuje unikalnego SKU

SKU wariantu powinno być stabilne i unikalne. Nie generuj SKU ponownie przy każdym imporcie, jeżeli ma ono służyć do aktualizacji produktu. Zmiana SKU może spowodować utworzenie nowego rekordu zamiast aktualizacji istniejącego.

Błędy SKU do wychwycenia

puste, powtórzone, SKU produktu głównego, znaki, spacje, wielkość liter
  • puste SKU
  • powtórzone SKU w różnych grupach
  • SKU produktu głównego użyte jako SKU wariantu
  • znaki niewspierane przez system docelowy
  • spacje i niewidoczne znaki
  • przypadkowe różnice wielkości liter
04

EAN identyfikuje wariant, nie całą rodzinę

Jeżeli warianty są osobnymi jednostkami handlowymi, każdy powinien mieć własny EAN. Ten sam kod przypisany do rozmiaru M i L uniemożliwi wiarygodne skanowanie, integrację magazynową i matching w marketplace.

Kontrole EAN wariantu

brak według reguły, EAN-13 i EAN-8, duplikat, zapis naukowy, kod opakowania
  • brak EAN dozwolony według reguły biznesowej
  • EAN-13: 13 cyfr i poprawna cyfra kontrolna; EAN-8 dla małych opakowań
  • duplikat EAN w kilku wariantach
  • EAN zapisany w arkuszu jako liczba naukowa
  • EAN produktu opakowaniowego przypisany do sztuki
05

Atrybuty muszą mieć kontrolowany słownik

granat, Granatowy, NAVY i navy blue mogą oznaczać ten sam kolor, ale dla importera są czterema wartościami. To samo dotyczy rozmiarów M, Medium, 38/40 oraz m.

Nie każdy parametr powinien być osią wariantowania. Materiał, kolekcja czy sezon mogą być filtrami, ale nie muszą tworzyć osobnego SKU. Mapowanie wartości źródłowych na docelowe prowadzimy tak samo jak mapowanie kategorii produktów: z regułami, wyjątkami i akceptacją. W sklepie na Shoperze ten słownik jest częścią przygotowania importu produktów CSV/XML.

Słownik: wartość źródłowa → wartość docelowa

słownik kolorówdane przykładowe
Wartość źródłowaWartość docelowaTyp atrybutu
granatGranatowykolor
GranatowyGranatowykolor
NAVYGranatowykolor
navy blueGranatowykolor
Cztery wartości dla importera, jedna wartość w sklepie. W słowniku zapisujesz też kolejność prezentacji i to, czy wartość tworzy wariant.

Co zapisać w słowniku

wartość źródłowa i docelowa, typ i kolejność, wariant czy parametr
  • wartość źródłowa i wartość docelowa
  • typ atrybutu i kolejność prezentacji
  • informacja, czy wartość tworzy wariant, czy jest tylko parametrem
06

Ceny i stany trzeba sprawdzać na poziomie wariantu

Jeżeli stan jest zapisany tylko na produkcie głównym, sklep nie będzie wiedział, którego rozmiaru faktycznie brakuje. Jeżeli cena jest wspólna, można ją dziedziczyć, ale proces musi rozstrzygać wyjątki.

Kontrole ceny i stanu wariantu

stan, wartości ujemne, cena, cena promocyjna, waluta, suma wariantów
  • stan jest liczbą całkowitą albo wartością zgodną z modelem magazynowym
  • brak ujemnych wartości, chyba że system świadomie je obsługuje
  • cena jest większa od zera albo rekord ma status niedostępny
  • cena promocyjna nie jest wyższa od bazowej. Porównuj właściwe pole: w Shoperze cena po promocji to comp_price, nie price — porównanie ze złym polem daje fałszywe błędy i zapisy do cofnięcia
  • waluta i brutto/netto są jednoznaczne
  • stan produktu głównego nie nadpisuje sumy wariantów bez reguły
07

Zdjęcia kolorów muszą być przypisane świadomie

Najczęstszy model to wspólne zdjęcia dla wariantów rozmiaru i osobne zdjęcia dla kolorów. Plik powinien umożliwiać przypisanie zdjęcia do grupy koloru albo konkretnego SKU.

Kontrole zdjęć wariantu

zdjęcie koloru, inny model, URL, kolejność, zdjęcie główne rodziny
  • wariant koloru ma zdjęcie
  • zdjęcie nie wskazuje innego modelu
  • URL odpowiada
  • kolejność zdjęć jest zachowana
  • główne zdjęcie rodziny nie nadpisuje zdjęcia wariantu bez potrzeby
08

Walidacja rodziny przed zapisem

Dobra walidacja nie analizuje każdego wiersza w izolacji. Najpierw grupuje rekordy według variant_group, a następnie sprawdza rodzinę jako całość.

Walidacja rodziny, nie wiersza

  1. najpierwGrupowanierekordy według variant_group
  2. potemKontrola rodzinycała rodzina jako całość
  3. błąd blokującyDuplikat SKUzatrzymuje zapis
  4. ostrzeżenieBrak zdjęciamoże być ostrzeżeniem

Wyniki powinny mieć poziomy: błąd blokujący, ostrzeżenie i informacja. Brak zdjęcia może być ostrzeżeniem, ale duplikat SKU powinien zatrzymać zapis.

  • czy grupa ma nazwę i kategorię
  • czy istnieje co najmniej jeden wariant
  • czy kombinacje atrybutów są unikalne
  • czy wszystkie SKU są unikalne globalnie
  • czy pola wspólne nie są sprzeczne między wariantami
  • czy zdjęcia i opisy są przypisane do odpowiedniego poziomu
  • czy grupa nie łączy różnych marek lub modeli
09

Raport powinien wskazywać, co poprawić

Komunikat „rekord niepoprawny” nie wystarcza. Przy tysiącach wariantów potrzebne jest również podsumowanie: liczba rodzin, wariantów, duplikatów, brakujących pól i rekordów gotowych do importu.

Raport: co podać przy każdym rekordzie
Element raportuPrzykład: wariant Biały / M
numer wiersza, SKU i grupata sama variant_group, kombinacja Biały / M w dwóch wierszach
pole i wartość źródłowakolor: Biały, rozmiar: M
kod błędu oraz opis problemukombinacja atrybutów nie jest unikalna w rodzinie
sugerowana poprawka—
decyzjaodrzucono / pominięto / przyjęto z ostrzeżeniem

Import, po którym nie poprawiasz wariantów ręcznie

Ustawimy reguły dla rodzin produktów, poziomy błędów i blokadę zapisu przy błędzie krytycznym. Do sklepu trafiają kompletne warianty, a reszta czeka w raporcie z gotową listą poprawek.

Podobna realizacja936 testów przed wdrożeniem, ok. 115 tys. produktów i wariantówSportina B2B · Magento