Reklama

Specifikace XML Feedu

Co je XML Feed?

XML Feed je strojově čitelná podoba produktů e-shopu.

Jedná se o datový soubor, který generuje Váš e-shop a my podle něj můžeme importovat produkty do vyhledávače. Tam je po zpracování následně zobrazujeme a umožňujeme našim návštěvníkům vyhledávat a přesměrovávat je přímo na stránky konkrétních produktů ve Vašem e-shopu kde si je posléze mohou zakoupit.

Jak zjistím adresu XML Feedu mého e-shopu?

V případě, že neznáte URL adresu XML Feedu Vašeho e-shopu, kontaktuje prosím v první řadě Vašeho dodavatele e-shop systému.

Ten by Vám měl poskytnout adresu na které e-shop generuje XML Feed pro srovnávače. Pokud nevíte jak formulovat Váš požadavek, zašlete dodavateli žádost o adresu, na které Váš e-shop generuje XML Feed zboží + odkaz na tuto stránku (http://www.hledejlevne.cz/specifikace-xml-feedu) kde programátoři naleznou technickou specifikaci souboru.


Technická specifikace XML Feedu (pro programátory)

Základní XML Feed (pouze povinné položky, minimální specifikace)


<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <PRODUCT><![CDATA[Samsung Galaxy S II černý s pouzdrem]]></PRODUCT>
    <DESCRIPTION>
        <![CDATA[Mobilní telefon 4.3" 480x800 Super AMOLED Plus, CPU Dual-Core 1,2GHz, RAM 1GB, interní paměť 16GB, fotoaparát 8mpx, GPS, WiFi, Bluetooth, 3G, FM, microSD, microUSB, Android 2.3, česká verze]]>
    </DESCRIPTION>
    <URL>http://www.example.com/mobilni-telefony/1452365-samsung-galaxy-s-II&amp;color=black</URL>
    <PRICE_VAT>9599</PRICE_VAT>
  </SHOPITEM>
</SHOP>

Kompletní XML Feed (doporučená specifikace)


<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <ITEM_ID>P1452365</ITEM_ID>
    <EAN>1231231234</EAN>
    <PRODUCTNAME>Samsung Galaxy S II</PRODUCTNAME>
    <PRODUCT><![CDATA[Samsung Galaxy S II černý]]></PRODUCT>
    <DESCRIPTION>
        <![CDATA[Mobilní telefon 4.3" 480x800 Super AMOLED Plus, CPU Dual-Core 1,2GHz, RAM 1GB, interní paměť 16GB, fotoaparát 8mpx, GPS, WiFi, Bluetooth, 3G, FM, microSD, microUSB, Android 2.3, česká verze]]>
    </DESCRIPTION>
    <MANUFACTURER>Samsung</MANUFACTURER>
    <CATEGORYTEXT>Elektronika | Mobilní telefony | Samsung</CATEGORYTEXT>
    <URL>http://www.example.com/mobilni-telefony/1452365-samsung-galaxy-s-II&amp;color=black</URL>
    <IMGURL>http://storage.example.com/product/1452365-samsung-galaxy-s-II.jpg</IMGURL>
    <IMGURL_ALTERNATIVE>http://storage2.example.com/product/1452365-samsung-galaxy-s-II.jpg</IMGURL_ALTERNATIVE>
    <PRICE_VAT>9599.4</PRICE_VAT>
    <HLEDEJLEVNE_CPC>1.5</HLEDEJLEVNE_CPC>
  </SHOPITEM>
</SHOP>

Popis jednotlivých elementů a jejich význam

Název elementu Význam elementu
SHOP * Kořenový element ohraničující začátek a konec feedu. Do něj jsou vnořené veškeré další elementy.
SHOPITEM * Každý tento prvek představuje jedno zboží a obsahuje vnořené elementy definující zboží.
PRODUCT * Představuje název zboží. Ideální název v sobě zahrnuje kromě názvu samotného zboží také název výrobce, produktovou řadu nebo barvu.
Pro větší kompatibilitu umožňujeme namísto tohoto elementu uvádět element TITLE.

V případě, že nebude element ve Feedu uveden, systém se místo něj pokusí načíst PRODUCTNAME.
DESCRIPTION * Popis zboží, který nejlépe charakterizuje jeho vlastnosti a obsahuje klíčová slova, podle kterých může být zboží vyhledáváno.
URL * Celá URL adresa ke zboží ve Vašem e-shopu, včetně protokolu (http://). Na tuto adresu budou směrováni zájemci o zboží.
PRICE_VAT ** Celková cena zboží vč. DPH a to včetně všech poplatků (recyklační, autorské).
Pokud nejsou v ceně zahrnuty tyto poplatky, je povinné uvádět ještě element DUES.

Haléře je možné oddělovat čárkou nebo tečkou.
Cena může obsahovat mezery.
NEpoužívejte čárky nebo tečky pro oddělování řádů (tisíců)!
PRICE ** Celková cena zboží bez DPH. Platí stejná pravidla jako pro PRICE_VAT.
VAT ** Sazba DPH daného zboží. Platí stejná pravidla jako pro PRICE_VAT.
DUES *** Poplatky ke zboží v CZK (například recyklační poplatek, autorské poplatky).
Uvádějte pouze v případě, že nejsou poplatky zahrnuty v konečné ceně PRICE_VAT nebo PRICE!
ITEM_ID Unikátní označení produktu v rámci Vašeho e-shopu.
Nám slouží pro správné identifikování Vašich konkrétních produktů i v případě, že změníte jeho název nebo URL adresu.
EAN Kód výrobku EAN13. Uvádějte pouze oficiální kódy zboží nebo element vynechejte.
PRODUCTNAME Název výrobku bez jakýchkoliv dalších informací.
NEsmí tedy obsahovat žádné informace o zboží zdarma apod.
MANUFACTURER Výrobce daného zboží.
CATEGORYTEXT Kategorie ve kterých je zboží ve Vašem e-shopu zařazeno.
Jednotlivé kategorie je možné oddělovat znaky (bez uvozovek): " | ", " / ", " - " nebo " > "
(znak > je nutné v XML souboru zapisovat jako &gt;)
IMGURL URL adresa na které se nachází obrázek k danému zboží.
Neuvádějte prosím odkazy na obrázky typu "Obrázek neexistuje" - v těchto případech element úplně vynechejte.
IMG_ALTERNATIVE Adresa s dalším obrázkem produktu (z jiného pohledu, v jiném stavu, ...).
HLEDEJLEVNE_CPC Nastavuje konkrétnímu produktu danou cenu za proklik (CPC) pro zvýhodnění produktu oproti ostatním.
V případě nekladného kreditu Obchodníka se tato položka ignoruje - CPC se aplikuje pouze pokud je nabitý dostatečný kredit.

*     - povinné položky, bez nich produkt nebude importován.
**   - pokud není uveden element PRICE_VAT, jsou elementy PRICE a VAT povinné. V opačném případě je povinný pouze PRICE_VAT.
*** - element DUES je povinný pouze v případě, že nejsou v ceně PRICE_VAT nebo PRICE zahrnuty veškeré poplatky spojené s produktem (recyklační, autorské).

Časté chyby

Statistiky
2 232

vyhledáváme u více než 2 200 e-shopů

8 087 298

srovnáváme ceny více než 8 milionů zboží