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

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