1. FAVI help page
  2. Zahteve za XML feed
  3. Pomen in zahteve za posamezne elemente

Pomen in zahteve za posamezne elemente

 

Priporočeni elementi:

OZNAČEVANJE VARIANT  |   DODATNE SLIKE |   PARAMETRI  |  MOŽNOST DOSTAVE | GTIN | PROIZVAJALEC

 


 

IDENTIFIKACIJSKA ŠTEVILKA (ID) *

ID je edinstvena oznaka za vsak izdelek v sistemu e-trgovine. Oznaka se v obdobju sodelovanja ne sme spreminjati, sicer lahko pride do izgube zgodovine in položaja izdelka.

Če ima več izdelkov enak ITEM_ID, se bo XML feed obravnaval za napačnega in zato posodobitev ne bo delovala.

Element lahko vsebuje številke, male in velike črke brez diakritike ter posebne znake, kot so črtice in podčrtaji.

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <ITEM_ID>abc987</ITEM_ID>
Google <g:id>abc987</g:id>
Compari/Árukereső/Pazaruvaj <Identifier>abc987</Identifier>
Ceneo id=“abc987
Jeftinije/Ceneje <![CDATA[abc987]]>

OZNAČEVANJE VARIANT

Oznake skupinskih različic izdelkov. Izdelki, ki so različice enega izdelka, imajo edinstven ITEM_ID, vendar enak ITEMGROUP_ID.

Priporočeno za vsak izdelek.

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google  <g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső/Pazaruvaj <GroupId>ZD563</GroupId>
Ceneo ni opredeljeno v Ceneo specifikaciji
Jeftinije/Ceneje ni opredeljeno v Jeftinije/Ceneje specification

IME IZDELKA *

Točno ime izdelka. Za pravilno vključitev v katalog mora biti ime izdelka dovolj opisno. Ni primerno navesti enobesednega imena izdelka, npr. imena zbirke ali izdaje.

Izdelki so v našem katalogu razvrščeni predvsem na podlagi imena izdelka, kar pomeni, da bi moralo ime izdelka v idealnem primeru vsebovati osnovno specifikacijo izdelka, zlasti poimenovanje, na primer: otroška posteljnina (v tem primeru ni primerno navesti samo "posteljnina", če gre za otroško posteljnino), vrtni stoli, jedilni stoli itd.
Ime izdelka lahko vsebuje ime proizvajalca ali blagovne znamke, vendar ne imena trgovine ali URL naslova trgovine. Naslov prav tako ne sme vsebovati informacij kot so "na zalogi", "razprodaja", "akcije", "brezplačna dostava" itd.

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element

Heureka/Zboží

<PRODUCTNAME>MERIDA double bed, 160×200 cm</PRODUCTNAME>
Google  <title>MERIDA double bed, 160×200 cm</title>
Compari/Árukereső/Pazaruvaj <Name>MERIDA double bed, 160×200 cm</Name>
Ceneo <name>MERIDA double bed, 160×200 cm</name>
Jeftinije/Ceneje <name><![CDATA[MERIDA double bed, 160×200 cm]]></name>

OPIS IZDELKA *

Opis izdelka. Opis mora vsebovati informacije o določeni različici izdelka. Dobrodošla je uporaba ustreznih ključnih besed, ki pomagajo pri uvrstitvi izdelkov v filtre. Opis izdelka mora biti opisen in poln informacij, ki kupce motivirajo za nakup.

Bolje je ustvariti neformatiran opis izdelka, saj se bo vaše kodiranje ohranilo v katalogu FAVI. Ni dovoljeno vključiti URL povezav, ki vodijo na drugo stran vaše trgovine, e-naslovov in splošnih kontaktnih informacij.

Na strani s podrobnostmi o izdelku v katalogu FAVI lahko preverite, kako naj bi bil videti opis določenega izdelka. Na splošno sistem FAVI dovoljuje le naslednje kode html:

  • <p> </p>, 
  • <b> </b>,
  • <strong> </strong>,
  • <i> </i>,
  • <em> </em>, 
  • <br>, 
  • <ul> </ul>,
  • <li> </li>,
  • <ol> </ol>.

Druge kode in formati niso podprti. Njihova uporaba lahko uniči besedilo in zmanjša njegovo kakovost. Pozorni bodite tudi pri kodiranju posebnih znakov, če so potrebni. Na primer simbol ampersand (&) mora biti kodiran z nizom ASCII &lt;li&gt, če za pošiljanje informacij ne uporabljate CDATA.  

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija

Element

Heureka/Zboží

<DESCRIPTION>Modern bed is made from …</DESCRIPTION>
Google <g:description>Modern bed is made from …</g:description>

Compari/Árukereső/Pazaruvaj

<Description>Modern bed is made from…</Description>

Ceneo

<desc><![CDATA[Modern bed is made from …]]></desc>

Jeftinije/Ceneje

<description>![CDATA[Modern bed is made from …]]></description>


KATEGORIJA IZDELKA *

Kategorija izdelka. Kategorija določa razvrstitev izdelka v katalogu in jo je potrebno navesti čim bolj podrobno. Dovoljeno je poslati kategorije v skladu z drevesom kategorij FAVI, lahko pa določite tudi svoje kategorije, če so dovolj podrobne. Najbolje je, da vedno kategorizirate celotno pot izdelka - na primer: Spalnica > postelje. 

Celoten seznam dreves kategorij za vse države je na voljo tukaj:

Katalog FAVI bo samodejno naložil vse izdelke, ki so navedeni v XML feed-u, če bodo vsebovali ustrezno kategorijo, veljavno povezavo in sliko ustrezne velikosti.

Za vsak izdelek mora biti element kategorije v XML feed-u naveden samo enkrat. Če izdelek nima kategorije, se v katalog ne bo naložil.

Uvoz naslednjih kategorij bo prav tako zavrnjen:

  • kategorije, ki niso ustrezne za katalog
  • zelo splošne kategorije (kot npr. popusti, razprodaje, promocije, imena sob itd.)
  • kategorije, ki niso v ustreznem jeziku

Kategorij ne spreminjajte prepogosto. V primeru sprememb kategorij bodo izdelki odstranjeni iz kataloga vse do takrat, dokler ne bodo novo predložene kategorije ponovno odobrene .

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

 

XML feed specifikacija

Element

Heureka/Zboží

<CATEGORYTEXT>Bedrooms > Beds</CATEGORYTEXT>

Google **

<g:google_product_category>Bedrooms> Beds</g:google_product_category>

<g:product_type>Bedrooms > Beds > single</g:product_type>

Compari/Árukereső/Pazaruvaj

<Category>Bedrooms > Beds</Category>

Ceneo

<cat>
<![CDATA[Bedrooms > Beds]]>
</cat>

Jeftinije/Ceneje

<fileUnder><![CDATA[Bedrooms > Beds]]></fileUnder>


CENA IZDELKA ( z DDV) *

Skupna cena izdelka z DDV (davek na dodano vrednost). Sistem FAVI sprejema cene samo v naslednjih oblikah: 

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Tisočic in milijonov naj se ne ločuje s piko. Piko lahko uporabljate le kot ločilo za decimalno število. Sistem FAVI številko samodejno zaokroži na dve decimalni mesti.

Popuste v katalogu FAVI sistem samodejno ustvari na podlagi shranjene zgodovine osnovnih cen. Če se cena v XML feed-u zniža, se zniža tudi cena izdelka v FAVI in izračuna znesek popusta. Informacij o popustih zatorej ne prejemamo iz nobenega posebnega vnosa v XML feed. 

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija

Element
Heureka/Zboží <PRICE_VAT>4500</PRICE_VAT>
Google 

<g:price>5500</g:price>
for product in sale: <g:sale_price>4500</g:sale_price>

Compari/Árukereső/Pazaruvaj <Price>4500</Price>
Ceneo price=“4500″
Jeftinije/Ceneje <price>659.90</price>

URL *

URL vsebuje povezavo do spletne strani vašega izdelka v e-trgovini. Pristopna stran izdelka mora vsebovati ceno izdelka, informacije o izdelku in gumb za nakup ali naročilo izdelka. Naslov URL mora biti edinstven v XML feed-u, sicer bodo izdelki z enako povezavo združeni.

Naslov URL mora biti veljaven, brez presledkov in diakritik, posebni znaki pa morajo biti uporabljeni v določeni HTML obliki, sicer izdelki ne bodo naloženi v katalog.

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija     Element
Heureka/Zboží <URL>https://www.url.com/bed-merida.html#/90x200_cm</URL>
Google <link>https://www.url.com/bed-merida.html#/90x200_cm</link>
Compari/Árukereső/Pazaruvaj <Product_url>https://www.url.com/bed-merida.html#/90x200_cm</Product_url>
Ceneo

url=“https://www.url.cz/merida.html#/90x200_cm″

Jeftinije/Ceneje

<link><![CDATA[https://www.url.cz/merida.html#/90x200_cm]]></link>


GLAVNA SLIKA *

Glavna slika izdelka, ki je eden najpomembnejših vidikov XML feed-a, mora izpolnjevati naslednja merila:

1) Izdelek na glavni sliki ne sme biti v nasprotju z njegovo specifikacijo - tj. z imenom ali opisom. To velja zlasti za primere, ko je slika izdelka glede na njegovo specifikacijo:

  • v drugačnem dekorju ali barvi (stol iz bukve ne sme imeti na sliki stola iz oreha),
  • v drugačni velikosti (nalepka, ki meri 25 x 25 cm, ne sme biti na sliki prikazana npr. čez celotno steno itd.)
  • prikazan z več izdelki, kot jih je na voljo za ceno izdelka (npr. prikaz celotnega spalnega kompleta, če je v navedeni ceni samo omara; ali prikaz celotnega kompleta z mizo in stoli, če je v navedeni ceni samo miza; ali prikaz izdelka v drugi barvi). Slika mora prikazovati samo število prodajnih izdelkov v kompletu (npr. komplet dveh stolov na sliki ne sme vsebovati več kot dveh stolov). Dopustna je tudi uporaba številke, ki označuje število enakih izdelkov v enem paketu oz. kompletu (npr. dovoljeno je prikazati sliko z enim stolom s številko "2" v kotu, ki nakazuje, da komplet vsebuje dva stola). Vendar pa številke ne smejo prekrivati izdelka ali kako drugače odvračati pozornosti: iz tega razloga je najbolje, da se številka nahaja v kotu slike).

2) Izdelek mora biti na glavni sliki predstavljen s pravo fotografijo: ni dovoljeno uporabiti skice ali ilustracije. 

3) Slike pošljite v obliki datoteke PNG ali JPEG.

4) Glavna slika mora biti velika vsaj 600 x 600 px. Priporočamo pa, da pošljete čimvečjo možno velikost, najbolje več kot 1000 x 1000 px.

5) Izdelek na glavni sliki mora biti prikazan v celoti in ne le določen del ali podrobnost izdelka.

6) Izdelek je dovoljeno prikazati na belem ozadju. Če je izdelek vgrajen v notranjost, mora biti na sliki dovolj viden, da kupec že na prvi pogled ve, za kakšen izdelek gre.

7) Glavna slika ne sme vsebovati dodatnega besedila ali drugih grafičnih sprememb (ikone, vodni znaki, logotipi, oznake 1 + 1, popusti, loki itd.).

8) Pri prikazu barvnih različic glavna slika ne sme biti le barvni kvadrat. Vsaka slika barvne različice mora prikazovati dejanski izdelek.

9) Slike ni dovoljeno vstaviti v okvir.

Če slika ne izpolnjuje zgornjih meril, je lahko njen prikaz blokiran. Vse dodatne slike, ki so na voljo (risbe, podrobnosti, fotografije notranjosti in sestave), je potrebno poslati kot dodatne slike, ki bodo prikazane neposredno na strani s podrobnostmi izdelka v katalogu FAVI.

Če je prikaz izdelka blokiran zaradi neskladnosti s katerimikoli od zgoraj naštetih meril za prikaz slik in sistem pozneje zazna spremembo slike, se slika ponovno oceni, izdelek pa se lahko vrne v katalog. Če želite spremeniti sliko, morate spremeniti tudi URL naslov v XML feed-u. Nova slika se naloži le, če sistem zazna spremembo URL naslova. Če spremembe ni, se ohrani prvotna slika.

URL za glavno (in dodatno) sliko izdelka mora izpolnjevati naslednje pogoje:

  • URL slike ne sme vsebovati presledkov. Presledek je potrebno ročno nadomestiti z znakom "%20": naš sistem ga ne bo nadomestil samodejno.
  • URL slike ne sme vsebovati naglasov ali diakritičnih znakov.
  • URL slike ne sme biti blokiran. Če sistem FAVI ne more prenesti slike zaradi blokade URL s strani strežnika, izdelek ne bo naložen v katalog.
  • URL slike je zavarovan s certifikatom https.

Upoštevati je potrebno, da če je slika za naloženi izdelek posodobljena in je novi URL izdelka nedostopen (blokiran, s presledki ali poudarki), bo izdelek v katalogu deaktiviran.

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <IMGURL>https://www.url.com/bed-merida.jpg</IMGURL>
Google <g:image_link>https://www.url.com/bed-merida.jpg</g:image_link>
Compari/Árukereső/Pazaruvaj <Image_url>https://www.url.com/bed-merida.jpg</Image_url>
Ceneo <imgs><main url=“https://www.url.com/bed-merida.jpg“/></imgs>
Jeftinije/Ceneje <mainImage><![CDATA[https://www.url.com/bed-merida.jpg]]></mainImage>

DODATNE SLIKE

URL za dodatne slike izdelka. Dodatne slike so prikazane na strani s podrobnostmi o izdelku. Naložite lahko največ 20 slik. 

Vsi URL naslovi dodatnih slik morajo biti zaščiteni s certifikatom https.

Pri dodatnih slikah je primerno zagotoviti:

  • fotografije izdelka v prostoru,
  • fotografije izdelka skupaj z drugimi izdelki (npr. iz iste kolekcije),
  • izdelek z različnih zornih kotov,
  • podrobnejše slike posameznih delov izdelka,
  • skice z merami itd.

Priporočeno za vsak izdelek.

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <IMGURL_ALTERNATIVE>https://www.url.com/bed-merida2.jpg</IMGURL_ALTERNATIVE>
Google  <g:additional_image_link>https://www.url.com/bed-merida2.jpg</g:additional_image_link>
Compari/Árukereső/Pazaruvaj <Image_url_2>https://www.url.com/bed-merida2.jpg</Image_url_2>
Ceneo

<imgs><i url=“https://www.url.com/bed-merida2.jpg“/></imgs>

Jeftinije/Ceneje

<moreImages><![CDATA[https://www.url.com/bed-merida2.jpg,https://www.url.com/bed-merida3.jpg]]
></moreImages>


PARAMETRI

Parametri izdelka. Informacije v obliki parametrov so prikazane v preglednici na strani s podrobnostmi o izdelku. Če boste za svoje izdelke poslali več parametrov, bo vaša kampanja verjetno uspešnejša. Še posebej priporočljivo je navesti specifikacije izdelka, ki s slike niso očitno razvidne.

Zelo priporočljivi parametri vključujejo: material, oblika, vzorec, tekstura, barva, dekor, stil, dimenzije, druge značilnosti proizvoda, ki bi lahko bile pomembne.

Več o parametrih in njihovih specifikacijah najdete tukaj. Nekateri parametri se uporabljajo za razvrščanje izdelkov v določene filtre.

Stranke, ki uporabljajo filtre, so na splošno bolj nagnjene k nakupu. Da ne bi izgubili takih strank, preverite trenutno stanje svojih parametrov. Če želite izdelke uvrstiti v filter "dimenzije" poskrbite, da vsako dimenzijo pošljete v ločenem parametru - višino ločeno, širino ločeno, globino ločeno itd. Če tega ne boste upoštevali, izdelka ne bo mogoče najti preko filtra "dimenzije". Priporočene dimenzije za vsako kategorijo lahko najdete na seznamu kategorij.

Splošna načela za parametre

  1. Ne pošiljajte več vrednosti parametrov, razen če se natančno ujemajo z različico izdelka, glejte primer (dekor, druge razpoložljive mere in barve), glavna slika mora ustrezati opisu in danim parametrom.
  2. Pri ustvarjanju parametrov ni treba natančno kopirati besedila naših filtrov v kategorijah. Združili bomo nekoliko drugačna poimenovanja, če jih bomo prejeli od večih partnerjev.
  3. Navedite merske enote za številčne vrednosti (cm, mm, l, ...).
  4. Vsak izdelek mora vsebovati svojo specifikacijo. Ne podvajajte vrednosti parametrov, glejte primer.
  5. Vrednosti parametrov, kot so da x ne, so sprejete , vrednosti 0 x 1 pa ne.
  6. Parametre pošljite čim bolj natančno. Ne vnašajte več vrednosti v več vrstic znotraj enega zapisa.
  7. Parametri morajo biti prevedeni v jezik določene države.
  8. Dimenzije je treba poslati v ločenih parametrih - ločeno za višino, ločeno za širino, ločeno za globino itd.

Zagotovljene parametre prikažemo v tabeli o podrobnostih izdelka. Prikazali se bodo, če pošljete 3 ali več.

Zelo priporočeno za vsak izdelek.

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží  <PARAM>
  <PARAM_NAME>Height</PARAM_NAME>
  <VAL>95 cm</VAL>
</PARAM>
Google

<g:color>brown</g:color>
<g:material>solid wood, beech</g:material>
<g:pattern>striped</g:pattern>

<g:product_detail>
   <g:section_name>Size</g:section_name>
   <g:attribute_name>Height</g:attribute_name>
   <g:attribute_value>95 cm</g:attribute_value>
</g:product_detail>

Compari/Árukereső/Pazaruvaj

<Attributes>
  <Attribute>
    <Attribute_name>Height</Attribute_name>
    <Attribute_value>95 cm</Attribute_value>
  </Attribute>
</Attributes>

Ceneo

<attrs>
   <a name=“Height“>
     <95 cm>
   </a>
</attrs>

Jeftinije/Ceneje

<attributes>
<name><![CDATA[Height]]></name>
<values>
<value><![CDATA[95 cm]]></value>
</values>
</attribute>
</attributes>


DOSTOPNOST IZDELKA *

Čas odpreme izdelka (v dnevih) od prejema plačila (v primeru predplačila) ali od prejema naročila (v primeru plačila ob dobavi).

Skladiščni izdelki v katalogu so označeni izdelki, ki vsebujejo naslednje:

  • DELIVERY_DATE vrednost 0, 1, 2 ali 3 (Heureka/Zboží)
  • Delivery_Time vrednost 0, 1, 2 ali 3 (Compari/Árukereső) 
  • razpoložljivost elementa "in stock" ali "in_stock" (Google)
  •  avail vrednost 0, 1, 2 ali 3 (Ceneo) 

Vrednosti, ki so drugačne od teh, se bodo odražale v skupni razvrstitvi izdelka, zato je vsekakor priporočljivo navesti datum dostave. Potrebno je tudi, da se navedena vrednost za čas dostave ujema s časom dostave, ki je naveden v vaši e-trgovini, kot je razvidno po kliku na povezavo iz FAVI. 

Zahtevano za vsak izdelek. 

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <DELIVERY_DATE>0</DELIVERY_DATE> **
Google

<g:availability>in stock</g:availability>

ali

<g:availability>in_ stock</g:availability>

Compari/Árukereső/Pazaruvaj <Delivery_Time>0</Delivery_Time> **
Ceneo avail=“1″ **
Jeftinije/Ceneje <stock>in stock</stock>

** V elementih DELIVERY_DATE, Delivery_Time in avail izpolnite eno številko in ne razpona vrednosti.


MOŽNOST DOSTAVE

Določitev možnosti dostave izdelkov.

Za posamezen izdelek je lahko na voljo več načinov dostave, zato je priporočljivo vključiti tudi stroške dostave. To bo povečalo skupno oceno izdelka.

Pri ocenjevanju kakovosti izdelka upoštevamo le dostavo na dom, ne pa dostave na prevzemno mesto.

Oznaka brezplačna dostava se prikaže na izdelku, če je ena od veljavnih možnosti pošiljanja navedena s ceno 0.

Zelo priporočeno za vsak izdelek.

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <DELIVERY>
   <DELIVERY_ID>PPL</DELIVERY_ID>
   <DELIVERY_PRICE>0</DELIVERY_PRICE>
   <DELIVERY_PRICE_COD>20</DELIVERY_PRICE_COD>
</DELIVERY>
Google  <g:shipping>
    <g:price>0 CZK</g:price>
</g:shipping>
Compari/Árukereső/Pazaruvaj

<Delivery_Cost>FREE</Delivery_Cost>

ali z oznako: gratuit, gratis, fara cost; ingyenes, ingyen, ingyenesen; безплатно, безплатен, безплатна.

Ceneo ni določeno
Jeftinije/Ceneje <deliveryCost>0</deliveryCost>


GTIN (EAN)

Global Trade Item Number (GTIN) oz. globalna trgovinska številka izdelka, je edinstvena številka dodeljena določenemu izdelku. Če vaši izdelki nimajo številke GTIN, jo lahko pridobite na spletnih straneh sistema GS1 .

V številko GTIN nikoli ne vključujte notranjih številčnih identifikatorjev izdelkov, dovoljene so le uradne oznake izdelkov.

Številka GTIN je v našem sistemu priznana kot veljavna, če izpolnjuje naslednja merila:

  1. Sestavljena je samo iz 8, 12, 13 ali 14 številk.
  2. Doseči mora uradni izračun kontrolne vsote (npr. https://www.gs1.org/services/how-calculate-check-digit-manually).
  3. Ne sme vsebovati predpon za vrednosti kuponov (več informacij: Postopek rešitve: Vrednost kupona ni podprta: GTIN)

Vključitev tega elementa je zelo priporočljiva.

XML feed specifikacija

Element

Heureka/Zboží

<EAN>6417182041488</EAN>

Google 

<g:gtin>6417182041488</g:gtin>

Compari/Árukereső/Pazaruvaj

<EAN_code>6417182041488</EAN_code>

Ceneo

<a name=“EAN“>
<![CDATA[6417182041488 ]]>
</a> 

Jeftinije/Ceneje

<EAN><![CDATA[6417182041488]]></EAN>



 PROIZVAJALEC

Določa proizvajalca izdelka.

Zelo priporočeno za vsak izdelek.

Primeri so odvisni od tega, kateri XML feed uporabljate na FAVI:

XML feed specifikacija Element
Heureka/Zboží <MANUFACTURER>Joinery XYZ</MANUFACTURER>
Google  <g:brand>Joinery XYZ</g:brand>
Compari/Árukereső/Pazaruvaj <Manufacturer>Joinery XYZ</Manufacturer>
Ceneo <attrs>
   <a name=“Manufacturer“>
     <![CDATA[Joinery XYZ]]>
    </a>
</attrs>
Jeftinije/Ceneje <brand><![CDATA[Joinery XYZ]]></brand>

 

* označuje zahtevan element