A cikkben részletes információkat talál a termék,- és az elérhetőségi MALL XML feed szerkezetéről, beleértve azokat a szabályokat, amelyeket mindkét feed létrehozásakor be kell tartani.
Fontos általános szabályok:
- Ehhez a kapcsolathoz csak a MALL XML-hírcsatornák működnek az alábbi struktúra szerint.
Más típusú hírcsatornák nem működnek, a rendszer nem tölti be őket. - A MALL XML-táplálékok szerkezete minden ország esetében azonos., csak az olyan adatok, mint a kategóriafák, paraméterek, HÉA-ország változnak az ország nyelvének megfelelően.
- A Heureka feedek nem működnek ezen a kapcsolaton. A MALL XML feed és a Heureka feed teljesen különböző feed típusok, és 2 különböző típusú kapcsolatként kezelik őket. A feedtípusok kombinálása sem lehetséges. Győződjön meg róla, hogy a megfelelő linktípus van beállítva a MALL Partner Portál oldalon. Ha rossz kapcsolattípust állított be, küldjön e-mailt az Onboarding specialistájának.
- A készlet információ nem illeszthető be a termékfeedbe, külön elérhetőségi feedet kell létrehoznia.
- A feedeket online elérhető URL-címekre kell generálni XML formátumban és kizárólag UTF-8 kódolásban. Nem fogadjuk el az FTP vagy FTPS használatát.
- A feedtesztelés közvetlenül a MALL Partner Portálon történik. A létrehozás után az URL-linkeket be kell illeszteni a portál Feeds szakaszába, és el kell indítani a feldolgozást. A feldolgozás eredménye a Statistics lapon található, ahol hibaüzenetek is vannak, amelyeket ki kell javítani. A feedek a portálba való beillesztésére vonatkozó utasítások és a hibaüzenetek megtalálhatók a itt cikkben.
Javasoljuk továbbá, hogy állítson be és kapcsoljon be egy adott intervallumban történő szinkronizációt.
A következő oldalakon részletes leírást talál az XML-feedek két alapvető formájáról.
2. oldal: Terméktáp
3. oldal: Accessibility Feed
Ha további kérdései vannak, kapcsolatba léphet velünk a következő elérhetőségeken keresztül Súgóközpont oldalon keresztül.
Termék hírcsatorna
Az első teendő egy olyan termékcsatorna létrehozása, amely a termékekről minden információt tartalmaz, kivéve azok elérhetőségét.
Fontos szabályok
- Az elemek sorrendje nem kötelező.
- A feed kötelező elemeket tartalmaz, amelyeket mindig a megfelelő értékekkel (value) kell megadni.
A részletesebb utasítások az alábbiakban olvashatók. - Az érték nélküli elemeket a rendszer hibaként értékeli. Kötelező elemek esetén hozzá kell adni az értéket, opcionális elemek esetén el kell távolítani az egész elemet. Üres elemeket sem lehet csak a záró tag használatával elküldeni.
- A raktáron nem elérhető termékeket benne kell tartani a termékfeedben. A weboldalon való megjelenítésüket a Elérhetőségi feedsegítségével tudja beállítani . A termék deaktiválásával kapcsolatos részletesebb információkért kérjük, olvassa el a következőt itt.
- Minden kategóriát egy egyedi azonosító azonosít. A kategorikus feltételek tartalmazhatnak kötelező elemeket is, amelyeket pontos értékekkel kell beilleszteni a feedbe.
A kategóriafa exportját a kategorikus feltételekkel együtt letöltheti itt, vagy a MALL partnerportálon a Kategóriák részben is kereshet kategóriát.
A kategóriák, a rendezési paraméterek és értékeik részletesebb leírását lásd itt.
A rendezési feltételek helyességét a rendszer nem ellenőrzi. A hibás vagy hiányzó kategorikus feltételekkel rendelkező termék nem jelenik meg az oldalon. A megjelenítés helyessége ellenőrizhető a Account Sandboxban. - Gondoskodni kell arról, hogy az esetleges termékváltozatok csoportjainak létrehozása, pl. egy póló 10 színváltozatban és 5 méretben egy termékcsoportként/változati termékként szükséges.. A termékváltozat létrehozásának 3 kulcsfontosságú eleme van: ITEMGROUP_ID, ITEMGROUP_TITLE és VARIABLE_PARAMS. Mindezek az elemek kötelezőek a termékváltozatok létrehozásához. Ezen elemek részletesebb leírása az alábbiakban található.
- A rendszer mindig elemenként ellenőrzi a termékeket, amíg hibát nem talál a termékadatokban. Ha igen, akkor a termék hibajegyzőkönyvi bejegyzést vált ki, és a rendszer továbblép a következő termék ellenőrzésére. Tehát ha egy adott termékben 1-nél több hiba van, azt nem lehet észlelni az első lejátszáskor.
Itt letölthet mintatermékeket .xml formátumban.
- Nem variáns termék minden elemmel
- Nem variáns termék, csak kötelező elemekkel
- Nem variáns termék energiacímkével és adatlappal
- Termékváltozat minden elemmel
- MALL XML FEED minta az összes példával
A termékfeed elemeinek leírása
| ITEMS kötelező elem | Az XML-fájl gyökéreleme. Csak egyszer szerepel a takarmányban. | |
| ITEM kötelező elem | Információkat tartalmaz egy adott termékről vagy változatról. | |
| ID kötelező elem | Termék azonosító vagy változat. Itt adja meg a termékkódját, amelyet aztán például a rendelésekbe is beírnak. Minden azonosítónak egyedinek kell lennie. Nem lehet azonos az ITEMGROUP_ID azonosítóval. Legfeljebb 50 karakterből álló kombinációk, megengedett karakterek: _ - 0-9 a-z A-Z A-Z (aláhúzás, kötőjel, nullától kilencig szám, kis- és nagybetű ékezet nélkül). | |
| SZÍNHÁZ kötelező elem | Meghatározza, hogy a termék látható-e online. A live/draft értékeket veszi fel. A megvalósítási szakaszban (TESTING) mindig a draft értéket kell elküldeni, az élő értéket a rendszer hibaként értékelné. Ebben a fázisban nincs lehetőség élő érték beállítására. A termékek élőre váltása csak a termék megjelenéseés az összes beállítás végrehajtása után történik. Az Önért felelős Onboarding specialista az ellenőrzést követően átállítja a fiókját a végső szakaszba - PRODUCTION - státuszba. Ezután értesítést kap arról, hogy a termékeket a termékek élőre (LIVE állapotba) kapcsolhatók.A termékek ezután láthatóvá válnak az oldalon. Az élő (LIVE) érték nem állítható vissza a draft állapotába. Egy termék deaktiválásához használja az itt leírt módszerek egyikét. | |
| ITEMGROUP_ID kötelező elem a változatokhoz | Ha variánsról van szó, ez az elem a variánscsoport azonosítóját jelzi. Az ITEMGROUP_ID-nek egyedinek kell lennie, és nem lehet azonos az ID elemmel. Legfeljebb 50 karakterből álló kombinációk, megengedett karakterek: _ - 0-9 a-z A-Z (aláhúzás, kötőjel, nullától kilencig szám, kis- és nagybetű ékezet nélkül). CSAK VARIÁNS TERMÉKEKRE KÖTELEZŐ ELEMEK | |
| ITEMGROUP_TITLE kötelező elem a változatokhoz | Ha ez egy változat, a mező az alaptermék címét jelzi. Az értéknek a változatcsoport általános nevét kell tartalmaznia, az egyes változatok jellemzői nélkül (például szín, méret, ... nélkül). CSAK VARIÁNS TERMÉKEKRE KÖTELEZŐ ELEMEK. | |
| CATEGORY_ID kötelező elem | Kategória azonosító A kategóriakódnak mindig tartalmaznia kell a kategóriafánknak megfelelő kategóriakódot arra az országra vonatkozóan, ahol a termékeket bevezetik. Az egyes országok kategóriafái eltérőek lehetnek. Ezeken kívül a kategóriafeltételek tartalmazhatnak kötelező elemeket, a kategória azonosítója nem biztos, hogy elegendő a termék helyes megjelenítéséhez. Mindig ellenőrizze az egyes kategóriák kategóriafeltételeit. | |
| BRAND_ID kötelező elem | Márka azonosító Mindig tartalmaznia kell a márkakódot vagy a BRAND ID-t. A márkakód nem azonos a tényleges márkanévvel. A márkaazonosítót a MALL Partner Portálon a következő menüpontban találja meg Brands . Ha az Ön márkája még nem létezik a rendszerünkben, hozzon létre egy létrehozási kérelmet az utasítások szerint itt. | |
| TITLE kötelező elem | Termék neve/változatai Nem tartalmazhatja a márkanevet, mert a márka automatikusan a BRAND_ID elem első pozíciójában kerül a webhelyre. A maximális hosszúság 200 karakter. Tartalmaznia kell a kulcsszavakat és ha ez egy változat van, akkor annak specifikációját (például színét). Különleges karakterek nem engedélyezettek. | |
| SHORTDESC kötelező elem | Rövid termékleírás Nem tartalmazhat formázást és HTML-karaktereket, csak teljes mondatokat. A maximális hosszúság 300 karakter. A weboldalon a terméklistában megjelenik egy rövid leírás, amelynek röviden be kell mutatnia a terméket. | |
| LONGDESC kötelező elem | Hosszú termékleírás Alapvető HTML-címkéket tartalmazhat, és a maximális hossza 13000 karakter. A termék részletesebb leírását kell tartalmaznia. 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. | |
| PRIORITÁSOK kötelező elem | Töltse ki az 1 értéket a mezőben értéket. A rendszer automatikusan rangsorolja a termékeket egy algoritmus segítségével, amely az adott termék kattintásainak, forgalmának és eladásainak száma alapján működik. Ez egy elavult elem, amelyet még ki kell tölteni, de egyáltalán nem veszik figyelembe. Jelenleg azon dolgozunk, hogy eltávolítsuk. | |
| PACKAGE_SIZE kötelező elem | Az smallbox/bigbox és jelzi a csomag méretét. Ez az elem párosítja a terméket és a szállítást, ezért fontos, hogy a szintén a megfelelő szállításon alapul. A Smallboxnak 3 feltételnek kell megfelelnie - a csomagolás mindhárom oldalának összege 175 cm-ig - najdłuższy bok paczki nie więcej niż 100 cm - a csomag tömege legfeljebb 20 kg A Bigbox minden olyan csomag, amely nem felel meg a fentieknek. | |
| BARCODE kötelező elem | A termék EAN kódja kötelező. . A rendszer 13 numerikus karaktert fogad el. Ha az EAN 14 numerikus karakterből áll, akkor 13 számjegyként adja meg, az elején lévő 0 nélkül. Ha rövidebb, 8 számjegyű EAN-kódja van, adjon hozzá annyi 0-t az elejére, amennyi a 13 karakterből hiányzik. | |
| ÁRA kötelező elem | A termék ára tartalmazza az országspecifikus ÁFA-t. Az ár nem tartalmazhat jutalékot. | |
| HÉA kötelező elem | ÁFA egész számmal (pl. 21). Az ÁFA-nak meg kell felelnie a termékek végrehajtásának helye szerinti országban alkalmazandó adókulcsoknak. | |
| RRP kötelező elem | Ajánlott kiskereskedelmi ár V zemích mimo CZ jako oddělovač částek používejte tečku „.“. | |
| PARAM kötelező elem | Termékparaméterek Itt csak a rendszerünkben az adott kategóriához meghatározott paraméterek és értékek kerülnek beírásra. Az egyes kategóriák paramétereivel kapcsolatos részletes információk az alábbi szakaszban találhatók Kategóriák a MALL Partner Portálon. | |
| PARAM kötelező elem | NÉV | Paraméter azonosító A paraméter nevét nem szabad használni, csak az azonosítóját, amely angol nyelven van (pl. COLOR).. |
| PARAM kötelező elem | ÉRTÉK | A paraméter értéke, amelyeknek mindig a helyi nyelven és pontosan meghatározott szöveggel kell készülniük. (např. „červená“). |
| VARIABLE_PARAMS kötelező elem a változatokhoz | Meghatározza azokat a paramétereket, amelyek alapján a rendszernek változatokat kell létrehoznia. Maximum 2 lehet (pl. méret "SIZE" és szín "COLOR"). ELEMÉNY KIZÁRÓLAG A VÁLTOZÓ TERMÉKEKHOZ SZÜKSÉGES. | |
| VARIABLE_PARAMS kötelező elem a változatokhoz | PARAM | A változó paraméter azonosítója (pl. COLOR). Nem a paraméter neve, hanem az azonosítója kerül ide. Kizárólag a VARIANT TERMÉKEKNEK SZÜKSÉGES ELEMZŐ. |
| MEDIA kötelező elem | Termékképek/variánsok. A képek maximális száma 20, és a képeknek fehér háttérrel/nem háttérrel, logók, vízjelek vagy matricák nélkül kell készülniük. A termék megjelenési követelményeiről bővebben lásd itt. Duplikált képek (URL vagy tartalom) nem illeszthetők be. | |
| MEDIA kötelező elem | URL | Kép URL A kép URL címe legfeljebb 200 karakter lehet, ékezetek és szóközök nélkül. A kép maximális mérete 2MB, felbontása pedig 2000px x 2000px. A minimális méret 100KB. A kép megváltoztatásakor az URL-t is módosítani kell. |
| MEDIA kötelező elem | MAIN | Az igaz/hamis érték azt jelzi, hogy ez a fő kép-e. Csak egy MEDIA elem tartalmazhat true értéket. |
| MEDIA kötelező elem | A Energiacímke is beillesztésre kerül a médiába. Vigyázzon, hogy a példában szereplő összes elemet használja, különben a teljes terméktáplálás letiltásra kerül. Kizárólag olyan termékek esetében kötelező, amelyeknél jogszabályi okokból kötelező az energiacímke. | |
| MEDIA kötelező elem | URL | Energiacímke URL Mindössze 200 karakter vagy annál kevesebb, ékezetek és szóközök nélkül. A kép maximális mérete 2 MB, felbontása pedig 2000px x 2000px. A minimális méret 100KB. Változás esetén az URL-t is módosítani kell. |
| MEDIA kötelező elem | MAIN | mindig töltse ki a FALSE értéket |
| MEDIA kötelező elem | ENERGY_LABEL | mindig TRUE kitöltése |
| MEDIA kötelező elem | INFORMATION_LIST | mindig töltse ki a FALSE értéket |
| MEDIA kötelező elem | A média a következőket is tartalmazza Tájékoztató. Ügyeljünk arra, hogy a példában szereplő összes elemet használjuk, különben az egész terméktovábbítás le fog tiltódni. Csak olyan termékek esetében kötelező, amelyek esetében jogszabályi okokból adatlapot kell készíteni. | |
| MEDIA kötelező elem | URL | Tájékoztató URL Az URL-nek legfeljebb 200 karakterből kell állnia, ékezetek és szóközök nélkül. A kép maximális mérete 2 MB, felbontása pedig 2000px x 2000px. Minimális méret 100KB. Módosítás esetén az URL-t is módosítani kell. |
| MEDIA kötelező elem | MAIN | mindig töltse ki a FALSE értéket |
| MEDIA kötelező elem | ENERGY_LABEL | mindig töltse ki a FALSE értéket |
| MEDIA kötelező elem | INFORMATION_LIST | mindig TRUE kitöltése |
| PROMOTION opcionális elem | A termék promóciós árát jelzi. Az akciós ár részletesebb leírása a következő oldalon található itt. | |
| PROMOTION opcionális elem | ÁRA | Áfás kedvezményes ár. |
| PROMOTION opcionális elem | FROM | Az ár érvényessége tól (formátumban 2022-03-20T13:00:00:00) |
| PROMOTION opcionális elem | TO | Ár érvényes míg (formátumban 2022-03-21T13:00:00:00) |
| MÉRETEK opcionális elem | Termékméretek a szállításhoz A DIMENZIÓK hozzáadásakor a táphoz mindig az összes dimenzióelemet meg kell adni a termékek helyes betöltéséhez. Ha például csak a súly dimenziót kell hozzáadni (a Súly szerinti szállítás árazáshoz), akkor a többi dimenzióhoz 0-t kell beírni. | |
| MÉRETEK opcionális elem | SÚLY | Súly kg-ban |
| MÉRETEK opcionális elem | SZÉLESSÉG | Szélesség cm-ben |
| MÉRETEK opcionális elem | MAGASSÁG | Magasság cm-ben |
| MÉRETEK opcionális elem | HOSSZÚSÁG | Hossza cm-ben |
| LABEL opcionális elem | A használható címkék itt találhatók. A címkék száma termékenként nem korlátozott, de nem lehet 2 ugyanolyan. | |
| LABEL opcionális elem | NÉV | Címkeazonosító A FDEL (ingyenes szállítás), NEW (új) és SALE (eladás) alapcímkék használhatók. Bármely más címke csak a kereskedővel való előzetes egyeztetés után használható. |
| LABEL opcionális elem | FROM | A címke érvényességi ideje tól (2022-03-20T13:00:00) |
| LABEL opcionális elem | TO | A címke érvényességi ideje míg (2022-03-21T13:00:00:00) |
| DELIVERY_DELAY kötelező elem | Megadja a termék kiszállításához szükséges teljes munkanapok számát. Az értéknek egész számnak kell lennie. Az információ a teljes portfólióra vonatkozóan is beállítható a MALL partnerportál Szállítás részében. A szállítási késleltetés beállítása a terméken felülírja a szállításban megadott beállítást. A 0 érték azt jelenti, hogy az adatokat a szállítási beállításokból vesszük át. A szállítási késedelem szállítási és termék vagy változat értékeit nem adjuk hozzá. |
Ha további kérdései vannak, kapcsolatba léphet velünk a következő elérhetőségeken keresztül Súgóközpont oldalon keresztül.
Rendelkezésre állási takarmány
A termék elérhetőségének beállításai ugyanazok, mint a terméktáplálásé, de az XML-fájl szerkezete eltérő.
Fontos szabályok
- Az elérhetőségi feed URL mezője nem tartalmazhatja ugyanazt a linket, mint a termék feed.
- A rendelkezésre állási takarmány mindig különálló, és saját kötelező struktúrával rendelkezik.
- A takarmány minden eleme kötelező.
- Az elemek sorrendje nem kötelező.
- Ha vannak változatos termékek a terméktáplálásban, mindig a változat azonosítójára kell küldenie a rendelkezésre állást, soha nem az ITEMGROUP_ID-re.
- A termékek törlése az elérhetőségi feedből nem érvényes módja a termékek deaktiválásának.
A termék deaktiválásával kapcsolatos részletesebb információkért lásd itt. - Az a termék, amely létezik a terméktáplálékban, de amelynek nincs megfelelője a rendelkezésre állási tápban, a rendszerben marad a legutóbb játszott információval.
- A változat és a változatlan termék elérhetőségének jelzése megegyezik.
- A készleten lévő darabszám legfeljebb 9 999 darab.
- Javasoljuk, hogy mindig tényleges készletet idézzen. A megrendelésre gyártott áruk esetében javasoljuk, hogy a rendelkezésre állásként azt a maximális darabszámot adja meg, amelyet egy rendelésen belül meg tud rendelni.
- A rendelkezésre állási számot csak egész számokban lehet megadni, minden más szám hibaként értékelődik ki, és a rendelkezésre állás nem kerül lejátszásra.
FIGYELMEZTETÉS:
Ha Ön BEJELENTKEZIK, és fiókja még nem lett aktiválva, az AKTÍV mezőnek mindig az "true" értéket kell tartalmaznia..
Itt letölthet egy mintát a rendelkezésre állási adatokról .xml formátumban.
A rendelkezésre álló takarmányelemek leírása
| ELÉRHETŐSÉGEK | XML gyökérelem (csak egyszer fordul elő a takarmányban). |
| ELÉRHETŐSÉG | Az egyes termékek és változatok elérhetőségét jelző elem. |
| ID | ID produktu/varianty. Musí být totožné s ID které uvádíte v produktovém feedu. |
| IN_STOCK | Raktáron lévő tételek száma, ha a raktáron lévő tételek száma 0, kérjük, tartsa a terméket a takarmányban, akkor elérhetetlennek fog megjelenni. Mindig teljes számban kell feltüntetni. |
| AKTÍV | A true/false értékeket veszi fel, a készleten lévő termék deaktiválására szolgál. A termék deaktiválásával kapcsolatos részletesebb információkért lásd itt. A termék/variáns megjelenítéséhez az oldalon az ACTIVE elemnek is true értéket kell adnia. |
Ha további kérdései vannak, kapcsolatba léphet velünk a következő elérhetőségeken keresztül Súgóközpont oldalon keresztül.