Schéma XML souboru

TAXA mimo hodnocení a vyhledávání obchodů umožňuje také vyhledávání jednotlivého zboží ve vašich obchodech, což výrazně pomáhá zvýšit návštěvnost obchodu. Abychom mohli zařadit vaše zboží do vyhledávání, je třeba nám poskytnout informace o vašem zboží. Informace se stahují z jednoduchého souboru ve formátu XML. Tento soubor se stahuje z Vámi zadaného URL. Můžete si také určit, jak často se má soubor stahovat, pro případ že neaktualizujete informace o zboží tak často, aby se zbytečně nevytěžoval jak náš, tak Váš server.

Schéma souboru je následující:

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <PRODUCT>Mobilní telefon XY</PRODUCT>
    <DESCRIPTION>Ultratenký telefon, aktivní TFT displej, fotoaparát...</DESCRIPTION>
    <URL>http://obchod.cz/mobily/xy</URL>
    <IMGURL>http://obchod.cz/obrazky/mobily/xy.jpg</IMGURL>
    <PRICE_VAT>600</PRICE_VAT>
    <PRICE>500</PRICE>
    <VAT>20</VAT>
    <EAN>123456789012</EAN>
    <PRODUCT_ID>1234</PRODUCT_ID>
    <MANUFACTURER>Výrobce XY</MANUFACTURER>
    <CATEGORYTEXT>Telekomunikace > Mobilní telefony </CATEGORYTEXT>
    <CATEGORYURL>http://obchod.cz/mobily</CATEGORYURL>
    <AVAILABILITY>2</AVAILABILITY>
  </SHOPITEM>
  <SHOPITEM>
    <PRODUCT>Psací pero</PRODUCT>
    <DESCRIPTION>Celokovové plnící pero...</DESCRIPTION>
    <URL>http://obchod.cz/psaci-potreby/pero</URL>
    <IMGURL>http://obchod.cz/obrazky/psaci-potreby/pero.jpg</IMGURL>
    <PRICE_VAT>60</PRICE_VAT>
  </SHOPITEM>
</SHOP>

Význam značek:

SHOP
  kořenová značka, v jejímž rámci jsou všechny položky
SHOPITEM
  v jejím rámci jsou informace týkající se jednoho produktu nebo služby

Značky s údaji pro jednotlivé zboží:

PRODUCT
  stručný název produktu nebo služby (maximálně 255 znaků)
DESCRIPTION
  popis produktu nebo služby (maximální délka není omezena, nejlépe však do 512 znaků)
URL
  odkaz na stránku s daným produktem nebo službou, pozor: NESMÍ obsahovat žádné proměnné údaje (například session ID)
IMGURL
  odkaz na obrázek zboží
PRICE_VAT *
  cena v Kč s DPH
PRICE
  cena v Kč bez DPH
VAT
  vyjádření DPH
EAN
  EAN-kód výrobku (13místný čárový kód), tato položka je vhodná jednak pro vyhledávání zboží přímo podle čárového kódu a jednak pro porovnávání identických výrobků mezi různými obchody, například při srovnání cen nebo dodací doby
PRODUCT_ID
  unikátní identifikace zboží v rámci Vašeho obchodu
MANUFACTURER
  název výrobce zboží
CATEGORYTEXT
  Váš název kategorie včetně podkategorií, ve které máte tento produkt zařazen (ve formátu "Kategorie > Podkategorie"), pozor: znak ">" musí být jako speciální znak v xml souboru nahrazen ">"
CATEGORYURL
  přímý odkaz na stránku s touto kategorií
AVAILABILITY
  dostupnost zboží ve dnech (0 = skladem)

Červené údaje jsou povinné. Ostatní údaje volitelné, ale doporučujeme uvádět co možná nejvíce informací.
* Namísto značky PRICE_VAT lze uvést značku PRICE s cenou bez DPH plus značku VAT, kde je uvedena sazba DPH v procentech jedním z následujících způsobů (oba zápisy jsou ekvivalentní a představují sazbu 20 procent):

    <VAT>20</VAT>
    <VAT>0.20</VAT>

Pokud tedy neuvedete značku PRICE_VAT, jsou značky PRICE a VAT povinné.
Kódování doporučejeme utf-8, lze ale použít i iso-8859-2 nebo windows-1250.
Maximální velikost souboru je 20MB. Toto omezení je dočasné.

Tip: Schéma XML souboru je v povinných položkách shodné se schématem pro server zbozi.cz. Takže pokud již exportujete pro zbozi.cz, můžete stejný soubor použít i pro nás. Pokud pak v budoucnu vytvoříte rozšířený soubor pro nás, data se jen budou aktualizovat o přidané položky.

Pravidla pro poskytované údaje:

XML musí obsahovat pravdivé informace
XML nesmí obsahovat reklamní slogany
XML neobsahuje zboží, které není možné zakoupit samostatně
veškeré položky mají uvedenou kladnou cenu
žádné položky neobsahují HTML značky
XML neobsahuje zboží s erotickou tematikou (tuto možnost ale připravujeme)