Účetní programy za nejnižší ceny!
Shopio - efektivní řešení pro Váš e-shop.

Jak vytvořit export

Export umožňuje, aby systém Naakup měl přehled o sortimentu ve Vašem internetovém obchodě. Z technického hlediska jde o soubor, nebo stránku, kde jsou informace pro systém Naakup v určitém formátu.

Velká část systémů pro e-shop má již určité možnosti exportu zabudovány. Pak jediné, co musíte udělat, je zjistit, na jaké adrese se export nachází.

Exportní soubor umístíte na určité místo (například http://www.vas-obchod.cz/export.xml) a robot systému Naakup.cz tento soubor v pravidelných intervalech čte a zpracovává (pravděpodobně několikrát za týden). Podle informací v exportním souboru pak upraví databázi Naakupu. Exportní soubor nesmí být zaheslován nebo umístěn v privátní oblasti Vašeho webu.

Pakliže se o správu Vašeho internetového obchodu stará nějaká firma, webmaster, nebo jde o větší systém od jednoho poskytovatele, obraťte se s žádostí na vytvoření exportu na ně. V případě jakýchkoli nejasností nás neváhejte kontaktovat.

Pravidla exportu

Aby mohly být Vaše produkty zařazeny do našeho vyhledávače, musí splňovat následující pravidla:

  • Exportní soubor musí obsahovat pravdivé informace.
  • Exportní soubor neobsahuje produkty, které není možné zakoupit samostatně (např. dárky, které si lze koupit pouze s dalším zbožím).
  • Veškeré produkty mají uvedenou kladnou cenu.
  • Popis produktu (DESCRIPTION) obsahuje informace o daném produktu (tj. ne např. „XYZ je nejlevnější internetový obchod“).
  • Žádné položky neobsahují HTML značky.
  • Kódování XML souboru musí být utf-8, windows-1250 nebo iso-8859-2.

Podporované formáty

Podporujeme následující formáty exportu:

  • XML pro Seznam Zbozi.cz
  • XML pro Heureka.cz
  • XML pro Centrum.cz
  • XML pro Jyxo.cz
  • XML výstup ze systému Vltava 2000
  • XML výstup ze systému Zoner InShop

Ukázka XML souboru

<?xml version="1.0" encoding="windows-1250"?>
<SHOP>
  <NAME>Jméno Vašeho obchodu</NAME>
  <URL>URL Vašeho obchodu</URL>
  <SHOPITEM>
     <MANUFACTURER>Název výrobce</MANUFACTURER>
     <PRODUCT>Název produktu</PRODUCT>
     <DESCRIPTION>Popis produktu</DESCRIPTION>
     <URL>http://www.mujobchod.cz/produkty?id=100</URL>
     <IMGURL>http://www.nejakyobchod.cz/image?id=100</IMGURL>
     <PRICE>10000.15</PRICE>
     <PRICE_VAT>11900.20</PRICE_VAT>
     <VAT>0.19</VAT>
     <CATEGORYTEXT>Kategorie produktu ve vašem obchodě</CATEGORYTEXT>
     <EAN>Čárový kód (EAN)</EAN>
     <PRODUCTNO>Výrobní číslo produktu udávané výrobcem, u knih např. ISBN, nejedná se o katalogové číslo nebo interní značení produktu</PRODUCTNO>
     <WARRANTY>Záruční doba v měsících</WARRANTY>
     <DELIVERY_DATE>Dodací lhůta - slovně</DELIVERY_DATE>
     <AVAILABILITY>Dostupnost v hodinách</AVAILABILITY>
     <DUES>Poplatky k ceně (např. za elektroodpad atd.)</DUES>
  </SHOPITEM>
  
  <SHOPITEM>
  	<MANUFACTURER>Tichý a spol.</MANUFACTURER>
    <PRODUCT>Účto 2007 - daňová evidence/jednoduché účetnictví</PRODUCT>
    <DESCRIPTION>Komplexní program pro vedení daňové evidence</DESCRIPTION>
    <URL>http://obchod.blahasoft.cz/software/ucto-tichy/</URL>
    <IMGURL>http://obchod.blahasoft.cz/software/ucto-tichy/logo.gif</IMGURL>
    <PRICE>2857</PRICE>
    <PRICE_VAT>3400</PRICE_VAT>
    <VAT>0.19</VAT>
    <CATEGORYTEXT>Software</CATEGORYTEXT>
    <EAN>123456</EAN>
    <PRODUCTNO>UCTO2008</PRODUCTNO>
    <WARRANTY>24</WARRANTY>
    <DELIVERY_DATE>2</DELIVERY_DATE>
    <AVAILABILITY>24</AVAILABILITY>
    <DUES>0</DUES>
  </SHOPITEM>
</SHOP>

Popis jednotlivých XML elementů

Element nejvyšší úrovně SHOP obsahuje nepovinný element NAME (název obchodu), URL (adresa obchodu) a libovolné množství elementů SHOPITEM, každý popisuje jednu položku.

Pokud budou v XML souboru nalezeny neznámé elementy, budou tyto elementy ignorovány, budou zpracovány jen povolené elementy.

Doporučujeme mít vyplněné položky EAN a PRODUCTNO, podle těchto položek bude prováděno párování položek i zvýhodněné vyhledávání.

Každý element SHOPITEM obsahuje tyto položky (tučné položky jsou povinné):

  • SHOP - kořenový element
  • SHOPITEM - element v jehož rámci jsou informace týkající se jednoho výrobku
  • PRODUCT - obsahuje název produktu. Maximální délka je 100 znaků.
  • DESCRIPTION - textový popis daného produktu. Text by neměl obsahovat informace, které se nevztahují ke konkrétnímu produktu. Maximální délka textu je 800 znaků. Text nesmí obsahovat HTML tagy.
  • URL - url adresa internetové stránky produktu, na které jsou informace o tomto produktu. URL adresa musí být absolutní a začínat na http://. V rámci jednoho XML exportu může být více stejných URL.
    • Správný tvar: http://www.vas_obchod.cz/zbozi.php?id=1
    • Špatný tvar: www.vas_obchod.cz/zbozi.php?id=1, zbozi.php?id=1
  • IMGURL - url adresa odkazující na obrázek produktu
  • PRICE_VAT - koncová cena produktu včetně DPH. Může být celé nebo desetinné číslo, oddělovačem desetin je . (tečka).
  • PRICE - cena bez DPH (vyplníte pouze pokud jste plátci DPH). Může být celé nebo desetinné číslo, oddělovačem desetin je . (tečka).
  • VAT - sazba DPH pokud jste plátci DPH (buď <VAT>0.19</VAT> nebo <VAT>19</VAT>).
  • MANUFACTURER - obsahuje název výrobce produktu. Maximální délka je 100 znaků.
  • CATEGORYTEXT - textový popis kategorie, do které ve svém obchodu produkt zařazujete. Maximální délka je 100 znaků. Pokud bude text shodný s názvem naší kategorie, bude Váš produkt snadno a přesně zařazen do kategorie zboží v našem vyhledávači. Nadřazené a podřazené kategorie oddělujte " > ", oddělovač nesmí být před nejvyšší a za nejnižší kategorií. Příklad:
    Kategorie > Podkategorie
    Počítače > Procesory > Desktopové > AMD > Duron
  • EAN - čárový kód produktu (evropský identifikátor zboží EAN-UCC). Maximální délka je 20 znaků.
  • PRODUCTNO - výrobní číslo produktu udávané výrobcem, u knih např. ISBN, nejedná se o katalogové číslo nebo interní značení produktu. Maximální délka je 40 znaků.
  • DUES - pokud se poplatky vztahují k nabízenému sorimentu a nejsou již obsaženy v ceně. Součet ceny všech poplatků, které je nutné zaplatit při zakoupení výrobku (cena uvedena včetně DPH, nezahrnuje dopravu a balné).
  • AVAILABILITY - dostupnost zboží jako číselná hodnota vyjadřující hodiny
    • 0 = skladem
    • 1 - 72 = do 3 dnů
    • 73 - 168 = do týdne
    • 168 = více než týden
  • DELIVERY_DATE - doba doručení produktu. Zboží skladem se může uvést jako:
    • <DELIVERY_DATE>0</DELIVERY_DATE>
    • <DELIVERY_DATE>skladem</DELIVERY_DATE>
    • <DELIVERY_DATE>ihned</DELIVERY_DATE>
    Je možné uvádět dodací dobu ve dnech (pouze celočíselná hodnota):
    • <DELIVERY_DATE>5</DELIVERY_DATE>
    Dostupnost uvedená datem - od tohoto data bude produkt dostupný
    • <DELIVERY_DATE>2007-03-05</DELIVERY_DATE>
    • <DELIVERY_DATE>skladem</DELIVERY_DATE>
    • <DELIVERY_DATE>ihned</DELIVERY_DATE>
  • WARRANTY - délka záruky v měsících - pouze celočíselná hodnota

Uvádění cen s DPH a bez DPH

Pokud uvedete jen dvě hodnoty z trojice PRICE_VAT, PRICE, VAT, bude třetí hodnota dopočítána. Vždy ale musí být možné načíst nebo dopočítat konečnou cenu s DPH. Pozor tedy na následující případy:

  1. Pokud uvedete všechny hodnoty PRICE_VAT, PRICE, VAT, je vše v pořádku a je to ideální případ.
  2. Pokud uvedete jen hodnotu PRICE_VAT (s DPH) a VAT, dopočítáme cenu bez DPH. I toto je v pořádku.
  3. Pokud uvedete jen hodnotu PRICE_VAT (s DPH) a nic víc, předpokládáme že sazba DPH je 0% a dopočítáme cenu bez DPH. I toto je v pořádku.
  4. Pokud uvedete jen hodnotu PRICE (bez DPH) a VAT, dopočítáme cenu s DPH. I toto je v pořádku.
  5. Pokud uvedete jen hodnotu PRICE (bez DPH) a nic víc, nelze dopočítat cenu s DPH. Tento případ není v pořádku a Vaše produkty budou ve vyhledávání označené jako neúplné a tedy nedůvěryhodné.

Ampersandy (&) v adresách, ale i v popise výrobků by měly být nahrazeny znakovou entitou &amp; Podobně i znaky < a > (vyjma těch vymezujích XML tagy) entitou &lt; a &gt; Pokud nebudou, při zpracování exportu může docházet k chybám a nemusí se načíst celý. Také se vyvarujte nadbytečných mezer a to především v adresách výrobků a obrázků.