Treningers XML termék feed leírás

Mi az az XML Feed?

Egy XML feed egy strukturált adatfájl, amelyet a weboldalak és alkalmazások használnak információk cseréjére. Ez a fájl XML formátumban van, amely egy olyan szabvány, amit számítógépek könnyen olvasnak és értelmeznek. Az XML feed tartalmazza az adatokat egy meghatározott formátumban, például termékek adatait, és lehetővé teszi, hogy ezek az adatok automatikusan frissüljenek és megjelenjenek a weboldalakon vagy más rendszerekben.

Miért kell nekünk a webshopod XML feedje?

Azért van szükség az XML feedre a Treningersre kerüléshez, mert ez biztosítja, hogy a termékinformációk automatikusan, pontosan és naprakészen jelenjenek meg a weboldalunkon. Az XML feed segítségével könnyedén integrálhatjuk a partnerek adatait, és a termékek részletei, ára, elérhetősége mindig friss lesz. Ezáltal jobb vásárlói élményt nyújtunk, és időt takarítunk meg a manuális adatrögzítés helyett.

Fontos tudnivalók

01
Az ITEM_ID egyedi legyen minden termékhez.
02
Azonos ITEMGROUP_ID a variánsoknak.
03
Adj pontos termékneveket a NAME mezőben.
04
A DESCRIPTION legyen informatív, szükség esetén használj CDATA-t.
05
Az URL-ek és IMGURL-ek működő webcímek legyenek.
06
A PRICE_VAT és SALE_PRICE_VAT formátuma legyen helyes.
07
GTIN egyedi minden termékváltozatra.
08
Használd a PARAM mezőt részletes termékinformációkhoz.
09
A DELIVERY_DATE pontos szállítási időt adjon meg.
10
Adj meg releváns CATEGORY információkat.

Treningers feed részei

Termék feed példa

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
	<SHOPITEM>
    <ITEM_ID>0001</ITEM_ID>
    <ITEMGROUP_ID>1</ITEMGROUP_ID>
    <NAME>Rider Női papucs</NAME>
    <DESCRIPTION>&lt;![CDATA[Rider Pool női papucs pink színben fix kivitel Braziliából. Soft Dry Foam párnázott, vízlepergető talppal. A szokásosnál egy mérettel nagyobb terméket ajánlott választani!]]&gt;</DESCRIPTION>
    <URL>http://example.com</URL>
    <URL_VARIANT>http://example.com/variant</URL_VARIANT>
    <IMGURL>http://example.com/img1.webp</IMGURL>
    <IMGURL_ALTERNATIVE>http://example.com/img2.webp</IMGURL_ALTERNATIVE>
    <IMGURL_ALTERNATIVE>http://example.com/img3.webp</IMGURL_ALTERNATIVE>
    <PRICE_VAT>8990</PRICE_VAT>
    <SALE_PRICE_VAT>6500</SALE_PRICE_VAT>
    <CATEGORY>&lt;![CDATA[Footwear]]&gt;</CATEGORY>
    <PARAM>
        <PARAM_NAME>Brand</PARAM_NAME>
        <VAL>Rider</VAL>
    </PARAM>
    <PARAM>
        <PARAM_NAME>Szín</PARAM_NAME>
        <VAL>pink</VAL>
    </PARAM>
    <PARAM>
        <PARAM_NAME>Méret</PARAM_NAME>
        <VAL>30</VAL>
    </PARAM>
    <DELIVERY_DATE>4</DELIVERY_DATE>
    <DELIVERY>
        <DELIVERY_NAME>Magyar Posta</DELIVERY_NAME>
        <DELIVERY_PRICE>1290</DELIVERY_PRICE>
        <DELIVERY_PRICE_COD>2000</DELIVERY_PRICE_COD>
    </DELIVERY>
    <DELIVERY>
        <DELIVERY_NAME>GLS</DELIVERY_NAME>
        <DELIVERY_PRICE>1390</DELIVERY_PRICE>
        <DELIVERY_PRICE_COD>2100</DELIVERY_PRICE_COD>
    </DELIVERY>
    <GTIN>1b40856096298</GTIN>
  </SHOPITEM>
</SHOP>

Gyakori hibák

Speciális karakterek használata

A speciális karaktereket, mint például az & és < szimbólumokat, megfelelően kell kódolni az XML-ben. Ezeket a karaktereket & és < formában kell megadni, vagy használj CDATA szekciókat, hogy elkerüld az XML elemzés során fellépő hibákat.
Helytelen
<NAME>Jack & Jones</NAME>
Helyes
<NAME>Jack &amp; Jones</NAME>
<NAME><![CDATA[Jack & Jones]]></NAME>

Nem párosított tagok

Az XML elemeknek mindig párosított nyitó és záró tagekkel kell rendelkezniük. Ha egy elem nyitó tagja nincs megfelelően lezárva, akkor az XML érvénytelen lesz, és nem lehet megfelelően feldolgozni.
Helytelen
<NAME>Adidas Superstar II
Helyes
<NAME>Adidas Superstar II</NAME>

Hiányzó kötelező mezők

Bizonyos mezők, mint például az ITEM_ID, NAME, PRICE_VAT, kötelezőek minden terméknél. Ha ezek hiányoznak, a termék nem kerül be a rendszerbe, vagy nem jelenik meg megfelelően.
Helytelen
<SHOPITEM><PRICE_VAT>8990</PRICE_VAT></SHOPITEM>
Helyes
<SHOPITEM><ITEM_ID>0001</ITEM_ID><NAME>Termék neve</NAME><PRICE_VAT>8990</PRICE_VAT></SHOPITEM>

Helytelen árformátum

Az árat megfelelő formátumban kell megadni, decimális számként, ezres elválasztó nélkül. Ha az ár rosszul van formázva, a rendszer nem tudja helyesen kezelni.
Helytelen
<PRICE_VAT>8,990</PRICE_VAT>
Helyes
<PRICE_VAT>8990</PRICE_VAT>

Nem támogatott HTML használata

A DESCRIPTION mezőben gyakori hiba a HTML tagek használata. Az XML fájlokban a HTML nem mindig megengedett, és a rendszer nem fogja tudni megfelelően feldolgozni. Használj CDATA szekciót a HTML tartalmak védelmére.
Helytelen
<DESCRIPTION><b>Rider papucs</b> női</DESCRIPTION>
Helyes
<DESCRIPTION><![CDATA[<b>Rider papucs</b> női]]></DESCRIPTION>

Üres vagy hiányzó URL mezők

Az URL és IMGURL mezőknek mindig érvényes webcímet kell tartalmazniuk. Ha ezek üresek vagy rossz formátumúak, a vásárlók nem fogják megtalálni a terméket az áruházban.
Helytelen
<URL></URL>
Helyes
<URL>http://example.com/product</URL>

Nem egyértelmű ITEMGROUP_ID használata

Az ITEMGROUP_ID azonosítóval ellátott termékeknek különálló variánsoknak kell lenniük (pl. szín vagy méret). Ha ugyanazt az ITEMGROUP_ID-t több, különböző terméknél használod, akkor azok összekeverednek a rendszerben.
Helytelen
<ITEMGROUP_ID>123</ITEMGROUP_ID> <!-- Különböző termékek ugyanazzal az ID-val -->
Helyes
<ITEMGROUP_ID>123</ITEMGROUP_ID> <!-- Csak variánsok ugyanazzal az ID-val -->

Ismétlődő vagy érvénytelen GTIN kód

A GTIN egyedinek kell lennie minden termékváltozat esetében (pl. különböző színek és méretek). Ha ugyanazt a GTIN kódot használod több variáns esetén, akkor hibás termékazonosítás történhet.
Helytelen
<GTIN>1234567890123</GTIN> <!-- Ugyanaz minden variánsnál -->
Helyes
<GTIN>1234567890123</GTIN> <!-- Minden variánsnak egyedi GTIN -->

Helytelen vagy hiányzó kategória információ

A CATEGORY mezőben pontos kategóriát kell megadni. A rossz kategorizálás miatt a termékek nem megfelelő helyen jelennek meg, ami rossz felhasználói élményt eredményezhet.
Helytelen
<CATEGORY><![CDATA[Other]]></CATEGORY>
Helyes
<CATEGORY><![CDATA[Cipők]]></CATEGORY>

Nem létező vagy rossz szállítási információ

A DELIVERY elemekben helyes szállítási lehetőségeket és díjakat kell megadni. Ha a szállítási információk pontatlanok vagy hiányosak, a vásárlók nem kapnak megfelelő tájékoztatást a költségekről és szállítási időkről.
Helytelen
<DELIVERY><DELIVERY_NAME>Posta</DELIVERY_NAME></DELIVERY>
Helyes
<DELIVERY><DELIVERY_NAME>Magyar Posta</DELIVERY_NAME><DELIVERY_PRICE>1290</DELIVERY_PRICE><DELIVERY_PRICE_COD>2000</DELIVERY_PRICE_COD></DELIVERY>