ShopsInTouch XML rozhraní

Níže je zobrazena XML definice, kterou je nutné dodržet při synchronizaci Vašich produktů do služby ShopsInTouch. Lze ji rozdělit do dvou částí a to na seznam novinek a seznam produktů. V seznamu novinek mohou být libovolné informace od akcí na produkty či aktuality z Vašeho obchodu až po nejnovější produkty. Všechny tyto informace se zobrazí v aplikaci ShopsInTouch v sekci Vašeho obchodu v horní části stránky.
Seznam produktů je výpis všech Vašich produktů, které chcete zobrazit v mobilní aplikaci ShopsInTouch. Plně podporovány jsou kombinace produktů a příslušenství, které se efektivně v aplikaci zobrazují. Příklad vygenerovaného XML je k nahlédnutí zde.


<SHOP>
 <NEWSLIST>
  <NEWS>
   <DATE>2012-06-11</DATE>
   <TITLE>Nadpis aktuality nebo název nového produktu</TITLE>
   <DESCRIPTION>Popis aktuality nebo nového produktu</DESCRIPTION>
   <IMGURL>http://www.shop.com/banner1.jpg</IMGURL>
   <URL>http://www.shop.com/aktualita.htm</URL>
  </NEWS>
 </NEWSLIST>
 <PRODUCTLIST>
  <PRODUCT>
   <ITEM_ID>AB123</ITEM_ID>
   <PRODUCTNAME>iPHONE 4S</PRODUCTNAME>
   <DESCRIPTION>Klasický s plným dotykovým uživatelským rozhraním</DESCRIPTION>
   <DESCRIPTION_FULL><![CDATA[<p><span style="color: #b21811; font-family: Tahoma; font-size: 8pt;">Klasický s plným dotykovým uživatelským rozhraním a navíc s velikou pamětí.</span></p>]]></DESCRIPTION_FULL>
   <URL>http://www.shop.com/mobily/iphone-4s</URL>
   <IMGURLTHUMB>http://www.shop.com/mobily/iphone-4s/obrazek.jpg</IMGURLTHUMB>
   <IMGURL>http://www.shop.com/mobily/iphone-4s/obrazek.jpg</IMGURL>
   <IMGURL_ALTERNATIVE>http://www.shop.com/mobily/iphone-4s/obrazek2.jpg</IMGURL_ ALTERNATIVE>
   <IMGURL_ALTERNATIVE>http://www.shop.com/mobily/iphone-4s/obrazek3.jpg</IMGURL_ ALTERNATIVE>
   <IMGURL_ALTERNATIVE>http://www.shop.com/mobily/iphone-4s/obrazek4.jpg</IMGURL_ ALTERNATIVE>
   <VIDEO_URL>http://www.youtube.com/watch?v=KjR759oWF7w</VIDEO_URL>
   <PRICE>5400</PRICE>
   <PRICE_VAT>6000</PRICE_VAT>
   <VAT>10</VAT>
   <MANUFACTURER>APPLE</MANUFACTURER>
   <CATEGORYTEXT>Elektronika | Mobilní telefony</CATEGORYTEXT>
   <CATEGORYTEXT>Akční nabídka</CATEGORYTEXT>
   <EAN>6417182041488</EAN>
   <ISBN>6417182041488</ISBN>
   <UPC>1234679991111</UPC>
   <PARAM>
    <NAME>Barva</NAME>
    <VALUE>Bílá</VALUE>
   </PARAM>
   <PARAM>
    <NAME>Paměť</NAME>
    <VALUE>32 GB</VALUE>
   </PARAM>
   <PRIMARY_PRODUCT>1</PRIMARY_PRODUCT>
   <AVAILABILITY>Na skladě</AVAILABILITY>
   <DELIVERY_DATE>2</DELIVERY_DATE>
   <DELIVERY>
    <DELIVERY_NAME>Česká Pošta</DELIVERY_NAME>
    <DELIVERY_PRICE>120</DELIVERY_PRICE>
    <DEFAULT>1</DEFAULT>      
   </DELIVERY>
   <DELIVERY>
    <DELIVERY_NAME>DPD</DELIVERY_NAME>
    <DELIVERY_PRICE>130</DELIVERY_PRICE>
   </DELIVERY>
   <DELIVERY>
    <DELIVERY_NAME>DHL</DELIVERY_NAME>
    <DELIVERY_PRICE>140</DELIVERY_PRICE>
   </DELIVERY>
   <ITEMGROUP_ID>G_10</ITEMGROUP_ID>
   <ACCESSORY>CD456</ACCESSORY>
   <ACCESSORY>CD457</ACCESSORY>
   <ACCESSORY>CD458</ACCESSORY>
  </PRODUCT>
  <PRODUCT>
...
  </PRODUCT>
 </PRODUCTLIST>
</SHOP>

Popis elementů v bloku novinek

[P] - povinná položka [N] - nepovinná položka

[P] DATE – datum vydání aktuality ve formátu YYYY-MM-DD
[P] TITLE – nadpis aktuality
[N] DESCRIPTION – podrobnější popis aktuality
[N] IMGURL – cesta na obrázek k aktualitě
[N] URL – odkaz na stránku do prohlížeče na kompletní popis aktuality

Popis elementů v bloku produktů

[P] ITEM_ID – jedinečný identifikátor v rámci elektronického obchodu, nemusí být pouze číslo
[P] PRODUCTNAME – „čistý“název produktu bez dalších dovětků
[P] DESCRIPTION – popis produktu
[N] DESCRIPTION_FULL – podrobný popis produktu. Může obsahovat HTML značky, ale je nutné mít obaleno v CDATA
[P] URL – url odkaz přímo na produkt do elektronického obchodu. Může se i opakovat v rámci XML
[P] IMGURLTHUMB – odkaz na náhledový obrázek produktu, který se zobrazuje napříč aplikací
[P] IMGURL – odkaz na výchozí obrázek produktu, který se zobrazuje na detailu produktu
[N] IMGURL_ALTERNATIVE - odkaz na další obrázek produktu (může být více těchto elementů)
[N] VIDEO_URL – odkaz na video prezentaci produktu na youtube.com serveru
[P] PRICE – cena produktu bez DPH
[N] PRICE_VAT – cena produktu s DPH
[N] VAT – výše DPH
[P] MANUFACTURER – výrobce produktu
[P] CATEGORYTEXT – zařazení produktu v kategorii (může být více těchto elementů, je-li produkt umístěn ve více kategoriích zároveň). Jednotlivé kategorie jsou odděleny: mezera|mezera
[N] EAN – globální identifikační kód. Důležitý parametr pro porovnávání produktů
[N] ISBN – globální identifikační kód pro knihy
[N] UPC – globální identifikační kód pro US market
[N] PARAM – hodnoty pro kombinace produktů (může být více těchto položek)
[N] PRIMARY_PRODUCT – označení, zda se jedná o default výchozí produkt ke kombinacím produktům (0/1)
[P] AVAILABILITY – dostupnost produktu, např. Na skladě, Na dotaz, Do 2 dnů
[N] DELIVERY_DATE – doba doručení, čísla od 0.
[N] DELIVERY – informace o ceně za přepravu po daný produkt + druhy přepravy (může být více těchto položek)
[N] ITEMGROUP_ID – označení skupiny, ve které se produkt nachází (kombinace produktů)
[N] ACCESSORY – identifikátor produktů (ITEM_ID), kterou jsou příslušenstvím pro daný produkt (může být více těchto položek)