Nová XML Zboží.cz, co byste o nich měli vědět

Rozdíl mezi vendorským a nabídkovým XML feedem

Zboží.cz nově zavede pojmy vendorský a nabídkový XML feed.

  • Vendorský XML feed, slouží výhradně ke tvorbě katalogu zboží a zakládání nových produktových karet. Obsahuje XML elementy nutné pro vytvoření produktové karty, nemusí však obsahovat elementy charakteristické pro nabídku, jako např. URL či PRICE_VAT konkrétního e-shopu. V praxi využijí vendoři, kteří nemají vlastní e-shop, ale chtějí určovat podobu katalogu Zboží.cz.
  • Nabídkový XML feed odpovídá stávajícímu XML e-shopu. Obsahuje informace o nabídce konkrétního e-shopu.

Rozdělení XML feedů je orientační a slouží hlavně k pochopení nového přístupu Zboží.cz k XML feedům. V praxi může e-shop obsahovat elementy jak nabídkového, tak vendorského typu. Pokud jde o běžného prodejce, využijí se nabídkové elementy, pokud půjde i o vendora některých značek, využije Zboží.cz i elementy "vendorského" typu.

Vendor XML

Novinky ve významu XML elementů

Podrobný přehled najdete v dokumentaci. Já podtrhnu novinky, které zaujaly mne:

  • rozšiřuje element SHOP o definici verze XML souboru, v novém XML: xmlns="http://www.zbozi.cz/ns/offer/1.0"
  • zavádí unikátní identifikátor položky zboží ITEM_ID
  • nově podporuje parametry PARAM a kromě tradičních PARAM_NAME (název parametru) a VALUE (obsah parametru) obsahuje také UNIT (označení jednotky, např. cm, ml, GB aj.)
  • zavede správné zpracování desetinných teček i čárek v elementech MAX_CPC a MAX_CPC_SEARCH
  • varianty označí pomocí elementu ITEMGROUP_ID
  • element VISIBILITY naváže na tradici elementů TOLLFREE a UNFEATURED - označí položky, které se nemají na Zboží.cz zobrazovat
  • PRICE_VAT bude nově konečnou cenou včetně všech poplatků
  • DELIVERY_DATE nově zpřesní intervaly, na které zaokrouhluje na stránkách Zboží.cz
  • EAN bude podporovat i jiné standardy, než jen EAN-13
  • EXTRA_MESSAGE nově zavede hodnotu „voucher“
  • budou zavedeny nové elementy:
    • BRAND, značka zboží, např. Lumix jako značka fotoaparátů od výrobce Panasonic Corporation
    • CATEGORY_ID, identifikace kategorie dle číselníku Zboží.cz
    • PRODUCT_LINE, produktová řada, např. iPad aj.
    • LIST_PRICE, doporučená maloobchodní prodejní cena
    • RELEASE_DATE, datum zahájení prodeje

Mergadův komentář

S nasazováním nových formátů XML pro Zboží.cz doporučuji pár (tý)dnů posečkat. Jde o novinku, která se může ještě měnit. Po zavedení by měla fungovat i stávající XML, nicméně pozor, význam některých elementů bude upraven. Jakmile to bude dávat smysl, připravím pro vás potřebné nástroje i zde v Mergadu. Nyní píši, ať máte přehled a víte, že panikařit není třeba :)

Komentáře

To zase bude práce :-(. Úplně se toho děsím, když se podívám, kolika mých svěřených shopů se to dotkne. O změně jsem díky (ne)konferenci věděla, ale jak se říká, co oči nevidí, to srdce nebolí. Tak jsem to mezitím pustila částečně z hlavy. No je vidno, že budu muset znovu na to kouknout a začít s úpravami. Jsem ráda za to odlišení značky, tedy chápu-li dobře, že "manufacturer" je zachován a jako novinka navíc, kterou lze v XML posílat, je "brand". Díky za připomenutí oné spuštěné změny.

Petra Mikulášková/Čtvrtek, 25. Červen 2015 - 7:47

Bezva servis . Díky pane Mergado i za budoucí pomoc. Pepíno.

Josef Tomiška/Čtvrtek, 25. Červen 2015 - 7:53

Velice důležité informace. Díky za pomoc. Kolektiv pana Mergada zdraví Pepíno.

Josef Tomiška/Čtvrtek, 25. Červen 2015 - 7:55

Dobrý den,

děkuji za info! Chci se zeptat, zda existuje pro Zbozi.cz strojový seznam kategorií, ideálně v XML, jako to má například Heuréka.

David Pšondr/Čtvrtek, 25. Červen 2015 - 9:48

Proste zase se zpozdenim nekolika let opisuji od google :)

Marek Kail/Čtvrtek, 25. Červen 2015 - 10:01

Díky za info :)

Proskin/Čtvrtek, 25. Červen 2015 - 11:29

Dobrý den,

možná někde existuje, ale Zboží.cz kategorie téměř nezohledňuje. Výjimku tvoří sporné produkty, například když se něco jmenuje Star Wars Racer, může to být puzzle, pc hra, hra na playstation nebo xbox. Tehdy se zohledňuje kategorie. Jinak není potřeba řešit.

Jakub Nožička (admin)/Čtvrtek, 25. Červen 2015 - 12:09

v napovede seznamu si najdete CATEGORY_ID a tam najdete odkaz na xls soubor http://napoveda.seznam.cz/soubory/Zbozi.cz/category_ID.xls

Hezky den

Paja/Čtvrtek, 25. Červen 2015 - 12:34

Tak se naplnilo, co jsem říkal v závěru článku výše - uplynuly dva týdny a máme tu doplnění specifikace nového XML feedu Zboží.cz. Tentokráte by mělo být už finální. Pojďme si proto říct, co se změnilo. Upozorňuji, že jde o můj subjektivní komentář. Podrobnosti najdete v dokumentaci viz odkazy na závěr tohoto komentáře.

  • Podtrhuji princip, že jde o jeden XML feed. Ten mohou použít nejen e-shopy, jako nabídkový feed, ale nové také vendoři. Ti mohou nově pomáhat tvořit katalog položek Zboží.cz, i když nemají vlastní e-shop.
  • Nový feed podporuje element PRICE_VAT, neumí však zpracovat elementy PRICE a VAT. Starý feed však elementy PRICE a VAT i nadále zpracovávat umí. Předpokládám, že se v administraci Zboží.cz objeví nějaké „zaškrtávatko“, kterým zpracování podle nových pravidel bude možné zapnout. Bez zapnutí by měly nadále fungovat i elementy PRICE a VAT oddělené, se zapnutím pozor, jejich zpracování fungovat přestane.
  • Také Zboží.cz zavádí u některých kategorií povinné složení elementu PRODUCTNAME. Podobně jako v případě Heureky jde o pneumatiky, tonery... přesný seznam viz dokumentace.

Podrobnosti najdete v dokumentaci nového XML Zboží.cz či přiloženém PDF. Ke spuštění podpory nových formátů XML by mělo dojít v závěru léta 2015. Do té doby bych měl mít pro vás připraven jak audit XML, tak automatický převodník ze stávajících XML.

pan Mergado (admin)/Středa, 8. Červenec 2015 - 6:06

Já ještě doplním drobnou opravu. Je sice možné, že se v administraci Zboží.cz objeví, pro zapnutí zpracování XML v novém režimu, klikátko, ale nemusí. XML dle nového formátu by měla u značky SHOP obsahovat také text "xmlns=“http://www.zbozi.cz/ns/offer/1.0“ ". Tím XML řekne, že odpovídá novému standardu.

 

Michal Janík (admin)/Středa, 8. Červenec 2015 - 11:08

Dobrý den, bude pan Mergado umět nový typ exportu pro Zboží.cz? Vytvořil jsem si export z formátu Zboží.cz do formátu Zboží.cz, za vstupní XML zvolil feed ve starém formátu, a výstup bych očekával v novém formátu, ale validace výstupního XML pomocí http://www.zbozi.cz/validace-feedu/ skončí už na tagu SHOP.

Martin Kaman/Středa, 12. Srpen 2015 - 10:27

Dobrý den. Ano, nový formát umět budeme. Vývojáři to mají v plánech, však zatím nemohu slíbit konkrétní termín.

Jakub Nožička (admin)/Úterý, 18. Srpen 2015 - 16:08

Dobrý den, pane Mergado.
Chci se zeptat, jestli jste se setkal s tímto tagem:<S_PRODUCT_ACTIV>1</S_PRODUCT_ACTIV>
V oficiální dokumentaci ho nemohu najít. Hledám špatně?
Díky.

Dvořák/Středa, 25. Listopad 2015 - 9:05

Dobrý den,

bohužel ani my tento tag neznáme.

Mergado

Jakub Nožička (admin)/Středa, 25. Listopad 2015 - 13:06

Zjišťoval jsem to přímo u programátora feedu a bylo mi sděleno, že je to stará značka znamenající aktivní produkt.

<SHOPITEM>
<ID>512523</ID>
<PRODUCT>Pavouk a moucha</PRODUCT>
<PRODUCTNAME>Pavouk a moucha</PRODUCTNAME>
<DESCRIPTION>
Pavouk a moucha, Vhodná zábava pro příznivce tohoto hmyzu. Stačí pohodit na místo oběti a čekat.
</DESCRIPTION>
<URL>http://www.netshop007.cz/pavouk-a-moucha/</URL>
<IMGURL>
http://www.netshop007.cz/foto/i117-er05712x/ER05712x-10.jpg
</IMGURL>
<PRICE>16.37</PRICE>
<PRICE_VAT>20</PRICE_VAT>
<DUES>0</DUES>
<S_PRODUCT_ACTIV>1</S_PRODUCT_ACTIV>
<CATEGORYTEXT>
Žertovné předměty, dárky | Žertovné dárky k narozeninám, svátku (Valentýn, MDŽ, Vánoce a další...) | Halloween (31.10.)
</CATEGORYTEXT>
<DELIVERY_DATE>0</DELIVERY_DATE>
<UNFEATURED>1</UNFEATURED>
</SHOPITEM>

Dvořák/Středa, 25. Listopad 2015 - 13:16

Přidat komentář