Przejdź do treści

Walidacja danych produktowych przed importem i automatyzacją

Błędny EAN, pusta cena albo źle przypięty wariant z pliku dostawcy trafia do sklepu i psuje sprzedaż, filtry i integracje. Stawiamy reguły, które sprawdzają każdy rekord przy każdym imporcie: dobry idzie do sklepu, błędny do raportu z powodem.

Realizacja21 639 nazw produktów zapisanych przez API w ok. 4 h, bez jednego błęduCMP Polska · Shoper
Jeden rekord przed zapisem: pole, reguła, decyzja przykład · dane demonstracyjne
  • rekord RN-210-M · Rękawice narciarskie, rozmiar M aktualizacja istniejącego produktu z pliku hurtowni sprawdzany
  • pole: EAN 5900000412347 cyfra kontrolna z pierwszych 12 cyfr to 4, w pliku jest 7 naruszenie
  • reguła EAN-13 w tym katalogu: poprawna cyfra kontrolna, unikalny poziom ważności ustalony dla tej reguły: BLOCK BLOCK
  • decyzja Rekord nie zapisany, w sklepie zostaje poprzedni EAN raport: kod błędu, wartość z pliku, priorytet blokujący, sugerowana akcja: sprawdź kod u dostawcy w raporcie
Przykład na danych demonstracyjnych: SKU i EAN są zmyślone. Poziom ważności każdej reguły ustalamy z Tobą.

Które rekordy można zaimportować? Decyzja zapada przed zapisem

Cztery rekordy z pliku hurtowni: który przejdzie, a który zostanie w raporcie. Te same wiersze na każdym etapie. Raport podaje kod błędu, poziom i powód; do sklepu trafia tylko to, co przeszło reguły albo ma ostrzeżenie, które ustaliliśmy jako dopuszczalne.

Import butów trekkingowych: cztery warianty demo · dane przykładowe

Cztery wiersze z pliku hurtowni przed zapisem do sklepu. Kolumna „Title” to długość meta title w znakach.

SKUEANRodzicCenaTitle Stan
BT-38 5900000000031 BT 349,00 58 zn. do sprawdzenia
BT-39 — BT 349,00 58 zn. do sprawdzenia
BX-40 5900000000048 BX 349,00 61 zn. do sprawdzenia
BS-41 5900000000055 BS 0,00 92 zn. do sprawdzenia

Każde pole przechodzi reguły: pole wymagane, typ i zakres, słownik, unikalność, relacja wariant–produkt. Podświetlone komórki naruszają regułę.

SKUEANRodzicCenaTitle Stan
BT-38 5900000000031 BT 349,00 58 zn. reguły spełnione
BT-39 — BT 349,00 58 zn. wymagane: pusty EAN
BX-40 5900000000048 BX 349,00 61 zn. relacja: brak produktu BX
BS-41 5900000000055 BS 0,00 92 zn. zakres: cena 0,00; title ponad limit

Poziom ważności jest częścią reguły: OK, WARN albo BLOCK. Przy kilku naruszeniach decyduje najwyższy poziom.

SKUEANRodzicCenaTitle Stan
BT-38 5900000000031 BT 349,00 58 zn. OK
BT-39 — BT 349,00 58 zn. WARN · MISSING_EAN
BX-40 5900000000048 BX 349,00 61 zn. BLOCK · VARIANT_CONFLICT
BS-41 5900000000055 BS 0,00 92 zn. BLOCK · cena 0,00; WARN · SEO_TITLE_TOO_LONG

Zapis albo raport z powodem i priorytetem: blokujący, ważny albo kosmetyczny. Zablokowany rekord nie nadpisuje danych w sklepie.

SKUEANRodzicCenaTitle Stan
BT-38 5900000000031 BT 349,00 58 zn. zapisany
BT-39 — BT 349,00 58 zn. zapisany; raport: brak EAN, priorytet ważny
BX-40 5900000000048 BX 349,00 61 zn. niezapisany; raport: priorytet blokujący
BS-41 5900000000055 BS 0,00 92 zn. niezapisany; raport: cena blokująca, title kosmetyczny
Demonstracja na danych przykładowych: SKU, EAN i ceny są zmyślone. Progi (np. długość title) i poziomy ustalamy z klientem.

Co dostajesz w raporcie

Walidacja pokazuje, które rekordy można bezpiecznie zapisać, które wymagają poprawy i które powinny zostać zablokowane. Zespół dostaje raport z priorytetem, powodem błędu i sugerowaną akcją, zamiast szukać problemu po nieudanym imporcie.

Kiedy potrzebna jest Twoja decyzja

  • Poziom ważności każdej reguły ustalamy z Tobą, tak samo progi (np. długość title).
  • Przed zapisem dostajesz raport błędów i krótką listę rekordów do decyzji, więc nikt nie poprawia sklepu po nieudanym imporcie.
  • Tam, gdzie reguła jest jednoznaczna, przygotowujemy poprawki, mappery albo plik do kontrolowanego zapisu.

Fragment raportu · te same cztery rekordy: rekord i jego decyzja

raport-walidacji.csvdane demonstracyjne
SKU · poziomPowódWynik
BT-38 · OKreguły spełnionezapisany
BT-39 · WARN · MISSING_EANwymagane: pusty EANzapisany; raport: brak EAN, priorytet ważny
BX-40 · BLOCK · VARIANT_CONFLICTrelacja: brak produktu BXniezapisany; raport: priorytet blokujący
BS-41 · BLOCK · cena 0,00; WARN · SEO_TITLE_TOO_LONGzakres: cena 0,00; title ponad limitniezapisany; raport: cena blokująca, title kosmetyczny
Zablokowany rekord nie nadpisuje danych w sklepie.

Co sprawdzamy, zanim błąd trafi do sklepu

Reguły w trzech rodzinach. Automatyzacja przyspiesza pracę tylko wtedy, gdy nie powiela błędów ze starego sklepu, hurtowni albo arkusza. Dlatego przed zapisem sprawdzamy strukturę katalogu, relacje wariantów i pola, które wpływają na SEO, filtry, integracje oraz obsługę zamówień.

SKU, EAN, kody wariantów

Identyfikatory

SKU, EAN, kody wariantów, duplikaty i puste pola. Od identyfikatorów zależy import, aktualizacja stanów, eksport zamówień i połączenie z ERP.

ceny i stany, zdjęcia, treści SEO

Pola wymagane i zakresy

  • Ceny i stany wartości zerowe, ujemne, puste, podejrzane skoki i rozjazdy między źródłami
  • Zdjęcia braki, niedziałające linki, duplikaty i przypisanie zdjęć do wariantów
  • Treści SEO opisy, krótkie opisy, title, description, długości i duplikaty
relacje, kategorie, atrybuty

Relacje wariantów i struktura

  • Relacje produktów produkt główny, warianty, rozmiary, kolory, modele i grupowanie
  • Kategorie i atrybuty niespójne kategorie, brakujące parametry filtrów i konflikty klasyfikacji

Pełna tabela: obszar, reguła i błąd, który zatrzymuje

sześć obszarów walidacji i błędy zatrzymywane przed publikacją
Obszary walidacji danych produktowych i błędy, które zatrzymują
ObszarCo sprawdza regułaJaki błąd zatrzymuje przed publikacją
IdentyfikatorySKU, EAN, kody wariantów, duplikaty i puste polaten sam SKU przy różnych produktach albo wariantach; brak EAN/GTIN tam, gdzie kanał wymaga jednoznacznej identyfikacji. Od identyfikatorów zależy import, aktualizacja stanów, eksport zamówień i połączenie z ERP.
Relacje produktówprodukt główny, warianty, rozmiary, kolory, modele i grupowanierozmiary, kolory i modele, które nie tworzą spójnej relacji produkt główny → wariant
Ceny i stanywartości zerowe, ujemne, puste, podejrzane skoki i rozjazdy między źródłamipuste, zerowe albo nierealne wartości, które bez kontroli trafiłyby do sprzedaży
Zdjęciabraki, niedziałające linki, duplikaty i przypisanie zdjęć do wariantówprodukty bez zdjęć, które obniżają zaufanie i często nie powinny być publikowane automatycznie
Kategorie i atrybutyniespójne kategorie, brakujące parametry filtrów i konflikty klasyfikacjistruktura z technicznych nazw feedu hurtowni zamiast odzwierciedlenia sposobu kupowania
Treści SEOopisy, krótkie opisy, title, description, długości i duplikatymeta title, description i opisy za długie, puste, zdublowane albo niespójne z kategorią

Od reguł do raportu: przebieg walidacji

  1. Pobranie danychEksportujemy produkty ze sklepu, pliku, ERP albo hurtowni.
  2. Reguły walidacjiUstalamy, które pola są krytyczne, a które informacyjne.
  3. Raport błędówTworzymy listę braków, konfliktów i produktów wymagających decyzji.
  4. Priorytety naprawyDzielimy błędy na blokujące, ważne i kosmetyczne.
  5. Bezpieczne poprawkiTam, gdzie reguła jest jednoznaczna, przygotowujemy poprawki, mappery albo plik do kontrolowanego zapisu.

Efekt: katalog gotowy do importu, SEO i automatyzacji

  • Mniej błędów po imporcie i publikacji.
  • Bezpieczniejsze wdrożenia AI/API.
  • Lepsze filtry, SEO i integracje.
  • Reguły działają przy każdym imporcie, nie tylko raz.
produktów
ok. 22 tys.
wariantów
ok. 168 tys.
W sklepie, który obsługujemy na co dzień (ok. 22 tys. produktów, ok. 168 tys. wariantów), reguły działają co noc po imporcie: przestawiają flagę wariantu domyślnego, uzupełniają czas wysyłki, a nowym kolorom znanych modeli nadają nazwę, kolor i kategorie.

Walidacja danych — pytania

Nie ma tu Twojego pytania? Napisz

Nie. Audyt to jednorazowa diagnoza eksportu z planem napraw i priorytetami. Walidacja to zestaw reguł uruchamiany przy każdym kolejnym imporcie, który zatrzymuje błędny rekord przed zapisem; poziom ważności błędu jest częścią reguły.
Tak. Najczęściej wynik ma formę CSV/XLSX z błędami, priorytetem i sugestią naprawy.
Tak, to jej główne zastosowanie: przy każdym imporcie z hurtowni i każdej aktualizacji katalogu. W sklepie, który obsługujemy na co dzień (ok. 22 tys. produktów, ok. 168 tys. wariantów), reguły co noc sprawdzają i poprawiają skutki importu: wariant domyślny, czas wysyłki oraz nazwy, kolory i kategorie nowych produktów.
Może proponować opisy, klasyfikację i uzupełnienia, ale propozycje przechodzą te same reguły walidacji i akceptację człowieka; krytyczne dane (SKU, EAN, cena, stan) zapisuje się tylko ze źródła.

Wyślij próbkę danych — pokażemy, co odpadnie i dlaczego

Nie musisz mieć gotowej specyfikacji. Wystarczy link do sklepu, plik albo krótki opis tego, co dziś blokuje sprzedaż lub pracę zespołu.

Walidacja to wejście do większego procesu

Audyt danych produktowych

Jednorazowa diagnoza katalogu, zanim ustawimy reguły na stałe.

Audyt danych produktowych

Mapowanie kategorii

Kategorie dostawcy przełożone na drzewo sklepu, z raportem wyjątków.

Mapowanie kategorii

Dane produktowe

SKU, EAN, warianty i atrybuty — czyli to, co walidacja sprawdza.

Dane produktowe

Integracje API

Gdzie walidacja wchodzi do procesu wymiany danych między systemami.

Integracje API