Prenos dát


Prenos údajov z obchodu do najnakup.sk prebieha na základe načítavania xml súboru uloženého na serveri obchodu robotom z najnakup.sk, pričom xml súbor musí zodpovedať nižšie popísanej špecifikácii.
Najnakup.sk načítava xml súbor spravidla 1xdeň a to v noci po 01:00. V prípade, že často aj v priebehu dňa meníte ceny alebo dostupnosť tovaru, obráťte sa prosím priamo na najnakup.sk so žiadosťou o zvýšenie frekvencie aktualizácie Vašich ponúk.
Prevádzkovateľ internetového obchodu zodpovedá za aktuálnosť a správnosť dát uvedených v xml súbore.


Špecifikácia xml feed-u (súboru)


Xml súbor je spravidla kompatibilný s verziou xml súboru pre heureka.sk

Xml súbor vytvára spravidla programátor obchodu. Pokiaľ používate štandardizovaný produkt - internetový obchod, obráťte sa na dodavateľa obchodu so žiadosťou o vytvorenie xml súboru s Vašimi ponukami.

- príklad xml súboru (feed-u) vhodného pre najnakup.sk nájdete tu: xml súbor.
- preferované kódovanie súboru je utf-8, prípadne win-1250
- xml súbor je možné skomprimovať zip formátom s cieľom znížiť dátový prenos
- súbor obsahuje všetky ponuky obchodu, ktoré sú správne a aktuálne

Popis položiek (xml tag-ov):

poradie názov atribútu povinný popis
1 code
resp. item_id
áno jedinečné id tovaru vo Vašej databáze
- toto id produktu musí byť nemenné, v opačnom prípade nebudú ponuky obchodu zaradené do katalógu
2 name
resp. productname
áno názov/označenie tovaru
- v tvare názov výrobcu a označenie, napr. SAMSUNG LE32B450
- príklad chybného názvu: SAMSUNGLed televizor LE32B450
3 description odporúčaný popis tovaru
- nesmie obsahovať žiadne reklamné texty
4 image_url
resp. imgurl
odporúčaný celá url na obrázok na Vašom webe
- napr.: http://www.mojobchod.sk/images/p0001.jpg
- minimálny rozmer jednej strany 160px
- obrázok môže zobrazovať len produkt, nesmie obsahovať watermark obchodu a podobne
5 product_url
resp. url
áno url (adresa) na stránku obchodu s produktom
napr.: http://www.mojobchod.sk/products/p0001.htm
6 price
resp. price_vat
áno cena tovaru v EUR vrátane DPH, recyklačných, autorských a iných podobných poplatkov
cena je konečná (pri spôsobe platby dobierkou), neobsahuje len cenu za dopravu
- napr.: 126,55
- všetky ceny sú v € a pozostávajú len z desatinného čísla, bez označenia meny
7 shipping áno najnižšia cena za dopravu, za ktorú je možné tovar dodať kamkoľvek na Slovensko (pri spôsobe platby dobierkou)
- napr.: 6,50 - obsahuje len číslo (bez medzier, označenia meny a pod.)
- ak je doprava zadarmo, zadajte 0
8 part_number
resp. productno
odporúčaný kód (označenie) produktu výrobcom
9 ean odporúčaný unikátny číselný kód identifikujúci produkt
ean a part number umožnia zaradenie Vašich ponúk do katalógu tovaru
pokiaľ je rovnaký kód použitý pri viacerých produktoch v xml, tak bude ignorovaný
10 manufacturer áno názov výrobcu
11 category
resp. categorytext
áno názov kategórie vo Vašom obchode
- celá cesta/napr.: Telefóny > Mobilné telefóny
12 availability
resp. delivery_date
odporúčaný dostupnosť tovaru
- v textovej forme, napr.: skladom
- max. dĺžka 12 znakov
13 gift nie darček ku produktu
14 itemgroup_id áno varianty produktov
Pokiaľ predávate produkty, ktoré sú vo viacerých variantoch, xml tagom itemgroup_id sa označia všetky varianty. Ide najmä o produkty v kategóriách oblečenie, bicykle a podobne.
Každá varianta produktu musí byť v xml uvedená ako samostatná položka.
15 accessory nie id produktov, ktoré tvoria príslušenstvo tohto tovaru
16 param odporúčané parametre produktu, dôležité najmä pri produktoch existujúcich vo variantách
príklad:
<PARAM>
  <PARAM_NAME>Veľkosť EUR</PARAM_NAME>
  <VAL>43</VAL>
</PARAM>
17 cpc nie ponúkaná cena za preklik za daný produkt
načitanie tohto xml tagu je nutné povoliť v administrácii eshopu

XML tagy môžu byť malými aj veľkými písmenami.

ŠPECIÁLNE POŽIADAVKY PRE NIEKTORÉ TYPY PRODUKTOV (ovplyvní zaradenie tovaru do katalógu)
PARFÉMY
PNEUMATIKY
ELEKTRÓNY (hliníkové disky)
PLECHOVÉ DISKY
NOTEBOOKY
OBUV, OBLEČENIE


Upozornenie: Xml súbor musí byť validný v zmysle xml špecifikácie.
Najčastejšie býva chyba v tom, že v xml rezervované znaky (viď nasl. tabuľka)
nie sú správne zapísané (xml escape). Chybný súbor nedokážeme spracovať.

znak zápis do xml (mimo CDATA sekcií)
& &amp;
' &apos;
" &quot;
< &lt;
> &gt;

Obsah jednotlivých xml tagov odporúťame  do xml zapisovať do CDATA sekcií.

Chybný stav
<DESCRIPTION>popis poroduktu <b>televízor</b></DESCRIPTION>
Oprava odporúčaná pomocou CDATA
<DESCRIPTION><![CDATA[popis poroduktu <b>televízor</b>]]</DESCRIPTION>
Oprava alternatívna enkódovaním znakov
<DESCRIPTION>popis poroduktu &lt;b&gt;televízor&lt;/b&gt;</DESCRIPTION>