Struktura XML souboru se zbožím

Na této stránce naleznete podrobný návod jak sestavit XML soubor vašeho obchodu, abychom jej dokázali zpracovat. XML soubor MODEMI.cz je podobný ostatním konkurenčním XML souborům. Tudíž pokud používáte jiné vyhledávače zboží (např. Heureka feed, Zboží.cz feed), měli bychom váš XML soubor umět zpracovat. Podmínkou je, aby váš XML soubor obsahoval značku <ITEM_ID>, která zaručuje unikátní kód produktu. Důležité je poskytnout MODEMI.cz originální XML soubor s vašimi měřícími kódy, abyste mohli správně vyhodnocovat kampaně zboží např. v Google Analytics.

1. Struktura XML souboru

Hlavička XML

<?xml version="1.0" encoding="utf-8"?>

<SHOP>

Kořenová značka XML souboru.

<SHOP>
<SHOPITEM><!-- ... --></SHOPITEM>
<SHOPITEM><!-- ... --></SHOPITEM>
<!-- ... -->
</SHOP>

<SHOPITEM>

Obsahuje informace týkající se jednoho konkrétního produktu.

<SHOP>
<SHOPITEM>
	<PRODUCTNAME>Šaty</PRODUCTNAME>
		<!-- ... -->
	</SHOPITEM>
<SHOPITEM>
<PRODUCTNAME>Bunda</PRODUCTNAME>
<!-- ... -->
</SHOPITEM>
<!-- ... -->
</SHOP>

2. Vlastnosti produktu v XML souboru

Následující značky popisují vlastnosti produktu, přidávají se dovnitř elementu <SHOPITEM>…</SHOPITEM>.

ITEM_ID String (64)

Unikátní kód produktu, který používáte ve vašem katalogu. Musí být v rámci vašeho obchodu unikátní a neměnný. Např. ID produktu ve skladovém systému, je povolena jakákoli kombinace znaků [0-9, a-z, A-Z, _ , -]

<ITEM_ID>187545</ITEM_ID>
<ITEM_ID>md9020-02</ITEM_ID>

ITEM_GROUP_ID String (64)

Všechny položky, které jsou variantami stejného produktu a liší se pouze barvou, velikostí, vzorem apod., musí mít stejné ITEM_GROUP_ID.

<SHOP>
<SHOPITEM>
<PRODUCTNAME>Šaty černé</PRODUCTNAME>
<!-- ... -->
<ITEM_GROUP_ID>s1501</ITEM_GROUP_ID>
</SHOPITEM>
<SHOPITEM>
<PRODUCTNAME>Šaty modré</PRODUCTNAME>
<!-- ... -->
<ITEM_GROUP_ID>s1501</ITEM_GROUP_ID>
</SHOPITEM>
<!-- ... -->
</SHOP>
								

PRODUCTNAME String (200)

Název produktu.

<PRODUCTNAME>Šaty</PRODUCTNAME>

EAN String (200)

Kód produktu (čárový kód).

<EAN>8434486530973</EAN>

DESCRIPTION String (65535)

Textový popis produktu.

<DESCRIPTION><![CDATA[Dámské stylové šaty...]]></DESCRIPTION>

URL String (767)

URL produktu ve vašem eshopu.

<URL>https://www.example.com/saty/saty-187545/</URL>

URL_SIZE String (767)

URL produktu ve vašem eshopu, která směřuje na konkrétní stránku produktu se zvolenou velikostí.

<URL_SIZE>https://www.example.com/saty/saty-187545/?size=40</URL_SIZE>

IMGURL String (767)

URL hlavního obrázku produktu.

<IMGURL>https://img.example.com/saty-1875455.jpg</IMGURL>

IMGURL_ALTERNATIVE String (767)

URL dalšího obrázku produktu. Tento tag se může libovolně opakovat.

<IMGURL_ALTERNATIVE>https://img.example.com/saty-1875455-1.jpg</IMGURL_ALTERNATIVE>

PRICE_VAT Decimal

Koncová cena produktu s DPH.

<PRICE_VAT>780</PRICE_VAT>

PRICE_OLD_VAT Decimal

Cena produktu před slevou s DPH.

<PRICE_OLD_VAT>1080</PRICE_OLD_VAT>

MANUFACTURER String (200)

Název značky produktu, např. Adidas nebo název vaší značky.

<MANUFACTURER>Adidas</MANUFACTURER>

CATEGORYTEXT String (255)

Uveďte kategorii produktu včetně pohlaví.

<CATEGORYTEXT> Ženy | Oblečení | Šaty</CATEGORYTEXT>

MODEMI_CPC Decimal

Nastavení CPC pro produkt pro desktop. CPC na mobil je automaticky proporčně navýšené dle poměru, který naleznete ve své administraci v sekci Nastavení CPC.
Hodnota se použije pokud je vyšší než základní hodnota pro kategorii.

<MODEMI_CPC>3,75</MODEMI_CPC>

PARAM String (255)/integer

Uvádějte všechny parametry, které máte k dispozici: střih, velikost, materiál, délka, barva, atd.

<PARAM>
<PARAM_NAME>velikost</PARAM_NAME>
<VAL>M</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>barva</PARAM_NAME>
<VAL>černá</VAL>
</PARAM>

DELIVERY_DATE Integer

Dodací doba produktu ve dnech.

Skladem <DELIVERY_DATE>0</DELIVERY_DATE>
Za tři dny <DELIVERY_DATE>3</DELIVERY_DATE>

DELIVERY String (255)/integer

Doprava obsahuje více prvků. V prvku DELIVERY_ID nastavte název dopravce, v DELIVERY_PRICE cenu a cenu s volitelnými poplatky (například za dobírku) v DELIVERY_PRICE_COD. Pokud je cena za dobírku stejná, vyplňte tuto položku se stejnou cenou.

Pokud máte dopravu zdarma, uveďte alespoň jednu dopravu, kterou nabízíte. U této dopravy pak uveďte cenu DELIVERY_PRICE 0 Kč a pokud nabízíte i dopravu s dobírkou zdarma, tak uveďte i u DELIVERY_PRICE_COD 0 Kč. U Vašich produktů na MODEMI.cz se bude vždy zobrazovat nejlevnější varianta dopravy, kterou nabízíte.

Příklad - doprava 59 Kč bez dobírky a 99 Kč s dobírkou

<DELIVERY>
<DELIVERY_ID>PPL</DELIVERY_ID>
<DELIVERY_PRICE>59</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>99</DELIVERY_PRICE_COD>
</DELIVERY>

Příklad - doprava 0 Kč bez dobírky a 29 Kč s dobírkou

<DELIVERY>
<DELIVERY_ID>PPL</DELIVERY_ID>
<DELIVERY_PRICE>0</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>29</DELIVERY_PRICE_COD>
</DELIVERY>

Příklad - doprava i dobírka zdarma:

<DELIVERY>
<DELIVERY_ID>PPL</DELIVERY_ID>
<DELIVERY_PRICE>0</DELIVERY_PRICE>
<DELIVERY_PRICE_COD>0</DELIVERY_PRICE_COD>
</DELIVERY>

3. Příklad XML souboru:

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
 <SHOPITEM>
  <ITEM_ID>187545</ITEM_ID>
  <ITEM_GROUP_ID>187545aa</ITEM_GROUP_ID>
  <PRODUCTNAME>Desigual Šaty Černá</PRODUCTNAME>
  <PRODUCTNO>aaww7711</PRODUCTNO>
  <EAN>8434486542518</EAN>
  <DESCRIPTION><![CDATA[Dámské stylové šaty...]]></DESCRIPTION>
  <URL>https://www.example.com/saty/saty-187545/</URL>
  <URL_SIZE>https://www.example.com/saty/saty-187545/?size=40</URL_SIZE>
  <IMGURL>https://img.example.com/saty-1875455.jpg</IMGURL>
  <IMGURL_ALTERNATIVE>https://img.example.com/saty-1875455-1.jpg</IMGURL_ALTERNATIVE>
  <IMGURL_ALTERNATIVE>https://img.example.com/saty-1875455-2.jpg</IMGURL_ALTERNATIVE>
  <PRICE_VAT>2099.00</PRICE_VAT>
  <PRICE_OLD_VAT>2299.00</PRICE_OLD_VAT>
  <MANUFACTURER>Desigual</MANUFACTURER>
  <CATEGORYTEXT>Ženy | Oblečení | Šaty </CATEGORYTEXT>
  <DELIVERY_DATE>0</DELIVERY_DATE>
  <PARAM>
    <PARAM_NAME>barva</PARAM_NAME>
    <VAL>Černá</VAL>
  </PARAM>
  <PARAM>
    <PARAM_NAME>materiál</PARAM_NAME>
    <VAL>svršek - 95% polyamid, 5% elastan</VAL>
  </PARAM>
  <PARAM>
    <PARAM_NAME>vzor</PARAM_NAME>
    <VAL>krajkovaný</VAL>
  </PARAM>
  <PARAM>
    <PARAM_NAME>střih</PARAM_NAME>
    <VAL>mini</VAL>
  </PARAM>
  <PARAM>
    <PARAM_NAME>velikost</PARAM_NAME>
    <VAL>36;38;40</VAL>
  </PARAM>
  <MODEMI_CPC>3,5</MODEMI_CPC>
  <DELIVERY>
    <DELIVERY_ID>PPL</DELIVERY_ID>
    <DELIVERY_PRICE>89</DELIVERY_PRICE>
    <DELIVERY_PRICE_COD>99</DELIVERY_PRICE_COD>
  </DELIVERY>
  <DELIVERY>
    <DELIVERY_ID>Česká pošta</DELIVERY_ID>
    <DELIVERY_PRICE>49</DELIVERY_PRICE>
    <DELIVERY_PRICE_COD>89</DELIVERY_PRICE_COD>
  </DELIVERY>
 </SHOPITEM>
</SHOP>
nahoru