Niewidoczne znaki w kodzie lub nazwie produktu
Kod wygląda poprawnie, a nie pasuje do niczego. Jest w nim znak, którego nie widać, na przykład twarda spacja z arkusza albo znak zerowej szerokości.
Objaw
Wpisujesz kod produktu w wyszukiwarkę panelu i nic się nie znajduje, choć towar jest i widzisz go na liście. Hurtownia odsyła plik z informacją, że tego kodu nie zna. Integracja z magazynem tworzy drugą kartę, zamiast dopasować istniejącą. Na ekranie kod wygląda dokładnie tak, jak powinien.
Problem nie jest w tym, co widać. W polu jest dodatkowy znak, którego przeglądarka nie rysuje: twarda spacja przeniesiona z arkusza kalkulacyjnego, znak zerowej szerokości z kopiowania ze strony internetowej albo tabulator z eksportu.
Ile to kosztuje
Kod produktu ma jedno zadanie: być tym samym ciągiem znaków u Ciebie, u dostawcy i w każdym systemie po drodze. Niewidoczny znak psuje to po cichu.
- Dopasowania przestają działać. Import po kodzie nie znajduje towaru i zakłada nowy. Po kilku takich przebiegach masz w katalogu duplikaty, których nie da się znaleźć wyszukiwarką.
- Wyszukiwarka panelu nic nie znajduje. Wpisujesz kod, który widzisz na ekranie, i dostajesz pusty wynik. Wygląda to na usterkę sklepu, a nie danych.
- Plik produktowy dla Google (feed) albo marketplace może odrzucić ofertę albo przyjąć ją z kodem, którego nikt później nie dopasuje do zamówienia.
Najbardziej podstępne jest co innego: dwa towary mogą mieć ten sam kod, który w bazie różni się
jednym niewidocznym znakiem. ABC-1 i ABC-1 z twardą spacją na końcu to dla człowieka ten sam
kod, a dla bazy dwa różne. Sprawdzanie unikalności w sklepie i w systemie magazynowym przepuści
taki duplikat.
Jak sprawdzić to samodzielnie
Z WP-CLI, bez żadnej wtyczki. Zapytanie szuka bajtów, a nie znaków:
wp db query "SELECT p.ID, pm.meta_value AS sku \
FROM wp_postmeta pm JOIN wp_posts p ON p.ID = pm.post_id \
WHERE pm.meta_key = '_sku' AND pm.meta_value <> '' \
AND (HEX(pm.meta_value) LIKE '%C2A0%' \
OR HEX(pm.meta_value) LIKE '%E2808B%' \
OR HEX(pm.meta_value) LIKE '%EFBBBF%' \
OR pm.meta_value <> TRIM(pm.meta_value))"
Podmień wp_ na swój przedrostek tabel. C2A0 to twarda spacja, E2808B znak zerowej szerokości,
EFBBBF znacznik BOM. Zapytanie szuka ich w zapisie szesnastkowym, bo w wyniku i tak byłyby
niewidoczne.
Zapytanie sprawdza tylko kody SKU, za to w produktach i wariantach w każdym stanie, także w koszu, i tylko najczęstsze znaki. Merchlint sprawdza też numery GTIN, nazwy produktów i więcej rodzajów znaków (lista w ostatniej sekcji), ale tylko w opublikowanych produktach i ich wariantach.
Kody EAN z eksportu. Narzędzie Sprawdź kody EAN pokazuje niewidoczne znaki w kolumnie kodów jako ⟨U+00A0⟩ i liczy je tą samą definicją co Merchlint. Plik nie opuszcza przeglądarki.
Jak to naprawić
- Skopiuj kod z pola i wklej go do edytora, który pokazuje znaki specjalne, albo po prostu wpisz kod ręcznie od nowa. Przy krótkim kodzie to najszybsza droga.
- Nie licz na funkcję „przytnij spacje” w arkuszu.
TRIMw większości arkuszy i w SQL nie usuwa twardej spacji ani znaku zerowej szerokości, tylko zwykłą spację. - Napraw źródło, bo inaczej znak wróci przy następnym imporcie. Częste źródła to kolumna sformatowana w arkuszu jako tekst z wyrównaniem i kopiowanie kodów ze strony hurtowni prosto do arkusza.
- Po naprawie sprawdź, czy nie powstał duplikat. Jeśli niewidoczny znak był jedyną różnicą między dwoma towarami, po wyczyszczeniu kody będą identyczne i sklep nie przyjmie zapisu.
Kiedy to fałszywy alarm
- Kod, który naprawdę zawiera spację, na przykład
ABC 123. Zwykła spacja w środku kodu jest dozwolona i ta kontrola jej nie zgłasza. Zgłasza za to zwykłą spację na początku albo na końcu kodu. - Nazwa produktu z twardą spacją użytą celowo. Polska typografia wiąże twardą spacją jednoliterowe spójniki („w domu”, „z drewna”), robią to też wtyczki typograficzne. Dlatego w nazwie kontrola nie zgłasza twardej spacji ani miękkiego łącznika, tylko znaki sterujące, znaki zerowej szerokości i BOM.
- Kod z zewnętrznego systemu, którego nie wolno Ci zmienić. Zdarza się przy kodach narzuconych przez dostawcę. Wtedy ukryj ten wynik. Problem zostaje, ale wiesz o nim.
Jak Merchlint to znajduje
Merchlint odczytuje surową wartość kodu SKU, numeru GTIN i nazwy każdego opublikowanego produktu, a także kodów SKU i GTIN jego wariantów. Bierze ją dokładnie taką, jaka jest w bazie, bez czyszczenia po drodze, i porównuje z tą samą wartością po oczyszczeniu. Różnica znaczy, że w polu jest znak, który do kodu nie należy. Nazw wariantów nie sprawdza, bo WooCommerce składa je z nazwy produktu i cech.
W kodach zgłaszane są: znaki sterujące ASCII, znaki zerowej szerokości (U+200B–U+200D, U+2060), znacznik BOM (U+FEFF), miękki łącznik (U+00AD), twarde spacje (U+00A0, U+202F, U+2007) w dowolnym miejscu kodu oraz zwykłe spacje na początku i na końcu kodu. W nazwie zakres jest węższy i celowo ostrożny: tylko znaki sterujące, znaki zerowej szerokości i BOM.
Przy wyniku widać, gdzie dokładnie jest znak, zapisany jako ⟨U+00A0⟩ w miejscu, w którym
występuje, i ile pól produktu ma takie znaki. Bez tego zapisu „spacja na końcu” i „twarda spacja
na końcu” wyglądałyby na ekranie tak samo, a to dwie różne naprawy.
Tej samej definicji czystego kodu używają kontrole duplikatów, więc nie mogą się z tą kontrolą rozjechać. Jeśli Merchlint uznaje dwa kody za ten sam, to po usunięciu niewidocznych znaków są identyczne.
Pewność: F — fakt z bazy danych. Bajt albo tam jest, albo go nie ma.
Ta kontrola jest w dodatku Pro, który jeszcze przygotowujemy. Darmowa wtyczka jej nie uruchamia.
Zainstaluj za darmoCoś się nie zgadza z tym, co widzisz w sklepie? Napisz do nas. Czytamy każdą wiadomość. contact@merchlint.com
Masz wynik z wtyczki i nie wiesz, od czego zacząć? Do 30 listopada 2026 przeglądamy eksporty z dziesięciu sklepów — darmowy audyt katalogu.