1. FAVI help page
  2. Uvjeti za XML feed
  3. Značenje i uvjeti za individualne elemente

Značenje i zahtjevi za pojedine elemente

Potrebni elementi:

IDENTIFIKACIJSKI BROJ (ID)*  | NAZIV PROIZVODA* | OPIS PROIZVODA* | KATEGORIJA PROIZVODA*  | CIJENA PROIZVODA* |  URL* | GLAVNA SLIKA* |  DOSTUPNOST PROIZVODA*

Preporučeni elementi:

OZNAČAVANJE VARIJANTI  | ALTERNATIVNE SLIKE |  PARAMETRI  | MOGUĆNOSTI DOSTAVE |  PROIZVOĐAČ


 

IDENTIFIKACIJSKI BROJ (ID) *

ID je jedinstvena oznaka za svaki proizvod u sistemu e-trgovine. ID se ne smije mijenjati tijekom razdoblja suradnje, inače se povijest i pozicija proizvoda mogu izgubiti.

U slučaju da više proizvoda ima isti ITEM_ID, XML feed će se smatrati neispravnim i ažuriranje neće pravilno raditi.

Element može sadržavati brojeve, mala i velika slova bez dijakritičkih znakova te posebne znakove kao što su crtice i podvlake.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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

 

OZNAČAVANJE VARIJANTI PROIZVODA

Oznaka grupnih varijanti proizvoda. Proizvodi koji su različite varijacije jednog proizvoda imaju jedinstveni ITEM_ID, ali isti ITEMGROUP_ID.

Preporučeno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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 not specified in Ceneo specification

 

NAZIV PROIZVODA*

Točan naziv proizvoda. Naziv identificira proizvod i pomaže da se ispravno navede u katalogu. Naziv proizvoda treba biti jasan i deskriptivan. Nije prikladno koristiti naziv od jedne riječi, kao što je NAZIV kolekcije ili izdanja.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>

 

OPIS PROIZVODA*

Opis proizvoda. Opis treba sadržavati podatke o konkretnoj varijanti proizvoda. Podržavamo korištenje relevantnih ključnih riječi koje pomažu u uvrštavanju filtera vašim proizvodima. Opis proizvoda treba biti detaljan i pun informacija koje motiviraju kupce na kupnju.

Bolje je izraditi neformatirani opis proizvoda jer će vaše kodiranje biti prikazano u FAVI katalogu. Nije dopušteno stavljati URL-ove koji vode na druge stranice vaše trgovine, adrese e-pošte i općenite  kontakt podatke.

Na stranici detalja o proizvodu u FAVI katalogu, možete provjeriti kako bi trebao izgledati opis pojedinog proizvoda. Općenito, FAVI sistem dopušta samo sljedeće html kodove:

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

Ostali kodovi i formati nisu podržani. Njihova uporaba može uništiti tekst i smanjiti njegovu kvalitetu. Pripazite i kod kodiranja posebnog znaka ako je potreban. Na primjer, simbol (&) mora biti kodiran s ASCII nizom &lt;li&gt ako ne koristite CDATA za slanje informacija.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>


 

KATEGORIJA PROIZVODA *

Kategorija proizvoda. Kategorija prvenstveno određuje razvrstavanje proizvoda u katalogu i treba je specificirati što točnije. Dopušteno je slati kategorije prema FAVI stablu kategorija, ili također možete odrediti svoje vlastite kategorije ako su dovoljno detaljne. Najbolje je uvijek kategorizirati u kategorije i podkategorije proizvoda – na primjer, Spavaća soba>Kreveti.

Cijelo stablo kategorija za sve zemlje dostupno je ovdje:

FAVI katalog će automatski učitati sve proizvode koji su navedeni u XML feedu pod uvjetom da imaju odgovarajuću kategoriju, valjanu poveznicu i sliku odgovarajuće veličine.

Za svaki proizvod, kategorija treba biti spomenuta samo jednom u XML feedu. Ako proizvod nema kategoriju, neće se učitati u katalog.

Sljedeće kategorije također neće biti prihvaćene:

  • kategorije nisu primjenjive na katalog
  • vrlo općenite kategorije (kao što su popusti, rasprodaje, promocije, nazivi soba itd.)
  • kategorije koje nisu na odgovarajućem jeziku.

Kategorije ne treba često mijenjati. Promjena kategorije uklonit će proizvode iz kataloga dok se nove kategorije ponovno ne odobre.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>


 

CIJENA PROIZVODA (PDV UKLJUČEN)*

Ukupna cijena proizvoda uključuje PDV (porez na dodanu vrijednost). FAVI sistem prihvaća cijene samo u sljedećim formatima:

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Nemojte koristiti točku za odvajanje tisuća i milijuna. Točka se smije koristiti samo kao decimalni razdjelnik. FAVI sistem automatski zaokružuje broj na dvije decimale.

Popusti za proizvode u FAVI katalogu sistem automatski generira na temelju pohranjene povijesti osnovnih cijena. Ukoliko dođe do sniženja cijene u XML feedu, snižava se i cijena proizvoda na FAVI-u te se obračunava iznos popusta. Stoga ne primamo informacije o popustima iz bilo kojeg posebnog unosa u XML feedu.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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″

 

URL *

URL je poveznicu koja dovodi kupca s naše  na vašu stranicu.. Odredišna stranica proizvoda mora sadržavati cijenu proizvoda, specifične informacije o proizvodu i gumb za kupnju ili naručivanje proizvoda. URL mora biti jedinstven unutar XML feeda, inače će se proizvodi s istom vezom spojiti.

URL mora biti važeći, razmaci ili dijakritički znakovi nisu dopušteni, a posebni znakovi moraju se koristiti u određenom HTML obliku, inače proizvodi neće biti učitani u katalog.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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.com/bed-merida.html#/90x200_cm″


 

GLAVNA SLIKA *

Glavna slika proizvoda, jedan je od najvažnijih aspekata XML feeda i mora ispunjavati sljedeće kriterije:

1) Proizvod na glavnoj slici ne smije biti u suprotnosti sa svojom specifikacijom – odnosno s nazivom ili opisom. Ovo se posebno odnosi na slučajeve kada je slika proizvoda u odnosu na opis:

  • u drugom dekoru ili boji (stolica u dekoru bukve ne smije imati na slici stolicu u dekoru oraha),
  • u drugoj veličini (naljepnica dimenzija 25 x 25 cm ne smije biti prikazana na slici preko cijelog zida i sl.)
  • prikazano s više proizvoda nego što je dostupno za cijenu proizvoda (npr. prikazivanje cijele spavaće sobe kada dana cijena uključuje samo ormar; ili prikazivanje cijelog seta uključujući stol sa stolicama kada dana cijena uključuje samo stol; ili prikazivanje proizvoda u drugoj boji) Slika treba prikazivati samo broj artikala prodanih u setu (npr. set od dvije stolice ne bi trebao sadržavati više od dvije stolice na slici). Alternativno će se tolerirati korištenje broja za označavanje broja identičnih proizvoda u jednom paketu (setu) (npr. dopušteno je prikazati sliku s jednom stolicom s brojem '2' u kutu koji označava da set sadrži dvije stolice). Međutim, znamenke ne smiju prekrivati proizvod ili na neki drugi način ometati pažnju: iz tog je razloga najbolje staviti broj u kut slike).

2) Proizvod na glavnoj slici mora imati pravu fotografiju: nije dopušteno koristiti skicu ili ilustraciju.

3) Molimo pošaljite slike u formatu datoteke PNG ili JPEG.

4) Glavna slika mora biti najmanje 600 x 600 px. Ipak, preporučuje se slanje najveće moguće veličine, idealno 1000 x 1000 px.

5) Proizvod na glavnoj slici mora biti prikazan u cijelosti, a ne samo određeni dio ili detalj.

6) Dopušteno je izlaganje proizvoda na bijeloj pozadini. Ako je proizvod ugrađen u interijer, proizvod mora biti dovoljno istaknut na slici kako bi kupac na prvi pogled znao o kojem je proizvodu riječ.

7) Glavna slika ne smije sadržavati dodatni tekst ili druge grafičke izmjene (ikone, vodene žigove, logotipe, oznake 1 + 1, popuste, mašne itd.).

8) Kod prikaza varijanti boja, glavna slika ne smije biti samo kvadrat u boji. Svaka slika varijante boje mora prikazivati stvarni proizvod.

9) Nije dopušteno staviti sliku u okvir.

Ako slika ne ispunjava gore navedene kriterije, može biti blokirana. Sve dodatne slike koje su dostupne (crteži, detalji, fotografije interijera i sastava) treba poslati kao alternativne slike, koje će biti prikazane izravno na stranici s detaljima proizvoda u FAVI katalogu.

Ako je proizvod blokiran za prikaz kao rezultat neusklađenosti s bilo kojim od gore navedenih kriterija popisa slika, a sistem kasnije otkrije izmjenu slike, slika će se ponovno ocijeniti i proizvod se može vratiti u katalog. Međutim, da biste promijenili sliku, morate promijeniti i URL u XML feedu. Nova slika će se učitati samo ako sistem otkrije promjenu URL-a. Ako se ne napravi nikakva promjena, izvorna slika se zadržava.

URL za glavnu (i alternativnu) sliku proizvoda mora ispunjavati sljedeće uvjete:

  • URL slike ne smije sadržavati razmake. Razmak treba ručno zamijeniti znakom "%20": naš sistem ga ne zamjenjuje automatski.
  • URL slike ne smije sadržavati naglaske ili dijakritičke znakove.
  • URL slike ne smije biti blokiran. Ako  FAVI sistem nepreuzimaslike zbog blokiranja URL-a od strane poslužitelja, proizvod se neće učitati u katalog.

Ako je  za učitani proizvod  slika ažurirana, a njen novi URL je nedostupan (blokiran, s razmacima ili naglascima), proizvod će biti deaktiviran unutar kataloga.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>

 

ALTERNATIVNE SLIKE

URL za alternativne slike proizvoda. Ostale ponuđene slike prikazane su na stranici s pojedinostima o proizvodu. Maksimalan broj slika je 20.

Sve alternativne slike moraju biti osigurane s https certifikatom.

U alternativnim slikama prikladno je pružiti:

  • fotografije proizvoda unutar sobe,
  • fotografije proizvoda uz druge proizvode (npr. iz iste kolekcije),
  • proizvod iz različitih kutova,
  • detaljnije slike pojedinih dijelova proizvoda,
  • skice koje pokazuju dimenzije itd.

Alternativne slike prikazujemo u tablici na Detalj o proizvodu.

Preporučeno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>


 

PARAMETRI

Parametri proizvoda. Podaci navedeni u obliku parametara prikazani su u tablici na stranici s pojedinostima o proizvodu. Ako pošaljete više parametara za svoje proizvode, vaša će kampanja vjerojatno biti uspješnija. Molimo vas navedite specifikacije proizvoda koje nisu jasno vidljive na slici.

Parametri koji se visoko preporučuju uključuju:

  • materijal,
  • oblik,
  • uzorak,
  • tekstura,
  • boja,
  • dekor,
  • stil,
  • dimenzije,
  • druge karakteristike specifične za proizvod koje bi mogle biti važne.

Parametre prikazujemo u tablici na Detalj o proizvodu. Prikazuju se jedino ako pošaljete 3 ili više parametra.

Preporučeno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>


 

DOSTUPNOST PROIZVODA *

Vrijeme dostave proizvoda (mjereno u danima) od primitka uplate (u slučaju plaćanja unaprijed), odnosno od primitka narudžbe (u slučaju plaćanja pouzećem).

Proizvodi na zalihi u katalogu su označeni i sadrže sljedeće:

  • DELIVERY_DATE vrijednost 0, 1, 2 ili 3 (Heureka/Zboží)
  • Delivery_Time vrijednost 0, 1, 2 ili 3 (Compari/Árukereső) 
  • “in stock” ili "in_stock" dostupnost elementa (Google)
  •  raspoloživa vrijednost 0, 1, 2 ili 3 (Ceneo) 

Ukoliko vrijednosti nisu navedene, to će se odrazit će se na ukupnom skoru proizvoda, stoga je svakako preporučljivo navesti datum isporuke. Međutim, također je potrebno da navedena vrijednost za rok isporuke odgovara roku isporuke koji je naveden u vašoj e-trgovini, kao što je vidljivo nakon klika na FAVI link.

Obavezno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite na FAVI:

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

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

ili 

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

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

** U elementima DELIVERY_DATE, Delivery_Time raspoloživost ispunjava jedan broj, a ne raspon vrijednosti.


 

MOGUĆNOSTI DOSTAVE

Specifikacija o mogućnosti isporuke proizvoda. Može postojati više načina isporuke po proizvodu. Oznaka besplatne dostave bit će prikazana za proizvod ako je jedna od važećih opcija dostave s cijenom 0.

U skor kvalitete računamo samo dostavu do kuće, ne dostavu na pick up lokacijama.

Oznaka za besplatnu dostavu  prikazati će se samo za proizvode ukoliko je jedna od opcija cijena dostave 0.

Ukoliko ne postoji mogućnost dodavanja cijene dostave u XML feed, možete informacije ispuniti na partnerskoj nadzornoj ploči pod Postavke>Dostava:

  • Najnižu cijenu dostave na adresu
  • Besplatna dostava na iznos iznad

Dodavanje cijena preko nadzorne ploče prepoučuje se samo ako imate jednake cijene i uvjete za cijeli portfolio proizvoda. Ukoliko nije tako, preporučujemo podatke zadati u XML feed.

Preporučeno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>

ili sljedeća oznaka: gratuit, gratis, fara cost; ingyenes, ingyen, ingyenesen; безплатно, безплатен, безплатна.

Ceneo nije specificirano


GTIN (EAN)

Global trade item number, skraćenog naziva GTIN je jedinstveni broj dodijeljen svakom proizvodu. Ukoliko vaši proizvodi nemaju GTIN broj, može te ga dobiti na GS1 webstranici.

Nemojte nikada uključivati interne numeričke oznake u GTIN, samo oficijalni kodovi proizvoda su dozvoljeni.

GTIN naš sistem prepoznaje i priznaje ukoliko:

1. Sadrži samo 8,12, 13 ili 14 znakova

2. Mora proći oficijalnu kalkulaciju 

3. Ne smije sadržati prefikse za vrijednosti kupona

Preporučujemo dodati ovaj element.

 

XML feed specifikacija Element
Heureka/Zboži

<EAN>6417182041488</EAN>

Google

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

Compari/Árukereső/Pazaruvaj

<EAN_code>6417182041488</EAN_code>

Jeftinije

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


PROIZVOĐAČ

Određuje proizvođača proizvoda.

Preporučeno za svaki proizvod.

Primjeri ovise o tome koji XML feed koristite 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>

 

*označava traženi element