Specifikace XML feedu portálu Nakup.to

Na této stránce najdete podrobnou specifikaci XML feedu, který využíváme na portálu Nakup.to.

Co je to XML feed

XML feed je datový soubor, obsahující informace o jednotlivých prodejních nabídkách ve vašem e-shopu (název, cena, popisky produktů, parametry produktů, apod.). Je zpravidla automaticky generován z vašich stránek, a proto jeho vytvoření či úpravy konzultujte se svým webmasterem.

Vzor XML feedu a struktura

Na obrázku níže naleznete ukázku XML feedu. Velmi důležitými XML tagy jsou CATEGORYTEXT a EAN. Není-li některý XML tag správně vyplněný, jisté napárování na již vytvořený produkt na portálu nakup.to zajistí XML tag EAN.

ITEM_ID tag obsahuje Vaše interní ID produktu.

PRODUCTNAME a PRODUCT tagy slouží pro název produktu. PRODUCTNAME nesmí obsahovat žádné jiné informace, jako např. určitý předmět zdarma a podobně, musí být zadán pouze oficiální název. Pro název + další specifika k názvu slouží PRODUCT tag.

CATEGORYTEXT je XML tag sloužící ke specifikování cesty ve stromové struktuře kategorií. Díky tomuto tagu se produkt správně napáruje na kategorii.

EAN je velmi užitečný XML tag k zápisu tzv. EAN kódu, sloužícího k označování jednotlivých druhů zboží. EAN tag vám napomůže ke správnému napárování, existuje-li v systému již zaevidovaný produkt se stejným EAN.

PARAM tag využijte pro specifikování vlastností/parametrů, viz ukázka níže.

Ukázka XML feedu

Upozornění

V případě, že budete chtít importovat datový soubor s velkým počtem produktů (50 000 a více, nebo nad 30 MB daného XML feedu), kontaktujte prosím nejdříve naši podporu na e-mailové adrese it@nakup.to a domluvte se na dalším postupu. Rádi Vám budeme při jeho nahrávání asistovat.

Z důvodu častých chyb v XML feedu obchodníků všechny feedy kontrolujeme, tudíž zobrazení produktů může pár dní trvat. Napárované produkty jsou však doledatelné přes vyhledávač portálu nakup.to

Kdy nemusí být XML feed příjmutý?

Hlavní faktor není pouze počet produktů, ale také velikost samotného feedu. Produkty z XML feedu nemusí být ani uloženy z technických důvodu, jako nevalidní XML feed. Z těchto důvodů doporučujeme nahrávat pouze validní XML feed a v přijatelné velikosti, aby byla zajištěna co nejlepší úspěšnost uložení co nejvíce produktů z Vašeho feedu. Dalším velmi důležitým faktorem jsou kategorie. Bude-li Váš produkt směřovat na kategorii, která v portálu nakup.to neexistuje, nemusí být produkt korektně nahrán.

XML feed generovaný přes Shoptet

Často se nám stává, že obchodníci ze Shoptetu mají problém s nahráním XML feedu do našeho systému, protože jej má Shoptet v základu uzavřen. Zde je stručný návod, jak na to:

V administraci e-shopu najdete zabezpečení feedu (Propojení >> XML feedy >> zabezpečení) a zde zaškrtněte možnost Zakázat přístup z IP adres, které nepoužijí bezpečnostní hash. Následně se vygeneruje kód (XXXX). Ten vložte za váš feed ve tvaru: https://www.vas-eshop.cz/heureka/export/products.xml?hash=XXXX a na místo XXXX doplníte kód, který se vám vygeneruje po zaškrtnutí tlačítka. Tuto adresu pak nahrajte do našeho systému.