Artikul system

Specifikace importních souborů XML - artikul.cz

XML datový soubor pro artikul.cz je v základu kompatiblní s XML formáty ostatních českých vyhledávačů.
Pokud si nejste jisti, kontaktujte nás na obchod@artikulsystem.cz nebo podpora@artikulsystem.cz.
Nicméně platí, že náklady na zprovoznění vašeho eshopu na artikul.cz jsou nebo se blíží nule, stačí použít již existující XML datový zdroj.

Pro přehlednost uvádíme tvar XML a limity jednotlivých položek. Preferujeme kódování UTF8, ale poradíme si i ostatními standardy.
Pokud vaše data nesplňují dané podmínky, budou oříznuty na požadované délky.

<?xml version="1.0" encoding="utf-8"?>

<SHOP>

  <SHOPITEM>

    <ITEM_ID>Vaše Interní ID položky</ITEM_ID>

    <PRODUCT>Modelový název produktu</PRODUCT>

    <PRODUCTNAME>Detailní název produktu</PRODUCTNAME>

    <DESCRIPTION>Popis produktu</DESCRIPTION>

    <URL>URL adresa detailu produktu na Vašem eshopu</URL>

    <IMGURL>URL adresa obrázku produktu</IMGURL>

    <VIDEO_URL>URL adresa videa produktu</VIDEO_URL>

    <PRICE_VAT>Cena včetně DPH v českých korunách</PRICE_VAT>

    <PRICE>Cena bez DPH v českých korunách</PRICE>

    <MANUFACTURER>Název výrobce</MANUFACTURER>

    <CATEGORYTEXT>Název kategorie produktu</CATEGORYTEXT>

    <EAN>EAN kód produktu</EAN>

    <PRODUCTNO>Kód produktu, většinou kód výrobce</PRODUCTNO>

    <DELIVERY_DATE>Doba dodání</DELIVERY_DATE>

    <DELIVERY>

      <DELIVERY_ID>ID dopravy, viz níže</DELIVERY_ID>

      <DELIVERY_PRICE>Cena dopravy</DELIVERY_PRICE>

      <DELIVERY_PRICE_COD>Cena dopravy vč. doběrečného</DELIVERY_PRICE_COD>

    </DELIVERY>

    <ITEM_TYPE>Typ položky(nové, bazar)</ITEM_TYPE>

    <ITEMGROUP_ID>Skupina produktů, které představují varianty</ITEMGROUP_ID>

    <GIFT>Dárek</GIFT>

  </SHOPITEM>

 

 </SHOP>

 

Abychom byli schopni indexovat všechny produkty bez rozdílu a umožnit koncovým uživatelům vyhledávat podle kategorií, existuje jednotný seznam kategorií. Ten si můžete stáhnout jako Excel CSV soubor ZDE.

Indexace bere nejpřesnější zařazení Vašich produktů do produktových kategorií. Tzn. pokud je produkt zařazen jak v Auto-Moto, tak v Auto-Moto / Autobaterie, produkt bude zařazen do kategorie Autobaterie, protože do kategorie Auto-Moto je zařazen automaticky - ta je totiž nadřazená kategorii Autobaterie.

Prosíme také o umožnění přístupu naší IP adresy [85.118.131.2]

Element Popis Omezení
SHOPITEM Položka datového souboru, produkt nebo služba  
ITEM_ID Interní ID položky Max. 32 znaků
PRODUCT Modelový název produktu Max. 100 znaků
PRODUCTNAME Detailní název produktu Max. 200 znaků
DESCRIPTION Popis produktu Max. 1000 znaků
URL URL adresa detailu produktu na Vašem eshopu Max. 256 znaků
IMGURL URL adresa obrázku produktu Max. 256 znaků
VIDEO_URL URL adresa videa produktu Max. 256 znaků
PRICE_VAT Cena včetně DPH v českých korunách Číslo; pokud je jakýkoli řetězec je považováno za produkt s nulovou cenou
MANUFACTURER Název výrobce max. 45 znaků
CATEGORYTEXT

Název kategorie produktu.

Při zadání více kategorií použijte jako oddělovač |.

<CATEGORYTEXT>Kosmetika a zdraví | Zdraví | Léky, vitamíny a potravinové doplňky | Aromaterapie</CATEGORYTEXT>
Max. 65 znaků
EAN EAN kód produktu, popř. pokud není může být ISBN nebo UPC

Max. 20 znaků

PRODUCTNO Kód produktu, číslo výrobce Max. 45 znaků
DELIVERY_DATE

Doba dodání (počet dní, nebo datum uvedení produktu na trh)

0 - nulu použijte, pokud je zboží skladem

-1 - neznámá dostupnost

Číslo, popř. řetězec
DELIVERY Cena dopravy, viz. níže  
ITEM_TYPE Typ položky(nové, bazar)

- prázdný řetězec = nový produkt
- bazar = bazarová položka 

ITEM_GROUP Produkty, které představují varianty.

Max. 32 znaků

GIFT Textový popis dárků, položek, které jsou k produktu ZDARMA. 

Max. 250 znaků

 

Způsoby a ceny dopravy

Opakuje se tolikrát, kolik způsobů dopravy lze pro tento produkt využít. Při využití více služeb jednoho dopravce se uvádí nelevnější varianta ceny za dopravu. Podmínkou je doručování po celé ČR.

 

ELEMENTY

DELIVERY_ID - řetězec identifikující dopravce. Vybírejte z našich dopravců (jiné dopravce nelze uvádět).

DELIVERY_PRICE - celková cena – cena vč. DPH u konkrétního způsobu dopravy při platbě předem.

DELIVERY_PRICE_COD - celková cena – cena vč. DPH u konkrétního způsobu dopravy + hodnota dobírky. Je li cena dopravy u platby předem a platby na dobírku stejná, pak cenu v tomto elementu opakujte. Element se neuvádí, není-li možné zajistit dopravu s platbou na dobírku.

 

PODPOROVANÍ DOPRAVCI

V abecendním seznamu níže jsou uvedeni podporovaní dopravci:

  • Česká pošta <DELIVERY_ID>CESKA_POSTA
  • Česká pošta - Balík Na poštu <DELIVERY_ID>CESKA_POSTA_NA_POSTU
  • ČSAD Logistik Ostrava <DELIVERY_ID>CSAD_LOGISTIK_OSTRAVA
  • DPD <DELIVERY_ID>DPD
  • DHL <DELIVERY_ID>DHL
  • DSV <DELIVERY_ID>DSV
  • EMS <DELIVERY_ID>EMS
  • FOFR <DELIVERY_ID>FOFR
  • Gebrüder Weiss <DELIVERY_ID>GEBRUDER_WEISS
  • Geis <DELIVERY_ID>GEIS
  • General Parcel <DELIVERY_ID>GENERAL_PARCEL
  • GLS <DELIVERY_ID>GLS
  • HDS <DELIVERY_ID>HDS
  • HeurekaPoint <DELIVERY_ID>HEUREKAPOINT
  • InTime <DELIVERY_ID>INTIME
  • PPL <DELIVERY_ID>PPL
  • Radiálka <DELIVERY_ID>RADIALKA
  • Seegmuller <DELIVERY_ID>SEEGMULLER
  • TNT <DELIVERY_ID>TNT
  • TOPTRANS <DELIVERY_ID>TOPTRANS
  • UPS <DELIVERY_ID>UPS
  • Vlastní přeprava <DELIVERY_ID>VLASTNI_PREPRAVA

Pozn: pokud nabízíte vlastní přepravu zboží, opět vaše přeprava musí splňovat, že ji nabízíte po celé ČR.

 

Odběr novinek