Feed pro Heureku a Zboží.cz: struktura a validace

Feed pro srovnávače vypadá jednoduše. Pár desítek řádků XML na produkt, stejný formát pro Heureku i Zboží.cz. Problém přijde, když se oba srovnávače začnou v detailech lišit. Jeden element chybí, jiný má špatný formát a část katalogu tiše zmizí z nabídek.

V článku se díváme na feed technicky: jak vypadá kostra, které elementy jsou povinné, v čem se Heureka a Zboží.cz liší a jak feed zkontrolovat. Jak na srovnávačích nastavit cenu za proklik, rozebíráme zvlášť v článku Heureka a Zboží.cz: jak optimalizovat CPC a pozice. Stav specifikací je k září 2026.

Kostra feedu: SHOP a SHOPITEM

Oba srovnávače používají stejný základ. Kořenový element SHOP obsahuje libovolný počet položek SHOPITEM. Každá položka je jedna prodejná nabídka, tedy i každá varianta produktu. Obecně o formátu píšeme v hesle XML feed.

Zjednodušená položka jednoho trička ve velikosti M může vypadat takto:

Pro Zboží.cz musí mít kořenový element jmenný prostor: <SHOP xmlns="http://www.zbozi.cz/ns/offer/1.0">. Bez něj Zboží.cz feed nezpracuje podle aktuální specifikace. Heureka jmenný prostor nevyžaduje.

Povinné a doporučené elementy

Podle Heureky položku nepřijme, když chybí ITEM_ID, PRODUCTNAME, URL nebo PRICE_VAT. Zboží.cz má povinných pět elementů: PRODUCTNAME, DESCRIPTION, URL, PRICE_VAT a DELIVERY_DATE. Když jeden z nich chybí, položka se na Zboží.cz nenahraje.

To je ale minimum pro import, ne pro prodej. Bez obrázku, kategorie a dostupnosti nabídka sice projde, ale špatně se páruje a prohrává v řazení.

EAN a PRODUCTNO jsou nejsilnější páka párování. Nespárovaná nabídka se neukáže v detailu produktu vedle konkurence, i když má nejnižší cenu.

Heureka vs. Zboží.cz: kde se feedy liší

Zboží.cz je dnes součást Seznam Nákupů. Od 15. 9. 2025 se v nich inzeruje jen přes kampaně Nákupy v Skliku a bývalá administrace Zboží.cz se jmenuje Centrum prodejce. Web Zboží.cz dál běží pod svým jménem, feed se tedy stále řídí specifikací Zboží.cz, kterou dnes najdete v nápovědě Skliku.

Hlavní rozdíly, které ve feedu vidíme:

• Kořenový element. Zboží.cz vyžaduje jmenný prostor, Heureka ne.
• Povinné elementy. Zboží.cz trvá na DESCRIPTION a DELIVERY_DATE, Heureka na ITEM_ID.
• Strom kategorií. Každý srovnávač má vlastní strom. CATEGORYTEXT podle stromu Heureky proto pro Zboží.cz není ideální. Kategorie na Zboží.cz navíc od dubna 2026 určuje minimální CPC.
• Nabídka za proklik. Heureka čte HEUREKA_CPC, Seznam Nákupy MAX_CPC a MAX_CPC_SEARCH.
• Doplňkové informace. Zboží.cz má element EXTRA_MESSAGE, například pro dopravu zdarma. Heureka ho nezná.

Proto doporučujeme dva feedy generované ze stejného zdroje dat. Jeden feed pro oba kanály svádí ke kompromisům, které se projeví až v diagnostice.

Varianty a ITEMGROUP_ID

Varianta je samostatný SHOPITEM s vlastním ITEM_ID, cenou, dostupností a ideálně vlastní URL. Všechny varianty jednoho produktu spojuje stejná hodnota ITEMGROUP_ID. Parametr, ve kterém se varianty liší, patří do PARAM (například Velikost nebo Barva), ne jen do názvu.

Nejčastější chyby u variant:

• Jedna položka za celý produkt s nejnižší cenou ze všech variant. Zákazník klikne na „od 399 Kč" a na webu vidí 549 Kč.
• ITEMGROUP_ID shodné s ITEM_ID jedné z variant a pak změněné při úpravě produktu.
• Stejná URL pro všechny varianty, takže web po prokliku ukáže jinou velikost nebo barvu.

Jak varianty rozpadnout, když je dodavatel posílá jinak, popisujeme v článku Varianty produktů ve feedech.

Doprava: DELIVERY_DATE a DELIVERY

DELIVERY_DATE říká, za kolik dní zboží expedujete. Hodnota 0 znamená skladem. Heureka přijímá i datum ve tvaru RRRR-MM-DD, které bere jako datum uvedení na trh. Na Heurece je dodací lhůta podmínkou pro box doporučených nabídek. Nabídky bez lhůty tam nemají šanci.

Blok DELIVERY popisuje jeden způsob dopravy a opakuje se pro každého dopravce. Obsahuje DELIVERY_ID z pevného seznamu srovnávače, DELIVERY_PRICE a volitelně DELIVERY_PRICE_COD pro dobírku. Seznam povolených DELIVERY_ID ověřte ve specifikaci každého srovnávače zvlášť. Například Heureka rozlišuje ZASILKOVNA pro výdejní místa a ZASILKOVNA_NA_ADRESU. Na Zboží.cz můžete ceny dopravy nastavit i v Centru prodejce.

Cena dopravy ve feedu musí sedět s košíkem. Srovnávače ji ukazují vedle ceny zboží a zákazník ji porovnává.

Dostupnostní feed Heureky

Hlavní feed Heureka importuje zhruba každé 2 hodiny. Pro přesnou dostupnost nabízí samostatný dostupnostní XML feed, který podle své specifikace stahuje každých 10 minut. Obsahuje jen produkty, které jsou opravdu k dispozici:

• item s atributem id, který musí odpovídat ITEM_ID v hlavním feedu,
• stock_quantity jako kladné celé číslo. Nula se neuvádí, vyprodaný produkt z dostupnostního feedu vypusťte,
• čas doručení a orderDeadline ve tvaru RRRR-MM-DD HH:MM, tedy do kdy musí zákazník objednat, aby zboží dostal v uvedený čas,
• volitelně depot pro výdejní místa s vlastní zásobou a časem vyzvednutí.

Dostupnostní feed má smysl jen tehdy, když ho generujete z aktuálních dat skladu. Soubor, který se přegeneruje jednou denně, rychlé stahování nevyužije. Jak dostat sklad do feedů v reálném čase, rozebíráme v článku Realtime synchronizace skladu.

Validace: jak feed zkontrolovat

Validaci děláme ve třech vrstvách.

1. Technická validita XML. Soubor musí jít načíst: kódování UTF-8 deklarované v hlavičce, správně uzavřené elementy, znak & zapsaný jako & nebo text v CDATA. Jedna neuzavřená značka rozbije celý import.
2. Kontrola proti specifikaci. Povinné elementy, formát cen a čísel, délka a znaky ITEM_ID, platná DELIVERY_ID, platná kontrolní číslice EAN. Tyto kontroly pouštíme automaticky při každém vygenerování feedu.
3. Diagnostika srovnávače. Až tady vidíte, co srovnávač s nabídkou udělal.

Na Heurece najdete výsledky importu v administraci obchodu. Dostupnostní feed zkontrolujete odkazem „Zkontrolovat XML soubor" v sekci dostupnosti. Heureka feed nevytváří ani neopravuje, za obsah odpovídá obchod. Pozor na limit: nejvýš 500 000 prodejných položek a jedna URL základního feedu.

Na Zboží.cz slouží okno Diagnostika v Centru prodejce. Seznam v něm rozlišuje nabídky neviditelné, zamítnuté, čekající na vyhodnocení a nabídky, které se nezobrazují kvůli nastavení kampaně nebo vyčerpanému rozpočtu v Skliku. Neviditelné nabídky se neukážou v Seznam Nákupech ani v dynamickém retargetingu.

Nejčastější chyby, které vidíme

• Cena ve feedu jiná než na webu, typicky kvůli slevě pro přihlášené nebo zaokrouhlení.
• DELIVERY_DATE 0 u zboží, které je skladem jen u dodavatele.
• CATEGORYTEXT jen s jednou úrovní místo celé cesty.
• Změněné ITEM_ID po migraci e-shopu. Srovnávač pak nabídky bere jako nové a přicházíte o historii.
• HTML a styly v DESCRIPTION zkopírované z e-shopu.
• Vymyšlený nebo interní kód v EAN.

Obecný přehled chyb napříč kanály najdete v článku Nejčastější chyby v produktových feedech.

Jak na to prakticky: checklist

• Dva feedy ze stejného zdroje dat: jeden pro Heureku, jeden pro Zboží.cz.
• Pro Zboží.cz kořenový element s jmenným prostorem.
• Stálé ITEM_ID kompatibilní s pravidly Heureky.
• Každá varianta jako samostatný SHOPITEM se společným ITEMGROUP_ID.
• CATEGORYTEXT podle stromu konkrétního srovnávače, celá cesta.
• EAN a PRODUCTNO všude, kde je výrobce přiděluje.
• DELIVERY_DATE a DELIVERY podle skutečné skladovosti a ceníku dopravy.
• Automatická kontrola feedu před každým publikováním a týdenní průchod diagnostikou.

Feed generujeme a hlídáme v rámci služby napojení dodavatelů a feedy, včetně transformací dat od dodavatelů. Pokud chcete srovnávače řídit i obchodně, navazuje na to marketplace marketing. Pokud přes Heureku zároveň prodáváte, přečtěte si i heslo Heureka Marketplace.