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
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.
| 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, amely aztán a rendelésekbe is beíródik. Minden azonosítónak egyedinek kell lennie. Nem lehet azonos az ITEMGROUP_ID-vel. Maximálisan 50 karakter, 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). | |
| STAGE kötelező elem | Meghatározza, hogy a termék látható-e online. A live/draft értékeket veszi fel. Az megvalósításaz ffázisban (TESZTELÉS) mindig a draftértéket kellküldeni, az élő értéket a rendszer hibaként értékelné. Az éles érték ebben a fázisban nem állítható be. A termékek élesre váltása csak a termékek sikeres ellenőrzése megjelenése és az összes beállítás elvégzése után történik. Az onboarding szakember az ellenőrzést követően átállítja fiókját a végső szakaszba - PRODUCTION -. Ezután értesítést kap arról, hogy a termékek Éles üzemmódba kapcsolhatók.A termékek ezután láthatóvá válnak az oldalon. Az éles értéket nem lehet visszaállítani vázlat státuszra. Egy termék deaktiválásához használja a 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 | A kategória azonosítónak Mindig tartalmaznia kell a kategória kódját a kategóriafánknak megfelelően az országra vonatkozóan, ahol a termékeket bevezetik. Az országfák eltérőek lehetnek. Ezeken kívül a kategóriafeltételek kötelező elemeket is tartalmazhatnak, a kategóriaazonosító nem biztos, hogy elegendő a termék helyes megjelenítéséhez. Mindig ellenőrizze az egyes kategóriák kategóriafeltételeit.Mindig ellenőrizze a kategóriafeltételeket. | |
| BRAND_ID kötelező elem | A márkaazonosító Mindig tartalmaznia kell a márkakódot vagy a BRAND ID-t. A márkakód nem azonos a márka valódi nevével. A márkaazonosítót a MALL partnerportálon a Brands alatt keresheti. Amennyiben az Ön márkája még nem létezik a rendszerünkben, akkor a itt utasításait követve létrehozhat egy kérelmet. | |
| TITLE kötelező elem | Terméknév/változatok Nem tartalmazhatja a márkanevet, mivel a márka automatikusan a BRAND_ID elem első pozíciójában kerül az oldalra. A maximális maximális d hossza 200 karakter. Meg kell tartalmaznia kulcsszavak és ha ez egy változat, akkor annak specifikációját is (például szín). Nem engedélyezettek különleges karakterek. Nem engedélyezettek különleges karakterek.</strong | |
| SHORTDESC kötelező elem | Rövid termékleírás Nem tartalmazhat formázási és HTML karaktereket, csak teljes mondatokat. A maximális hosszúság 300 karakter. A rövid leírás a weboldalon a terméklistában jelenik meg, ezért 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. | |
| PRIORITY 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 | A smallbox/bigbox értékeit veszi fel, és a csomag méretét jelzi. Ez az elem párosítja a terméket a szállítással, ezért dleletolivee mto megfelelő szállítást is létrehozott. A kisdoboznak 3 feltételnek kell megfelelnie - a csomag mindhárom oldalának összege legfeljebb 175 cm - a csomag leghosszabb oldala legfeljebb 100 cm - a csomag súlya legfeljebb 20 kg Nagydoboz minden olyan csomag, amely nem felel meg a fentieknek. | |
| BARCODE kötelező elem | A termék OEM kódja kötelező. A rendszer 13 numerikus karaktert fogad el. Ha az EAN-kód 14 numerikus karakterből áll, akkor 13 számjegyűként adja meg, 0 nélkül az elején. Ha rövidebb, 8 számjegyű EAN-je van, akkor annyi 0-t adjon az elejére, ahány 0 hiányzik a 13 karakterből. | |
| PRICE kötelező elem | A termék ára az országspecifikus ÁFA-t tartalmazza. Az ár nem tartalmazhat jutalékot. | |
| VAT kötelező elem | A héának meg kell felelnie a termékek végrehajtásának helye szerinti országban alkalmazandó adókulcsoknak. | |
| RRP kötelező elem | Ajánlott bolti ár MÁR NEM KÖTELEZŐ ELEM, KIHAGYHATÓ. Csehországon kívüli országokban a "." pontot használja elválasztójelként. | |
| PARAM kötelező elem | Termékparaméterek Kizárólag a rendszerben a kategóriához meghatározott paraméterek és értékek kerülnek ide. Az egyes kategóriák paramétereivel kapcsolatos részletes információk a MALL partnerportál Kategóriák részében találhatók. | |
| PARAM kötelező elem | NAME | Paraméter azonosító A paraméter nevét nem szabad használni, hanem az azonosítóját, amely angol nyelven (pl. COLOR).. |
| PARAM kötelező elem | VALUE | Olyan paraméterérték, amelynek mindig egy lokális nyelven és egy pontosanmeghatározott hangon kell lennie (pl. "piros"). |
| 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 "MÉRET" és szín "SZÍN"). KIZÁRÓLAG VÁLTOZÓ TERMÉKEKNEK SZÜKSÉGES ELEGMENTUM. | |
| 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 | Az Energiabélyegző szintén bekerül a médiába. Az ppélda összes elemének használatára figyelni kell, aellentétes esetbenaz egészterméktáplálékleépül. Kizárólag azon termékek esetében kötelező, amelyekhez jogszabályi okokból energiaszükséges. | |
| 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 hordozóba egy Tájékoztató lap is be van helyezve. Az ppélda összes elemének használatára figyelni kell, aellenkező esetbenaz egésztermékadagolás hibásan működik. Kizárólag olyan termékek esetében kötelező, amelyeknéljogszabályi okokbólaz információ csak uvlapokadásátkövetelik meg. | |
| 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 | PRICE | Á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) |
| DIMENSIONS kötelező 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), a többi dimenzióhoz írjon be 0 értéket. | |
| DIMENSIONS kötelező elem | WEIGHT | Súly kg-ban |
| DIMENSIONS kötelező elem | WIDTH | Szélesség cm-ben |
| DIMENSIONS kötelező elem | HEIGHT | Magasság cm-ben |
| DIMENSIONS kötelező elem | LENGTH | Hossza cm-ben |
| LABEL opcionális elem | A használható címkék itt találhatók. A termékenkénti címkék száma nem korlátozott, de nem lehet 2 ugyanolyan. | |
| LABEL opcionális elem | NAME | 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 | 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ésleltetés szállítási és a terméken vagy változaton lévő értékek nem adódnak össze. | |
| TARIC_CODE kötelező elem | A terméknek megfelelő Kombinált Nómenklatúra (KN) kód. Ezek a kódok kulcsfontosságúak a vámáru-nyilatkozatokhoz az EU-n belüli, illetve az EU-ba irányuló vagy onnan kiinduló áruk behozatala vagy kivitele esetén. Ha nem biztos a helyes kódban, javasoljuk, hogy használja az EU hivatalos KN-adatbázisát, vagy forduljon vámszakértőhöz. A rendszer a KN-kód 8 numerikus karakterét fogadja el. |
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 | Termék azonosító/változatok. Meg kell egyeznie a termékadatban megadott azonosítóval. |
| 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.