Špecifikácia XML feedu

Prenos informácii z Vášho eshopu do Magrano môže byť riešený dvomi spôsobmi.

1. Pomocou API prepojenia

V prípade, že chcete údaje o produktoch posielať prostredníctvom API, kontaktujte našu technickú podporu.

2. Pomocou dátových súborov XML

Pre čo najlepšie výsledky vyhľadávania odporúčame použiť náš odporúčaný formát súborov, ktorý je popísaný v tomto dokumente.

Pokiaľ máte vlastný formát XML súboru, odporúčame aby obsahoval všetky povinné a odporúčané položky.

A) Feed produktov

Povinné polia

PRODUCTS povinné – koreňový element produktov, v súbore je uvedený len raz.
PRODUCT povinné – element obsahuje informácie o konkrétnom produkte. Každý produkt má samostatný element.
ITEM_ID povinné – unikátne ID produktu vo vašom eshope.
TITLE povinné – názov produktu.
CATEGORIES > CATEGORY povinné – zaradenie produktu do kategórií. Element CATEGORY je možné opakovať. Pri konkrétnej kategórii je možné uvádzať aj ID kategórie vo vašom eshope.
URL povinné – URL adresa produktu vo vašom eshope.
IMG povinné – URL adresa obrázku produktu vo vašom eshope. Odporúčame menšie rozlíšenie obrázkov. Približne 200x200px.
PRICE povinné – aktuálna cena produktu.

Odporúčané polia

BRAND odporúčané – značka produktu.
SALE_PRICE odporúčané – akciová cena produktu.
MARGIN odporúčané – marža na produkte.
NUM_OF_SALES odporúčané – počet objednávok daného produktu.
STOCK odporúčané – počet produktu na sklade.
DELIVERY_DATE odporúčané – počet dní dodania produktu v prípade, že nie je na sklade.
DELIVERY_TEXT odporúčané – popisok k dostupnosti produktu.
LABELS > LABEL odporúčané – zoznam štítkov produktu. Element LABEL je možné opakovať. Každý štítok obsahuje tieto polia:
- LABEL_NAME – názov štítku (napr. Novinka, Akcia, Hit).
- LABEL_CSS_CLASS – CSS trieda, ak ju chcete použiť v dizajne.
- LABEL_BACKGROUND_COLOR – farba pozadia štítku v hex tvare (#rrggbb).
- LABEL_TEXT_COLOR – farba textu štítku (#rrggbb).

Voliteľné polia

ITEM_GROUP_ID voliteľné – ID skupiny produktov.
GROUP_TITLE voliteľné – názov skupiny produktov v prípade použitia ITEM_GROUP_ID.
DESCRIPTION voliteľné – popis produktu.
PARAMS > PARAM voliteľné – priradenie dodatočných parametrov k produktu (veľkosť, farba,...). Element PARAM je možné opakovať. Pri konkrétnom parametri je potrebné uvádzať názov parametra v elemente PARAM_KEY a jeho hodnotu v elemente PARAM_VALUE.
RELATED_PRODUCTS > RELATED_ITEM_ID voliteľné – zoznam previazaných produktov. Element RELATED_ITEM_ID je možné opakovať.

Ukážka feedu

<?xml version="1.0" encoding="utf-8"?>
<PRODUCTS>
  <PRODUCT>
    <!-- Povinné polia -->
    <ITEM_ID>1</ITEM_ID>
    <TITLE>Product</TITLE>
    <CATEGORIES>
      <CATEGORY id="2">Hlavná kategória | Kategória 1</CATEGORY>
    </CATEGORIES>
    <URL>https://www.adresavashohoobchodu.com/product</URL>
    <IMG>https://www.adresavashohoobchodu.com/obrazok_produktu.png</IMG>
    <PRICE>19.99</PRICE>

    <!-- Odporúčané polia -->
    <BRAND>Názov 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>Na sklade</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>

    <!-- Voliteľné polia -->
    <ITEM_GROUP_ID>1</ITEM_GROUP_ID>
    <GROUP_TITLE>Názov skupiny produktov</GROUP_TITLE>
    <DESCRIPTION>Popis produktu</DESCRIPTION>
    <PARAMS>
      <PARAM>
        <PARAM_KEY>Veľkosť</PARAM_KEY>
        <PARAM_VALUE>XL</PARAM_VALUE>
      </PARAM>
      <PARAM>
        <PARAM_KEY>Farba</PARAM_KEY>
        <PARAM_VALUE>Žltá</PARAM_VALUE>
      </PARAM>
    </PARAMS>
    <RELATED_PRODUCTS>
      <RELATED_ITEM_ID>2</RELATED_ITEM_ID>
    </RELATED_PRODUCTS>
  </PRODUCT>
</PRODUCTS>

B) Feed kategórií

Povinné polia

CATEGORIES povinné – koreňový element kategórií, v súbore je uvedený len raz.
CATEGORY povinné – element obsahuje informácie o konkrétnej kategórii. Každá kategória má samostatný element.
TITLE povinné – názov kategórie.
URL povinné – URL adresa kategórie.

Odporúčané polia

ID odporúčané – unikátne ID kategórie vo vašom eshope.
HIERARCHY odporúčané – cesta kategórie. Voliteľné v prípade použitia hodnôt ID a PARENT_ID.

Voliteľné polia

PARENT_ID voliteľné – ID nadradenej kategórie vo vašom eshope.

Ukážka feedu

<?xml version="1.0" encoding="utf-8"?>
<CATEGORIES>
  <CATEGORY>
    <!-- Povinné polia -->
    <TITLE>Hlavná kategória</TITLE>
    <URL>https://www.adresavashohoobchodu.com/hlavna_kategoria</URL>

    <!-- Odporúčané polia -->
    <ID>1</ID>
    <HIERARCHY>Hlavná kategória</HIERARCHY>

    <!-- Voliteľné polia -->
    <PARENT_ID>0</PARENT_ID>
  </CATEGORY>
  <CATEGORY>
    <!-- Povinné polia -->
    <TITLE>Kategória 1</TITLE>
    <URL>https://www.adresavashohoobchodu.com/kategoria_1</URL>

    <!-- Odporúčané polia -->
    <ID>2</ID>
    <HIERARCHY>Hlavná kategória | Kategória 1</HIERARCHY>

    <!-- Voliteľné polia -->
    <PARENT_ID>1</PARENT_ID>
  </CATEGORY>
</CATEGORIES>

C) Feed značiek

Povinné polia

BRANDS povinné – koreňový element značiek, v súbore je uvedený len raz.
BRAND povinné – element obsahuje informácie o konkrétnej značke. Každá značka má samostatný element.
TITLE povinné – názov značky.
URL povinné – URL adresa značky.

Ukážka feedu

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

D) Feed článkov

Feed článkov slúži na prenos obsahu blogu, magazínu alebo iných textových príspevkov z Vášho webu do Magrano. Vďaka tomu môžu užívatelia vyhľadávať aj v článkoch a získavať relevantné odpovede priamo z Vašej obsahovej databázy.

Povinné polia

ARTICLES povinné – koreňový element článkov, v súbore je uvedený len raz.
ARTICLE povinné – element obsahuje informácie o konkrétnom článku. Každý článok má samostatný element.
TITLE povinné – názov článku.
URL povinné – URL adresa článku.
CONTENT povinné – kompletný text (obsah) článku.

Voliteľné polia

ARTICLE_ID voliteľné – unikátne ID článku vo vašom systéme.
PEREX voliteľné – krátky úvodný text (perex, anotácia) článku.

Ukážka feedu

<?xml version="1.0" encoding="utf-8"?>
<ARTICLES>
  <ARTICLE>
    <!-- Povinné polia -->
    <TITLE>Názov článku v blogu</TITLE>
    <URL>https://www.adresavashohoobchodu.com/blog/nazov-clanku</URL>
    <CONTENT>Kompletný text článku sa nachádza tu...</CONTENT>

    <!-- Voliteľné polia -->
    <ARTICLE_ID>1</ARTICLE_ID>
    <PEREX>Krátky úvodný text alebo perex článku.</PEREX>
  </ARTICLE>
</ARTICLES>

Posledná aktualizácia: apríl 2026