Specifikace ASYMBO XML feedu Děkujeme, že máte zájem o mobilní e-shop ASYMBO! Aby vše fungovalo, jak má, připravili jsme pro vás detailní specifikaci XML souboru, kterým vzájemně komunikuje Váš e-shop s m-shopem ASYMBO.

ASYMBO XML feed je kompatibilní s  XML feedem od Heureky. Můžete tak použít stejný XML soubor, který používáte pro inzerci produktů na srovnávači zboží Heureka.cz. Pokud máte Heureka XML feed korektně zpracovaný podle specifikace od Heureky, nemusíte dělat žádné změny a váš m-shop bude správně fungovat.

Doporučujeme vám však připravit samostatný feed pouze pro ASYMBO.

ASYMBO XML feed totiž obsahuje oproti Heureka XML feedu pár užitečných věcí navíc. S jeho použitím tak například:

• • • • •

zadáte libovolné názvy produktů bez jakýchkoliv omezení, vyplníte k produktům libovolně dlouhé popisky, jednodušeji a efektivněji zpracujete varianty produktů, popisky produktů vyšperkujete použitím HTML značek, máte možnost definovat vlastní dostupnost zboží pomocí delivery tagu,

ASYMBO XML feed je několikanásobně menší a proto i stažení a parsování feedu je rychlejší a méně zatěžuje servery. ASYMBO XML feed je kompatibilní s Heureka XML feedem. Můžete jednoduše použít stejný XML soubor jako používáte pro inzerci produktů na zbožovém srovnávači Heureka.cz.

1

HLAVIČKA XML SOUBORU:

<SHOP>

<SHOPITEM> Element, který označuje produkt. Nachází se na začátku a na konci každého produktu.

Unikátní označení produktu ve vašem e-shopu. Formát: 36 znaků [0-9a-zA-Z]. Každý produkt musí obsahovat .

Příklad: 123456AB  

A Unikátní název produktu. Pokud máte vyplněny oba dva tagy, přednostně se bere tag .

Pro ASYMBO m-shop nemusíte dodržovat žádná pravidla při pojmenovávání produktů. Jen doporučujeme nepřesahovat délku 25 znaků.

Popis produktu může být libovolně dlouhý a může také obsahovat základní HTML značky:  

2

•

-

nadpisy •

odstavec • odkaz s atributy href, name a target • <strong> zvýrazněný text   • číslované a nečíslované seznamy

1. • obrázky s atributem src • další HTML značky: blockquote, nl, b, i, strong, em, strike, code, hr, br, div, table, thead, caption, tbody, tr, th, td, pre • Inline styly budou ignorovány, každý tag může mít nastaveno class nebo id a styly k tomu lze editovat v Asymbo administraci.   Jiné HTML tagy, které jsou obsažené v popisku, se ignorují.
   
   Ve výpisu produktů v kategoriích se jako text anotace použije začátek popisku produktu.
   
   Příklad:  
   
   

   Matrace Supragel Hard - popis

   Kvalitní <strong>matrace Supragel Hard střední tuhosti, která uspokojí široké spektrum uživatelů – doporučujeme především pro mladé (do dětských pokojů – pro mládež a dorost). Nosné jádro <strong>matrace Supragel Hard tvoří odolná pěna Flexifoam® nové generace. Gelové výplně v bederní části jsou konstrukčně řešeny tak, aby dokázaly plně reflektovat i vyšší tělesnou hmotnost a usměrňovaly tento tlak tak, aby nedocházelo k narušení spánkového klidu vlivem přeležení.

   Vyrábí se ve dvou tuhostech. Tzn. jedná se o dvě různé matrace:

   • <strong>Matrace Supragel HARD – tužší pro muže
   • <strong>Matrace Supragel SOFT – měkčí pro ženy
   
   
   URL  adresa  hlavního obrázku. Doporučení pro obrázky je následující:  
   
   3
   
   • Optimální velikost obrázku je 1280px x 1280px • V případě, že změníte obrázek je potřeba změnit jeho URL adresu   • Obrázek nesmí být s průhledným pozadím   Příklad:
 http://www.nazev-domeny-eshopu.cz/img/nazev-obrazku.jpg
   
   URL adresa dalších obrázků k produktu. Můžete uvést tolikrát, kolik máte k produktu obrázků.
   
   Příklad:   http://www.nazev-domeny-eshopu.cz/img/nazev-obrazku.jpg

   
   Celková cena včetně DPH. Cenu můžete uvádět v těchto formátech:   • 32 000 • 32000 • 32000,50 • 32000.50 Posílaný formát ceny neovlivní zobrazení ceny v aplikaci.
   
   Příklad:   10990
   
   4
   
   Původní cena před slevou. Formát může být stejný jako u . V aplikaci se zobrazí jako původní cena a vypočítá se z ní velikost slevy.
   
   Název kategorie včetně celkové cesty k produktu.
   
   Kateorie 1. úrovně | Kategorie 2. úrovně | Kategorie 3. úrovně
 Oddělovací znak mezi nadkategoriemi a podkategoriemi je mezera | mezera. Úrovní kategorií může být neomezeně.
 Pokud máte produkt zařazen do více kategorií, stačí uvést tag vícekrát.
   
   Příklad:   Dům a zahrada | Nábytek | Matrace
 Matrace | Pružinové matrace
 Matrace pro sportovce | Pružinové metric
   
   A Dostupnost zboží lze vyjádřit dvěmi způsoby. Pomocí tagu nebo . Nepoužívejte oba tagy zároveň.
   
   
 1 - 3 dní
 1

   
   5
   
   V tagu name uvedete libovolný textový řetězec, který má vystihovat dostupnost zboží. Znění je naprosto na Vás.
   
   1 je označení, že se jedná o položku skladem, v aplikaci bude nápis, který uvedete v tagu name zvýrazněn typicky zeleně nebo jinou barvou.
   
   V tagu delivery date uvádějte počet dní od přijetí objednávky do expedice zboží.
   
   Dostupnost se pak v m-shopu zobrazí dle uvedených dní:
   
   • skladem – 0 dní • do 3 dnů - 1 - 3 dní • do týdne – 4-6 dní • do 2 týdnů - 7 - 14 dní • do měsíce - 14 - 30 dní • více než měsíc - 31 a více dní
   
   Příklad: 5
   
   <MANUFACTURER> Název výrobce.
   
   Příklad: <MANUFACTURER>Geltech
   
   6
   
   Prostor pro parametry produktů. Parametry se zobrazí přehledně v tabulce v detailech produktu v aplikaci. Nakupující také mohou podle parametrů filtrovat výpis produktů..
   
   Těchto parametrů ve výchozím stavu můžete uvádět neomezeně.
   
   Parametry se používají také k označení variant produktů. Viz samostatná kapitola níže.
   
   TIP:  Pořadí jednotlivých položek ve filtru ovlivníte pořadím parametrů. Který parametr u produktu vypís
   
   Název parametru Hodnota prametru Příklad:   Velikost a rozlišení Malý – do 13,4“ Výbava WiFi Výbava
   
   7
   
   Bluetooth
   
   K produktům je možnost přiřazovat štítky s ikonkami. Standardně nabízíme tuto sadu ikonek. Labely se zobrazují ve výpisu produktů a v detailu produktu.
   
   Ke každé ikonce lze přiřadit vlastní význam.
   
   Příklad: DOPRAVA ZDARMA
   
   8
   
   SKLADEM 1+1 Zdarma
   
   Postup: • K produktům přiřaďte tag s názvy štítků dle svých potřeb • Pošlete nám kterou ikonku ke kterému názvu byste chtěli zobrazit, na výběr je:
   
   Hvězda
   
   Štítek
   
   Procento
   
   Balík
   
   Dárek
   
   Vykřičník
   
   9
   
   Varianty produktů Pokud máte např. velikostní varianty produktů, existují dvě možnosti, jakým způsobem varianty do feedu zapracovat.
   
   • ASYMBO způsob: K jednotlivým produktům přiřadíte varianty • Heureka způsob: Každá varianta produktu je samostatný produkt
   
   Doporučujeme ASYMBO způsob, je zde menší pravděpodobnost chyb způsobených špatnými daty, feed je několikanásobně menší a tím je zpracování rychlejší.
   
   ASYMBO ZPŮSOB, TAG Mezi tagy <shopitem> umístíte tag , ve kterém specifikujete vlastnosti varianty. Jednohodnotvé tagy (např. PRICE_VAT, PRODUCT, IMGURL) uvedené u varianty přepisují stejný tag bázového produktu. Skupinové tagy (např. IMGURL_ALTERNATIVE) bázový produkt rozšiřují.
   
   159743 boty STEEL - 10 dírkové černé ( 105/106 Black) 48 http://www.metalshop.cz/images/produkty/184_2.jpg http://www.metalshop.cz/images/produkty/184_2.jpg 1 7 - 14 dni Velikost 48 1 KOD 12346 10
   
   Pokud má jiný ITEM_ID, jiný stav skladu, parametry, obrázky, cena apod. lze tyto hodnoty přepsat. Lze použít takřka jakýkoliv tag kromě . Varianta nemůže být v jiných kateogorích než daný produkt.
   
   1 Určuje variantu, která se má ve výchozím stavu uživateli otevřít pokud na výpisu produktů tapne na konkrétní produkt. 1 Určuje, který parametr se má brát jako varianta. V příkladu je tento tag určený u parametru velikost. Uživatelé si tedy budou na kartě produktu vybírat velikost. Každá varianta musí mít definováno své .
   
   HEUREKA ZPŮSOB, KAŽDÁ VARIANTA JAKO SAMOSTATNÝ PRODUKT Aby varianty fungovalý správně, musí být korektně nastaveny tagy:
   
   • <productname> • •
   
   V tagu productname je potřeba mít název produktu BEZ velikostního rozlišení. Všechny varianty se tedy budou tagu productname jmenovat stejně:
   
   Název produktu
   
   11
   
   V tomto tagu je nutné identifikovat alespoň jeden rozlišující parametr následujícím způsobem: 12345 Rozměry 20m 3x1 1 Součástí tagu variant musí být dané varianty.
   
   Označení skupiny produktů které představují varianty. Každé variantě produktu přiřaďte stejné ITEMGROUP_ID.
   
   Příklad: 2862
   
   12
   
   XML FEED DEFINUJÍCÍ STRUKTURU KATEGORIÍ Jednoduchým samostatným XML feedem definujete strukturu kategorií.
   
   Příklad:
 <SHOP> Slevy Boty boty kožené boty street Doplňky na sebe kontaktní čočky čočky roztoky
   
   13
   
   XML FEED AKTUALIZUJÍCÍ SKLADOVOST A CENY Pokud se ceny či dostupnost zboží mění každým okamžikem, posílejte nám tento aktualizační feed, který obsahuje tagy:
   
   • • • •
   
   pro identifikaci produktu a pro definici ceny pro definici dostupnosti pro stažení produktu z prodeje
   
   Příklad: <SHOP> <SHOPITEM> 186 1000 <SHOPITEM> 184 2000 2500 1 den 1 <SHOPITEM> 185 1 <SHOPITEM> 185 60026 1500 1600 14
   
   1 tyden 60027 1
   
   DŮLEŽITÉ • Posílat jen produkty/varianty u kterých došlo ke změně PRICE_VAT, PRICE_COMMON_VAT a nebo DELIVERY. • Pokud je v SHOPITEM nebo VARIANT uveden 1, dojde ke smazání produktu respektivě varianty. • Není umožněno přidávat nové produkty nebo varianty, ale pouze mazat nebo měnit existující
   
   CENOVÉ HLADINY Přihlášeným uživatelům může aplikace zobrazovat cenu, kterou jim určíte pomocí cenové hladiny. Každý produkt nebo varianta produktu kromě tagů: 2299
 3000 Může obsahovat: A1 // vlastní identifikátor cenové hladiny které posíláte s údaji o přihlášeném uživateli 1000 // cena bez DPH 0.21 // DPH 1210 cena s DPH 2000 // běžná cena před slevou bez DPH 1420 // běžná cena před slevou s DPH
   
   15
   
   Příklad zakomponování cenových hladin v XML feedu naleznete zde:
 https://gist.github.com/pjancarik/918a1c69fe6a353bf6a1
   
   16