Sledujcenu.cz - průvodce nakupováním

Popis XML souboru (feedu)

Základní informace

Níže je popsán formát xml souboru, který slouží pro import zboží z obchodu, zvlášť jsou vyznačeny povinné hodnoty, pokud nejsou povinné hodnoty u položky obsaženy je celá brána jako neplatná.


Formát soubor se shoduje s jinými srovnávači zboží, pokud již využíváte import zboží do portálu Heureka.cz nemusíte provádět žádné úpravy a můžete použít stejný soubor i pro SledujCenu.cz.


Soubor je stahován několikrát za týden, nejčastěji v nočních hodinách.


Údaje uvedené v souboru musí odpovídat skutečným hodnotám v internetovém obchodě.

Popis XML formátu

Příklad

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
<SHOPITEM>
  <PRODUCTNAME>Nokia C6</PRODUCTNAME>
  <URL>http://www.nejaky-obchod.cz/nokia-c6</URL>  
  <PRICE_VAT>6530</PRICE_VAT>
  <DELIVERY_DATE>0</DELIVERY_DATE>
  <DESCRIPTION> Chytrý mobilní telefon. Dotykový telefon řady C. Nechybí podpora HSDPA, Wi-Fi, GPS.
  Doba hovoru je přibližně 300 hodin a baterie má kapacitu 1200mAh. K dispozice k výsuvná klávesnice, 
  která umožňuje rychlé psaní SMS zpráv a emailů.
  </DESCRIPTION>
  <IMGURL>http://www.nejaky-obchod.cz/nokia-c6.png</IMGURL>
  <MANUFACTURER>NOKIA</MANUFACTURER>  
  <CATEGORYTEXT>Elektronika | Mobilní telefony a tablety | Mobilní telefony</CATEGORYTEXT>
  <EAN>6438158164475</EAN>
  <PROMOTION>1</PROMOTION>
</SHOPITEM>
</SHOP>


Povinné údaje

  • SHOP - základní značka, která vše obaluje, je obsažena pouze jednou
  • SHOPITEM - značka vždy obaluje každý produkt
  • PRODUCTNAME nebo PRODUCT obsahuje přesný název produktu
    • PRODUCTNAME pokud osahuje text je upřednostněn
    • PRODUCT pokud je PRODUCTNAME prázdný, získá se hodnota ze značky PRODUCT
  • URL obsahuje adresu produktu v internetovém obchodě, tedy stránky, na které je možné zboží zakoupit, url by měla být jedinečná
  • PRICE nebo PRICE_VAT cena může být zadána několika způsoby, cena musí být konečná se všemi poplatky
    • PRICE_VAT pokud obsahuje tato značka cena s DPH je primárně zpracována
    • PRICE a VAT pokud není PRICE_VAT vyplněna, pokusí se cena získat ze značek PRICE, kde je cena bez DPH a značky VAT, jde je výše DPH (ve tvaru 0.20 nebo 20)
    • PRICE pokud není vyplněna žádná z předchozích variant a není nastavena značka VAT, použije se hodnota jako konečná cena s DPH

Nepovinné údaje

  • DELIVERY_DATE počet dnů, kdy bude zboží od přijetí platby expedováno, není-li tento údaj uveden, nastaví se dostupnost jako neznámá
    • hodnota 0 nebo ihned značí, že je zboží skladem a může být ihned expedováno
    • 1 nebo jiná celočíselná hodnota značí počet dnů
    • -1 značí neznámou dobu dodání
    • 2012-11-18 značí, že zboží bude skladem až od daného data (rok-měsíc-den)
  • EAN slouží pro identifikaci zboží, používejte pouze oficiální kódy nikoli vlastní označení nebo katalogové čísla
  • MANUFACTURER název výrobce
  • CATEGORYTEXT název kategorie
    • hodnota může být např.: Elektronika | Mobilní telefony a tablety | Mobilní telefony nebo Elektronika > Mobilní telefony a tablety > Mobilní telefony
    • pro oddělování kategorií můžete použít znak | nebo >
  • DESCRIPTION popis produktu, neměl by obsahovat informace, které se přímo netýkají zboží
  • IMGURL url adresa obrázku, obrázek by neměl obsahovat vodoznak apod., rozměr obrázku být větší jako 50x50 a menší než 1000x1000
  • PROMOTION (připravuje se) slouží pro propagaci zboží z Vašeho obchodu. Váš internetový obchod má na portále vlastní stránku ("vizitku"), kde jsou obecné informace, možnosti plateb a doručení, pobočky pro osobní odběr a také část, kde jsou zobrazeny produkty, které obchod nabízí. Jejich výběr je náhodný, pokud chcete ovlivnit, které produkty se zde mají vypisovat, tak právě těmto produktům přidejte tag PROMOTION s hodnotou 1, tyto produkty pak budou upřednostněny. Počet produktů není omezen.


V případě jakýchkoliv nejasností využijte náš kontaktní formulář.