Technická specifikace pro export produktů do e-shopu Bydlení.cz

Export probíhá pomocí XML souboru v níže uvedeném formátu. Tento soubor s aktuálními informacemi o produktech je umístěn na serveru obchodu a v pravidelných intervalech je zpracován do e-shopu na Bydlení.cz.

Formát datového souboru

První řádek souboru musí obsahovat hlavičku s informací o kódování souboru:

<?xml version="1.0" encoding="kódování"?>

Informace o produktech jsou uzavřeny do značky <shop></shop> Mezi těmito značkami jsou uvedeny všechny produkty v následujícím tvaru:

  <shopitem>
  	<title>název</title>
  	<description>krátký popis</description>
  	<detail>delší popis pro zobrazení detailu produktu</detail>
  	<url>url adresa produktu na serveru obchodu</url>
  
  	<price>cena s DPH</price>
  	<vat>DPH</vat>
  	
  	<images>
  		<imgurl>url adresa obrázku produktu</imgurl>
  		<imgurl>url adresa obrázku produktu</imgurl>
  	</images>
  
  	<category>název kategorie do které je produkt zařazen</category>
  </shopitem>
  

Význam a omezení informací o produktu

• title - název o maximální délce 255 znaků
• description - krátký popis do přehledu produktů, maximální délka 400 znaků
• detail - plný popis produktu, který bude zobrazen na detailní stránce
• url - url adresa na stránkách obchodu, na které se nachází detail produktu
• price - cena s DPH
• vat - sazba DPH, tedy 5 nebo 19
• images / imgurl - url adresy obrázků produktu, maximální počet je 4
• category - název kategorie do které je produkt zařazen, pokud je struktura kategorií hierarchická, je možné jednotlivé úrovně oddělit znakem lomítko "/"

Povinné položky u jednotlivých produktů jsou pouze title, price, vat, images / imgurl (alespoň 1 obrázek) a category. Doporučujeme však vyplnit co nejvíce informací.

Pokud data obsahují speciální symboly, musí být zakódovány pomocí XML entit, jinak nebude možné XML soubor zpracovat. Jedná se například o symboĺy >, <, &, ", ', atd.

Příklad XML souboru

  <?xml version="1.0" encoding="utf-8"?>
  <shop>
    <shopitem>
    	<title>Myčka nádobí XYZ</title>
  	<description>Myčka s malým obsahem</description>
  	<detail>Tato myčka je navržena pro malou domácnost...</detail>
  	<price>12330</price>
  	<vat>19</vat>
  	<images>
  		<imgurl>http://www.adresaobchodu.cz/mycky/xyz_1.jpg</imgurl>
  		<imgurl>http://www.adresaobchodu.cz/mycky/xyz_2.jpg</imgurl>
  	</images>
  	<category>Bílé zboží/Kuchyňské spotřebiče/Myčky nádobí</category>
    </shopitem>
  
    <shopitem>
  	<title>Kombinovaný sporák S1</title>
  	<description>Plynový sporák s elektrickou troubou</description>
  	<detail>Kombinovaný sporák s rozměry 85 x 50 x 60 cm.</detail>
  	<price>4300</price>
  	<vat>19</vat>
  	<images>
  		<imgurl>http://www.adresaobchodu.cz/sporaky/s1.jpg</imgurl>
  	</images>
  	<category>Bílé zboží/Sporáky/Kombinované</category>
    </shopitem>
  </shop>