Specifikace XML feedu

Povinná pole

• PRODUCTS povinné – kořenový element produktů, v souboru je uveden pouze jednou.
• PRODUCT povinné – element obsahuje informace o konkrétním produktu. Každý produkt má samostatný element.
• ITEM_ID povinné – unikátní ID produktu ve vašem eshopu.
• TITLE povinné – název produktu.
• CATEGORIES > CATEGORY povinné – zařazení produktu do kategorií. Element CATEGORY je možné opakovat. U konkrétní kategorie je možné uvádět i ID kategorie ve vašem eshopu.
• URL povinné – URL adresa produktu ve vašem eshopu.
• IMG povinné – URL adresa obrázku produktu ve vašem eshopu. Doporučujeme menší rozlišení obrázků. Přibližně 200x200px.
• PRICE povinné – aktuální cena produktu.

Doporučená pole

• BRAND doporučené – značka produktu.
• SALE_PRICE doporučené – akční cena produktu.
• MARGIN doporučené – marže na produktu.
• NUM_OF_SALES doporučené – počet objednávek daného produktu.
• STOCK doporučené – počet produktu na skladě.
• DELIVERY_DATE doporučené – počet dní dodání produktu v případě, že není na skladě.
• DELIVERY_TEXT doporučené – popisek k dostupnosti produktu.
• LABELS > LABEL doporučené – seznam štítků produktu. Element LABEL je možné opakovat. Každý štítek obsahuje tato pole:
  • LABEL_NAME – název štítku (např. Novinka, Akce, Hit).
  • LABEL_CSS_CLASS – CSS třída, pokud ji chcete použít v designu.
  • LABEL_BACKGROUND_COLOR – barva pozadí štítku v hex formátu (#rrggbb).
  • LABEL_TEXT_COLOR – barva textu štítku (#rrggbb).

Volitelná pole

• ITEM_GROUP_ID volitelné – ID skupiny produktů.
• GROUP_TITLE volitelné – název skupiny produktů v případě použití ITEM_GROUP_ID.
• DESCRIPTION volitelné – popis produktu.
• PARAMS > PARAM volitelné – přiřazení dodatečných parametrů k produktu (velikost, barva,...). Element PARAM je možné opakovat. U konkrétního parametru je třeba uvádět název parametru v elementu PARAM_KEY a jeho hodnotu v elementu PARAM_VALUE.
• RELATED_PRODUCTS > RELATED_ITEM_ID volitelné – seznam propojených produktů. Element RELATED_ITEM_ID je možné opakovat.

Ukázka feedu

<?xml version="1.0" encoding="utf-8"?>
<PRODUCTS>
  <PRODUCT>
    <ITEM_ID>1</ITEM_ID>
    <TITLE>Produkt</TITLE>
    <CATEGORIES>
      <CATEGORY id="2">Hlavní kategorie | Kategorie 1</CATEGORY>
    </CATEGORIES>
    <URL>https://www.adresavasehoobchodu.cz/produkt</URL>
    <IMG>https://www.adresavasehoobchodu.cz/obrazek_produktu.png</IMG>
    <PRICE>19.99</PRICE>
    <BRAND>Název značky</BRAND>
    <SALE_PRICE>17.99</SALE_PRICE>
    <MARGIN>4.50</MARGIN>
    <NUM_OF_SALES>125</NUM_OF_SALES>
    <STOCK>42</STOCK>
    <DELIVERY_DATE>3</DELIVERY_DATE>
    <DELIVERY_TEXT>Skladem</DELIVERY_TEXT>
    <LABELS>
      <LABEL>
        <LABEL_NAME>Novinka</LABEL_NAME>
        <LABEL_CSS_CLASS>label_new</LABEL_CSS_CLASS>
        <LABEL_BACKGROUND_COLOR>#00ff00</LABEL_BACKGROUND_COLOR>
        <LABEL_TEXT_COLOR>#ffffff</LABEL_TEXT_COLOR>
      </LABEL>
    </LABELS>
    <ITEM_GROUP_ID>1</ITEM_GROUP_ID>
    <GROUP_TITLE>Název skupiny produktů</GROUP_TITLE>
    <DESCRIPTION>Popis produktu</DESCRIPTION>
    <PARAMS>
      <PARAM>
        <PARAM_KEY>Velikost</PARAM_KEY>
        <PARAM_VALUE>XL</PARAM_VALUE>
      </PARAM>
      <PARAM>
        <PARAM_KEY>Barva</PARAM_KEY>
        <PARAM_VALUE>Žlutá</PARAM_VALUE>
      </PARAM>
    </PARAMS>
    <RELATED_PRODUCTS>
      <RELATED_ITEM_ID>2</RELATED_ITEM_ID>
    </RELATED_PRODUCTS>
  </PRODUCT>
</PRODUCTS>

Povinná pole

• CATEGORIES povinné – kořenový element kategorií, v souboru je uveden pouze jednou.
• CATEGORY povinné – element obsahuje informace o konkrétní kategorii. Každá kategorie má samostatný element.
• TITLE povinné – název kategorie.
• URL povinné – URL adresa kategorie.

Doporučená pole

• ID doporučené – unikátní ID kategorie ve vašem eshopu.
• HIERARCHY doporučené – cesta kategorie. Volitelné v případě použití hodnot ID a PARENT_ID.

Volitelná pole

• PARENT_ID volitelné – ID nadřazené kategorie ve vašem eshopu.

Ukázka feedu

<?xml version="1.0" encoding="utf-8"?>
<CATEGORIES>
  <CATEGORY>
    <TITLE>Hlavní kategorie</TITLE>
    <URL>https://www.adresavasehoobchodu.cz/hlavni_kategorie</URL>
    <ID>1</ID>
    <HIERARCHY>Hlavní kategorie</HIERARCHY>
    <PARENT_ID>0</PARENT_ID>
  </CATEGORY>
  <CATEGORY>
    <TITLE>Kategorie 1</TITLE>
    <URL>https://www.adresavasehoobchodu.cz/kategorie_1</URL>
    <ID>2</ID>
    <HIERARCHY>Hlavní kategorie | Kategorie 1</HIERARCHY>
    <PARENT_ID>1</PARENT_ID>
  </CATEGORY>
</CATEGORIES>

Povinná pole

• BRANDS povinné – kořenový element značek, v souboru je uveden pouze jednou.
• BRAND povinné – element obsahuje informace o konkrétní značce. Každá značka má samostatný element.
• TITLE povinné – název značky.
• URL povinné – URL adresa značky.

Ukázka feedu

<?xml version="1.0" encoding="utf-8"?>
<BRANDS>
  <BRAND>
    <TITLE>Název značky</TITLE>
    <URL>https://www.adresavasehoobchodu.cz/znacka</URL>
  </BRAND>
</BRANDS>

Feed článků slouží k přenosu obsahu blogu, magazínu nebo jiných textových příspěvků z Vašeho webu do Magrano. Díky tomu mohou uživatelé vyhledávat i v článcích a získávat relevantní odpovědi přímo z Vaší obsahové databáze.

Povinná pole

• ARTICLES povinné – kořenový element článků, v souboru je uveden pouze jednou.
• ARTICLE povinné – element obsahuje informace o konkrétním článku. Každý článek má samostatný element.
• TITLE povinné – název článku.
• URL povinné – URL adresa článku.
• CONTENT povinné – kompletní text (obsah) článku.

Volitelná pole

• ARTICLE_ID volitelné – unikátní ID článku ve vašem systému.
• PEREX volitelné – krátký úvodní text (perex, anotace) článku.

Ukázka feedu

<?xml version="1.0" encoding="utf-8"?>
<ARTICLES>
  <ARTICLE>
    <TITLE>Název článku v blogu</TITLE>
    <URL>https://www.adresavasehoobchodu.cz/blog/nazev-clanku</URL>
    <CONTENT>Kompletní text článku se nachází zde...</CONTENT>
    <ARTICLE_ID>1</ARTICLE_ID>
    <PEREX>Krátký úvodní text nebo perex článku.</PEREX>
  </ARTICLE>
</ARTICLES>