překlad do CZ
překlad do CZ překlad do SK překlad do ENG překlad do DE překlad do HU překlad do PL překlad do RU

Specifikace XML souboru

Význam jednotlivých zkratek
Nezbytnosti kvalitního XML souboru
Ukázka XML souboru
Vytvoření XML souboru
Nejčastější chyby

Význam jednotlivých zkratek

Nezbytnosti kvalitního XML souboru

XML soubor obsahuje důležité tagy:

PRODUCTNAME - název obsahuje výrobce, produktové číslo či kód
ITEM_ID - unikátní a trvalá identifikace produktu
CATEGORYTEXT - celá cesta k produktu
DELIVERY - cena dopravy jednolivých produktů
DELIVERY_DATE - dostupnost produktů
IMGURL_ALTERNATIVE, VIDEO_URL, ACCESSORY - pro vylepšení představení a ukázky produktů
ITEMGROUP_ID - varianty různých velikostí, barev, vzorů atd. jednotlivých produktů, které lze sdružovat

Ukázka XML souboru

Aby mohlo dojít k importu vašich produktů do našeho systému je potřeba mít vytvoření tzv. XML soubor (XLM FEED), s jehož pomocí nám předáte potřebné informace o vašem zboží. XML soubor je automaticky generován z vašich stránek, a proto se o jeho vytvoření či úpravách poraďte se svým webmasterem.

Množství exportovaných dat je úspěchem k zobrazovaní v našem systému. Doporučená podoba specifikace jednotlivých položek je uvedena níže.
<?xml version="1.0" encoding="utf-8"?>
<SHOP>
<SHOPITEM>
<ITEM_ID>AB123</ITEM_ID>
<PRODUCTNAME>Nokia 5800 XpressMusic</PRODUCTNAME>
<PRODUCT>Nokia 5800 XpressMusic + pouzdro zdarma</PRODUCT>
<DESCRIPTION>Klasický s plným dotykovým uživatelským rozhraním</DESCRIPTION>
<URL>http://obchod.cz/mobily/nokia-5800-xpressmusic</URL>
<IMGURL>http://obchod.cz/mobily/nokia-5800-xpressmusic/obrazek.jpg</IMGURL>
<IMGURL_ALTERNATIVE>http://obchod.cz/mobily/nokia-5800-xpressmusic/obrazek2.jpg</IMGURL_ALTERNATIVE>
<PRICE_VAT>6000</PRICE_VAT>
<CATEGORYTEXT>Elektronika | Mobilní telefony</CATEGORYTEXT>
</SHOPITEM>
<SHOPITEM>
...
</SHOPITEM>
</SHOP>

Vytvoření XML souboru

Váš XML soubor stahujeme pravidelně jednou za 12 hodin. Z vaší strany je třeba vždy zajistit aktuálnost souboru, aby data byla co nejrelevantnější.

Komprimace XML Souboru
Základní XML soubor přijímáme také ve formátu GZip. Lze tedy pouzit GZip kompresi HTTP přenosu tohoto souboru. Stačí mít váš HTTP server nakonfigurovaný tak, aby tuto kompresi podporoval, což je většinou standardní chovaní. Ke komprimaci pak dojde transparentně na straně HTTP serveru a k dekomprimaci pak opět transparentně na straně našeho HTTP serveru. Dojde tak k úspoře objemu přenesených dat, avšak i tak přijímáme XML soubor s max. 100 000 položkami.

Aktualizace XML hlavičky
Před samotným stažením XML souboru kontrolujeme datum jeho poslední modifikace prostřednictvím HTTP hlavičky "Last-Modified". Doporučujeme tedy nakonfigurovat HTTP server tak, aby tuto informaci v hlavičce odpovědi odesílal. Předejde se tak zbytečné zátěži serverů na obou stranách, způsobené stahováním nezměněných XML souborů.

Význam elementů:

SHOP
Kořenový element, v souboru je obsažen pouze jednou.
SHOPITEM
Element obsahuje informace o konkrétním produktu, v souboru je obsažen tolikrát, kolik máte variant produktů.
ITEM_ID
Unikátní označení produktu v rámci e-shopu. Musí zůstat unikátní navždy, díky čemuž budeme schopni jednoznačně identifikovat produkt i když se změní URL. Kombinace maximálně 36 znaků [0-9a-zA-Z_\-] tedy čísel nula až devět, malých a velkých písmen bez diakritiky, podtržítka a pomlčky.
PRODUCTNAME
Přesný název produktu. Nesmí obsahovat žádné jiné informace, jako např. dárek, pouzdro či nabíječka zdarma, atd. Hodnota musí být obsažena také v tagu PRODUCT, jinak nebude brána v potaz. Pokud názvy produktů nebudou obsahovat produktové číslo, hrozí, že nedokážeme produkty správně identifikovat. Maximální délka názvu produktu je 255 znaků.

SPRÁVNĚCanon PowerShot SX100 červený

ŠPATNĚDigitální fotoaparát Canon SX100 Power-shot + nabíječka

Povinné údaje v názvu pro jednotlivé kategorie Obecně platí, že název nesmí být obecný. Pokud tedy uvedete do názvu produktu výrobce, řadu a produktové číslo, měl by být produkt v pořádku zařazen. Pokud se jedná o varianty produktů, které se liší barvou, rozměry, příchutí, množstvím a dalšími atributy, je nutné všechny tyto parametry rozlišit v názvu produktu, aby se nesloučily do jednoho.

PRODUCT
Obsahuje rozvětvený PRODUCTNAME včetně přívlastků, jako dárek zdarma, + pouzdro, poukaz na ….. Tento název bude zobrazen v porovnání cen. Např. „Digitální fotoaparát Canon SX100 Power-shot + nabíječka“. Maximální délka názvu produktu je 255 znaků.
DESCRIPTION
Popis produktu, snažte se uvádět co nejrelevantnější popis, ve fulltextovém vyhledávání se bere v potaz. Měl by obsahovat popis a specifikaci výrobku bez reklamy na dopravu zdarma, akce a daný obchod. Není povolena nadměrná interpunkce. Počet znaků v tagu DESCRIPTION není omezen, avšak ve fulltextu zobrazujeme pouze 200 znaků.
URL
Odkaz na stránku s nabídkou daného výrobku v obchodě. Na této stránce musí být uvedena cena produktu a možnost vložit do košíku. Adresa musí být unikátní v rámci celého feedu.
IMGURL
Odkaz na hlavní/primární obrázek produktu.

Podmínky pro obrázky

Adresa obrázku nesmí obsahovat mezery či diakritiku. Pokud máte pro více produktů jeden obrázek, použijte vždy jednu a tu samou adresu (adresa nemusí být jedinečná v rámci feedu). Dále by obrázek neměl mít průhledné pozadí. Při změně obrázku na stránkách obchodu je třeba změnit též url adresu obrázku v XML souboru. Obrázky automaticky aktualiyujeme pouze v případě ,že se podaří zjistit jejich velikost. Minimální potřebná velikost obrázku je 500x500pixelů, maximální 1500x1500px. Posílejte nám pouze obrázky (nejlépe *jpeg) produktů. Obrázky typu http://www.obchod.cz/img/bez-obrazku.gif do feedu nedávejte! Zajistěte, aby na jedné url nedocházelo k rotování obrázků (na jedné adrese se musí vždy nacházet ten samý obrázek), protože náš systém si může stáhnout z vašich stránek obrázek kdykoliv. Vám by se pak mohly zobrazovat špatné (nebo také žádné) obrázky u produktů. Obrázky musí být univerzální, nesmí tedy obsahovat vodoznak, zobrazení nějaké slevy či bonusu. V opačném případě budou blokovány. .
IMGURL_ALTERNATIVE
Odkaz na další obrázek výrobku, například pohled z jiného úhlu, přehled celého balení, apod.Lze uvést vícekrát.
PRICE_VAT
Koncová cena produktu s DPH, v ceně musí být uvedeny autorské a recyklační poplatky.

Uvádění ceny

Ceny na serveru uvádíme vždy konečné.

Cena může být uvedena v těchto formátech:

25000
25000,50
25000.50

Nepoužívejte jako oddělovač tisíců/miliónů tečku ('.'), ta je použita k oddělování desetinných míst. Cenu uvádějte maximálně na 2 desetinná místa.

CATEGORYTEXT

Zařazení produktu do kategorie, uvádějte vždy celou cestu k produktu, tak jak to máte na vašem eshopu (stačí nám tedy vaše kategorie) pokud jasně určují druh produktu.

SPRÁVNĚElektronika | Mobilní telefony | Příslušenství | Nabíječky | Originální
ŠPATNĚNabíječky

Kategorie musí vždy jasně určovat druh produktu, které se pod ní skrývají.

SPRÁVNĚElektronika | Televize | LCD televize
SPRÁVNĚElektronika | Bílá technika | Ost. Kuchyňské přístroje | Vaflovače
SPRÁVNĚDětské zboží | Hračky | Pro nejmenší | Chrastíka
SPRÁVNĚKosmetika | Pleťové kosmetika | Pleťové krémy
SPRÁVNĚChovatelství | Pro psy | Krmivo
SPRÁVNĚOblečení | Dámské | Trička
ŠPATNĚTelevize
ŠPATNĚOstatní kuchyňské přístroje
ŠPATNĚPodle výrobce | Bosch
ŠPATNĚHračky | Cars
ŠPATNĚosmetika | Pleťová kosmetika
ŠPATNĚChovatelství | Krmiva
ŠPATNĚOblečení | Dámské oblečení
ŠPATNĚOblečení | Krátká trička

Pozn.: Jednotlivé podkategorie oddělujte následujícím způsobem NADKATEGORIE mezera | mezera PODKATEGORIE

Vytvoření XML souboru pomocí CDATA

Tohoto zápisu využijete v případě textů, kde se vyskytuje příliš mnoho nepovolených znaků (např. "&", "<", ">")

<MANUFACTURER><![CDATA[Black & Decker]]></MANUFACTURER>

Nejčastější chyby

1) Nenahrazení některých znaků (např. "&", "<", ">") entitami

<MANUFACTURER>Black & Decker</MANUFACTURER>

Možné řešení:

<MANUFACTURER>Black &amp; Decker</MANUFACTURER>

<MANUFACTURER><![CDATA[Black & Decker]]></MANUFACTURER>


2) Neuzavřený element

<PRODUCT>Clinique Happy EdP 30ml <DESCRIPTION>Tenoučký slide-up s bohatou multimediální výbavou</DESCRIPTION> <URL>http://obchod.cz/parfemy/clinique-happy-edp</URL>

3) Chybný formát url

<IMGURL>/parfemy/clinique-happy-edp/obrazek.jpg</IMGURL>


<IMGURL>není</IMGURL>


<URL>http://obchod.cz/noční krém</URL>


Tato stránka používá cookies, aby mohla uchovávat informace ve vašem počítači. Některé cookies zajišťují správnou funkci těchto stránek, jiné nám pomáhají vylepšovat stránky tím, že nám dovolí nahlédnout, jak jsou stránky používány. Tím, že tyto stránky dále používáte, dáváte svůj souhlas s použitím cookies.