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.

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.

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)
01

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ę.

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ę.

  • identyfikator grupy lub parent_sku
  • SKU każdego wariantu
  • atrybuty różnicujące
  • pola wspólne i pola wariantowe
  • reguła tworzenia nazwy wariantu
02

Macierz kombinacji ujawnia brakujące i zdublowane warianty

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

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.

Macierz kombinacji kolor × rozmiar
Kolor / rozmiarSML
Czarnyjestjestbrak
Białyjestduplikatjest
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.

  • 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.

  • brak EAN dozwolony według reguły biznesowej
  • niepoprawna długość lub format
  • 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ą.

  • 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.

  • 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
  • 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.

  • 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ść.

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.

  • numer wiersza, SKU i grupa
  • pole i wartość źródłowa
  • kod błędu oraz opis problemu
  • sugerowana poprawka
  • decyzja: odrzucono / pominięto / przyjęto z ostrzeżeniem
Artykuł kończy się checklistą i macierzą do pobrania. Świadomie nie dopisujemy tu sekcji FAQ — pytania o sam format pliku znajdziesz w poradniku o przygotowaniu CSV.