Specifikace importních souborů XML - artikul.cz

XML datový soubor pro artikul.cz je v základu kompatibilní s XML formáty ostatních českých srovnávačů zboží (www.heureka.cz, www.zbozi.cz).
Pokud si nejste jisti, kontaktujte nás na info@artikul.cz.

Pokud máte k dispozici datový feed v jiném formátu, doporučujeme použít službu https://www.mergado.cz, která umí převádět celou řadu různých formátů do požadovaného formátu. A nejen to. 

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>

    <PRODUCTNAME>Název produktu</PRODUCTNAME>

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

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

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

    <PRODUCT>Název produktu zobrazený ve vyhledávání</PRODUCT>

    <DESCRIPTION>Popis produktu</DESCRIPTION>

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

    <VIDEO_URL>URL adresa videa produktu</VIDEO_URL>

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

    <VAT>DPH</VAT>

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

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

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

    <ISBN>Číselný kód určený pro jednoznačnou identifikaci knižních vydání</ISBN>

    <IMGURL_ALTERNATIVE>Další odkaz na obrázek výrobku, může být uveden vícekrát</IMGURL_ALTERNATIVE>

    <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>

    <ACCESSORY>Příslušenství k tomuto produktu, obsahuje ITEM_ID, může být uveden vícekrát</ACCESSORY>

    <PARAM>

       <PARAM_NAME>název paramteru, např. Barva, Uhlopříčka displeje, apod.</PARAM_NAME>
       <VAL>
hodnota parametru, např. červená, 14", apod.</VAL>

    </PARAM>

  </SHOPITEM>

 </SHOP>

 

Červeně označené hodnoty u položky jsou nutné k tomu, aby vůbec došlo k importu produktu a tím dohledání na webu artikul.cz
Oranžově označené hodnoty u položky jsou pak nutné pro správné napárovaní k našemu produktovému katalogu.
Zeleně označené hodnoty u položky jsou nutné pro správné filtrování zboží v kategoriích.
Bazarové položky je nutné označit jako bazar.

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.

Prosíme také o umožnění přístupu k feedu z naší IP adresy 85.118.129.14.

Ke kontrole správného formátu feedu můžete využit např. tyto nabídky třetích stran

Na artikulu dochází k validaci feedu po registraci eshopu a nastavení url na datový feed.

Popis elementů v xml feedu

Element Popis Omezení
SHOPITEM Položka datového souboru, produkt nebo služba  
ITEM_ID Interní ID položky, slouží k identifikaci produktu a proto je velmi důležité pro spravné aktualizace ceny, dostupnosti a napárování na katalog zboží. Max. 32 znaků
PRODUCT Název produktu zobrazující se ve výsledcích vyhledávání Max. 100 znaků
PRODUCTNAME 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ů
ISBN Číselný kód určený pro jednoznačnou identifikaci knižních vydání  
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ů

ACCESSORY Příslušenství k tomuto produktu, obsahuje ITEM_ID, může být uveden vícekrát  
PARAM

Parametry produktu, můžou být uvedeny vícekrát. Parametry slouží k filtrování produktů v kategorii. 

Elementy:

<PARAM_NAME>barva</PARAM_NAME>
<VAL>žlutá</VAL> 

Doporučení: Názvy parametrů zadávejte v jednotném čísle, u číselných hodnot používejte jednotky, používejte ano, ne místo např. má, nemá, obsahuje, neobsahuje (správně Bluetooth - ano, špatně Bluetooth - nemá)

 

 

 

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ámka: pokud nabízíte vlastní přepravu zboží, opět vaše přeprava musí splňovat podmínku, že ji nabízíte po celé ČR.