Mapowanie rozmiarów i kolorów między sklepem, ERP i marketplace
Mapowanie wartości to tłumaczenie zapisu cechy z jednego systemu na zapis akceptowany przez inny. W sklepie kolor może nazywać się „Granat morski”, bo tak brzmi lepiej w opisie, ale marketplace oczekuje wartości z własnego słownika, np. „niebieski”. Rozmiary bywają jeszcze trudniejsze: system rozmiarów europejskich, literowych i producenta potrafi występować w jednym katalogu.
Najprostszy model to słownik wewnętrzny i tabela mapowania dla każdego kanału. Słownik wewnętrzny zawiera jedną, kanoniczną listę wartości, np. XS, S, M, L, XL. Tabela mapowania mówi, jaka wartość odpowiada im w ERP, w sklepie i na każdym marketplace. Integracja nigdy nie przesyła wartości bezpośrednio z jednego systemu do drugiego, tylko przez słownik. Nowa, nieznana wartość nie tworzy automatycznie wariantu, tylko trafia do kolejki do zmapowania.
Na Allegro listę parametrów dostępnych w kategorii, w tym wartości słownikowych, zwraca zasób GET /sale/categories/{categoryId}/parameters, a produkt w katalogu można wyszukać po EAN zasobem GET /sale/products z trybem GTIN (stan na lipiec 2026 - sprawdź aktualną dokumentację Allegro). Allegro ma też mechanizm ofert wielowariantowych, który łączy oferty w grupę według parametrów różnicujących. Jego zasady i dostępne parametry zmieniały się w czasie, dlatego przed wdrożeniem warto sprawdzić aktualny opis w dokumentacji dla deweloperów.
[#tip] Przechowuj w tabeli mapowania nie tylko nazwy wartości, ale też identyfikatory słownikowe z każdego kanału. Nazwy wartości na marketplace mogą zostać zmienione, a identyfikator zwykle zostaje ten sam.
Warianty w WooCommerce i Shopify - jak zapisują je platformy
W WooCommerce produkt z wariantami to produkt zmienny, a każdy wariant jest osobnym rekordem typu variation powiązanym z produktem nadrzędnym. W imporcie CSV wariant wskazuje rodzica przez jego ID lub SKU, a aktualizacje są dopasowywane po ID lub SKU (stan na lipiec 2026 - sprawdź aktualną dokumentację WooCommerce). Oznacza to, że każdy wariant może i powinien mieć własne SKU, cenę i stan.
Shopify grupuje warianty pod jednym produktem i opisuje je przez opcje, np. rozmiar i kolor. Produkt może mieć do 3 opcji, a od października 2025 limit wariantów na produkt wynosi 2048 dla wszystkich sprzedawców. W pliku CSV warianty to kolejne wiersze z tym samym uchwytem produktu i wartościami opcji (stan na lipiec 2026 - sprawdź aktualną dokumentację Shopify). Niektóre motywy i aplikacje mogą wciąż zakładać dawny, niższy limit, więc przy dużej liczbie wariantów warto to sprawdzić przed wdrożeniem.
Różnice w modelach mają znaczenie przy łączeniu platform. Jeśli integrujesz sklep na Shopify z polskimi marketplace i ERP, model wariantów jest jednym z pierwszych tematów do ustalenia - piszemy o tym szerzej we wpisie integracja Shopify z polskimi marketplace i ERP.
Kiedy łączyć warianty, a kiedy wystawiać osobne produkty
Nie każda różnica między produktami powinna być wariantem. Warianty mają sens, gdy produkty mają wspólny opis i różnią się cechą, którą klient wybiera na karcie produktu. Gdy produkty różnią się na tyle, że potrzebują innych opisów, zdjęć lub kategorii, lepiej traktować je jako osobne produkty powiązane relacją, a nie warianty.
[#chart:wpr47c]
Ta decyzja wpływa na integrację. Jeśli w sklepie produkt ma warianty, a na marketplace każdy wariant jest osobną ofertą, integracja musi wiedzieć, która oferta odpowiada któremu wariantowi. Taką tabelę powiązań - SKU wariantu, identyfikator w sklepie, identyfikator oferty w każdym kanale - warto przechowywać w jednym miejscu, np. w integratorze lub własnej bazie.
Stany i ceny wariantów - jak uniknąć nadsprzedaży
Stany magazynowe zawsze synchronizuje się na poziomie wariantu. Suma stanów produktu nadrzędnego przydaje się w raportach, ale nie powinna trafiać do kanałów sprzedaży jako stan oferty, bo klient może wtedy kupić rozmiar, którego już nie ma. Jak zaprojektować przepływ stanów między kanałami, opisujemy we wpisie synchronizacja stanów magazynowych między sklepem a marketplace.
Z cenami bywa podobnie. Część platform dopuszcza różne ceny wariantów, a część oczekuje jednej ceny dla grupy. Jeśli sklep ma droższy rozmiar XXL, a kanał sprzedaży tego nie obsługuje, trzeba zdecydować, czy XXL ma być osobną ofertą, czy cena ma być wyrównana. Tę regułę zapisz w konfiguracji integracji, a nie w głowie osoby obsługującej panel.
Przy małych stanach pomaga bufor bezpieczeństwa liczony per wariant. Jeśli rozmiar M ma na magazynie dwie sztuki, a sprzedajesz w trzech kanałach, opóźnienie synchronizacji o kilka minut wystarczy, by sprzedać trzecią sztukę, której nie ma. Bufor, np. wysyłanie do kanałów stanu pomniejszonego o jedną sztukę przy niskich stanach, ogranicza takie sytuacje kosztem rzadkich, utraconych sprzedaży ostatniej sztuki. Wysokość bufora warto dobrać osobno dla kategorii o różnej rotacji.
Problemy z wariantami najczęściej wychodzą dopiero po kilku tygodniach sprzedaży. Typowe objawy i poprawki:
[#chart:wpr47b]
Warianty w ERP i u dostawców - jak przyjmować nowe wartości
ERP często traktuje każdy wariant jako osobną kartotekę towarową, bez pojęcia produktu nadrzędnego. Wtedy relację rodzic - wariant trzeba odtworzyć w integracji, np. na podstawie wspólnego pola z kodem modelu albo prefiksu SKU. Taka reguła musi być jednoznaczna i opisana, bo każda kartoteka, która jej nie spełnia, wypadnie z grupy i trafi do sprzedaży jako osobny produkt. Dobrze, gdy ERP ma dodatkowe pole na kod modelu - integracja nie musi wtedy zgadywać relacji z budowy kodu.
Dane od dostawców i hurtowni to osobne źródło chaosu. Ten sam rozmiar przychodzi raz jako „M”, raz jako „M/38”, a kolor raz po polsku, raz po angielsku. Zamiast poprawiać pliki ręcznie, dodaj do słownika wewnętrznego tabelę synonimów dla każdego dostawcy. Integracja zamienia wartość z pliku na wartość kanoniczną, a jeśli jej nie zna, wstrzymuje tylko ten wariant i zgłasza go do zmapowania. Reszta dostawy przechodzi dalej.
Osobno warto zadbać o zdjęcia wariantów. Jeśli klient wybiera kolor na karcie produktu, zdjęcie powinno zmieniać się razem z wyborem, a na marketplace każda oferta koloru powinna mieć własne zdjęcie główne. W modelu danych oznacza to, że zdjęcia przypisuje się do wartości koloru, a nie tylko do produktu nadrzędnego. Przy rozmiarach zdjęcia są zwykle wspólne, więc nie ma sensu ich powielać w każdym wariancie.
Ostatnia sprawa to wycofywanie wariantów. Gdy rozmiar znika z kolekcji, nie usuwaj go od razu z bazy. Ustaw stan zero, zakończ oferty w kanałach i oznacz wariant jako archiwalny. Usunięcie rekordu zrywa powiązania z historycznymi zamówieniami, zwrotami i raportami sprzedaży.
Jak wdrożyć mapowanie wariantów krok po kroku
Inwentaryzacja - wypisz wszystkie cechy wariantów i wartości, które występują w sklepie, ERP i u dostawców.
Słownik wewnętrzny - ustal jedną listę wartości dla każdej cechy i usuń duplikaty zapisu.
Identyfikatory - nadaj brakujące SKU wariantom i uzupełnij kody EAN, sprawdzając cyfrę kontrolną.
Mapowanie kanałów - dla każdej platformy zapisz odpowiedniki wartości i ich identyfikatory słownikowe.
Test na jednej kategorii - zsynchronizuj kilka produktów z wieloma wariantami i sprawdź wynik w każdym kanale.
Monitoring - nieznane wartości i warianty bez powiązań trafiają do raportu, nie do sprzedaży.
[#checklista] Przed uruchomieniem synchronizacji wariantów: każdy wariant ma unikalne SKU; EAN przechodzi walidację cyfry kontrolnej; wartości cech pochodzą ze słownika; każdy kanał ma tabelę mapowania; tabela powiązań SKU z ofertami jest kompletna; stany synchronizowane na poziomie wariantu; test na kategorii z wieloma rozmiarami zakończony bez błędów.
Jak Vinson pomaga przy wariantach produktów w integracjach
Zapewniamy wsparcie programistyczne dla sklepów i sprzedawców: integracje, automatyzacje, poprawki i rozwój sklepów oraz narzędzi. Przy wariantach porządkujemy SKU i EAN, budujemy słowniki i tabele mapowania rozmiarów oraz kolorów, łączymy warianty ze sklepu, ERP i marketplace oraz naprawiamy integracje, które dublują produkty lub nadpisują stany. Szczegóły znajdziesz na stronie Wsparcie programistyczne dla e-commerce.
Najczęściej zadawane pytania
Czy każdy wariant produktu musi mieć własne SKU?
W integracjach tak. SKU jest kluczem, po którym systemy łączą wariant, jego stan i cenę. Wspólne SKU dla kilku rozmiarów powoduje, że stan jednego rozmiaru nadpisuje pozostałe, a zamówienia trafiają do złego wariantu.
Czy każdy wariant potrzebuje osobnego kodu EAN?
Jeśli wariant ma być sprzedawany jako osobny towar z kodem kreskowym, powinien mieć własny GTIN. Wiele marketplace łączy oferty z katalogiem właśnie po kodzie EAN, więc wspólny kod dla kilku rozmiarów utrudnia lub uniemożliwia poprawne wystawienie. Zasady nadawania numerów opisuje organizacja GS1.
Jak mapować kolory, gdy marketplace ma inny słownik niż sklep?
Utrzymuj własny słownik kolorów i tabelę, która każdej wartości przypisuje odpowiednik w słowniku marketplace. Integracja tłumaczy wartości przez tę tabelę, a nieznane kolory trafiają do kolejki do ręcznego zmapowania. Dzięki temu marketingowa nazwa koloru w sklepie nie blokuje wystawienia.
Ile wariantów może mieć produkt w Shopify?
Od października 2025 Shopify pozwala na maksymalnie 2048 wariantów na produkt, przy najwyżej 3 opcjach, np. rozmiar, kolor i materiał (stan na lipiec 2026 - sprawdź aktualną dokumentację Shopify). Część motywów i aplikacji może jednak obsługiwać mniej wariantów, więc warto to sprawdzić przed importem.
Dlaczego po synchronizacji pojawiają się zduplikowane warianty?
Najczęściej integracja łączy warianty po nazwie lub wartości cechy, a nie po SKU, albo wartość cechy została zapisana inaczej niż wcześniej. Rozwiązaniem jest łączenie wyłącznie po identyfikatorach i przepuszczanie wartości cech przez słownik z mapowaniem.
Warianty przestają psuć integracje, gdy mają stałe identyfikatory, a ich cechy przechodzą przez jeden słownik i tabele mapowania. Jeśli chcesz uporządkować warianty w sklepie i kanałach sprzedaży, sprawdź wsparcie programistyczne Vinson. Przygotowanie samego pliku z wariantami opisujemy we wpisie import produktów do sklepu z Excela i CSV.
