Heureka XML feed: nastavení a 8 častých chyb

Heureka je s velkým náskokem nejnavštěvovanější český srovnávač a pro spoustu menších e-shopů je to první kanál, kde vůbec dává smysl být. Vstupenkou je jeden XML feed: soubor, který Heurece zhruba každé dvě hodiny ř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í, produkt validací sice projde, ale tiše se neprodává, a vy nevíte proč.

Tenhle článek je praktický návod, jak Heureka XML feed nastavit a hlavně čemu se vyhnout. Projdeme povinné versus doporučené elementy (a rovnou si vyjasníme jeden rozpor, na který narazí každý, kdo čte dvě různé stránky Heureky), rozdíl mezi PRODUCTNAME a PRODUCT, kategorie, dostupnost, obrázky a parametry. Pak ukážeme, jak feed vzniká na Shoptetu a na WooCommerce, a zakončíme osmi nejčastějšími chybami i tím, kde do toho vůbec patří Emberfeed (spoiler: až za vaším existujícím feedem, ne místo něj).

PRODUCTNAME vs PRODUCT: chyba číslo jedna

Tohle jsou dva různé elementy a jejich záměna je nejčastější důvod, proč se produkty nenapárují do katalogu Heureky. Heureka páruje právě podle PRODUCTNAME (plus kategorie), takže cokoliv navíc v tomhle poli párování rozbíjí.

PRODUCTNAMEje přesný název produktu a nesmí obsahovat žádné jiné informace, jako třeba „dárek“, „pouzdro zdarma“ nebo „nabíječka v ceně“. Formát je výrobce + název produktu + případně varianta, tedy například „Bosch WAN24108 bílá“. Naopak PRODUCT je zobrazovaný, marketingový název: může to být PRODUCTNAME plus „doprava zdarma“, název akce nebo „osobní odběr“. To je to, co vidí uživatel, ne to, podle čeho se páruje.

Pravidlo zní jednoduše: PRODUCTNAME držte čistý, marketing dejte do PRODUCT. Pokud váš e-shop sype promo text rovnou do názvu, je to přesně případ pro pravidlo na úpravu pole, které koncovku nebo vsuvku z párovacího názvu odstraní, než se feed odešle.

CATEGORYTEXT a kategorický strom Heureky

CATEGORYTEXT musí nést celou cestu až k nejhlubší (listové) podkategorii, jednotlivé úrovně oddělené svislítkem | a začínající na Heureka.cz. Správný příklad z nápovědy Heureky vypadá takhle:

Aktuální strom kategorií si můžete stáhnout jako XML na adrese heureka.cz/direct/xml-export/shops/heureka-sekce.xml, což je autoritativní seznam, proti kterému máte cesty párovat. Když CATEGORYTEXT stromu neodpovídá nebo nejde až k listu, důsledky jsou nepřesné zařazení v katalogu, delší párování a v horším případě se produkt nenapáruje vůbec. Heureka ho sice umí spárovat ručně, ale je to pomalejší a nespolehlivé. Téhle chybě se na Emberfeedu věnuje samostatná stránka CATEGORYTEXT mimo strom kategorií.

Dostupnost: DELIVERY_DATE a blok DELIVERY

DELIVERY_DATE nese dostupnost ve dnech (nebo přesné datum YYYY-MM-DD). Heureka mapuje hodnoty takto:

• 0 znamená skladem
• 1 až 3 do 3 dnů
• 4 až 7 do týdne
• 8 až 14 do 2 týdnů
• 15 až 30 do měsíce
• 31 a více více než měsíc

Častá chyba je posílat stejné DELIVERY_DATE pro všechno nebo nechat skladové produkty bez 0. Heureka špatnou dostupnost penalizuje a snižuje pozici. Stav skladu navíc mezi plnými stahy feedu řeší samostatný dostupnostní feed (feed jen s dostupností). Na Shoptetu ho zapnete v Propojení, Heureka, XML feedy, Dostupnostní XML soubor.

Blok DELIVERY se opakuje jednou za každý způsob dopravy dostupný pro produkt a vnořuje DELIVERY_ID, DELIVERY_PRICE (platba předem) a DELIVERY_PRICE_COD (dobírka). DELIVERY_ID bere Heurečin pevný seznam ID dopravců, třeba CESKA_POSTA, PPL, DPD nebo ZASILKOVNA. DELIVERY_PRICE_COD je povinné jen pro Heureka Marketplace, ne pro samotný výpis ve srovnávači.

IMGURL a PARAM: obrázky a parametry

IMGURL

IMGURL je URL hlavního obrázku produktu. Heureka uvádí minimum 20 × 50 px (nebo 50 × 20), doporučuje zhruba 175 × 175 px a strop je 4096 × 4096 px a 2 MB. Podporované formáty jsou webp, jpeg, png a bmp (jpeg nejlépe). Na fotce má být bílé pozadí (ne průhledné ani barevné) a jen daný produkt, bez vodoznaků, slevových popisků a rotujících obrázků. URL musí být bez diakritiky a mezer, max 255 znaků.

Jedna věc, na kterou se zapomíná: když měníte obrázek, změňte i jeho URL v XML. Heureka cachuje obrázky podle URL, takže na stejné adrese novou fotku neuvidí. 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 Heurece pokaždé ukáže čerstvý obrázek.

PARAM

Parametry produktu se zapisují jako bloky <PARAM><PARAM_NAME>velikost</PARAM_NAME><VAL>XL</VAL></PARAM>, jeden PARAM na atribut, a pro každý atribut se blok opakuje. Háček je v tom, že pro některé kategorie je vyplnění konkrétních parametrů povinné. Bez nich produkt nejde filtrovat ve facetovém vyhledávání Heureky, což potichu sráží jeho viditelnost, i když feed validací projde. Heureka pro tyhle kategorie publikuje tabulky povinných parametrů a e-shopy je běžně přeskakují. Téhle situaci odpovídá stránka chybějící povinný PARAM.

Krátká poznámka k EAN, abychom nepřeháněli: EAN je povinný jen pro kategorie Knihy, Učebnice, Mapy a průvodci, Filmy, Hudba a Komiksy. Jinde povinný není, ale je silně doporučený jako „berlička“ pro párování, protože produkt s EANem se obvykle napáruje automaticky. Heureka navíc zavádí takzvaný Simple Pairing (párování podle EANu), takže EAN je čím dál důležitější, to ale není totéž jako „nově povinný pro všechno“.

Nastavení na Shoptetu (zdarma a vestavěné)

Na Shoptetu nepotřebujete kupovat nic navíc: Heureka feed je součástí Shoptetu, zdarma a prakticky bez nastavování. URL feedu najdete v Propojení, Heureka, XML feedy. Párování kategorií probíhá v Propojení, Heureka, Kategorie, kde vyberete kategorie odpovídající sortimentu a uložíte.

CATEGORYTEXT se na Shoptetu řídí ve dvou úrovních. Za prvé per kategorie v Produkty, Kategorie, vybraná kategorie, záložka Doplňková nastavení, kde vyhledáte a přiřadíte doporučené Heureka kategorie. Za druhé per produkt v jeho záložce Pokročilé, sekce Párování kategorií, kde nastavení produktu přebije nastavení kategorie. Dobré vědět: Shoptetův rozšířený Heureka feed posílá jen výchozí kategorii produktu, ne každou kategorii, ve které produkt visí.

A nečekejte okamžité změny. Úpravy se do feedu propíšou zhruba do 2 hodin a Heureka feed stahuje také přibližně každé 2 hodiny, takže aktualizace katalogu má vždy nějaké zpoždění. Pokud chcete nad Shoptetem řešit hezčí obrázky nebo čistší výstup, podívejte se na napojení Emberfeedu na Shoptet, ale Heureka feed samotný k tomu nepotřebujete.

Nastavení na WooCommerce (přes plugin)

WooCommerce nemá nativní feed pro české srovnávače, takže potřebujete plugin. Běžné volby:

• České služby (open-source na GitHubu): generuje feedy pro Heureku, Zboží.cz, Google a Pricemanii. U Heureky řeší CATEGORYTEXT v nastavení kategorií i produktů, EAN navázaný na SKU, DELIVERY_DATE a základní generování parametrů pro varianty. Zdarma, open source.
• Toret XML Feeds (placený): Heureka, Zboží, Google, Glami a další, s nastavením per feed, mapováním kategorií a výchozími hodnotami. Cena 69 € za rok plus případná jednorázová instalace.
• WPify Woo: balí Heureka feed dohromady s CZ specifiky (IČO/DIČ, odstoupení, QR platby).

8 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 neprodává:

• Promo text v PRODUCTNAME. „dárek zdarma“ v párovacím názvu rozbije párování. Oprava: PRODUCTNAME držte čistý, promo dejte do PRODUCT.
• CATEGORYTEXT mimo strom nebo ne až k listu. Produkt se ztratí v katalogu a páruje se pomalu. Oprava: párujte proti staženému XML stromu, vždy až k nejhlubší podkategorii.
• Chybějící povinné PARAMy kategorie. Produkt nejde filtrovat a klesá viditelnost. Oprava: doplňte parametry, které daná kategorie vyžaduje.
• Špatné nebo statické DELIVERY_DATE. Nesprávná dostupnost vede k penalizaci. Oprava: mapujte reálný stav skladu a nasaďte dostupnostní feed.
• Stejná doprava dvakrát. Obě dopravy zmizí. Oprava: každý způsob dopravy uvádějte u produktu jen jednou.
• Vodoznak, slevový štítek nebo barevné pozadí v IMGURL. Obrázek Heureka odmítne. Oprava: bílé pozadí, jen produkt, žádné popisky.
• Změněný obrázek na stejné URL. Heureka cachuje podle URL a novou fotku neuvidí. Oprava: při změně obrázku změňte i jeho URL.
• Chybějící EAN v mediálních kategoriích. U Knih, Filmů a Hudby je EAN povinný a bez něj se produkt nezobrazí. Oprava: doplňte EAN-13 do těchto kategorií.

Společný jmenovatel většiny z nich: feed projde, ale produkt potichu 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 Heureka po jednotlivých kategoriích chce. K tomu slouží i naše referenční stránka specifikace Heureka XML feedu pro rok 2026 a přehled celého kanálu Heureka.

Kde do toho patří Emberfeed

Buďme féroví: Heureka feed na Shoptetu i přes plugin na WooCommerce vzniká bez Emberfeedu, zadarmo nebo za cenu pluginu. Emberfeed negeneruje ani nenahrazuje váš zdrojový feed. 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“ nebo srovnat dostupnost: 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 chyby dřív, než je odhalí samotná Heureka.
• Čistá servírovaná URL pro české srovnávače. Heureka, Zboží.cz i Glami konzumují formát <SHOP><SHOPITEM>…</SHOPITEM></SHOP>, ne RSS ani Atom, a to je výstupní režim, který Emberfeed nativně umí.

Jinými slovy: pokud váš Heureka feed existuje a vaše skutečná brzda je kvalita obrázků nebo drobné úpravy polí, je tohle přesně ta levná vrstva navíc. Stejnou logiku jsme rozebrali v článku o alternativách k Mergadu a do detailu obrázkové stránky věci jdeme v textu o dynamických šablonách pro katalogy.