Przejdź do treści

SKU czy EAN? Jak identyfikować produkty w integracjach e-commerce

SKU i EAN często występują w tym samym pliku, ale nie są zamiennikami. SKU opisuje rekord w procesie konkretnej firmy. EAN identyfikuje jednostkę handlową. Integracja musi wiedzieć, kiedy użyć jednego, kiedy drugiego i co zrobić, gdy wartości są puste, powtórzone albo różne między systemami.

Jeden wariant, kilka identyfikatorów

koszulka · czarna · Mprzykład z sekcji 06
PoleDo czego służy
parent_skurodzina albo model; nie jest sprzedawaną jednostką
skuklucz operacyjny aktualizacji wariantu
eanjednostka handlowa: skanowanie i marketplace
source_id → target_idmapa powiązań: najpewniejsze dopasowanie
Dopasowanie po mapie, SKU albo EAN
  • utrwalona relacja zamiast zgadywania przy każdym uruchomieniu
Dopasowanie po nazwie
  • nigdy: automatyczne dopasowanie wyłącznie po nazwie produktu
Wybór jednego identyfikatora „do wszystkiego” jest źródłem duplikatów

Integracja może używać kilku warstw naraz: wewnętrznego ID systemu, stabilnego SKU firmy, EAN jednostki handlowej, identyfikatora dostawcy i mapy powiązań. Problem zaczyna się wtedy, gdy proces szuka „pierwszego podobnego kodu”.

Objaw w integracji

Po każdym uruchomieniu powstają nowe produkty zamiast aktualizacji istniejących, a część stanów aktualizuje się na niewłaściwym rekordzie — albo pozycje zamówienia w BaseLinkerze mają pustą kolumnę „ID produktu” i stan nie schodzi (patrz zamówienie z Magento nie zmniejsza stanu w BaseLinkerze).

Pierwszy test

Sprawdź, czy integracja przechowuje relację source_id → target_id, czy przy każdym przebiegu szuka produktu od nowa.

Ścieżka 1 z 2 Wybieram klucz

Sekcje 1–8: klucz dla konkretnej operacji, kolejność dopasowania, rola SKU i EAN, identyfikatory wariantu, zmiana SKU i spisana polityka.

01

Jaki identyfikator do jakiej operacji

Zamiast jednej reguły „zawsze SKU” albo „zawsze EAN” warto mieć tabelę decyzji dla konkretnych operacji. SKU i EAN zapisane w zamówieniu w chwili zakupu są kluczem także w historii zamówień partnerów na platformie B2B.

Preferowany klucz według operacji
OperacjaPreferowany klucz
aktualizacja istniejącego produktumapa ID lub stabilne SKU
matching z hurtowniąID dostawcy + EAN/SKU według jakości danych
skanowanie magazynoweEAN
wariantyunikalne SKU i EAN wariantu
historia zamówieniawewnętrzne ID + zapis SKU/EAN z momentu zakupu
02

Kolejność dopasowania produktów

Mapa identyfikatorów jest najpewniejsza, bo nie wymaga ponownego zgadywania przy każdym uruchomieniu. Po pierwszym poprawnym połączeniu rekordów integracja zapisuje relację i używa jej dalej.

  1. Mapa IDistniejąca mapa source_id → target_id
  2. SKUzgodne i unikalne SKU
  3. EANzgodny i unikalny EAN
  4. Ręczna kolejkaręczna kolejka dopasowania
  5. Nigdy: nazwanigdy: automatyczne dopasowanie wyłącznie po nazwie
03

SKU jest identyfikatorem operacyjnym

SKU powstaje wewnątrz firmy. Może kodować model, kolor, rozmiar, sezon albo kolejny numer. Najważniejsze, żeby było stabilne, unikalne w danym katalogu i nie zmieniało się bez procesu migracji.

SKU jest dobrym kluczem do aktualizacji stanów, cen i danych pomiędzy systemami tej samej organizacji, jeżeli wszystkie systemy rzeczywiście korzystają z tej samej wartości. Nie można zakładać tego bez sprawdzenia — ERP, sklep i BaseLinker mogą mieć różne pola nazwane „SKU”.

04

EAN identyfikuje jednostkę handlową

EAN jest używany w handlu, skanowaniu, marketplace i wymianie danych z partnerami. W katalogu wariantowym zwykle identyfikuje konkretny wariant, nie całą rodzinę produktu.

EAN może być dobrym kluczem do matchingu z hurtownią albo marketplace, ale tylko wtedy, gdy jest poprawny i unikalny. Brak EAN nie oznacza automatycznie, że produktu nie da się integrować. Produkty własne, usługi lub część katalogów B2B mogą działać wyłącznie na SKU.

Ta sama wartość w pliku, dwie różne role

SKUsekcja 03
  • powstaje wewnątrz firmy; stabilne i unikalne w katalogu
  • klucz do stanów, cen i danych w systemach tej samej organizacji
  • warunek: wszystkie systemy używają tej samej wartości
EANsekcja 04
  • identyfikuje jednostkę handlową, zwykle wariant
  • klucz do hurtowni i marketplace, gdy jest poprawny i unikalny
  • brak EAN nie wyklucza integracji
05

Dlaczego nie należy wybierać jednego identyfikatora dla wszystkiego

Najbezpieczniejszy matching nie polega na szukaniu pierwszego podobnego kodu. Powinien mieć ustaloną kolejność i poziom pewności.

  1. ID rekorduwewnętrzny identyfikator rekordu systemu
  2. SKUstabilne SKU firmy
  3. EANEAN jednostki handlowej
  4. Dostawcaidentyfikator dostawcy
  5. Mapamapa powiązań między systemami
06

Warianty wymagają identyfikatora na poziomie jednostki sprzedażowej

Koszulka w kolorze czarnym i rozmiarze M musi mieć identyfikator odróżniający ją od rozmiaru L. Wspólne SKU rodziny nie wystarczy do aktualizacji stanu wariantu.

Koszulka, kolor czarny, rozmiar M – identyfikatory jednego wariantu
parent_sku
Rodzina albo model. Nie jest sprzedawaną jednostką.
sku
Konkretny wariant. Klucz operacyjny aktualizacji.
ean
Jednostka handlowa wariantu. Klucz do skanowania i marketplace.
source_id / target_id
Rekord w systemie źródłowym i docelowym. Podstawa mapy powiązań.
07

Zmiana SKU jest migracją, nie zwykłą edycją

Jeżeli SKU pełni funkcję klucza integracji, jego zmiana może zerwać powiązania, utworzyć duplikat albo przestać aktualizować stary rekord. Dlatego zmiana SKU powinna tworzyć historię aliasów lub aktualizować mapę identyfikatorów.

Zmiana SKU krok po kroku

  1. Mapaeksportuj mapę stary SKU → nowy SKU
  2. Zależnościsprawdź zamówienia, magazyn i marketplace
  3. Kopiawykonaj migrację na kopii
  4. Blokadazablokuj równoległe aktualizacje
  5. Liczbyzweryfikuj liczbę rekordów przed i po
08

Polityka identyfikatorów powinna być spisana

To krótki dokument, ale usuwa wiele problemów z importami, stanami i zamówieniami. Szersza architektura — kto rządzi którym polem między sklepem, ERP i BaseLinkerem — jest tematem poradnika o źródle prawdy.

polityka identyfikatorówco ustala dokument
Pytanie, na które odpowiada
kto nadaje SKU i czy może się zmienić
czy wielkość liter ma znaczenie
czy SKU produktu i wariantu są oddzielne
kiedy EAN jest obowiązkowy i jak obsłużyć jego brak
jak wykrywać duplikaty (procedura dla EAN – sekcja 10)
gdzie przechowywana jest mapa identyfikatorów między systemami

Ścieżka 2 z 2 Rozwiązuję duplikat

Sekcje 9–10: typowe konflikty i procedura dla duplikatu EAN – eksport, wykrycie, rozpoznanie przypadku, korekta i sprawdzenie.

09

Typowe konflikty

Każdy z poniższych przypadków powinien trafić do raportu, nie do cichego automatycznego połączenia. Wykrywamy je w ramach audytu danych produktowych. Procedurę wykrywania i rozstrzygania duplikatów EAN opisuje sekcja 10.

raport konfliktów
Konflikt do raportu, nie do cichego połączenia
jedno SKU występuje przy dwóch produktach
jeden EAN przypisano do kilku rozmiarów
ERP przechowuje SKU bez prefiksu, sklep z prefiksem
BaseLinker ma własny numer katalogowy zamiast SKU producenta. W naszym wdrożeniu B2B product_id z katalogu BaseLinkera zapisujemy w atrybucie produktu Magento przy cyklicznej synchronizacji stanów, bo odpowiedź API i tak go zwraca; eksport zamówienia nie szuka produktu od nowa
dostawca zmienił kod produktu
stary produkt został skopiowany wraz z EAN
arkusz usunął zera z początku EAN
produkt główny i wariant mają ten sam identyfikator
10

Jak wykryć i rozstrzygnąć duplikat EAN

Duplikat EAN to dwa albo więcej rekordów z tym samym kodem w jednym katalogu. Nie zawsze jeden z nich jest zbędny: czasem to ten sam produkt zapisany dwa razy, czasem kod trafił do innego wariantu albo do innej jednostki sprzedażowej. Dlatego najpierw ustalamy, który przypadek zachodzi, a dopiero potem zmieniamy dane i powiązania.

  1. Eksportte same kolumny z każdego systemu, EAN jako tekst
  2. Wykryciekolumna do porównania, kod w 14 pozycjach, grupy po kodzie
  3. Rozpoznanieatrybuty, ilość w opakowaniu, kod z etykiety
  4. Korektawstrzymanie zapisu, kopia, wyłączenie zamiast usunięcia
  5. Sprawdzeniejeden aktywny rekord na kod w katalogu
Ten sam produkt

Te same atrybuty, ilość i jednostka: jeden rekord zostaje główny, drugi zostaje wyłączony.

Różne produkty lub jednostki

Inny wariant, inne opakowanie, produkt główny albo kopia: kod zostaje przy rekordzie potwierdzonym etykietą albo kartą producenta.

Niepewne → raport

Ręczna kolejka dopasowania (sekcja 02), bez automatycznego połączenia po tym kodzie.

1. Eksport do porównania

ID, SKU, parent_sku, atrybuty, EAN jako tekst, opakowanie, status, powiązania

Z każdego systemu, w którym EAN służy do łączenia rekordów (sklep, ERP, BaseLinker, plik hurtowni), potrzebny jest eksport z tymi samymi kolumnami:

  • wewnętrzne ID rekordu, SKU, SKU rodziny (parent_sku) i atrybuty wariantu (rozmiar, kolor)
  • EAN zapisany jako tekst – format liczbowy w arkuszu obcina zera z początku kodu
  • ilość w opakowaniu i jednostka miary (sztuka, zgrzewka, karton)
  • status rekordu, źródło (import, hurtownia, ręczne dodanie) i data utworzenia
  • powiązania: wpis w mapie identyfikatorów, oferty marketplace, stan

2. Wykrycie konfliktu

kolumna do porównania, długość i cyfra kontrolna, zapis w 14 pozycjach, grupy po kodzie

Wartość źródłowa zostaje bez zmian; do porównania powstaje osobna kolumna. Usuwa się z niej wyłącznie uzgodnione znaki formatowania (na przykład spacje wstawione przy eksporcie), a potem sprawdza długość (GTIN ma 8, 12, 13 albo 14 cyfr), to, czy zostały same cyfry, i cyfrę kontrolną.

Dopiero poprawny kod porównuje się w postaci 14-cyfrowej, uzupełnionej zerami z lewej – tak GS1 zapisuje krótsze GTIN w 14 pozycjach, więc ten sam kod z obciętym zerem i bez niego daje tę samą wartość. Zapisu nietypowego albo uszkodzonego (litera w środku, zła długość, błędna cyfra kontrolna) nie naprawia się przez usuwanie znaków – trafia do wyjaśnienia.

Rekordy grupujemy po kodzie w obrębie jednego katalogu – także te z kodem do wyjaśnienia (po wartości źródłowej), bo błędny kod też może powtarzać się w kilku rekordach. Każda grupa z więcej niż jednym rekordem trafia do raportu konfliktów; przy kodzie uszkodzonym raport pokazuje oba problemy, a automatyczne dopasowanie po tym kodzie zostaje wstrzymane.

Ten sam EAN w sklepie i w ERP to oczekiwane powiązanie, a nie konflikt – konfliktem jest dopiero sytuacja, w której kod prowadzi w drugim systemie do innego rekordu niż mapa powiązań.

3. Rozpoznanie przypadku i jednostki sprzedażowej

pięć przypadków w tabeli: co widać, co to zwykle oznacza, rozstrzygnięcie
Rodzaje duplikatów EAN i sposób rozstrzygnięcia
Co widać w grupieCo to zwykle oznaczaRozstrzygnięcie
te same atrybuty, ilość i jednostka; inne źródło albo data utworzeniaten sam produkt zapisany dwa razy (drugi import, druga hurtownia)po potwierdzeniu, że oba rekordy to ten sam produkt i ta sama jednostka, jeden zostaje główny (tu pomaga historia sprzedaży i ofert), drugi zostaje wyłączony; stanów nie sumuje się automatycznie (krok 4)
różne rozmiary albo kolory tej samej rodzinykod przypisany do niewłaściwego wariantukod zostaje przy wariancie potwierdzonym przez źródło (etykieta, karta producenta, dane dostawcy); pozostałe dostają kod z tego samego źródła, nie z domysłu
różna ilość w opakowaniu (sztuka, zgrzewka, karton)kod jednostki pomylony z kodem opakowaniawedług zasad GS1 każdy poziom opakowania powyżej jednostki podstawowej ma własny GTIN, a zmiana liczby sztuk w opakowaniu zbiorczym wymaga nowego – właściwy kod odczytuje się z etykiety danej jednostki albo z karty producenta
produkt główny i jego wariantkod wpisany na poziomie rodzinyprodukt główny nie jest sprzedawaną jednostką (sekcja 06) – kod zostaje przy wariancie
nowy rekord powstał przez skopiowanie staregokod przeniesiony razem z kopiąkod zostaje przy rekordzie, którego wariant i jednostkę potwierdza etykieta albo karta producenta; drugi rekord dostaje kod ze źródła albo czeka bez EAN

Rozstrzygnięcie opiera się na atrybutach, ilości w opakowaniu i kodzie z etykiety albo karty producenta – nie na nazwie produktu i nie na historii sprzedaży, bo starszy rekord też może mieć błędny kod. Historia pomaga wybrać rekord zachowywany przy scaleniu dopiero wtedy, gdy wiadomo, że oba rekordy oznaczają ten sam produkt. Grupa, której nie da się rozstrzygnąć jednoznacznie, idzie do ręcznej kolejki dopasowania (sekcja 02).

4. Bezpieczna korekta powiązań

co korzysta z kodu, wstrzymanie zapisu, stany, kolejność, wyłączenie, poprawka u źródła
  1. Co korzysta z kodu. Przed zmianą trzeba sprawdzić mapę powiązań, oferty marketplace połączone po EAN, zamówienia w realizacji i reguły importu z hurtowni.
  2. Wstrzymanie zapisu. Importy i synchronizacje, które mogą w tym czasie zapisać te rekordy, zostają wstrzymane – jak przy zmianie SKU (sekcja 07). Przed zmianą powstaje kopia danych.
  3. Stany przed korektą. Trzeba ustalić, czy stany obu rekordów to kopie tej samej dostępności, czy osobny zapas (inna partia, inny magazyn). Nie sumuje się ich automatycznie – dodanie kopii podwoiłoby dostępność, a osobny zapas wymaga decyzji, przy którym rekordzie i magazynie zostaje.
  4. Kolejność. Najpierw mapa powiązań wskazuje rekord główny, potem zmieniają się powiązania ofert i rekordów, a na końcu kod przy drugim rekordzie. Sposób zmiany powiązań ofert zależy od platformy; przy każdej zmianie zostaje zapis stanu „przed”, żeby dało się ją wycofać.
  5. Wyłączenie zamiast usunięcia. Historia zamówień odwołuje się do kodu z momentu zakupu (sekcja 01). W BaseLinkerze usunięcie produktu nie jest tym samym co stan 0 – według FAQ Base.com oferta traci wtedy powiązanie (mapa objawów BaseLinkera).
  6. Poprawka u źródła. Jeśli błędny kod przychodzi z pliku hurtowni albo z ERP, trzeba go poprawić u źródła albo dodać wyjątek w mapie powiązań – inaczej następny import odtworzy konflikt.

5. Sprawdzenie po korekcie

jeden aktywny rekord na kod, liczby rekordów, stan, oferty, kolejny import
  • w każdej poprawionej grupie jeden aktywny rekord na kod w katalogu
  • liczba wszystkich rekordów bez zmian – wyłączenie nie usuwa rekordu
  • liczba aktywnych rekordów mniejsza dokładnie o rekordy wyłączone według planu
  • stan zgodny z ustaleniem z kroku 4 (bez podwojenia), oferty przy właściwym rekordzie, w każdym systemie
  • kolejny przebieg importu nie tworzy rekordu od nowa i nie przywraca starego kodu
Źródło zdania o poziomach opakowania: zasady GS1 zarządzania numerami GTIN, reguła 8 „Zawartość opakowania zbiorczego” (gs1.org, odczyt 16.11.2026); zapis GTIN w 14 pozycjach: GS1, format GTIN w standardach EDI (odczyt 16.11.2026). Pozostałe kroki to nasza procedura – nie wymóg standardu GS1.

Integracja tworzy duplikaty albo zmienia stan nie temu produktowi?

Zbudujemy mapę identyfikatorów między sklepem, ERP, BaseLinkerem i hurtownią, rozstrzygniemy duplikaty EAN i ustawimy dopasowanie, które przy każdym przebiegu aktualizuje właściwy rekord zamiast tworzyć nowy.

Podobna realizacjaOk. 115 tys. produktów i wariantów z BaseLinkera w jednym katalogu B2BSportina B2B · Magento