Špecifikácia štandardného XML súboru

Štandardný XML súbor je možné využívať na import prostredníctvom ClickEshop administrátora na spracovanie jednorázových importov produktov hlavne pri vytváraní nového internetového obchodu alebo aktualizáciu existujúcich produktov. Tento súbor je možné využiť aj na napojenie na dodávateľa s automatickou aktualizáciou.

XML súbor je označený značkami a tagmi ktorých syntax je potrebné dodržiavať aby import prebehol bez chýb. Pre kvalitnú validáciu značky musia byť písané iba veľkými písmenami.

Význam jednotlivých značiek ( elementov XML feedu ):

SHOP ( Koreňový element, v súbore je obsiahnutý len raz.)
SHOPITEM ( Element obsahuje informácie o konkrétnom produkte, v súbore je uvedený toľkokrát, koľko máte produktov.

Element SHOPITEM obsahuje nasledovné elementy:

EAN ( EAN kód je používaný k označovaniu jednotlivých druhov tovaru.) Podrobnejšie o EAN kóde tu
PRODUCTNO ( Katalógové číslo produktu, sériové číslo produktu)

Poznámka: Pri importe je dôležité aby EAN alebo PRODUCTNO boli pri všetkých produktoch vyplnené z dôvodu párovania produktov a zachovania integrity.

PRODUCTNAME (Presný názov produktu. Všeobecne platí, že názov by nemal byť obecný. Pokiaľ ide o varianty produktov, ktoré sa líšia farbou, rozmermi, príchuťou, množstvom a ďalšími atribútmi, je nutné všetky tieto parametre rozlíšiť v názve produktu, aby sa nezlúčili do jedného alebo v parametroch produktu
CATEGORYTEXT (Zaradenie produktu do kategórie, uvádzať treba vždy celú cestu k produktu, tak ako to je v existujúcom eshope alebo kategórie . Kategórie sú oddelené oddelovačom zvislým lomítkom "|" ako napríklad: Elektronika | Mobilné telefóny | Príslušenstvo | Nabíjačky
Jeden produkt môže mať viac kategórii a v tom prípade sa prvok CATEGORYTEXT opakuje.
DESCRIPTION (Popis produktu, snažte sa uvádzať čo najrelevantnejší popis, vo fulltextovom vyhľadávaní sa berie do úvahy. Mal by obsahovať popis a špecifikáciu výrobku. Môže obsahovať aj formátovaný text.
DESCRIPTION_SHORT (Skrátený popis produktu, ktorý sa prednostne používa v rámci optimalizácie SEO. Neobsahuje formátovaný text a v skrátenej forme 500 znakov obsahuje dôležitú časť popisu)
IMGURL (Odkaz na hlavný/primárny obrázok produktu. Systém podporuje jpg/jpeg, png a gif typy súborov pre obrázky. Ak už raz produkt obsahoval URL linku a obrázok sa naimportoval, pri budúcej aktualizácii sa tento tag respektíve obrázok už neaktualizuje )
IMGURL_ALTERNATIVE (Odkaz na ďalší obrázok výrobku, napríklad pohľad z iného uhlu, prehľad celého balenia, a pod. Môžete uviesť viackrát. Ak už raz produkt obsahoval URL linku a obrázok sa naimportoval, pri budúcej aktualizácii sa tento tag respektíve alternatívny obrázok už neaktualizuje.)
PRICE_VAT (Celková cena produktu s DPH. Ako oddeľovač desatinných miest používať bodku ".")
VAT (Pole určujúce výšku DPH. Uvádzať výlučne číselnú hodnotu napr. 20 )
DISCOUNT (Pole určujúce výšku zľavy v % oproti výslednej cene s DPH. Ak je použitý discount (je väčší ako 0), položku PRICE_VAT treba uvádzať ako vypočítanú hodnotu už s uplatnenou so zľavou. Uvádzať výlučne číselnú hodnotu. )
MANUFACTURER (Obsahuje názov výrobcu produktu)
WARRANTY ( Záručná doba produktu. Uvádzať výlučne textovú hodnotu napr. 24 mesiacov )
UNIT ( Merná jednotka produktu. Uvádzať textovú hodnotu napr. ks, m2, balenie )
DELIVERY_DATE (Dodacia doba produktu v dňoch. Uvádzať výlučne číselnú hodnotu)
STOCK (Počet kusov na sklade pripravených k okamžitej expedícii. Uvádzať výlučne číselnú hodnotu)
AVAILABILITY ( textová informácia pre zákazníka o skladovej dostupnosti (napr. na objednávku 4-7 dní). Zobrazuje sa iba v prípade, že hodnota STOCK nie je nastavená, prípadne má produkt skladovú dostupnosť 0 kusov )
PRODUCT_STATUS ( Stav produktu. Produkt nadobúda tieto stavy:
Y - produkt je zverejnený v internetovom obchode
N - produkt nie je zverejnený a je prístupný iba z ClickEshop administrácie
H - produkt je prístupný z internetu ale nie je zverejnený v strome kategórií v internetovom obchode. Používa sa napr. pri súvisiacich variantách, kde sa nastaví hlavný produkt ako aktívny a ostatné varianty sa nastavia ako skryté.
WEIGHT (Váha produktu. Je potrebné mať všetky produkty v jednej spoločnej mernej jednotke napr. v gramoch. Uvádzať výlučne číselnú hodnotu )
LABELS (Obsahuje hodnoty štítkov produktu ako napríklad: Novinka, Akcia ...)

Štruktúra je nasledovná:
<LABELS>
<LABEL>Novinka</LABEL>
<LABEL>Akcia</LABEL>
</LABELS>

Štítky je potrebné najskôr v danom internetovom obchode manuálne vytvoriť v zozname štítkov. Štítkom je potrebné priradiť názov a zobrazovanú farbu. Až následne je možné využívať existujúce štítky na produktoch v XML feede.

Pre zmazanie všetkých štítkov na produkte sa použije prázdny element <LABELS><LABEL></LABEL></LABELS>
ITEMGROUP_ID kód alebo ID pod ktorým je možné združovať jednotlivé produkty do skupín ako varianty. Napr. pre rovnaké produkty odlišujúce sa od seba iba farbou alebo veľkosťou
PARAM (Obsahuje hodnoty parametrov( varianty ) ako napríklad:

<PARAM>
    <PARAM_NAME>RAM</PARAM_NAME>
    <PARAM_TYPE>S</PARAM_TYPE>
    <VAL>16 GB</VAL>
    <VAL>32 GB</VAL>
    <VAL price="100" code="E555" availability="out of stock" stock="5" weight="0.5" state="N" sort_id="1">65 GB</VAL>
</PARAM>

V prípade použitia vetvy parametrov, je hodnota VAL v XML feede povinná. Porovnávajúcim údajom pre variant ( či existuje alebo nie ) je hodnota v tagu VAL.
- PARAM_NAME - názov parametra
- PARAM_TYPE - definuje spôsob zobrazenia parametra a nadobúda tieto stavy:
      S - výberový zoznam
      I - obrázková galéria
      L - tabuľka
      B - tlačidlá
      F - informačný text
- VAL - konkrétne hodnoty parametra ako sú napr. pre farbu: biela, zelená, modrá
  
  Atribúty tagu VAL:
  - price - cena za variant. Rozdiel ceny zo základnej ceny produktu ako "Navýšiť cenu o sumu"
  - code - subkód parametra / variantu
  - availability - textová informácia pre zákazníka o skladovej dostupnosti (napr. na objednávku 4-7 dní). Zobrazuje sa iba v prípade, že hodnota STOCK nie je nastavená, prípadne má variant skladovú dostupnosť 0 kusov
  - stock -počet kusov na sklade pripravených k okamžitej expedícii. Uvádzať výlučne číselnú hodnotu
  - weight - váha parametra / variantu. Je potrebné mať všetky produkty v jednej spoločnej mernej jednotke napr. v gramoch. Uvádzať výlučne číselnú hodnotu
  - state - stav parametra / variantu ( Y - aktívny / N - neaktívny )
  - sort_id - poradie hodnoty parametra / variantu v zozname

Po príprave a dokončení XML súboru na import do internetového obchodu je dôležité aby ste si svoj XML súbor najprv zazipovali a až následne ho cez ClickEshop administrátora naimportovali cez ponuku "Hromadný import"