Specifikace XML

Vyhledávač Hyperzboží.cz má jednak vlastní formát importního souboru, ale podporuje i všechny ostatní formáty srovnávačů cen.

XML soubor je jednoduchý datový soubor, vytvářený přímo obchody. Slouží k předání aktuálních informací o Vašem sortimentu. Příklad XML souboru, uvedený na konci tohoto dokumentu, Vám jistě poradí s případnými nejasnostmi. Pro zamezení případných problémů s funkčností, doporučujeme držet se uvedeného postupu.

XML soubor lze generovat automaticky, nebo data napsat ručně pomocí textových editorů jako například Poznámkový blok a poté uložit s příponou .xml

Pokud generujete XML ručně, postupujte takto:

• Otevřete nový soubor v textovém editoru
• Na první řádek vložte: <?xml version="1.0" encoding="windows-1250"?>
• Na druhý řádek vložte: <SHOP>
• Na čtvrtý řádek vložte: </SHOP>
• Mezi značky <SHOP> a </SHOP> vložte údaje o produktech (více o značkách najdete níže), například:
  <SHOPITEM>
      <PRODUCT>Zpívající slovník</PRODUCT>
      <DESCRIPTION>Elektronický slovník zpívající anglická slovíčka</DESCRIPTION>
      <URL>http://adresa_vaseho_obchodu.cz/shop.php?id=112</URL>
      <IMGURL>http:// adresa_vaseho_obchodu.cz/obrazky/112.jpg</IMGURL>
      <PRICE_VAT>220</PRICE_VAT>
  </SHOPITEM>
  
• Tímto způsobem zápisu vložte veškeré informace
• Soubor uložte a nahrajte na Váš server, odkud si ho my budeme průběžně stahovat

Význam značek a jejich specifikace:
PRODUCT - stručný název zadávaného výrobku – povinný údaj
DESCRIPTION - detailní popis výrobku - povinný údaj
URL - www adresa odkazující přímo na stránku s nabídkou daného produktu - povinný údaj
IMGURL - www adresa odkazující přímo na obrázek produktu - nepovinný údaj

PRICE - cena výrobku bez DPH – nepovinné v případě, že je zadána hodnota PRICE_VAT
VAT - sazba DPH, např. 0,19 nebo 19 - nepovinné v případě, že je zadána PRICE_VAT
PRICE_VAT - cena produktu s DPH - nepovinné v případě, že jsou zadány hodnoty PRICE a VAT
DUES - poplatky které je nutné zaplatit při koupi zboží (autorské a recyklační poplatky, nikoliv však doprava a balné) – nepovinný údaj v případě, pokud jsou tyto poplatky již obsaženy v ceně výrobku - PRICE resp. PRICE_VAT

EAN - čárový kód, prostředek pro automatizovaný sběr dat - nepovinný údaj
ISBN - alfanumerický kód určený pro jednoznačnou identifikaci knižních vydání - nepovinný údaj
CATEGORYTEXT - textový popis kategorie, do které ve svém obchodu produkt zařazujete, uvádějte celou cestu k cílové kategorii - povinný údaj
DISCUSSION_SIZE - počet příspěvků v diskuzi k výrobku - nepovinný údaj
DISCUSSION_URL - www adresa do diskusního fóra - nepovinný údaj
TOLLFREE - položka TOLLFREE s hodnotou 1 vyloučí konkrétní zboží ze systému PPC a kliknutí na něj zůstanou bezplatná a nebude se u něj uplatňovat přednostní výpis. Používá se u zboží, u kterého nechcete platit za proklik např. z důvodu jeho nízké ceny. Položku TOLLFREE je možné použít jen u zboží s cenou do 40 Kč. - nepovinný údaj
AVAILABILITY – dostupnost daného zboží - nepovinný údaj:

• - S - Zboží je skladem
• - K - Zboží je skladem v kamenném obchodě
• - 3D - Zboží je dostupné do 3 dnů
• - 7D - Zboží je dostupné do 7 dnů
• - 7+ - Zboží je dostupné po více než 7 dnech
• - N - Zboží je (dočasně) nedostupné

PARAM – parametry zboží (výrobce, výkon, rozměry ...) - nepovinný údaj:

• - PARAM_NAME - obsahuje název parametru (výrobce, výkon ...)
• - VAL - obsahuje hodnotu parametru (Nokia, 150kW ...)

Konečný XML může vypadat následovně: