Validátor XML feedu

Zadejte URL vašeho feedu a během chvíle se dozvíte, jestli je připraven pro nasazení.


Načítání

XML feed načítáme v pravidelném intervalu (cca jednou za den). V případě, že XML feed obsahuje chybu (chyba HTTP, nevalidní XML), dostanete jednou za den email a na Můj.Skrz.cz se v menu vlevo nahoře zobrazí notifikace.

Příklad

<?xml version="1.0" encoding="utf-8"?>      
<SHOP>      
    <SHOPITEM>
        <ITEM_ID>70164</ITEM_ID>
        <ITEMGROUP_ID>DCA3546</ITEMGROUP_ID>   
        <PRODUCTNAME>Wenger Commando Day Date 70164.XL</PRODUCTNAME>    
        <PRODUCT>Wenger Commando Day Date 70164.XL + dárek v hodnotě až 1000 Kč, doprava ZDARMA, záruka 3 roky</PRODUCT>    
        <DESCRIPTION><![CDATA[<strong>Hodinky Wenger Day Date 70164.XL jsou velmi elegantní a zároveň vysoce odolné. Po prvním nasazení na ruku je již nechcete sundat</strong>. Bytelné ocelové pouzdro zaručuje vysokou odolnost a naopak krásný kožený pásek v kombinaci s černým ciferníkem dodává hodinkám na kráse a eleganci.]]></DESCRIPTION>    
        <URL>http://obchod.cz/wenger-day-date-xl-70164/</URL>    
        <IMGURL>http://obchod.cz/wp-content/uploads/70164XL_Commando-1-232x3851.jpg</IMGURL> 
        <EAN>7612752254216</EAN>    
        <CATEGORYTEXT>Módní doplňky | Hodinky</CATEGORYTEXT>   
        <DELIVERY_DATE>0</DELIVERY_DATE>    
        <PRICE_VAT>4390</PRICE_VAT> 
        <MANUFACTURER>WENGER</MANUFACTURER> 
        <IMGURL_ALTERNATIVE>http://obchod.cz/wp-content/uploads/2010/11/wenger-commando-701641.jpg</IMGURL_ALTERNATIVE>  
        <IMGURL_ALTERNATIVE>http://obchod.cz/wp-content/uploads/2010/11/wenger-commando-70164-side.jpg</IMGURL_ALTERNATIVE>  
        <IMGURL_ALTERNATIVE>http://obchod.cz/wp-content/uploads/2010/11/wener-commando-70164-back.jpg</IMGURL_ALTERNATIVE>   
        <VIDEO_URL>http://www.youtube.com/watch?v=XXXXXXXX</VIDEO_URL>   
        <ISBN></ISBN>   
        <PRODUCTNO>70164</PRODUCTNO>    
        <PRICE>3628</PRICE> 
        <VAT>21</VAT>   
        <PRICE_VAT>4390</PRICE_VAT>
        <PRICE_ORIG>4899</PRICE_ORIG>
        <DUES>0</DUES>  
        <ITEM_TYPE>new</ITEM_TYPE>  
        <EXTRA_MESSAGE>free_delivery</EXTRA_MESSAGE>    
        <EXTRA_MESSAGE>extended_warranty</EXTRA_MESSAGE>    
        <GIFT>Kožené pouzdro zdarma</GIFT>
        <PARAM> 
            <PARAM_NAME>Vodotěsnost</PARAM_NAME>
            <VAL>100 m</VAL>
        </PARAM>    
        <PARAM> 
            <PARAM_NAME>Typ číselníku</PARAM_NAME>
            <VAL>analogový - chronograf</VAL>
        </PARAM>    
        <PARAM> 
            <PARAM_NAME>Náramek</PARAM_NAME>
            <VAL>kožený</VAL>
        </PARAM>    
        <PARAM> 
            <PARAM_NAME>Rozměry</PARAM_NAME>
            <VAL>40x47x12 mm</VAL>
        </PARAM>    
        <DELIVERY>  
            <DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>
            <DELIVERY_PRICE>0</DELIVERY_PRICE>
            <DELIVERY_PRICE_COD>0</DELIVERY_PRICE_COD>
        </DELIVERY> 
        <DELIVERY>  
            <DELIVERY_ID>DPD</DELIVERY_ID>
            <DELIVERY_PRICE>0</DELIVERY_PRICE>
            <DELIVERY_PRICE_COD>0</DELIVERY_PRICE_COD>
        </DELIVERY> 
    </SHOPITEM>
    <SHOPITEM>
        <!-- ... -->
    </SHOPITEM>     
</SHOP>     

Elementy

<SHOP>

Povinný ano
Opakování ne
Typ kořenový element dokumentu

Kořenový element, v dokumentu je obsažen pouze jednou na nejvyšší úrovni.

<SHOPITEM>

Povinný ano
Opakování ano
Typ obalující element

Element sdružuje informace k jednomu produktu. V dokumentu se může vyskytovat vícekrát. Pokud např. budu mít 5 nabídek, kostra XML feedu (jsou vynechány podelementy <SHOPITEM>) bude vypadat následovně:

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
    <SHOPITEM>
        <ITEM_ID>101</ITEM_ID>
        <!-- ... -->
    </SHOPITEM>
    <SHOPITEM>
        <ITEM_ID>102</ITEM_ID>
        <!-- ... -->
    </SHOPITEM>
    <SHOPITEM>
        <ITEM_ID>103</ITEM_ID>
        <!-- ... -->
    </SHOPITEM>
    <SHOPITEM>
        <ITEM_ID>104</ITEM_ID>
        <!-- ... -->
    </SHOPITEM>
    <SHOPITEM>
        <ITEM_ID>105</ITEM_ID>
        <!-- ... -->
    </SHOPITEM>
</SHOP>

<ITEM_ID>

Povinný ano
Opakování ne
Typ řetězec
Příklad <ITEM_ID>42</ITEM_ID>, <ITEM_ID>400-ABC-15</ITEM_ID>

Vaše unikátní ID nabídky, 1 produkt = 1 ID. ID se nikdy v budoucnosti nesmí změnít, ani použít pro další produkty! ID se musí shodovat s ID posílaným v konverzním kódu.

Každá nabídka musí mít jednoznačné ID, které se během historie nabídky nikdy nezmění. Identifikaci nabídky neděláme podle URL, protože změnou parametrů v URL se nabídka může zduplikovat.

<ITEMGROUP_ID>

Povinný ne
Opakování ne
Typ řetězec
Příklad <ITEMGROUP_ID>DCA3546</ITEMGROUP_ID>

Tagem označujte skupinu produktů, které představují vzájemně variantu. Variantou se rozumí různá barva, vzor, velikost či provedení stejného výrobku. Tag může obsahovat čísla 0-9, malá i velká písmena bez diakritiky, podtržítka a pomlčky.

<PRODUCTNAME>

Povinný ano
Opakování ne
Typ řetězec
Příklad <PRODUCTNAME>Wenger Commando Day Date 70164.XL</PRODUCTNAME>

Přesný název produktu. Nesmí obsahovat jiné informace jako např. "+ dárek", "- doprava zdarma" apod. = název produktu s takovými přívlastky patří do elementu <PRODUCT>. Měl by obsahovat název výrobce, modelovou řadu a model produktu.

<PRODUCT>

Povinný ano
Opakování ne
Typ řetězec
Příklad <PRODUCT>Pánské hodinky Wenger Commando Day Date 70164.XL</PRODUCT>

Název produktu (<PRODUCTNAME>) s dalšími přívlastky (např. "+ dárek", "- doprava zdarma").

<DESCRIPTION>

Povinný ano
Opakování ne
Typ řetězec
Příklad <DESCRIPTION>

Hodinky Wenger Day Date 70164.XL jsou velmi elegantní a zároveň vysoce odolné. Po prvním nasazení na ruku je již nechcete sundat. Bytelné ocelové pouzdro zaručuje vysokou odolnost a naopak krásný kožený pásek v kombinaci s černým ciferníkem dodává hodinkám na kráse a eleganci.</DESCRIPTION>

Popis produktu. Měl by obsahovat popis a specifikaci produktu. Jestliže obsahuje popis HTML tagy, je potřeba entity správně escapovat, nebo lépe doporučujeme celý text označit pomocí CDATA. Neuvádějte neúplné texty anebo texty ukončené např. třemi tečkami.

<URL>

Povinný ano
Opakování ne
Typ řetězec
Příklad <URL>http://obchod.cz/wenger-day-date-xl-70164/</URL>

URL položky. Internetová adresa nesmí směřovat na obecnou stránku, kde návštěvník nenajde všechny podrobné informace o nabídce, nebo kde se může hlavní obsah internetové stránky v průběhu času změnit.

Přesměrování vždy bude obsahovat UTM parametry. Ve výchozím stavu bude přidáno do query stringu utm_source=skrz.cz&utm_medium=cpc&utm_campaign=akcnizbozi. Jestliže máte ve vaší URL utm_* parametry, mají přednost. Nejvyšší přednost má nastavení UTM parametrů na stránce Nastavení -> Nastavení kampaně.

<IMGURL>

Povinný ano
Opakování ne
Typ řetězec
Příklad <IMGURL>http://obchod.cz/wp-content/uploads/70164XL_Commando-1-232x3851.jpg</IMGURL>

URL hlavního obrázku produktu. Obrázek by měl být v dostatečné velikosti (delší strana alespoň 600 px) a kvalitě, bez vodoznaků či vložených textů. Na Skrzu lidé hodně vybírají podle obrázků, dávejte tedy do feedu odkazy na atraktivní obrázky.

<IMGURL_ALTERNATIVE>

Povinný ne
Opakování ano
Typ řetězec
Příklad <IMGURL_ALTERNATIVE>http://obchod.cz/wp-content/uploads/2010/11/wenger-commando-701641.jpg</IMGURL_ALTERNATIVE>

URL vedlejších obrázků produktu. Element se může opakovat - můžete tedy přidat více alternativní obrázků.

<VIDEO_URL>

Povinný ne
Opakování ne
Typ řetězec
Příklad <VIDEO_URL>http://www.youtube.com/watch?v=XXXXXXXX</VIDEO_URL>

URL na videorecenzi produktu. Lze uvádět pouze URL na server YouTube.

<EAN>

Povinný ne
Opakování ano
Typ řetězec
Příklad <EAN>7612752254216</EAN>

Platné EAN číslo produktu (nejlépe EAN-13). Element můžete opakovat vícekrát, jestliže má produkt více EAN kódů.

Protože hledáme jen zlevněné zboží, je EAN pro nás obzlášť důležitý. Jakmile vaše nabídka nebude srovnatelná s jinými na trhu, tak se na Skrz.cz nikdy nepublikuje. Je tedy důležité nám říct, o který produkt se jedná.

<ISBN>

Povinný ne
Opakování ano
Typ řetězec
Příklad <ISBN>978-80-257-0030-3</ISBN>

Platné ISBN číslo knihy. Element můžete opakovat vícekrát, jestliže má produkt více ISBN.

Protože hledáme jen zlevněné zboží, je ISBN pro nás obzlášť důležitý. Jakmile vaše nabídka nebude srovnatelná s jinými na trhu, tak se na Skrz.cz nikdy nepublikuje. Je tedy důležité nám říct, o který produkt se jedná.

<PRODUCTNO>

Povinný ne
Opakování ne
Typ řetězec
Příklad <PRODUCTNO>978-80-257-0030-3</PRODUCTNO>

Případné další číslo výrobce. Protože hledáme jen zlevněné zboží, jsou všechny informace, pomocí nichž můžeme spárovat produkty mezi sebou, pro nás obzlášť důležitý. Jakmile vaše nabídka nebude srovnatelná s jinými na trhu, tak se na Skrz.cz nikdy nepublikuje. Je tedy důležité nám říct, o který produkt se jedná.

<CATEGORYTEXT>

Povinný ano
Opakování ne
Typ řetězec
Příklad <CATEGORYTEXT>Módní doplňky | Hodinky</CATEGORYTEXT>

Zařazení do kategorie. Uvádějte celou cestu, tak jak ji máte v eshopu oddělenou svislítky - |. Nejlépe využijte strom kategorií dle Heureka.cz - viz XML s aktivními kategoriemi.

<DELIVERY_DATE>

Povinný ano
Opakování ne
Typ číslo
Příklad <DELIVERY_DATE>0</DELIVERY_DATE> = zboží je skladem; <DELIVERY_DATE>-1</DELIVERY_DATE> = zboží je nedostupné

Počet dnů od objednání zákazníkem, kdy zboží bude expedováno.

<PRICE_VAT>

Povinný ano
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <PRICE_VAT>4390</PRICE_VAT>, <PRICE_VAT>4390.00</PRICE_VAT>

Konečná cena produktu vč. DPH (tedy taková, kterou koncový zákazník zaplatí). Nesmí obsahovat mezery.

<PRICE>

Povinný ne
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <PRICE>3628</PRICE>, <PRICE>3628.00</PRICE>

Cena produktu bez DPH.

<PRICE_ORIG>

Povinný ne
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <PRICE_ORIG>4899</PRICE_ORIG>, <PRICE_ORIG>4899.00</PRICE_ORIG>

Cena produktu před slevou. Používejte prosím reálnou původní cenu.

<VAT>

Povinný ne
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <VAT>21</VAT>, <VAT>15</VAT>, <VAT>10</VAT>

Výše DPH v procentech ceny. Pro identifikaci, jakou částí ceny je DPH.

<DUES>

Povinný ne
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <DUES>0</DUES>

Součet veškerých poplatků neobsažených v ceně, které je potřeba zaplatit.

<MANUFACTURER>

Povinný ano
Opakování ne
Typ řetězec
Příklad <MANUFACTURER>WENGER</MANUFACTURER>

Název výrobce/značky produktu. Využívá se pro zařazení pro filtrování podle výrobců. Výrobce by měl být zároveň obsažen v textu elementu <PRODUCTNAME>. Uvádějte název výrobce nebo značky, jak je znají zákazníci, neuvádějte fakturační název společnosti výrobce.

<ITEM_TYPE>

Povinný ne
Opakování ne
Typ řetězec
Příklad <ITEM_TYPE>new</ITEM_TYPE> = nová položka; <ITEM_TYPE>bazar</ITEM_TYPE> = rozbalené/vrácené zboží

Je nutné uvádět jen pro použité, rozbalené položky, aby se odlišily od nových položek.

<EXTRA_MESSAGE>

Povinný ne
Opakování ano
Typ řetězec
Příklad <EXTRA_MESSAGE>free_delivery</EXTRA_MESSAGE>,

Doplňkové informace ke zboží. Jedná se o velmi důležitý příznak. Zboží nemusí být nejlevnější, ale např. s dopravou zdarma se jednoduše dokáže zařadit mezi výhodné nabídky, které lze propagovat na Skrz.cz.

Může být jedno z:

  • extended_warranty - prodloužená záruka
  • free_accessories - příslušenství zdarma
  • free_case - pouzdro zdarma
  • free_delivery - doprava zdarma
  • free_gift - dárek zdarma
  • free_installation - montáž zdarma
  • free_store_pickup - osobní odběr zdarma

<GIFT>

Povinný ne
Opakování ne
Typ text
Příklad <GIFT>Kožené pouzdro zdarma</GIFT>

Důležitá informace například o dárku či jiné výhodě k zakoupenému produktu. Při více dárcích uveďte do jednoho tagu. Tag je alternativní k <EXTRA_MESSAGE>.

<PARAM>

Povinný ne
Opakování ano
Typ obalující element

Sdružuje popis parametrů produktu, např. výška, šířka, hmotnost, velikost, barva apod. Obsahuje elementy <PARAM_NAME> a <VAL>.

<PARAM_NAME>

Povinný ne
Opakování ne
Typ řetězec
Příklad <PARAM_NAME>Vodotěsnost</PARAM_NAME>

Název parametru.

<VAL>

Povinný ne
Opakování ne
Typ řetězec
Příklad <VAL>100m</VAL>

Hodnota parametru.

<DELIVERY>

Povinný ne
Opakování ano
Typ obalující element

Způsob dodání/dopravy a její cena. Sdružuje pod sebe element <DELIVERY_ID>, <DELIVERY_PRICE> a <DELIVERY_PRICE_COD>.

Pro více způsobů dopravy použijte opakování elementu.

<DELIVERY_ID>

Povinný ne
Opakování ne
Typ řetězec
Příklad <DELIVERY_ID>CESKA_POSTA</DELIVERY_ID>

Označení způsobu dodání. Jedno z:

  • CESKA_POSTA - Česká pošta
  • CESKA_POSTA_NA_POSTU - Česká pošta, Balík na poštu
  • CSAD_LOGISTIK_OSTRAVA - ČSAD Logistik Ostrava
  • DPD - DPD
  • DHL - DHL
  • EMS - EMS
  • FOFR - FOFR
  • GEBRUDER_WEISS - Gebrüder Weiss
  • GEIS - Geis parcel
  • GENERAL_PARCEL - General parcel
  • GLS - GLS
  • HDS - HDS
  • HEUREKAPOINT - Heurekapoint
  • INTIME - InTime
  • PPL - PPL
  • RADIALKA - Radiálka
  • SEEGMULLER - Seegmuller
  • TNT - TNT
  • TOPTRANS - TopTrans
  • UPS - UPS
  • VLASTNI_PREPRAVA - vlastní přeprava

<DELIVERY_PRICE>

Povinný ne
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <DELIVERY_PRICE>0</DELIVERY_PRICE>

Cena dodání při platbě předem.

<DELIVERY_PRICE_COD>

Povinný ne
Opakování ne
Typ celé číslo, desetinné číslo oddělené desetinnou tečkou
Příklad <DELIVERY_PRICE_COD>49</DELIVERY_PRICE_COD>

Cena dodání při platbě na dobírku.


Validátor XML feedu

Zadejte URL vašeho feedu a během chvíle se dozvíte, jestli je připraven pro nasazení.

Skrz.cz s.r.o. (2019) Všeobecné obchodní podmínky | Pravidla pro zveřejňování nabídek