Specifikace exportního souboru

Všeobecné informace

Aby mohlo dojít k importu produktů do srovnávače, je potřeba mít vytvořený exportní soubor (dále jen „XML soubor“), což je jednoduchý datový formát, pomocí kterého nám předáte informace o vašem zboží a jeho cenách. XML soubor je automaticky generován z vašich stránek, a proto jeho vytvoření či úpravy konzultujte se svým webmastrem.

Formát XML souboru je totožny s formátem pro Zboží.cz nebo Heureka.cz.

XML soubor je základ úspěšnosti vašeho zobrazování ve srovnávači a proto jej doporučujeme připravit dle níže uvedených specifikací k jednotlivým kategoriím.

Ještě před tím, než zaregistrujete svůj obchod, ujištěte se, že XML soubor splňuje tyto důležitá kritéria:

• XML soubor odpovídá Všeobecným obchodním podmínkám - před registrací XML souboru se ujistěte, že jeho obsah a formát je v souladu s Všeobecnými obchodními podmínkámi, zejména článkem IV.
• XML soubor obsahuje položku EAN - položka EAN je jediný tag pro párování vašich titulů. Pokud ve feedu není veden, titul bude v nabídce téměř neviditelný.

Váš XML soubor stahujeme každých šest hodin, abychom vždy zajistili aktuální ceny. Z vaší strany je třeba zajistit aktuálnost souboru několikrát za den, nejlépe každou hodinu, aby data byla co nejrelevantnější.

Popis jednotlivých 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 produktů
• PRODUCT - obsahuje název titulu, musí obsahovat minimálně 3 znaky, snažte se uvádět přesný název; do názvu produktu neuvádějte žádné další přívlastky, typu doprava zdarma, akce, skladem aj.
• DESCRIPTION - anotace titulu, nesmí obsahovat HTML tagy
• URL - url adresa titulu, na této adrese musí být uvedena cena s možností nákupu
• IMGURL - url adresa obrázku titulu
• PRICE - cena produktu bez DPH, v ceně musí být uvedeny autorské a recyklační poplatky
• PRICE_VAT - cena produktu s DPH, v ceně musí být uvedeny autorské a recyklační poplatky
• VAT - sazba DPH; povinné s elementem PRICE
• ITEM_TYPE – k rozlišení nových (new) a bazarových (bazaar) tištěných knih, elektronických knih (ebook)
• PARAM – zde lze uvést další parametry titulu (jazyk, počet stran, autor), pokud nejsou parametry vyplněné, pak není možné zobrazovat Vaši nabídku ve filtrování
• MANUFACTURER - název nakladatele
• CATEGORYTEXT - zařazení titulu 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)
• EAN - EAN kód je používán k označování jednotlivých druhů zboží; podporujeme formát EAN 13
• PRODUCTNO - je alfanumerický kód určený pro jednoznačnou identifikaci knižních vydání; podporujeme formáty ISBN-10 a ISBN-13; čísla v ISBN kódu se oddělují pomlčkou, například "978-0-123456-47-2"
• DELIVERY_DATE - dodací doba titulu ve dnech udaná číslovkou nebo konrétní datum vydání nebo naskladnění (formát 2013-12-24 - Vánoce), tj. doba od přijetí platby do expedice zboží

Upozornění: Nezapomeňte nepřípustné znaky (např. "&", "<", ">") nahradit entitami.

Ukázka kvalitního XML souboru

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
    <SHOPITEM>
        <PRODUCT>Škola noci 7: Vyhořelá</PRODUCT>
        <DESCRIPTION>Zoeyina duše se ocitá na onom světě – roztříštěná na kusy, vyhaslá,...</DESCRIPTION>

        <URL>http://www.vasobchod.cz/knihy/12345/skola-noci-7/</URL>
        <IMGURL>http://www.vasobchod.cz/obalka/12/skola-noci-7.jpg</IMGURL>
        <PRICE_VAT>134</PRICE_VAT>

        <ITEM_TYPE>bazaar</ITEM_TYPE>
        <MANUFACTURER>BB art</MANUFACTURER>
        <CATEGORYTEXT>Knihy | beletrie</CATEGORYTEXT>

        <EAN>9788072579525</EAN>
        <PRODUCTNO>80-7257-952-5</PRODUCTNO>
        <DELIVERY_DATE>5</DELIVERY_DATE>

        <PARAM>
            <PARAM_NAME>Žánr</PARAM_NAME>
            <VAL>dětská</VAL>

        </PARAM>
        <PARAM>
            <PARAM_NAME>Vazba</PARAM_NAME>
            <VAL>vázaná</VAL>            

        </PARAM>
        <PARAM>
            <PARAM_NAME>Autor</PARAM_NAME>
            <VAL>P.C. Castová</VAL>

        </PARAM>
        <PARAM>
            <PARAM_NAME>Jazyk</PARAM_NAME>
            <VAL>Česky</VAL>

        </PARAM>
        <PARAM>
            <PARAM_NAME>Počet stran</PARAM_NAME>
            <VAL>186</VAL>            

        </PARAM>
        <PARAM>
            <PARAM_NAME>Rok vydání</PARAM_NAME>
            <VAL>2004</VAL>

        </PARAM>
        <PARAM>
            <PARAM_NAME>Nakladatelství</PARAM_NAME>
            <VAL>BB art</VAL>

        </PARAM>
    </SHOPITEM>
...