ShopsInTouch XML interface

The XML definition displayed below must be observed at the synchronisation of your products in the ShopsInTouch service. It may be divided to two parts - the list of news and the list of products. The list of news may include any information from promotional campaigns for products or news from your shop up to the newest products. All these pieces of information will be displayed in the ShopsInTouch application in the section of your e-shop in the upper part of the site.
The list of products is the statement of all your products which you want to have displayed in the mobile ShopsInTouch application. The application supports fully the combination of products and accessories which are displayed effectively in the application. An example of the generated XML is available here.


<SHOP>
 <NEWSLIST>
  <NEWS>
   <DATE>2012-06-11</DATE>
   <TITLE>Shop news title or special the of special product</TITLE>
   <DESCRIPTION>Shop news description or product description</DESCRIPTION>
   <IMGURL>http://www.shop.com/banner1.jpg</IMGURL>
   <URL>http://www.shop.com/shopnews.htm</URL>
  </NEWS>
 </NEWSLIST>
 <PRODUCTLIST>
  <PRODUCT>
   <ITEM_ID>AB123</ITEM_ID>
   <PRODUCTNAME>iPHONE 4S</PRODUCTNAME>
   <DESCRIPTION>Classic cell phone with touching display</DESCRIPTION>
   <DESCRIPTION_FULL><![CDATA[<p><span style="color: #b21811; font-family: Tahoma; font-size: 8pt;">Super Retina display and large amount of memory.</span></p>]]></DESCRIPTION_FULL>
   <URL>http://www.shop.com/cell-phones/iphone-4s</URL>
   <IMGURLTHUMB>http://www.shop.com/cell-phones/iphone-4s/picture_small.jpg</IMGURLTHUMB>
   <IMGURL>http://www.shop.com/cell-phones/iphone-4s/picture.jpg</IMGURL>
   <IMGURL_ALTERNATIVE>http://www.shop.com/cell-phones/iphone-4s/picture2.jpg</IMGURL_ ALTERNATIVE>
   <IMGURL_ALTERNATIVE>http://www.shop.com/cell-phones/iphone-4s/picture3.jpg</IMGURL_ ALTERNATIVE>
   <IMGURL_ALTERNATIVE>http://www.shop.com/cell-phones/iphone-4s/picture4.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>Electronics | Cell phones </CATEGORYTEXT>
   <CATEGORYTEXT>Special prices</CATEGORYTEXT>
   <EAN>6417182041488</EAN>
   <ISBN>6417182041488</ISBN>
   <UPC>1234679991111</UPC>
   <PARAM>
    <NAME>Color</NAME>
    <VALUE>White</VALUE>
   </PARAM>
   <PARAM>
    <NAME>Memory</NAME>
    <VALUE>32 GB</VALUE>
   </PARAM>
   <PRIMARY_PRODUCT>1</PRIMARY_PRODUCT>
   <AVAILABILITY>In stock</AVAILABILITY>
   <DELIVERY_DATE>2</DELIVERY_DATE>
   <DELIVERY>
    <DELIVERY_NAME>UPS</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)