XML feed

Proč používat XML feed?

Pokud již máte vlastní e-shop či jiný informační systém, ve kterém spravujete nabídku produktů, je XML feed nejlepší způsob, jak vůbec na začátku svou nabídku zveřejnit rychle pro prodej na Scuk.cz a poté nabídku udržovat aktuální - pokud budete chtít upravit popisky produktů, fotky, cenu, stačí, když upravíte na jednom místě a změny se automaticky propíšou do karty produktu na Scuku.

Import probíhá přes XML feed ve specifikaci pro české zbožové srovnávače jako Heureka.cz, Zboží.cz ad. Výhodou je, že tento formát je široce rozšířen, každý dodavatel e-shopových řešení se s ním již musel setkat a některé e-shopové platformy ho již rovnou mají jako jednu z funkcí.

Kde získat?

Získání URL pro import se odvíjí od vašeho dodavatele informačního systému:

  • E-shopové platformy
    • Shoptet - XML feed vytvoříte v administraci e-shopu na Shoptetu, řiďte se pokyny nápovědy Shoptetu, jako typ feedu vyberte produktový feed pro Heureka.cz.
    • Ostatní služby - hledejte v nápovědě dané služby výrazy jako XML feed, Heureka feed či Heureka XML. Pokud v nápovědě dané služby nic není, kontaktujte přímo jejich zákaznickou podporu s dotazem na XML feed pro Heureka.cz.
  • Vlastní řešení - kontaktujte svého dodavatele s dotazem na export produktů ve formátu XML (pro Heureka.cz), pošlete mu odkazu na tuto stránku, aby si mohl projít specifikaci.

URL

Výstupem, který od vás potřebujeme, je URL ve tvaru https://www.muj-eshop.cz/cesta/k/heureka.xml. Až ji od svého dodavatele informačního systému získáte, zkuste URL zadat do adresního řádku prohlížeče. Buď se vám nabídne XML soubor ke stažení, nebo se zobrazí přímo v prohlížeči. Zkontrolujte, jestli XML obsahuje data o vašich produktech.

Import produktů probíhá automaticky každý den kolem 8-9 hod. dopoledne. Proto vždy potřebujeme URL, odkud můžeme stáhnout aktuální soubor s daty produktů, neposílejte nám stažený XML soubor.

Jak by mělo XML vypadat? (Specifikace)

Jak bylo řečeno výše, používáme specifikaci kompatibilní s Heureka XML Feed 2.0.

Obchody na Heureka.cz mohou ještě používat tzv. "dostupnostní" XML feed. Ten ale na Scuk.cz nepoužíváme. Potřebujeme tzv. "plný" či "produktový" XML feed.

Příklad

<?xml version="1.0" encoding="UTF-8"?>
<SHOP>
<SHOPITEM>
<ITEM_ID>P1</ITEM_ID>
<PRODUCTNAME>Farmářské mléko plnotučné ve vratném skle, 1 l</PRODUCTNAME>
<DESCRIPTION><![CDATA[Čerstvé šetrně pasterované neodstředěné mléko v lahvi. Trvanlivost mléka je 5 dnů.

Láhev není zálohovaná, avšak můžete ji po spotřebování mléka vrátit na výdejní místo po domluvě s Organizátorkou vaší Nákupní skupiny. Máme možnost ji následně znovu využít a můžeme tak společně šetřit životní prostředí. Vrácení obalu však není povinné.]]></DESCRIPTION>
<IMGURL>https://www.muj-eshop.cz/obrazky/mleko-1.jpg</IMGURL>
<IMGURL_ALTERNATIVE>https://www.muj-eshop.cz/obrazky/mleko-2.jpg</IMGURL_ALTERNATIVE>
<IMGURL_ALTERNATIVE>https://www.muj-eshop.cz/obrazky/mleko-3.jpg</IMGURL_ALTERNATIVE>
<IMGURL_ALTERNATIVE>https://www.muj-eshop.cz/obrazky/mleko-4.jpg</IMGURL_ALTERNATIVE>
<IMGURL_ALTERNATIVE>https://www.muj-eshop.cz/obrazky/mleko-5.jpg</IMGURL_ALTERNATIVE>
<MANUFACTURER>Farma Horní Dolní</MANUFACTURER>
<DELIVERY_DATE>0</DELIVERY_DATE>
<PRICE_VAT>35</PRICE_VAT>
<VAT>15</VAT>
<URL>https://www.muj-eshop.cz/produkty/mleko</URL>
<EAN>8591234567890</EAN>
<PARAM>
<PARAM_NAME>Objem</PARAM_NAME>
<VAL>1000 ml</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>Skladování</PARAM_NAME>
<VAL>Při teplotě 4-8°C</VAL>
</PARAM>
<PARAM>
<PARAM_NAME>Typ mléka</PARAM_NAME>
<VAL>Kravské</VAL>
</PARAM>
</SHOPITEM>



</SHOP>

Povinné tagy

<ITEM_ID>

Kód produktu unikátní v rámci vašeho e-shopu.

Každá <SHOPITEM> musí obsahovat právě jedno <ITEM_ID>. Tento kód se bude zobrazovat na dodacích listech, které dostanete ke každé objednávce, a na fakturách zákazníkům, pokud máte zapnutou fakturaci přes Scuk.

Pokud se <ITEM_ID> změní, vznikne na Scuk.cz nový produkt, který musí projít naším schvalovacím procesem, a starý produkt se vypne z nabídky.

<PRODUCTNAME>

Název produktu.

Bude zobrazovat zákazníkům. Buďte struční, ale dostatečně popisní.

<DESCRIPTION>

Popis produktu.

Měl obsahovat důležité informace o produktu a navnadit zákazníka ke koupi. Zobrazuje se na detailu produktu.

<IMGURL>, <IMGURL_ALTERNATIVE>

URL obrázků produktu.

<IMGURL> je povinný, musí být obsažen právě jednou a slouží pro hlavní obrázek produktu. <IMGURL_ALTERNATIVE> je nepovinný, může se opakovat a je určen pro doplňující obrázky. Doporučujeme mít k produktu co nejvíce obrázků. Nikdy neuvádějte URL na zástupné obrázky, takové produkty stejně nebudou pro prodej na Scuku schváleny - pokud fotografii produktu nemáte, do feedu ho vůbec nedávejte.

<MANUFACTURER>

Výrobce produktu.

Vyplňte, pokud nejste výrobcem produktu.

<DELIVERY_DATE>

Doba dodání produktu ve dnech.

Na zbožových srovnávačích se normálně zobrazuje jako:

  • skladem - 0
  • do 3 dnů - 1-3
  • do týdne - 4-7
  • do 2 týdnů - 8-14
  • do měsíce - 15-30
  • více než měsíc - 31 a více

Na Scuku se zobrazují pouze produkty skladem, u všech produktů by tedy mělo být <DELIVERY_DATE>0</DELIVERY_DATE>.

<PRICE_VAT>

Koncová cena vč. DPH - tzn. cena, kterou zaplatí koncový zákazník.

Při vyúčtování se poté z této ceny počítá provize za objednávku a provize za rozvoz do nákupních skupin. Cenu uvádějte jako číslo bez mezer, nikdy nepoužívejte tečku či čárku oddělovač tisíců. Pokud cena obsahuje haléře, jako oddělovač desetinných míst můžete použít tečku i čárku.

<VAT>

DPH v procentech.

Uvádějte jako celé číslo bez mezer.

<URL>

URL detailu produktu na vašem e-shopu.

Používáme při schvalování produktů, pokud potřebujeme dozjistit některé informace.

<EAN>

Čárový kód produktu.

Tato informace je důležitá hlavně pro náš sklad. Všechny produkty musí mít na etiketě čárový kód a ten musí být uveden ve feedu. Jako čárový kód můžete buď použít GTIN-13 registrovaný u GS1 nebo RCN (Restricted Circulation Number) pro produkty na váhu.

Parametry

Parametry se uvádějí do tagů <PARAM> a do nich vnořených <PARAM_NAME> (název parametru produktu) a <VAL> (hodnota parametru). Tag <PARAM> můžete opakovat vícekrát, avšak neopakujte vícekrát stejný parametr.

U všech produktů by měly být uvedeny následující parametry (název v <PARAM_NAME>):

Hmotnost

Pokud dává pro potravinu smysl, uveďte hmotnost. Uvádějte jako celé číslo vč. jednotky, nejlépe v gramech. Např. tedy 1250 g.

Objem

Pokud dává pro potravinu smysl, uveďte hmotnost. Uvádějte jako celé číslo vč. jednotky, nejlépe v mililitrech. Např. tedy 1000 ml.

Složení

Uvádějte, pokud se nejedná o základní potravinu. Začněte od nejzastoupenější suroviny a jednotlivé suroviny oddělte čárkou.

Trvanlivost

Popište trvanlivost produktu textem, např. 30 dní.

Skladování

Popište, jak má být produkt skladován, např. Skladujte v suchu a teplotě do 25°C.

Může obsahovat stopy

Vypište seznam alergenů, které produkt obsahuje, oddělených čárkou.

Úpravy produktů v administraci Scuk.cz

Předně: Úpravy produktů doporučujeme dělat přímo ve vašem informačním systému a poté nechat XML import, aby změny propsal na Scuk.cz.

Pokud však upravíte produkt v administraci Scuk.cz, nemusíte se bát, že by se hned další den dopoledne XML importem vaše úprava smazala. Pro úpravy používáme pravidlo, že poslední změna vyhrává. Co to v praxi znamená?

  • Produkt prodáváte za 100 Kč, 100 Kč je v XML feedu a za tuto cenu zákazníci nakupují produkt na Scuku.
  • Poté se rozhodnete produkt na Scuku zlevnit pro zvýšení prodejů a změníte cenu na 80 Kč.
  • Na Scuku se tedy teď zobrazuje cena 90 Kč, v XML je stále cena 100 Kč.
  • Následující den dopoledne automaticky import stáhne vaše XML. Jelikož předchozí stažení XML určovalo cenu produktu 100 Kč a dnešní stažení taktéž, ke změně nedošlo, na Scuku tedy zůstane cena 90 Kč.
  • Zlevnění produktu mělo pozitivní vliv na prodeje a chcete toto promítnout i do svého e-shopu. Ovšem při 80 Kč máte přiliš malou marži. Ve svém e-shopu nastavíte tedy cenu 90 Kč.
  • Následující den dopoledne automaticky import stáhne vaše XML. Jelikož předchozí stažení určovalo cen produktu 100 Kč a dnešní říká 90 Kč, jedná se o změnu. Na Scuku tedy aktualizujeme cenu na 90 Kč.

Tato mechanika fuguje pro každé pole karty produktu samostatně (samostatně tedy pro název, popis, cenu atd.).

Pokud využíváte automatický XML import, nebojte se tedy upravit produkt přímo v administraci Scuku - vaše změna zůstává, nepřepíše se hned další den.

Hotovo? Pošlete nám URL

Pokud jste se rozhodli, že budete chtít importovat produkty pomocí XML feedu, pošlete nám jeho URL na vyrobci@scuk.cz a my vše nastavíme.

Jak se vám tato odpověď líbí?


Powered by HelpDocs