Zboží.cz XML feed: návod a časté chyby (2026)
Zboží.cz je po Heurece druhý nejnavštěvovanější český srovnávač a pro spoustu e-shopů druhý kanál, který má smysl pořešit hned po té první. Vstupenkou je jeden XML feed: soubor, který Zboží.cz pravidelně řekne, co prodáváte, za kolik, kam to patří a kdy to dorazí. Když je feed v pořádku, produkty se napárují do katalogu a začnou se zobrazovat. Když v pořádku není, feed sice projde, ale produkt se potichu nepáruje a nezobrazuje, a vy nevíte proč.
Jedna věc, kterou je dobré si vyjasnit na začátku, aby vás nepletla Sklikova nová terminologie: reklamní produkt, na který biddujete, se od července 2025 jmenuje Seznam Nákupy(dřív „kampaně Zboží.cz“), a reklamy běží nově i ve vyhledávání Seznam.cz, na Obrázky.cz a na Sbazaru. Srovnávač, který vidí nakupující, se ale pořád jmenuje Zboží.cz a feed se pořád nastavuje stejně. Takže pozor: Zboží.cz nezaniklo, jen se přejmenovala placená vrstva nad ním. Autoritativní specifikace feedu navíc dnes nežije na zbozi.cz, ale na napoveda.sklik.cz/reklamy/xml-feed/specifikace/.
Tenhle článek je praktický návod, jak Zboží.cz XML feed nastavit a hlavně čemu se vyhnout (spoiler ke konci: Emberfeed sedí až za vaším existujícím feedem, ne místo něj).
| Element | Status | Co obsahuje |
|---|---|---|
| PRODUCTNAME | Povinný | Název produktu, max 255 znaků, formát výrobce + řada + označení + varianta |
| DESCRIPTION | Povinný | Popis produktu, doporučeno 250 až 1024 znaků |
| URL | Povinný | Odkaz na produktovou stránku, bez diakritiky a mezer |
| IMGURL | Povinný | URL hlavního obrázku, min 425x440 px, JPEG, PNG nebo WebP |
| PRICE_VAT | Povinný | Konečná cena včetně DPH v CZK, max 2 desetinná místa, kladná |
| DELIVERY_DATE | Povinný | Dostupnost: 0 skladem, buckety 1-3 / 4-7 / 8+, -1 neznámá, nebo YYYY-MM-DD |
| EPREL_ID | Povinný podmíněně | ID energetického štítku EU, jen pro regulované kategorie (lednice, pračky, TV) |
| ITEM_ID | Doporučený (povinný pro bazar) | Unikátní identifikátor, drží párování i při změně názvu či URL |
| PRODUCT | Doporučený | Zobrazovaný název ve výsledcích, max 64 znaků, kratší než PRODUCTNAME |
| CATEGORYTEXT | Doporučený | Cesta ve vlastní taxonomii Zboží.cz, max 10 hodnot na nabídku |
| EAN | Doporučený | 8, 12, 13 nebo 14místné číslo bez mezer, zásadní pro párování |
| PRODUCTNO | Doporučený | Výrobní nebo katalogové číslo, vstupuje do párovacího algoritmu |
| MANUFACTURER | Doporučený | Výrobce, vstupuje do párování |
| PARAM | Doporučený | Strukturované parametry (PARAM_NAME + VAL + UNIT), pohánějí filtry |
| IMGURL_ALTERNATIVE | Doporučený | Další obrázky, max 20 |
| ITEMGROUP_ID | Doporučený pro varianty | Seskupení variant, každá varianta je vlastní SHOPITEM |
| CONDITION | Doporučený (povinný pro bazar) | new, open_box, used nebo refurbished |
Jak Zboží.cz páruje produkty (a proč rozhoduje EAN)
Tohle je na Zboží.cz nejdůležitější mechanika a obdoba toho, co je na Heurece PRODUCTNAME versus PRODUCT. Zboží.cz každou vaši nabídku automaticky páruje proti svému katalogu produktů, a to podle názvu produktu, EANu, jména výrobce, produktového čísla a ceny. Pokud se napáruje, sedíte u konkrétního produktu vedle ostatních prodejců. Pokud ne, spadnete jen do fulltextového vyhledávání a přicházíte o značnou část viditelnosti.
Klíčové je, jak moc do toho mluví EAN. Podle pravidel párování Zboží.cz, jak je shrnují české feedové nástroje (Mergado a další), platí zhruba toto: pokud nabídka EAN neobsahuje, je potřeba minimálně 90% shoda názvu nabídky s produktem v katalogu, aby se napárovala automaticky. S EANem postačuje shoda názvu kolem 40 %.
Z toho plyne pár věcí. Za prvé, posílejte EAN (osmi až čtrnáctimístné číslo bez mezer, tedy EAN-8, UPC-12, EAN-13 nebo ITF-14), a k němu PRODUCTNO a MANUFACTURER, protože i ty do párování vstupují. Za druhé, nedávejte promo balast doPRODUCTNAME: každé „dárek zdarma“ nebo „akce“ v párovacím názvu snižuje shodu a může párování rozbít. Marketingové fráze patří do PRODUCT (zobrazovaný název, max 64 znaků), ne do PRODUCTNAME. A za třetí, i když je ITEM_ID u nového zboží jen doporučený, vyplatí se ho posílat: je to unikátní identifikátor, díky kterému jde produkt sledovat i při změně názvu nebo URL, takže párování nepadá při každé drobné editaci.
Pěkný kontrast s Heurekou: na Heurece je EAN povinný jen pro mediální kategorie (Knihy, Filmy, Hudba a podobně) a jinde je to jen „berlička“. Na Zboží.cz není EAN striktně povinný nikde, ale prakticky je možná ještě důležitější, protože rozhoduje, jestli se vůbec napárujete. Zkráceně: Zboží.cz nemá kategorie, kde je EAN povinný jako na Heurece, zato EAN rozhoduje o spárování úplně všude. Téhle chybě se na Emberfeedu věnuje samostatná stránka chybějící EAN na Zboží.cz.
CATEGORYTEXT a vlastní strom Zboží.cz
CATEGORYTEXT nese cestu v kategorickém stromu Zboží.cz, a to je důležité slovo: Zboží.cz pracuje jen s vlastním stromem kategorií, ne s tím Heurečiným. Když do Zboží.cz pošlete cestu naformátovanou pro Heureku, kategorie nesednou a produkt spadne jen do fulltextu. To je klasická chyba u e-shopů, které jeden a tentýž CATEGORYTEXT sypou do obou srovnávačů.
Pravidla, na která je dobré myslet:
- Maximálně 10 hodnot
CATEGORYTEXTna jednu nabídku. Víc kategorií nepřidávejte. - Mapujte na list, ne na kořen. Vybírejte nejhlubší (listovou) kategorii, která produktu odpovídá.
- Funguje i jako záchranná síť. Pokud do Zboží.cz
CATEGORYTEXTpošlete, i nenapárované produkty (třeba unikátní zboží) se mohou zobrazit ve výpisu příslušné kategorie. Bez něj se objeví jen ve fulltextovém vyhledávání.
A jedna aktuální poznámka: od února 2026 Zboží.cz strom kategorií přeskládalo, přidalo nové sekce (rybaření, drogerie), šest kategorií přejmenovalo, patnáct smazalo a zavedlo nové filtrovatelné PARAM parametry (seznam dotčených kategorií vyšlo jako CSV). Dopad na vás: ověřte, že vaše hodnoty CATEGORYTEXT jsou pořád platné, a doplňte nové parametry, ať zůstanete filtrovatelní. Plný přehled máte v naší specifikaci Zboží.cz XML feedu.
IMGURL: obrázky (a co spec naopak neříká)
IMGURL je URL hlavního obrázku produktu. Co Zboží.cz podle Sklikovy specifikace skutečně vyžaduje:
- Minimum 425 x 440 px; u bazaru a použitého zboží min 800 x 600 px (kratší strana alespoň 800).
- Formáty JPEG, PNG nebo WebP.
- Bez vodoznaků, log obchodů, reklamních nápisů a jiných výrazných grafických prvků přímo na fotce.
IMGURL_ALTERNATIVEpro další obrázky, max 20.
Jedna věc, na kterou se zapomíná: když měníte obrázek, změňte i jeho URL v XML. Srovnávač cachuje obrázky podle URL, takže na stejné adrese novou fotku nemusí ukázat. Je to přesně ten problém s cache, který Emberfeed u servírovaných obrázků řeší automaticky tím, že ke každé render URL přidává verzovací parametr, takže se Zboží.cz pokaždé ukáže čerstvý obrázek.
DELIVERY_DATE a dostupnost (kontrast s Heurekou)
DELIVERY_DATE nese dobu od objednávky po expedici. Zboží.cz akceptuje tyhle hodnoty:
- 0 skladem (odeslání do 24 hodin)
- 1 až 3 do 3 dnů
- 4 až 7 do týdne
- 8+ déle než týden
- -1 neznámá dostupnost
- YYYY-MM-DD předobjednávka nebo datum naskladnění
Pokud migrujete feed z Heureky, malá čísla většinou znovu použijete beze změny (0 je skladem, 1-3 a 4-7 sedí stejně). Jsou tu ale dva rozdíly oproti Heurece, které je třeba pohlídat:
- Zboží.cz zná hodnotu
-1pro „neznámou dostupnost“. Heureka takovou konvenci nemá, tam-1nepoužívejte. - Zboží.cz hrubne na
8+(„déle než týden“), místo aby pokračovalo Heurečiným jemnějším žebříčkem8-14/15-30/31+.
Častá chyba je posílat stejné DELIVERY_DATE pro všechno nebo nechat skladové produkty bez 0, případně zapomenout na -1 u zboží, jehož dostupnost opravdu neznáte. Špatná dostupnost sráží relevanci a pozici stejně jako na Heurece.
Dubnový obrat: minimální CPC podle kategorie
Tohle je novinka, kterou má smysl spojit přímo s kategoriemi. Od 1. dubna 2026 Seznam mění způsob práce s ceníkem pro Seznam Nákupy a minimální CPC nově závisí na koncové (listové) kategorii produktu, ne jen na jeho ceně. Plošný model je pryč. Konkrétně:
- Minimální CPC = kategorie krát cena ve 12 cenových pásmech (prahy v CZK: 0, 100, 200, 300, 500, 700, 1000, 1500, 2500, 4500, 10000, 25000).
- Aktualizuje se každý týden, s přibližně dvoutýdenním předstihem u větších změn.
- Strojově čitelný soubor
mincpc.csv, stažitelný ze Seznam Nákupy. Tam si minimální CPC najdete podle kategorie produktu, ne jen podle ceny.
Proč to patří do návodu o feedu: protože minimální CPC teď klíčuje na listovou kategorii, špatný nebo příliš mělký CATEGORYTEXT už nezhoršuje jen viditelnost, ale může produkt zařadit do nesprávného CPC pásma. Jinými slovy správné kategorie jsou nově i páka na náklady, ne jen na zobrazení. O kontextu cen na českých srovnávačích a o tomhle dubnovém obratu píšeme i v článku o alternativách k Mergadu.
Nastavení na Shoptetu (zdarma a vestavěné)
Na Shoptetu nepotřebujete kupovat nic navíc: Zboží.cz feed je součástí Shoptetu, zdarma a prakticky bez nastavování. URL feedu najdete v Propojení, Seznam Nákupy a Zboží.cz (Shoptet tenhle uzel po přejmenování reklamního produktu přeznačil právě takhle).
Párování kategorií probíhá ve dvou úrovních, stejný vzorec jako u Heureky. Za prvé per kategorie: v detailu kategorie je sekce „Zboží kategorie“, kde vepíšete název kategorie Zboží.cz a administrace vám správný list napoví přes autocomplete, pak uložíte. Za druhé per produkt: v sekci párování kategorií u produktu jde individuálně přebít kategorie pro Heureku, Seznam Nákupy, Zboží.cz, Google i Glami, přičemž nastavení produktu vyhrává nad nastavením kategorie.
Pokud prodáváte zboží pro dospělé, Shoptet má i samostatné řešení kategorie „Erotické zboží“ a novější variantu Zboží.cz feedu, což řeší element EROTIC. Jinak na Shoptetu k existenci na srovnávači nepotřebujete nic dalšího. Pokud chcete nad Shoptetem řešit hezčí obrázky nebo čistší výstup, podívejte se na napojení Emberfeedu na Shoptet, ale Zboží.cz feed samotný k tomu nepotřebujete. Stejnou logikou jdeme i v článku o feedu pro Google Nákupy na Shoptetu.
Nastavení na WooCommerce (přes plugin)
WooCommerce nemá nativní feed pro české srovnávače, takže potřebujete plugin. Běžné volby, které umí Zboží.cz XML:
- Toret XML Feedy (placený): podporuje Heureku, Zboží.cz, Google Shopping, Srovnáme, Pricemanii a další. Nastavení per feed, mapování kategorií WooCommerce na Zboží.cz přes autocomplete a vlastní CRON pro automatické aktualizace. Cena se objevuje v CZK akcích i kolem 69 € za rok.
- České služby (open-source na GitHubu): napojí Heuréku, Zboží.cz a Srovnáme.cz, generuje XML, API a měření konverzí. Poctivý háček: projekt nebyl aktualizovaný zhruba dva roky, takže ho zvažte s rezervou a ověřte, že jeho výstup pořád odpovídá aktuální specifikaci.
9 nejčastějších chyb (a jak je opravit)
Tohle je seznam, kvůli kterému feed buď nevalidní je, nebo (mnohem zákeřněji) validuje, ale produkt se nepáruje a neprodává:
- CATEGORYTEXT naformátovaný pro Heureku. Zboží.cz má vlastní strom, takže cesta z Heureky nesedne a produkt spadne jen do fulltextu. Oprava: mapujte na taxonomii Zboží.cz (autocomplete v Shoptetu nebo Toretu).
- Chybějící EAN u špatně pojmenovaných produktů. Bez EANu je potřeba zhruba 90% shoda názvu místo 40 %, a produkt zůstane nenapárovaný ve fulltextu. Oprava: posílejte EAN, a k tomu
PRODUCTNOaMANUFACTURER. - Promo balast v PRODUCTNAME. „Dárek zdarma“ v párovacím názvu snižuje shodu a rozbíjí párování. Oprava:
PRODUCTNAMEdržte jako výrobce + řada + označení + varianta, marketing dejte doPRODUCT(max 64 znaků). - Statické nebo chybějící DELIVERY_DATE. Špatná dostupnost sráží pozici; časté je i zapomenuté
-1u opravdu neznámého skladu. Oprava: mapujte reálný stav,0je skladem. - Chybějící DESCRIPTION nebo IMGURL. Na Zboží.cz jsou obě pole striktně povinná (na rozdíl od Heureky) a jejich absence může nabídku shodit. Oprava: vždy uvádějte obojí.
- Vodoznak, logo obchodu nebo reklamní nápis v IMGURL. Takový obrázek Zboží.cz odmítne. Oprava: čistý produktový obrázek bez overlayů a výrazných grafických prvků.
- Příliš mělký nebo špatný CATEGORYTEXT. Po dubnu 2026 to není jen otázka viditelnosti, špatný list může produkt dostat do nesprávného pásma minimálního CPC. Oprava: zařaďte na správný list a po únorovém přeskládání kategorií hodnoty znovu ověřte.
- Změněný obrázek na stejné URL. Srovnávač drží cachovanou starou fotku. Oprava: při změně obrázku změňte i jeho URL (Emberfeed to přes
?v=dělá automaticky). - Chybějící EPREL_ID na energeticky štítkovaném zboží. U lednic, praček, TV nebo světel je registrační ID energetického štítku podmíněně povinné. Oprava: doplňte
EPREL_IDdo těchto kategorií.
Společný jmenovatel většiny z nich: feed projde, ale produkt se potichu nepáruje a nevydělává, takže problém poznáte až podle chybějících prokliků. Proto se vyplatí mít pevný přehled o tom, co Zboží.cz chce. K tomu slouží i naše referenční specifikace Zboží.cz XML feedu a přehled celého kanálu Zboží.cz. Stejnou logiku párování řešíme i v sesterském návodu na nastavení Heureka feedu a v textu o návodu na Glami feed.
Kde do toho patří Emberfeed
Buďme féroví: Zboží.cz feed na Shoptetu i přes plugin na WooCommerce vzniká bez Emberfeedu, zadarmo nebo za cenu pluginu. Emberfeed negeneruje ani nenahrazuje váš zdrojový feed a není self-hosted. Naimportuje feed, který už máte, a přidává nad něj vrstvu, kterou srovnávačový export sám o sobě neumí.
- On-brand obrázky per produkt. Místo holé produktové fotky vyrenderuje každý obrázek podle vaší šablony (vizuálně drag-and-drop, nebo HTML/CSS s pomocí AI), a to on-demand, takže to škáluje i na tisíce produktů.
- Pravidla na úpravu polí. Přesně případ „vyčistit promo z
PRODUCTNAME, ať se napáruje“ nebo srovnatDELIVERY_DATE: pravidlo upraví pole, než se feed odešle. - Validace proti specifikaci kanálu. Emberfeed kontroluje feed proti pravidlům cílové platformy a upozorní na chybějící
DESCRIPTION,IMGURLneboEANdřív, než se Zboží.cz potichu nenapáruje. - Čistá servírovaná URL v SHOP/SHOPITEM. Zboží.cz konzumuje formát
<SHOP><SHOPITEM>…</SHOPITEM></SHOP>, ne RSS ani Atom, a to je nativní výstupní režim Emberfeedu.
Cena je 25 €/feed/měsíc (~625 Kč), první 3 měsíce zdarma na jednom feedu do 1 000 produktů, bez karty. Férová hranice: pokud potřebujete feed teprve postavit z datového zdroje nebo chcete 50+ kanálů, je to práce pro Mergado, ne pro Emberfeed.
Related
- Heureka XML feed: nastavení a 8 častých chybPraktický návod, jak nastavit Heureka XML feed na Shoptetu i WooCommerce: co je povinné, jak na kategorie a dostupnost, a jak se vyhnout chybám, kvůli kterým se produkt nenapáruje.
- Mergado alternativa: ceny, AI obrázky, jednoduchostMergado + Feed Image Editor vyjde na ~2 272 Kč/měsíc. Srovnáváme levnější a jednodušší cesty pro český e-shop, včetně Emberfeedu za 25 €/feed.
- Shoptet a Google Nákupy: feed a Merchant CenterNa Shoptetu už feed pro Google Nákupy máte hotový: je systémový a aktualizuje se každou hodinu. Tady je, kde ho najdete, jak ho napojíte do Merchant Center a které dvě pole se nejčastěji zapomínají.
Ship better catalog ads this afternoon.
Free for 3 months on one feed up to 1,000 products. Connect your XML feed, design a template, paste the new URL into Meta / Google / TikTok.