1. FAVI súgóoldal
  2. XML feed követelmények
  3. Az egyes elemek jelentése és követelményei

Egyedi feed elemek jelentése és követelményei


AZONOSÍTÓ ID (ID) *

Az azonosító az egyes termékek egyedi jelölése a webáruház rendszerében. A jelölés nem változtatható meg az együttműködés időtartama alatt, ellenkező esetben a termék előzményei és pozíciója elveszhet.

Abban az esetben, ha több terméknek ugyanaz az ITEM_ID-je van, az XML feed hibásnak minősül, és a frissítés nem fog működni.

Az elem tartalmazhat számokat, kis- és nagybetűket diakritika nélkül, valamint speciális karaktereket, például kötőjeleket és aláhúzásokat. 

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem
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]]>

TERMÉKVARIÁNSOK

A csoportos termékváltozatok megnevezése. Az egyetlen termék különböző változatai egyedi ITEM_ID-vel, de azonos ITEMGROUP_ID-vel rendelkeznek.

Ajánlott minden termék számára

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem
Heureka/Zboží <ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google  <g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső/Pazaruvaj <GroupId>ZD563</GroupId>
Ceneo nem jelenik meg ebben a típusban
Jeftinije/Ceneje nem jelenik meg ebben a típusban

TERMÉKNÉV*

A termék pontos neve. A katalógusba való helyes felvételhez a termék nevének kellően leírónak kell lennie. Nem szabad egyszavas vagy semmitmondó terméknevet megadni.

A termékek kategorizálása katalógusunkban elsősorban a terméknév alapján történik, azaz ideális esetben a terméknévnek tartalmaznia kell a termék alapvető specifikációját, különösen a megnevezést, pl.: gyermekágynemű (tehát nem célszerű csak az ágyneműt felsorolni, ha gyermekágyneműről van szó). , kerti székek, étkezőszékek stb.A terméknév tartalmazhatja a gyártó vagy a márkanevet, de nem tartalmazhatja a bolt nevét vagy a bolt URL-címét. A cím szintén nem tartalmazhat olyan információkat, mint raktáron, akció, akciók, ingyenes szállítás stb.

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem

Heureka/Zboží

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

TERMÉKLEÍRÁS*

A termék leírása. A leírásnak tartalmaznia kell az adott termékváltozatra vonatkozó információkat. Örömmel fogadjuk a releváns kulcsszavak használatát, amelyek segítenek a termékek szűrőkben való felsorolásában. A termékleírásnak leírónak és olyan információkkal telinek kell lennie, amelyek vásárlásra ösztönzik a vásárlókat.

Jobb, ha nem formázott termékleírást készít, mivel a kódolás megmarad a FAVI katalógusban. Nem megengedett az üzletének egy másik oldalára mutató URL-cím, valamint az e-mail címek és általános elérhetőségi adatok feltüntetése.

A FAVI katalógus termék "részletek" aloldalán ellenőrizheti, hogyan kell kinéznie egy adott termék leírásának. A FAVI rendszer általában csak a következő html kódokat engedélyezi:

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

Más kódok és formátumok nem támogatottak. Használatuk tönkreteheti a szöveget és csökkentheti annak minőségét. Ha szükséges, a különleges karakterek kódolására is figyeljen oda! Például az "és" jelet & az &lt;li&gt ASCII karakterlánccal kell kódolni, ha nem a CDATA-t használja az információ küldésére.  

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus

Feed elem

Heureka/Zboží

<DESCRIPTION>A modern ágyat ...-ból készítettük</DESCRIPTION>
Google <g:description>A modern ágyat ...-ból készítettük</g:description>

Compari/Árukereső/Pazaruvaj

<Description>A modern ágyat ...-ból készítettük</Description>

Ceneo

<desc><![CDATA[A modern ágyat ...-ból készítettük]]></desc>

Jeftinije/Ceneje

<description>![CDATA[A modern ágyat…-ból készítettük]]></description>


TERMÉKKATEGÓRIA *

Termékkategória. A kategória határozza meg a termék besorolását a katalógusban, és a lehető legpontosabban kell megadni. A kategóriákat a FAVI kategóriafája szerint lehet elküldeni, de saját kategóriákat is megadhat, ha azok kellően részletesek. A legjobb, ha mindig a teljes termékútvonalat kategorizálja - például hálószoba>ágyak. 

A teljes kategóriafa minden országra vonatkozóan itt érhető el:

A FAVI katalógus automatikusan betölt minden olyan terméket, amely szerepel az XML feedben, feltéve, hogy megfelelő kategóriát, érvényes linket és megfelelő méretű képet tartalmaz.

Minden egyes termék esetében a kategóriaelemnek csak egyszer kell szerepelnie az XML-feedben. Ha a terméknek nincs kategóriája, nem töltődik be a katalógusba.

A következő kategóriák importálása szintén elutasításra kerül:
  • a katalógusban nem alkalmazható kategóriák
  • nagyon általános kategóriák (például kedvezmények, leárazások, akciók, helyiségek nevei stb.)
  • nem a megfelelő nyelven írt kategóriák.
A kategóriákat nem szabad gyakran változtatni. A kategóriák megváltoztatása eltávolítja a termékeket a katalógusból, amíg az újonnan benyújtott kategóriákat újra jóvá nem hagyjuk.

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus

Feed elem

Heureka/Zboží

<CATEGORYTEXT>Hálószoba>Ágyak</CATEGORYTEXT>

Google **

<g:google_product_category>Hálószoba> Ágyak</g:google_product_category>

<g:product_type>Hálószoba > Ágyak > single</g:product_type>

Compari/Árukereső/Pazaruvaj

<Category>Hálószóba > Ágyak</Category>

Ceneo

<cat>
<![CDATA[Hálószoba > Ágyak]]>
</cat>

Jeftinije/Ceneje

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

ÁR (ÁFA-VAL) *

A termék teljes ára az ÁFA-val együtt. A FAVI rendszer csak a következő formátumokban fogadja el az árakat:

  • 8 000
  • 8000
  • 8000,70
  • 8000.70

Kérjük, ne használjon pontot az ezrek és milliók elválasztására. A pont csak tizedesválasztóként használható. A FAVI rendszer automatikusan két tizedesjegyre kerekíti a számot.

A FAVI katalógusban szereplő termékekhez tartozó árengedményeket a rendszer automatikusan generálja a tárolt alapár-előzmények alapján. Ha az XML-feedben szereplő ár csökken, akkor a termék FAVI-ban szereplő ára is csökken, és a kedvezmény összege kiszámításra kerül. Ezért nem kapunk információt a kedvezményekről az XML feedben található külön paraméterekből. 

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus

Feed elem
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>4500</price>

URL *

Az URL megadja a webáruháza weboldalára mutató linket. A termék landing page-nek tartalmaznia kell a termék árát, a termékre vonatkozó konkrét információkat, valamint egy gombot a termék megvásárlására vagy megrendelésére. Az URL-címnek egyedinek kell lennie az XML-feeden belül, ellenkező esetben az azonos linkkel rendelkező termékek összevonásra kerülnek.

Az URL-nek érvényesnek kell lennie, nem megengedett a szóközök és az ékezetes karakterek használata, és a speciális karaktereket egy meghatározott HTML-formában kell használni, különben a termékek nem kerülnek feltöltésre a katalógusba.

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus     Feed elem
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>



MAIN PICTURE *

A fő termékképnek, mint az XML-feed egyik legfontosabb elemének, a következő kritériumoknak kell megfelelnie:

1) A termék a fő képen nem lehet ellentmondásban a termék specifikációjával - azaz a termék nevével vagy leírásával. Ez különösen azokra az esetekre vonatkozik, amikor a termék képe a specifikációjához képest:

  • más anyaggal vagy színben (egy bükkfa anyagú székhez nem szerepelhet a képen egy diófa anyagú szék),
  • más méretben (egy 25 x 25 cm méretű matrica nem szerepelhet a képen az egész falon stb.)
  • több termékkel együtt jelenik meg, mint amennyi a termék árában szerepel (pl. az egész hálószoba szettet jeleníti meg, amikor a megadott ár csak egy szekrényt tartalmaz; vagy egy egész szettet mutat, amely asztalt tartalmaz székekkel, miközben a megadott ár csak egy asztalt tartalmaz; vagy a terméket más színben jeleníti meg) A képen csak a szettben eladott darabszámot kell megjeleníteni (pl. egy két székből álló szett nem tartalmazhat kettőnél több széket a képen). Alternatív megoldásként egy szám használata az egy csomagban (készletben) található azonos termékek számának jelzésére megengedett (pl. megengedett egy olyan kép megjelenítése, amelyen egy szék van, a sarokban a „2” számmal annak jelzésére, hogy a készlet két széket tartalmaz). A számjegyek azonban nem takarhatják el a terméket, és nem lehetnek más módon zavaróak: ezért a számot a legjobb a kép sarkában elhelyezni).

2) A fő képen szereplő termékkép valódi fénykép kell legyen: vázlat vagy illusztráció használata nem megengedett. 
3) A képeket PNG vagy JPEG fájlformátumban kérjük elküldeni.
4) A fő képnek legalább 600 x 600 px méretűnek kell lennie. Azonban ajánlott a lehető legnagyobb méretet küldeni, ideális esetben több mint 1000 x 1000 px.
5) A terméknek a fő képen teljes egészében kell szerepelnie, tehát nem csak egy bizonyos résznek vagy részletnek.
6) A terméket lehetőség szerint fehér háttér előtt kell megjeleníteni. Ha a termék belső környezetbe van ágyazva, akkor a terméknek elég feltűnőnek kell lennie a képen ahhoz, hogy a vásárló első pillantásra tudja, hogy melyik termékről van szó.
7) A fő kép nem tartalmazhat további szöveget vagy egyéb grafikai módosításokat (ikonok, vízjelek, logók, 1+1 jelölések, kedvezmények, masnik stb.).
8) Színes változatok megjelenítésekor a főkép nem lehet csak egy színes négyzet. A színváltozat minden egyes képének a tényleges terméket kell ábrázolnia.
9) Nem megengedett a képet keretbe ágyazni.

Ha egy kép nem felel meg a fenti kritériumoknak, akkor a megjelenítés blokkolható. Minden további rendelkezésre álló képet (rajzok, részletek, belső és összetétel fotók) alternatív képként kell elküldeni, amelyek közvetlenül a FAVI katalógus termék részletező oldalán jelennek meg.

Ha a termék a fenti képlistázási kritériumok bármelyikének való meg nem felelés miatt letiltásra kerül, és a rendszer később képmódosítást észlel, a képet újraértékeljük, és a termék visszakerülhet a katalógusba. A kép megváltoztatásához azonban az XML-feed URL-címét is meg kell változtatnia. Az új kép csak akkor kerül betöltésre, ha a rendszer az URL megváltoztatását észleli. Ha nem történik változás, az eredeti kép marad meg.

A fő (és alternatív) termékkép URL-címének a következő feltételeknek kell megfelelnie:

  • A kép URL címe nem tartalmazhat szóközöket. A szóközt kézzel kell helyettesíteni a „%20” jellel: rendszerünk nem helyettesíti automatikusan.
  • A kép URL címe nem tartalmazhat ékezeteket vagy diakritikus jeleket.
  • A kép URL címe nem lehet blokkolt. Ha a FAVI rendszer a szerver által blokkolt URL miatt nem tudja letölteni a képet, a termék nem kerül be a katalógusba.
  • A kép URL-címét https-tanúsítvánnyal kell biztosítani.

Figyelembe kell venni, hogy ha a betöltött termék képét frissítik, és az új URL nem elérhető (blokkolt, szóközökkel vagy ékezetekkel küldött), a termék deaktiválódik a katalógusban.

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed specification 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>

ALTERNATÍV KÉPEK

Az alternatív termékképek URL címe. Az egyéb megadott képek a termék részletező oldalán jelennek meg. Az alternatív képek maximális száma 20. 

Minden alternatív kép URL-címét https-tanúsítvánnyal kell biztosítani.

Az alternatív képeknél célszerű megadni:

  • fotók a termékről egy helyiségben,
  • a terméket más termékekkel együtt ábrázoló fotók (pl. ugyanabból a kollekcióból),
  • a termék különböző szögekből,
  • részletesebb képek a termék egyes részeiről,
  • vázlatok a méretekről stb.

Ajánlott minden termék számára

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem
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>


PARAMÉTEREK

A termék paraméterei. A paraméterek formájában megadott információk a termék részletező oldalán található táblázatban láthatók. Ha több paramétert küld a termékekhez, a kampánya valószínűleg sikeresebb lesz. Kérjük, különösen olyan plusz információkat adjon meg, amelyek a képen nem nyilvánvalóan láthatók.

A kifejezetten ajánlott paraméterek közé tartoznak:

  • anyag,
  • forma,
  • minta,
  • textúra,
  • szín,
  • dekoráció,
  • stílus,
  • méretek,
  • egyéb olyan termékspecifikus jellemzők, amelyek fontosak lehetnek.

Többet is megtudhatsz a paraméterekről és specifikációjukról itt. Az egyes kategóriák ajánlott méretei, dimenziói a kategóriák listájában találhatók meg.

A megadott paramétereket egy táblázatban jelenítjük meg a termékrészleteken belül. Akkor kezdenek el megjelenni, ha 3 vagy több ilyen paramétert küld a feedben.

Ajánlott minden termék számára

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed specification Element
Heureka/Zboží  <PARAM>
  <PARAM_NAME>Magasság</PARAM_NAME>
  <VAL>95 cm</VAL>
</PARAM>
Google

<g:color>brown</g:color>
<g:material>tölgyfa</g:material>
<g:pattern>csíkos</g:pattern>

<g:product_detail>
   <g:section_name>Méret</g:section_name>
   <g:attribute_name>Magasság</g:attribute_name>
   <g:attribute_value>95 cm</g:attribute_value>
</g:product_detail>

Compari/Árukereső/Pazaruvaj

<Attributes>
  <Attribute>
    <Attribute_name>Magasság</Attribute_name>
    <Attribute_value>95 cm</Attribute_value>
  </Attribute>
</Attributes>

Ceneo

<attrs>
   <a name=“Magasság“>
     <95 cm>
   </a>
</attrs>

Jeftinije/Ceneje

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


TERMÉK ELÉRHETŐSÉG *

A termék szállításának időpontja (napokban mérve) a fizetés beérkezésétől (előlegfizetés esetén) vagy a megrendelés beérkezésétől (utánvétes fizetés esetén).

A katalógusban a készleten lévő termékek a következők szerint kerülnek meghatározásra:

  • DELIVERY_DATE érték 0, 1, 2 vagy 3 (Heureka/Zboží)
  • Delivery_Time érték 0, 1, 2 vagy 3 (Compari/Árukereső)
  • „raktáron” vagy „in_stock” elem elérhetősége (Google)
  •  avail érték 0, 1, 2 vagy 3 (Ceneo) 
Az ezektől eltérő értékek a termék teljes rangsorolásában is megjelennek, ezért mindenképpen ajánlott szállítási határidőt megadni. Szükséges azonban az is, hogy a szállítási időre megadott érték megegyezzen azzal a szállítási idővel, amely a webáruházában szerepel, ahogyan az a FAVI linkjére kattintva látható. 

Minden termék számára kötelező.

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem
Heureka/Zboží <DELIVERY_DATE>0</DELIVERY_DATE> **
Google

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

or

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

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

** A DELIVERY_DATE, Delivery_Time paraméterekben az avail egy számot tölt ki, nem pedig egy értéktartományt.


KISZÁLLÍTÁSI MÓDOK

A termékek vevőhöz történő szállítására vonatkozó lehetőségek meghatározása.

Egy termékhez több szállítási mód is létezhet, és célszerű feltüntetni a szállítási költséget. Ez növeli a termék általános pontszámát a katalógusban.

A termék minőségi pontszámánál csak a házhozszállítást vesszük figyelembe, a gyűjtőhelyre történő szállítást nem.

Az ingyenes szállítási címke akkor jelenik meg a terméken, ha az érvényes szállítási lehetőségek egyike 0 árral szerepel.

Ajánlott minden termék számára

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem
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 HUF</g:price>
</g:shipping>
Compari/Árukereső/Pazaruvaj

<Delivery_Cost>ingyen</Delivery_Cost>

Ceneo nincs megadva
Jeftinije/Ceneje <deliveryCost>0</deliveryCost>

GTIN (EAN)

A globális kereskedelmi tételszám (GTIN) egy egyedi szám, amelyet egy adott termékhez rendelnek. Ha az Ön termékei nem rendelkeznek GTIN-számmal, akkor az a GS1 rendszer weboldalain szerezhető be. 

Soha ne adjon meg belső numerikus termékazonosítókat a GTIN-ben, csak a hivatalos termékkódok engedélyezettek. 

A GTIN-t akkor ismerjük el érvényesnek a rendszerünkben, ha megfelel az alábbi kritériumoknak:

Ajánlott minden termék számára.

XML feed specification

Element

Heureka/Zboží

<EAN>6417182041488</EAN>

Google 

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

Compari/Árukereső/Pazaruvaj

<EAN_code>6417182041488</EAN_code>

Jeftinije/Ceneje

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


 

GYÁRTÓ

Megadja a termék gyártóját. 

Ajánlott minden termék számára

Példák annak függvényében, hogy milyen XML feedet használ a FAVI-n: 

XML feed típus Feed elem
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>

 

* kötelezően megadandó feed elemek