Ebben a cikkben áttekintést talál a Heureka XML termék- és elérhetőségi adatfolyam kötelező elemeiről. Ezek az elemek elengedhetetlenek a termékek megfelelő összekapcsolásához és elindításához.
Termék Heureka XML feed
| SHOP | Root elem, csak egyszer szerepel a fájlban. |
| SHOP_ITEM | Az elem a teljes termékszerkezetet tartalmazza, annyiszor szerepel a fájlban, ahány terméke vagy változata van a partnernek. Például, ha a partner egy pólót öt méretben (S, M, L, XL, XXL) és tíz színben (fehér, sárga, narancs, piros, kék, lila, zöld, barna, bézs, szürke és fekete) árul akkor 50-szer kell SHOPITEM-et tartalmaznia az XML-ben.Az XML-ben 50-szer kell SHOPITEM-et tartalmaznia. |
| ITEM_ID | Egyedi termékmegjelölés a webáruházon belül, amely alapján a MALL azonosító generálódik. Az azonosítónak egyedinek kell maradnia, mivel a termék egyedi azonosítására szolgál számunkra. Például a rendelkezésre állás helyes párosításához a Availability Heureka XML feedben. Nem lehet azonos az ITEMGROUP_ID-vel. Maximálisan 50 karaktert kombinálva, a megengedett karakterek: _ - 0-9 a-z A-Z A-Z (aláhúzások, kötőjelek, számok nullától kilencig, nagy- és kisbetűk diakritika nélkül). |
| PRODUCTNAME | Pontos terméknév. A hosszúságot a rendszerünk érvényesíti - max 200 karakter. Nem engedélyezettek különleges karakterek. |
| TERMÉK | Ez az elem nem kötelező. Ha elküldi a feedben, akkor egy rövid termékleírással párosul (max. 300 karakter a MALL-ban). Nem párosul, feltéve, hogy az elem megegyezik a PRODUCTNAME elemmel. Ebben az esetben a rövid termékleírás a DESCRIPTION elemből kerül hozzáadásra. |
| LEÍRÁS | Termékleírás tartalmaznia kell a legrelevánsabb termékinformációkat, amelyeket a teljes szöveges keresés során figyelembe vesznek. Nem szerepelhetnek: reklámok, promóciók vagy a webáruház promóciói. A DESCRIPTION elemben szereplő karakterek számát rendszerünk 13-ra érvényesíti. 000 karakter. Ezek azok az alapvető HTML címkék, amelyek egy hosszú leírásban használhatók: <a>, <b>, <br>, <div>, <dl>, <dt>, <em>, <hr>, <i>, <img>, <li>, <ol>, <p>, <strong>, <sub>, <sup>, <table>, <tbody>, <td>, <tfoot>, <th>, <thead>, <tr>, <u>, <ul>. Nem szükséges egyéni stílusokat használni a címkékben, ezek nélkül a szöveg a legjobban alkalmazkodik az oldalainkhoz. Ha a leírásban táblázatok vannak, akkor is hozzá kell adnunk a <table class="“tbl“">hogy a táblázat érzékeny legyen. A videókra és képekre mutató URL-linkek beágyazhatók a hosszú leírásba, és a weboldalon a termék részleteiben is megjelennek. |
| IMGURL | Link a fő/első termékképhez. A kép méretét rendszerünk érvényesíti - max. 2000px x 2000px, min. 100 KB és max. 2 MB. A kép URL címe nem tartalmazhat szóközöket és írásjeleket. Ha megváltoztatja a képet, akkor a kép URL címét is meg kell változtatnia, az URL nem lehet ugyanaz. |
| IMGURL_ALTERNATÍV | Ez az elem nem kötelező, de ha elküldi a feedben, akkor további képeket rajzolunk belőle a termékhez. A képek maximális száma 20. Ha megváltoztatod a képet, akkor a kép URL-jét is meg kell változtatnod, az URL nem lehet ugyanaz. Nem lehetséges duplikált képet (URL vagy tartalom) beilleszteni. |
| ÁR_ÁFA | A termék végső ára ÁFÁ-val. Az ár nem tartalmazhat jutalékot. Az árat szóközök nélkül kell megadni, ahogy az alábbi képen látható. |
| VAT | Egy opcionális elem, amelyből az áfakulcsot merítjük. Amennyiben ez az elem nincs jelen a feedben, az áfát manuálisan lehet beállítani a portálon minden termékre a Feed státusz-ban. Szükséges azonban, hogy a termékre az országnak megfelelő áfát írjunk, függetlenül attól, hogy áfafizető vagy sem. |
| GYÁRTÓ | A termék gyártóját (márkáját) tartalmazza, amely alapján a MALL-on a címkéket egyeztetjük. A címkékkel kapcsolatos részletesebb utasításokat lásd itt. |
| CATEGORYTEXT | Itt található a termék kategorizálása. Javasoljuk a Heureka kategóriafa használatát, a párosítás automatikusan megtörténik. A Heureka-fa itt található: https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml. Egyébként a kategóriák manuálisan is párosíthatók a partnerportálon, további információkért lásd itt. |
| EAN | Nem kötelező elem a Heureka XML-táplálékban, amely a termék EAN-számával van összevetve. A rendszer csak 13 numerikus karaktert fogad el. Nálunk az EAN-ek kötelezőek, és a termékekkel együtt kell elküldeni őket. Ha az EAN 14 numerikus karakterből áll, 13 számjegyűként adja meg, az elején lévő 0 nélkül. Ha rövidebb, 8 számjegyű EAN kódja van, akkor annyi 0-t adjon az elejére, ahány 0 hiányzik a 13 karakterből. Az EAN kódokról további információt itt talál: https://knowledgebase.mallgroup.com/ean-povinnym-atributem-pro-produkty/. |
| PARAM | Választható elem, amelyet aztán a portálon a paramétereinkhez párosíthatunk. A paraméter numerikus értékeinek helyes megjelenítéséhez az értékeket vesszővel kell kitölteni, nem pedig ponttal (pl. 0,5). Variált termék létrehozása esetén ez az elem kötelező. A részletesebb útmutatásért lásd itt. |
| DELIVERY_DATE | Egy opcionális elem, amely a Szállítási késedelem termékszintű párosításunkhoz párosul. Ebben az esetben a Szállítási késedelem beállítása nem jelenik meg a szállításban, és a rendszer a termékszintű beállítást helyezi előtérbe. A helyes megfeleltetéshez legfeljebb két számjegyű egész számokra van szükség. |
| ITEMGROUP_ID | A változatokhoz szükséges kötelező elem, amely alapján rendszerünk felismeri a termékváltozatot. Nem lehet azonos az ITEM_ID-vel. Max. 36 karakterből álló kombináció, a megengedett karakterek: _ - 0-9 a-z A-Z A-Z (aláhúzások, kötőjelek, számok nullától kilencig, nagy- és kisbetűk diakritika nélkül). |

Elérhetőség Heureka XML feed
| item_list | Root elem, csak egyszer szerepel a fájlban. |
| tétel | Egy adott termék elérhetőségére vonatkozó információkat tartalmaz, annyi alkalommal szerepel a fájlban, ahány elérhető terméke vagy változata van a partnernek. |
| tétel azonosító | Egy adott terméket azonosít. Az értéknek meg kell egyeznie a termék elemének értékével a termék Heureka XML feedjéből. Tehát a termék és a rendelkezésre állási feedekből származó azonosítónak azonosnak kell lennie. |
| stock_quantity | Azonnali szállításra kész darabszám. A megengedett érték egész szám. |

Ha változtatásokat eszközöl a webáruházában (XYZ webáruház vs. Heureka), az körülbelül 2 órán belül megjelenik (rendszeres frissítések). Ezután a változások megjelennek a partnerportálunkon az Ön által beágyazott URL-linken a feed struktúrával.
Hogyan validálhatom a Heureka XML feedet?
A Heureka XML-táplálékhoz a Mergado megfelelő validátort biztosít. Ez a validátor nem veszi figyelembe azokat a speciális követelményeket, amelyeknek a MALL-hoz való sikeres csatlakozáshoz meg kell felelniük, ez csak a Heureka feed általános validálása.
A validátor itt található: https://audit.mergado.com/.
A Heureka utasításait követve közvetlenül is érvényesítheti a rendelkezésre állási adatfolyamot: https://sluzby.heureka.cz/napoveda/dostupnostni-feed/.
Megtekintheti oktató videónkat is.
Ha további kérdései vannak, kapcsolatba léphet velünk a következő elérhetőségeken keresztül Súgóközpontban (Help Center).