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- 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
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.
Cztery wiersze z pliku hurtowni przed zapisem do sklepu. Kolumna „Title” to długość meta title w znakach.
| SKU | EAN | Rodzic | Cena | Title | 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łę.
| SKU | EAN | Rodzic | Cena | Title | 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.
| SKU | EAN | Rodzic | Cena | Title | 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.
| SKU | EAN | Rodzic | Cena | Title | 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 |
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
| SKU · poziom | Powód | Wynik |
|---|---|---|
| BT-38 · OK | reguły spełnione | zapisany |
| BT-39 · WARN · MISSING_EAN | wymagane: pusty EAN | zapisany; raport: brak EAN, priorytet ważny |
| BX-40 · BLOCK · VARIANT_CONFLICT | relacja: brak produktu BX | niezapisany; raport: priorytet blokujący |
| BS-41 · BLOCK · cena 0,00; WARN · SEO_TITLE_TOO_LONG | zakres: cena 0,00; title ponad limit | niezapisany; raport: cena blokująca, title kosmetyczny |
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ń.
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.
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 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ą
| Obszar | Co sprawdza reguła | Jaki błąd zatrzymuje przed publikacją |
|---|---|---|
| Identyfikatory | SKU, EAN, kody wariantów, duplikaty i puste pola | ten 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ów | produkt główny, warianty, rozmiary, kolory, modele i grupowanie | rozmiary, kolory i modele, które nie tworzą spójnej relacji produkt główny → wariant |
| Ceny i stany | wartości zerowe, ujemne, puste, podejrzane skoki i rozjazdy między źródłami | puste, zerowe albo nierealne wartości, które bez kontroli trafiłyby do sprzedaży |
| Zdjęcia | braki, niedziałające linki, duplikaty i przypisanie zdjęć do wariantów | produkty bez zdjęć, które obniżają zaufanie i często nie powinny być publikowane automatycznie |
| Kategorie i atrybuty | niespójne kategorie, brakujące parametry filtrów i konflikty klasyfikacji | struktura z technicznych nazw feedu hurtowni zamiast odzwierciedlenia sposobu kupowania |
| Treści SEO | opisy, krótkie opisy, title, description, długości i duplikaty | meta title, description i opisy za długie, puste, zdublowane albo niespójne z kategorią |
Od reguł do raportu: przebieg walidacji
- Pobranie danychEksportujemy produkty ze sklepu, pliku, ERP albo hurtowni.
- Reguły walidacjiUstalamy, które pola są krytyczne, a które informacyjne.
- Raport błędówTworzymy listę braków, konfliktów i produktów wymagających decyzji.
- Priorytety naprawyDzielimy błędy na blokujące, ważne i kosmetyczne.
- 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.
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 produktowychMapowanie kategorii
Kategorie dostawcy przełożone na drzewo sklepu, z raportem wyjątków.
Mapowanie kategorii