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.
- 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.
- Zgrupuj rekordy po
variant_groupi wypisz macierz kolor × rozmiar. - Braki i duplikaty widać wtedy od razu, bez czytania tysiąca wierszy.
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
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
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).
"extended": 1 + wartość opcjiwariant"extended": 0 bez rozmiarunie jest wariantem"extended": 0 + flaga domyślnościpanel pokazuje „0 szt.” przy pełnej rozmiarówceJeż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
| variant_group | SKU | kolor | rozmiar | EAN | stan |
|---|---|---|---|---|---|
| MODEL-A | MODEL-A-CZARNY-M | Czarny | M | EAN wariantu | stan 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
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
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
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
| Wartość źródłowa | Wartość docelowa | Typ atrybutu |
|---|---|---|
| granat | Granatowy | kolor |
| Granatowy | Granatowy | kolor |
| NAVY | Granatowy | kolor |
| navy blue | Granatowy | kolor |
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
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, nieprice— 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
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
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
- Grupowanierekordy według
variant_group - Kontrola rodzinycała rodzina jako całość
- Duplikat SKUzatrzymuje zapis
- Brak 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
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.
| Element raportu | Przykład: wariant Biały / M |
|---|---|
| numer wiersza, SKU i grupa | ta sama variant_group, kombinacja Biały / M w dwóch wierszach |
| pole i wartość źródłowa | kolor: Biały, rozmiar: M |
| kod błędu oraz opis problemu | kombinacja atrybutów nie jest unikalna w rodzinie |
| sugerowana poprawka | — |
| decyzja | odrzucono / pominięto / przyjęto z ostrzeżeniem |