Migrace produktového katalogu bez chyb
Katalog je srdce e-shopu a při migraci se v něm chyby schovávají nejlépe. Ukážeme, jak převést varianty, parametry, obrázky, EAN a kategorie a jak data ověřit dřív, než je uvidí zákazník.
Produkty, varianty, parametry a obrázky tvoří největší objem dat v každé migraci. A také místo, kde chyby nejdéle zůstávají skryté. Import proběhne bez chybové hlášky, e-shop vypadá v pořádku, a teprve za dva týdny zjistíte, že nefungují filtry, že Google Merchant Center odmítl třetinu produktů nebo že u části variant chybí fotky.
Za roky převodů katalogů jsme se naučili jedno: chybu je levnější najít v tabulce než na webu. Tenhle článek shrnuje, jak katalog převést tak, aby sedělo všechno, co zákazník a srovnávače vidí. Obecný průběh migrace najdete v kompletním průvodci migrací.
Proč export a import nestačí
Každá platforma má vlastní datový model. Co je v PrestaShopu kombinace, je v Shoptetu varianta a ve WooCommerce variace. Co je v Magentu atribut, může být na cílové platformě parametr pro filtr, text v popisu nebo metafield. Export ze staré platformy proto nikdy nepasuje 1:1 do importu nové.
Mezi exportem a importem potřebujete převodní krok, v praxi ETL: data načíst, transformovat do cílového modelu a zkontrolovat. U malého katalogu to jde v tabulkovém editoru. U tisíců produktů s variantami děláme převod skriptem, protože ho můžeme spustit znovu po každé opravě a výsledek je pokaždé stejný.
Samotné platformy na limity exportu upozorňují. Shoptet v nápovědách k převodu z jiných systémů opakovaně uvádí, že přenést jde jen část dat a produkty bude potřeba dál upravit.
Varianty: nejčastější zdroj chyb
Varianty se na každé platformě zapisují jinak. Obecně platí, že potřebujete společný identifikátor rodiče a sadu voleb, kterými se varianty liší. Na Shoptetu tuto roli hraje sloupec pairCode, který je v importu povinný a má stejnou hodnotu pro všechny varianty jednoho produktu. U produktů bez variant zůstává prázdný.
Na co si dát pozor:
- Limity platformy. Shoptet umožňuje až 512 variant na produkt. Shopify od října 2025 až 2 048 variant, ale pořád jen 3 volby na produkt (k 9/2026). Produkty s více osami (velikost, barva, délka, materiál) je potřeba přestavět nebo část voleb převést na příplatkové parametry.
- Rozpad na samostatné produkty. Některé staré platformy exportují varianty do samostatného souboru nebo listu. Pokud se nespojí s rodičem, vzniknou stovky „produktů" bez vazby.
- Vlastní data varianty. Cena, sklad, EAN, hmotnost a obrázek patří k variantě, ne jen k rodiči. Kontrolujte, jestli je export opravdu nese na úrovni varianty.
- URL variant. Pokud měly varianty na starém webu vlastní adresy, patří do mapy přesměrování. Postup v článku 301 přesměrování při migraci.
Parametry, filtry a kategorie
Parametry rozhodují o filtrech v kategoriích a o kvalitě XML feedů pro srovnávače. Při migraci je proto nestačí přenést jako text.
Doporučený postup:
- Vytáhněte seznam všech parametrů a všech jejich hodnot napříč katalogem.
- Sjednoťte zápis. „Černá", „cerna" a „Černá " jsou pro filtr tři různé hodnoty. Totéž platí pro jednotky („500 ml" vs. „0,5 l").
- Rozhodněte, které parametry budou filtrační, které jen informační a které vypustíte.
- Namapujte kategorie. Starý strom kategorií přeneste tak, aby zůstaly kategorie s návštěvností. Produkty zařazené do více kategorií kontrolujte zvlášť, ne všechny platformy mají stejnou logiku hlavní kategorie.
- Kategorie ve feedech (Heureka, Zboží.cz, Google) namapujte znovu, pokud se mění strom.
Pokud se katalog skládá z dat od více dodavatelů, je migrace dobrý okamžik zvážit PIM. Jedno místo pravdy pro produktová data zjednoduší i další budoucí migraci.
Obrázky a soubory
Obrázky se při migraci obvykle nepřenášejí jako soubory, ale znovu se stahují z adres. Na Shoptetu import vyžaduje kompletní URL obrázku, v každé buňce jen jeden obrázek a další ve sloupcích image2, image3 a dalších. Některé platformy URL obrázků v exportu vůbec nenabízejí, pak je dohledáváme z webu nebo databáze.
Kontrolujte:
- pořadí obrázků, hlavně který je hlavní,
- přiřazení obrázků k variantám (barva trička musí sedět s fotkou),
- dostupnost zdrojových souborů v době importu. Pokud starý hosting skončí dřív, obrázky už nestáhnete,
- alt texty, pokud je stará platforma měla,
- přílohy produktů: návody, bezpečnostní listy, certifikáty.
Zdrojové adresy nechte funkční až do dokončení importu a kontroly.
EAN a identifikátory
EAN je pro e-shop víc než číslo na krabici. Páruje produkty ve srovnávačích a Google Merchant Center podle něj ověřuje, o jaký produkt jde. Chyba v EAN znamená zamítnuté produkty nebo špatné spárování.
Nejčastější problémy při migraci:
- Excel z EAN udělá číslo. Zmizí úvodní nuly nebo se kód převede na tvar
5,90123E+12. Sloupce s kódy vždy importujte a exportujte jako text. - Neplatná kontrolní číslice. GTIN má 8, 12, 13 nebo 14 číslic a poslední je kontrolní podle algoritmu GS1. Validaci kontrolní číslice spouštíme automaticky nad celým katalogem ještě před importem.
- Duplicitní EAN. Stejný kód u dvou různých produktů je chyba v datech, ne v migraci, ale migrace je dobrá chvíle ji opravit.
- EAN u rodiče místo varianty. U produktů s variantami má každá varianta vlastní kód.
Stejnou pozornost věnujte interním kódům a SKU. Podle nich párujeme staré a nové URL, napojení na sklad, ERP a dodavatelské feedy. Kód produktu by se při migraci neměl měnit, pokud to není nezbytné.
Validace dat: před importem a po něm
Validace je krok, který odděluje migraci „bez chyb" od migrace „zatím nikdo nic nehlásil". Kontroly rozkládáme do čtyř fází, od převedeného souboru po ostrý provoz.
| Fáze | Co kontrolujeme | Jak |
|---|---|---|
| Před importem | Povinná pole, formát cen, kódování (UTF-8 vs. Windows-1250), duplicity kódů a EAN, kontrolní číslice EAN, sjednocené hodnoty parametrů | Skript nad převedeným souborem, report chyb po řádcích |
| Po testovacím importu | Počty produktů, variant, kategorií a obrázků proti zdroji | Export z nové platformy a porovnání se zdrojem |
| Po testovacím importu | Vzorek 20–50 produktů napříč kategoriemi: cena, sklad, varianty, fotky, parametry, texty | Ruční kontrola vedle sebe na starém a novém webu |
| Před spuštěním | Filtry v hlavních kategoriích, vyhledávání, feedy pro srovnávače a Merchant Center | Test na testovací verzi a validace feedu |
| Po spuštění | Zamítnuté produkty ve feedech, 404 na produktech, reklamace chybných údajů | Diagnostika v Merchant Center a Search Console |
Počty musí sedět na kus. Když má zdroj 4 812 variant a cíl 4 790, dvaadvacet produktů někde chybí a zákazník je nekoupí.
Jak data vyčistit ještě před exportem, rozebírá samostatný průvodce na našem sesterském Prevedshop.com.
Jak na to prakticky: checklist katalogu
- Máte zmapovaný datový model staré i nové platformy (produkty, varianty, parametry, kategorie)?
- Vejdou se největší produkty do limitu variant a voleb cílové platformy?
- Jsou hodnoty parametrů sjednocené a rozhodnuté filtrační parametry?
- Jsou EAN uložené jako text, validní a bez duplicit?
- Budou zdrojové obrázky dostupné až do konce importu?
- Máte převodní skript nebo postup, který jde spustit znovu po opravě dat?
- Sedí počty produktů, variant, kategorií a obrázků mezi zdrojem a cílem?
- Prošel vzorek produktů ruční kontrolou a feedy validací?
Převod katalogu řešíme skriptem s validacemi a opakovatelnými běhy, od stovek po statisíce položek. Pokud potřebujete jen převést nebo vyčistit data, podívejte se na službu importy a exporty. Pokud měníte celou platformu, začněte u služby migrace e-shopu.
Potřebujete s tím pomoct?