Lekce 2: XML soubor + chyby v XML/důvody blokace

Ve druhé lekci se zaměříme na další důležitou věc – XML soubor. Jedná se o datový soubor, ve kterém nám předáváte informace o produktech. Jedná se například o cenu produktu, jeho dostupnost, popis, parametry produktu a podobně. Tyto informace se potom zobrazují na Heurece – ve vyhledávání nebo na detailu produktu. A každá informace má svůj konkrétní tag/element.

XML soubor vypadá například takto.  To, jak má xml feed správně vypadat, jeho kompletní specifikaci, naleznete v naší nápovědě. Heureka importuje (aktualizuje) data z XML souboru v případě PPC režimu každé 2 hodiny, v případě FREE režimu každé 4 hodiny. (O obou režimech se více rozepíšeme ve třetí lekci). Aktualizace XML souboru z vaší strany by měla probíhat buď po každé změně či několikrát denně. Ohledně aktualizace XML souboru je potřeba se obrátit na správce vašeho obchodu, váš shopsystém nebo na vašeho programátora.

Chyby v XML/důvody blokace

Co se stane, pokud se v XML souboru vyskytují chyby? Nedochází ke správnému zařazení a zobrazení produktů na Heurece, a v některých případech může také dojít i k blokaci e-shopu.

A jaké chyby jsou zásadní, kvůli kterým může dojít k blokaci?

Cena produktu (tag <PRICE_VAT>)

Musí být uvedena konečná cena včetně autorských poplatků. Cena produktu v XML souboru musí souhlasit s cenou produktu po prokliku do obchodu.

Dostupnost produktu (tag <DELIVERY_DATE>)

Tento tag uvádí počet dnů od objednání zboží k jeho expedici ze skladu. Pokud máte zboží skladem, a expedujete jej ze skladu v ČR do 24 hodin od objednání, uvedete do XML: <DELIVERY_DATE>0</DELIVERY_DATE> . Na Heurece se tato informace zobrazí jako Skladem.

Pokud tag DELIVERY_DATE neuvedete nebo necháte hodnotu prázdnou, tak se zobrazí Info v obchodu.

Další možnosti zobrazení dostupnosti:

Název produktu (tag <PRODUCT>, či <PRODUCTNAME>)

Tento tag může obsahovat kromě názvu produktu také povolená rozšíření podle následující specifikace:

Dárek (tag <GIFT>)

Tagem GIFT se zobrazuje u produktu dárek, který nabízíte k nákupu produktu zdarma. Nesmí být omezen dalším nákupem. Dárek je možné uvést vícekrát, pokud k nákupu produktu nabízíte více dárků. Pokud uvádíte výběr z více dárků, je potřeba vybrat pouze jeden a ten do XML souboru uvést.

Zobrazení dárku na Heurece na detailu produktu:

Pro vaší lepší identifikaci dárku můžete využít tag GIFT ID, například:

<GIFT ID=“gift01″>Paměťová karta zdarma</GIFT>

Zobrazí se + Dárek: Paměťová karta zdarma

Cena dopravy (tag <DELIVERY>, případně v administraci záložka Ceny dopravy)

Tato informace se zobrazuje přímo na detailu produktu pod cenou produktu. V administraci obchodu na Heureka.cz v záložce Ceny dopravy můžete vyplnit spíše obecnější ceny dopravy, případně nastavit i rozsah cen dopravy dle ceny produktu. V administraci však nenastavíte případy, kdy máte cenu dopravy např. zdarma pro konkrétní produkty, atd. Pro nastavení konkrétních cen dopravy slouží tag DELIVERY, kde je potřeba uvést konkrétního dopravce a cenu dopravy při platbě předem, případně i na dobírku. Cena dopravy musí souhlasit při nákupu jednoho kusu produktu, u kterého je uvedena.

Minimální výše objednávky:

Ve VOP Heureky je uvedeno, že všechny produkty, které jsou v XML souboru musí být možné zakoupit (bod 3.1.). Pokud máte tedy hranici minimální výše objednávky, je potřeba v XML souboru nezasílat produkty, které nelze samostatně zakoupit. Například pokud máte minimální výši objednávky na 500,-, tak nesmí být v XML souboru produkt s cenou pod 500,-. Platí to i pro produkty, které zasíláte do XML souboru, ale není je možné objednat.

Bazarové produkty, (ale také rozbalené, renovované, repasované, poškozené, výstavní)

V XML souboru je potřeba označit pomocí tagu <ITEM_TYPE> bazarové a jiné zboží. Takto označené produkty se zobrazují po vyfiltrování bazarových položek ve fulltextovém vyhledávání na Heurece.

Duplicitní produkty

Každý produkt může být v XML souboru pouze jednou. Nejčastěji nastává situace duplicitních produktů u e-shopů, které prodávají náhradní díly pro automobily, motorky, ale i pro mobily apod. Ve chvíli, kdy je produkt kompatibilní s více zařízeními, je možné jej v XML souboru uvést pouze jednou, a zařízení, se kterými je kompatibilní uvést do popisu produktu (tag DESCRIPTION).

Chyby při importu

V těchto případech se jedná o chyby, které se při načítání XML souboru zjišťují automaticky v rámci jeho kontroly. Jedná se o tyto chyby:

  • Nulová neplatná cena – u produktu chybí cena, či je zadána 0,- (tag PRICE_VAT) -> tyto produkty jsou přeskočeny (nezobrazují se na Heurece), ostatní jsou v pořádku načteny
  • Neplatný název produktu – název produktu v XML souboru musí mít alespoň 3 znaky a nesmí se jednat pouze o číslo -> tyto produkty jsou přeskočeny (nezobrazují se na Heurece), ostatní jsou v pořádku načteny
  • Duplicitní url – každá URL adresa v XML souboru musí být unikátní; pokud máte varianty produktu v XML souboru rozdělené, ale na webu je máte na jedné produktové kartě, použijte tzv. kotvy, např. #1, #2, #3, atd.
  • Bazarové produkty – Bazarové produkty jsou při importu označeny jako produkty, které nejsou určeny k prodeji, znamená to, že bazarové produkty nijak nezpracováváme, pouze je zobrazíme ve vyhledávání po vyfiltrování bazarových položek
  • Chyba 404 – stránka nenalezena; chyba v URL, kde se XML soubor nachází, kontaktujte svého programátora, správce e-shopu, či váš shopsystém
  • Chyba 500 – výpadek vašeho serveru, kontaktujte svého programátora, správce e-shopu, či váš shopsystém
  • Chyba v ITEM_ID – ITEM_ID je unikátní kód produktu, jedná se o vaše kódy. Každé ITEM_ID by mělo být obsaženo v XML souboru pouze jednou a mít maximálně 36 znaků ([0-9/a-z/A-Z_-] tedy čísla nula až devět, malá a velká písmena bez diakritiky, podtržítka a pomlčky). ITEM_ID se používá pro identifikaci produktu v dostupnostním XML souboru, či v Ověřeno zákazníky
  • Neplatný dopravce – Dopravce do tagu DELIVERY v XML souboru je možné zadávat pouze dle specifikace. Pokud uvedete cokoliv jiného, tak vám přijde chyba při importu, nicméně produkty se zobrazí a ostatní ceny doprav se zpracují.
  • Stejný název produktu – Název produktu by měl být také pro celý XML souboru unikátní, pokud uvedete totožný název u více jak 100 produktů, tak jsou produkty u importu přeskočeny.

One thought on “Lekce 2: XML soubor + chyby v XML/důvody blokace”

Zanechat Odpověď

Vyplňte detaily níže nebo klikněte na ikonu pro přihlášení:

WordPress.com Logo

Komentujete pomocí vašeho WordPress.com účtu. Odhlásit / Změnit )

Twitter picture

Komentujete pomocí vašeho Twitter účtu. Odhlásit / Změnit )

Facebook photo

Komentujete pomocí vašeho Facebook účtu. Odhlásit / Změnit )

Google+ photo

Komentujete pomocí vašeho Google+ účtu. Odhlásit / Změnit )

Připojování k %s