Špecifikácia XML feedu

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

1. 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.

2. Pomocou API prepojenia

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

Feed produktov

Položky vo feede

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 ma samostatný element.

ITEM_ID (povinné) - unikátne ID produktu vo vašom eshope

ITEM_GROUP_ID (voliteľné) - ID skupiny produktov

TITLE (povinné) - názov produktu

GROUP_TITLE (nepovinné) - názov skupiny produktov v prípade použitia ITEM_GROUP_ID

DESCRIPTION (voliteľné) - popis produktu

BRAND (povinné) - značka produktu

CATEGORIES > CATEGORY (povinné) - zaradenie produktu do kategórie. 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.

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 (voliteľné) - popisok k dostupnosti 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>
                <ITEM_ID>1</ITEM_ID>
                <ITEM_GROUP_ID>1</ITEM_GROUP_ID>
                <TITLE>Product</TITLE>
                <DESCRIPTION>Popis produktu</DESCRIPTION>
                <BRAND>Názov značky</BRAND>
                <CATEGORIES>
                        <CATEGORY id="2">Hlavná kategória | Kategória 1</CATEGORY>
                </CATEGORIES>
                <URL>https://www.adresavsahobochodu.com/product</URL>
                <IMG>https://www.adresavsahobochodu.com/obrazok_produktu.png</IMG>
                <PRICE>19.99</PRICE>
                <SALE_PRICE>17.99</SALE_PRICE>
                <MARGIN>0.30</MARGIN>
                <NUM_OF_SALES>4</NUM_OF_SALES>
                <STOCK>0</STOCK>
                <DELIVERY_DATE>7</DELIVERY_DATE>
                <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>

Feed kategórii

Položky vo feede

CATEGORIES (povinné) - koreňový element kategórii, 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.
ID (voliteľné) - unikátne ID kategórie vo vašom eshope

PARENT_ID (voliteľné) - ID nadradenej kategórie vo vašom eshope
TITLE (povinné)- názov kategórie
HIERARCHY (povinné)- cesta kategórie, voliteľné v prípade použitia hodnôt ID a PARENT_ID
URL (povinné)- URL adresa kategórie

Ukážka feedu

<?xml version="1.0" encoding="utf-8"?>
<CATEGORIES>
        <CATEGORY>
                <ID>1</ID>
                <PARENT_ID>0</PARENT_ID>
                <TITLE>Hlavná kategória</TITLE>
                <HIERARCHY>Hlavná kategória</HIERARCHY>
                <URL>https://www.adresavsahobochodu.com/hlavna_kategoria</URL>
        </CATEGORY>
        <CATEGORY>
                <ID>2</ID>
                <PARENT_ID>1</PARENT_ID>
                <TITLE>Kategória 1</TITLE>
                <HIERARCHY>Hlavná kategória | Kategória 1</HIERARCHY>
                <URL>https://www.adresavsahobochodu.com/kategoria_1</URL>
        </CATEGORY>
</CATEGORIES>

Feed značiek

Položky vo feede

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.adresavsahobochodu.com/znacka</URL>
        </BRAND>
</BRANDS>

Pripravený na inteligentné vyhľadávnie?

Ukážte a odporučte svojim zákazníkom relevantné produkty pri hľadaní a získajte viac objednávok.

Vyskúšať na 30 dní zdarma

Špecifikácia XML feedu

Feed produktov

Feed kategórii

Feed značiek

Pripravený na inteligentné vyhľadávnie?

Dávid Forgáč

Pošlite nám správu