Termékek importálása
A termékek importálása megkönnyíti az új termékek webáruházba történő felvitelével kapcsolatos munkát. Ha például 1 000 tételt szeretne feltölteni a webáruházba, a tételek egyenkénti felvitele nagyon sok időt venne igénybe. Lehet, hogy a termékek importálása bonyolultnak tűnik, de az első feltöltés után rájön majd arra, hogy ez egyáltalán nem bonyolult.
A következő útmutatóban az importálás helyes beállításához szükséges minden egyes lépés bemutatásra kerül. Megismerkedhet a Shoptet rendszeréhez engedélyezett jelekkel. Azt is megtudhatja, hogy hogyan készítheti el a mintát az importáláshoz.
Amennyiben még több információt szeretne tudni az adatok rendszeres, például a beszállítóktól történő importálásáról, olvassa el a Termékek automatikus importálása cikket.
A termékek importálását a webáruház adminisztrátorában a Termékek → Importálás könyvjelző alatt találja. A termékeket XLSX, CSV vagy XML formátumú fájlból importálhatja. A fájlnak Windows-1250 (CP-1250) vagy UTF-8 kódolásúnak kell lennie. Az XLS formátum nem támogatott.
Mi az XLSX formátumban történő importálást mutatjuk be. Használatával egy sor utólagos beállítás elhagyható. Amire szüksége lesz, az egy XLSX formátumot támogató, azaz Microsoft Excel, Google Táblázat vagy Libre Office (ingyenes) szoftver.
Az importálás új verziója
Fokozatosan átállunk a termékimportálás új verziójára. A fájlformátumok, az oszlopnevek és az importálás beállításai nem változnak – az változik, ahogy az importálás a fájl tartalmát kezeli. A legfontosabb változás az, hogy az üres cella többé nem azt jelenti, hogy „töröld ezt az értéket", hanem azt, hogy „ne változtasd meg ezt az értéket".
Az új verziót fokozatosan kapcsoljuk be a webáruházaknál, így az ön webáruházához nem feltétlenül ugyanakkor érkezik meg, mint a többihez. Addig az importálás változatlanul működik. A változás a fájl kézi feltöltését és az automatikus importálást egyaránt érinti.
Honnan tudom, hogy engem is érint-e már a változás
Azoknál a webáruházaknál, amelyek már az új verziót használják, az importálás beállításainál (Termékek → Importálás) és az automatikus importálás részleteinél megjelenik ez a lehetőség: Az importban lévő üres értékek törlik az adatokat a webáruházban. Ha látja, a webáruháza már az új verziót használja.
A lehetőség alapértelmezetten ki van kapcsolva, így az üres értékek kimaradnak. Kézi importálásnál mindig csak egy fájlfeltöltésre vonatkozik. Automatikus importálásnál a profilhoz mentődik, és minden további feedletöltésnél érvényes.
Ez a lehetőség csak azoknál a webáruházaknál jelenik meg, amelyek már az új verziót használják. Ha a saját webáruházában nem látja, az még a korábbi importálási verziót használja. Az alábbi javaslatok mindkét verzióra érvényesek, így azokat mindenképpen követheti.
Mi változik az új verzióban
| Helyzet | Korábbi verzió | Új verzió |
|---|---|---|
| Az üres értékek többé nem törlődnek | ||
| Üres cella az oszlopban | Törölte az értéket a webáruházban | Meglévő terméknél nem változtatja meg az értéket, újnál a termék enélkül jön létre |
| Üres tag az XML-ben | Kézi feltöltésnél a termék hibával zárult, egyes mezőknél törölte az értéket | A rendszer figyelmen kívül hagyja, az érték megmarad |
| Üres mértékegység (unit) | Az alapértelmezett „db" értéket állította be | Meghagyja a változat meglévő mértékegységét |
| A nulla és az üres érték már nem ugyanaz | ||
| Nulla az árban (0) | „Nincs ár" értékként mentődött, nem különbözött az üres cellától | A 0 nulla árat jelent |
| Üres ár meglévő terméknél | Törölte az árat | Nem változtatja meg az árat |
| Üres ár új terméknél | A termék ár nélkül jött létre. Ha az ároszlop teljesen hiányzott a fájlból, egyáltalán nem jött létre | A termék ár nélkül jön létre |
| Árak exportálása | A nullát és az üres értéket egyformán exportálta | 0-t vagy üres értéket exportál aszerint, hogy mi szerepel a webáruházban |
| Új ellenőrzések, a legsúlyosabbtól kezdve | ||
| Túl hosszú szöveg | CSV és XLSX esetén nem volt ellenőrzés, csendben levágta | Az importálás hibával leáll |
| Másik termékhez tartozó kód vagy EAN | Az importálás felcserélte a kódokat a termékek között | A termék kimarad, az okot a napló tartalmazza |
| Nem létező kategóriaazonosító az összehasonlítónál | Nem volt ellenőrzés | A termék kimarad, az okot a napló tartalmazza |
| Hivatkozás nem létező árlistára | Nem volt ellenőrzés | Az importálás jelzi |
| Negatív ár, 0–100 % tartományon kívüli kedvezmény | Nem volt ellenőrzés | Az importálás jelzi |
| Sebesség | ||
| Változatlan termékek | Minden alkalommal felülíródtak | Nem íródnak felül, az importálás gyorsabb |
Az importálás 100 termékes kötegekben dolgozza fel a fájlt, és minden köteget folyamatosan ment. Ha az importálás hiba miatt leáll, a már mentett kötegek termékei a webáruházban maradnak, a fájl többi része pedig nem kerül importálásra. A katalógus így félkész állapotban marad. Ilyen esetben javítsa ki a fájlt, és töltse fel újra.
Ezért azt javasoljuk, hogy a webáruháza új verzióra való átállítása utáni első importálást kisebb fájlon vagy csúcsidőn kívül végezze el.
Készítse elő a fájlt úgy, hogy mindkét verzióval működjön
Az alábbi javaslatok attól függetlenül érvényesek, hogy a webáruháza melyik importálási verziót használja:
- Ne használja az üres cellát törlésre. A korábbi verzióban törölte az értéket, az újban kimarad. Ha értékeket szeretne tömegesen törölni, használja az adminisztráció tömeges módosítás funkcióját – az mindkét verzióban működik.
- Az XML feed üres tagjára se támaszkodjon, ugyanúgy viselkedik, mint az üres cella.
- Ellenőrizze a szövegek hosszát a Jelek és szabályok táblázata Megengedett értékek oszlopában szereplő korlátokhoz képest. A korábbi verzióban a túl hosszú szöveget CSV és XLSX esetén csendben levágta, az új verzióban az importálás leáll.
- Az árakban a nullát hagyja 0-ként, ne üres cellaként. Az új verzió megkülönbözteti a 0-t és az üres cellát: a 0 nulla árat jelent, az üres cella pedig azt, hogy „ne változtasd".
Mintafájl létrehozása az importáláshoz
Amennyiben a termék egyes tulajdonságainak exportálás és importálás segítségével történő módosítására van szüksége, használja a Termékek exportálása bejegyzésben található részletes útmutatót. Teljes exportálást csak abban az esetben alkalmazzon, ha teljesen új termékek nagy mennyiségét viszi fel a webáruházba. Kerülje azokat a helyzeteket, amikor tévedésből már létező terméket változtatna meg.
Használatát csak teljesen új webáruház termékekkel történő feltöltése során javasoljuk.
Az elkövetkező importáláshoz mintaként a termékek közvetlenül a Shoptet adminisztrációból történő exportálását alkalmazzuk. Megmutatjuk, hogyan lehet a fájlt a Shoptet által használt összes hozzáférhető jellel (azaz a táblázat összes oszlopával) exportálni. Így biztos lehet abban, hogy a termék egyetlen tulajdonságát sem hagyja ki. Ezzel elkerüli a termékek utólagos és hosszadalmas beállítását az adminisztrációban.
A fájl exportálásához XLSX/CSV formátumot használjon.
- lépjen be a webáruháza adminisztrátorába, Termékek → Termékek exportálása (01. ábra)

- kattintson a Hozza létre saját exportját lehetőséget
- adja meg a címét (pl.: Teljes)
- az alábbi összes kínálatból válassza a Jelöljön be mindent lehetőséget
- kattintson a Mentés gombra
- lépjen vissza az Exportálás könyvjelzőbe
- Válassza a saját Típust: Teljes
- válassza az XLSX Formátumot
- a többi beállítást hagyja ki
- kattintson az Exportálás gombra
Tisztában kell lennie azzal, hogy még ennek az eljárásnak a betartása mellett is egyes jelek hiányozhatnak a táblázatból. Tipikus példa erre az ÁFA. Amennyiben be van állítva a webáruháza adminisztrációjában, hogy nem ÁFA fizetésre kötelezett, úgy az exportálás nem fogja magába foglalni azokat a jeleket, melyek az ÁFA fizetésre vonatkoznak.
Importálás szabályai
Ahhoz, hogy a termékek importálása sikeres legyen, a következő szabályok szerint kell beírni az adatokat:
- A code, pairCode és adott esetben a name oszlopok mindig balról az elsők
- Új termékek esetén kötelező a code, pairCode, name és price oszlop. Új termékeknél a name és price oszlop értékeit ki kell tölteni.
- Meglévő termékek frissítésekor elegendő azokat az oszlopokat megadni, amelyek alapján a termék azonosítható (code és pairCode), valamint azokat, amelyeket importálással frissíteni szeretne. Meglévő termék importálása ezért a name és price oszlopok nélkül is lefut.
- A nem kötelező jelzésű oszlopokat nem kell megadni az importált fájlban.
- Az oszlopok sorrendje nem fontos
- A terméksoroknak kapcsolódniuk kell egymáshoz - üres sorok nem lehetnek
- pl.: amennyiben a fájl közepén pár üres sor van, a rendszer azt az importálás végeként értelmezi
- Ne hagyjon az importált fájlban üres vagy hibás oszlopokat vagy sorokat!
- A nyelvi változatokhoz tartozó oszlopok (pl. 'name:hu', 'name:en', stb.) kizárólag már meglévő termékek frissítésére használhatók. Új termékek létrehozásánál nem lehetséges.
Különbség van a következők között:
- A nem kötelező oszlop a fájlban nincs feltüntetve.
- Az oszlop meg van adva, de az értékek nincsenek kitöltve.
Erre különösen akkor kell figyelni, ha a termék már jelen van a webáruházban, és importálással szeretné frissíteni a tulajdonságait. Az 1. esetben a termék eredeti tulajdonságai megmaradnak.
A 2. esetben attól függ, hogy a webáruháza melyik importálási verziót használja. A korábbi verzióban az eredeti tulajdonságok üres értékekkel lesznek felülírva, tehát törlődnek. Az új verzióban az üres érték kimarad, és az eredeti tulajdonság megmarad.
Jelek és szabályok táblázata
A következő táblázat minden olyan tag (jel) jegyzékét tartalmazza, melyekkel a Shoptet exportálásában és importálásában találkozhat. Minden egyes tag (táblázatban - oszlop) a webáruházában lévő valamelyik tétel tulajdonságát jelzi:
| Oszlop neve | Kötelező | Megengedett értékek | Leírás |
|---|---|---|---|
| code | igen | max. 64 karakter | Termék vagy változat kódja. A webáruházban teljesen egyedinek kell lennie. A termék kódja legfeljebb 64 karakterből állhat. Használhat 0-9, A-Z közötti karaktereket, speciális karaktereket (pl.: _,/,-,., vagy szóköz). |
| pairCode | igen |
| A pairCode egy olyan kódot jelöl, amely segít azonosítani a termékek különböző változatait. Fontos, hogy minden termék változatánál ugyanazt a párosító kódot használja. Ha a termékeinek nincsenek változatai, akkor hagyja ezt az oszlopot üresen. A pairCode 0-9 és A-Z terjedelmű karaktereket tartalmazhat. Speciális karaktereket nem tartalmazhat. További részletek az alábbi szekcióban, a Termékek importálása változatok nélkül és változatokkal alatt. |
| name | igen - új termékek esetén | max. 250 karakter | A termék neve. Új termékeknél a name oszlop értékét ki kell tölteni. Ha a termék már létezik a webáruházban, az importálás a name oszlop nélkül is lefut. |
| variant:paraméter-név | igen (ha a termék több változattal rendelkezik |
| Helyes megadásához ki kell tölteni a pairCode oszlopot. Az név meghatározza a változat-paraméter nevét, az ebben az oszlopban lévő sorok határozzák meg a paraméter értékeit. Például: az oszlop neve variant:Szín és az egyforma pairCode-dal rendelkező sorokban egy Fehér egy Kék és egy Zöld értéke szerepel. Ezzel léterhozunk egy terméket, amelynek három változata lesz: fehér, kék és zöld. Egy változatra legfeljebb három paraméter adható meg. |
| shortDescription | nem |
| Termék rövid leírása. Ez a leírás például a termékkategóriák kivonatában jelenik meg, vagy a termékkeresőkbe exportálódik. |
| description | igen (új termék esetén) |
| Termék részletes leírása. A termékinformációban jelenik meg. Maximális hossz: 32767 karakter. |
| supplier | nem | max. 255 karakter | A termék beszállítója. |
| manufacturer | nem | max. 200 karakter | Termék gyártója. |
| metaDescription | nem |
| Termék meta-leírása. (SEO) |
| seoTitle | nem | max. 255 karakter | Meta-cím a html forráskódban, |
| itemType | nem |
| Itt választhatja ki, hogy pl. új, használt termékről, vagy szolgáltatásról van-e szó. |
| setItem | nem |
| Termékszett-elem. A szett további termékeit új oszlopokban, setItem;setItem2;setItem3;... adhatók meg. |
| guid | nem | érvényes UUID | Shoptet belső adata. Importálás során figyelmen kívül hagyható. |
| externalId | nem | 0-9 számjelet és A-Z betűjelet tartalmazhat, max. 128 karakter | Ez a tag, illetve annak értéke segít párosítani a változatokat a konkrét termékkel. Használatával mellőzhető az összes többi változat megadása pl. az XML exportban. |
| appendix | nem | max. 150 karakter | Név-bővítmény. Meg lehet adni akciós ajánlatokat illetve ajándékokat, a további információkat a Ajándékok a megrendeléshez alkalmazásról szóló bejegyzésben találja. |
| ean | nem | max. 255 karakter | Termék vagy változatok EAN kódja. |
| productNumber | nem | max. 32 karakter | Termék vagy változatok cikkszáma (ISBN). |
| partNumber | nem | max. 32 karakter | Gyártó azonósító száma (MPN) |
| serialNumber | nem | max. 32 karakter | Termék sorozatszáma. |
| plu | nem | max. 16 karakter | Termék PLU-kódja. |
| image | nem | max. 2 000 karakter | A termékkép abszolút elérési útja (URL-címe). Több kép importálásához használjon további image oszlopokat sorszámmal – image; image2; image3; .... |
| imageDesc | nem |
| A kép alternatív leírása. Az importfájlban egyúttal szerepelnie kell az image oszlopnak a kép URL-címével. Több képleírás importálásához használjon további imageDesc oszlopokat sorszámmal – imageDesc; imageDesc2; imageDesc3; .... |
| defaultImage | nem | max. 2 000 karakter | Abszolút elérési út a képhez a termék változatainál. |
| categoryText | nem |
| Termék besorolása további (más) olyan kategóriákba, mint az alapértelmezett defaultCategory. Amennyiben a terméket több kategóriában, különböző fákban szeretné elhelyezni, categoryText2, categoryText3 stb. oszlopok hozzáadása szükséges. További részletek a Kategóriák importálása bekezdésben. |
| defaultCategory | nem | max. 255 karakter | Alapértelmezett kategória. Az a kategória, amelyben a termék a webáruházban elhelyezésre került. Ahhoz, hogy az áru megjelenjen a webáruházban, ki kell tölteni a defaultCategory oszlopot. További részletek a Kategóriák importálása bekezdésben. |
| price | igen - új termékek esetén | nem negatív szám | A termék vagy a változat ára, csak a numerikus értéket kell megadni speciális jegyek nélkül. Új termékeknél a price oszlop értékét minden terméknél és változatnál ki kell tölteni. Ha a termék már létezik a webáruházban, ezt az oszlopot nem kell feltüntetni az importfájlban. |
| priceRatio | nem | 0–1 | Áregyüttható. A termék ára a megadott ár és ennek az együtthatónak a szorzataként kerül kiszámításra. Ha azt szeretné, hogy a kapott ár megegyezzen az Ár mezőben lévő árral, az áregyütthatót 1-re állítsa be. |
| standardPrice | nem | nem negatív szám | Termék vagy változatok eredeti ára. |
| purchasePrice | nem | nem negatív szám | Termék vagy változatok beszerzési ára. |
| purchasePriceVatRate | nem | A beszerzési ár áfa százalékos mértéke a terméknél vagy változatnál. | |
| purchasePriceIncludingVat | nem | 0;1 | Jelzi, hogy a megadott beszerzési ár áfa nélkül vagy áfával együtt van feltüntetve. A 0 érték áfa nélküli árat jelent, míg az 1 érték áfával együttit. |
| currency | nem | max. 3 karakter, pl. HUF vagy EUR | Annak a pénznemnek a kódja, amelyben a termék vagy változat ára megadásra került. |
| includingVat | nem | 0;1 | Megmutatja, hogy a feltüntetett ár tartalmazza- vagy nem az ÁFÁ-t. A 0 érték az ÁFA nélküli, az 1 érték az ÁFÁ-t is tartalmazó árra vonatkozik. Érvényes az eladási árra, a standard árra és az akciós árra. |
| percentVat | nem |
| A termék vagy változat százalékos adókulcsa. Érvényes az eladási árra, a standard árra és az akciós árra. |
| actionPrice | nem | pozitív szám | Termék akciós ára. További információk az Akciós árak importálása alatt. |
| actionFrom | nem |
| Milyen dátumtól lép életbe az akciós ár (YYYY-MM-DD formátum). |
| actionUntil | nem |
| Milyen dátumig lesz érvényes az akciós ár (YYYY-MM-DD formátum). |
| minimumAmount | nem |
| Minimálisan rendelhető mennyiség. |
| maximumAmount | nem |
| Maximálisan rendelhető mennyiség. |
| freeShipping | nem | 0;1 | Meghatározza, hogy a termék kaphat-e engedélyt az ingyenes szállításra. |
| freeBilling | nem | 0;1 | Meghatározza, hogy a termék kaphat-e engedélyt az ingyenesen fizetési módra. |
| maxDiscount | nem | 0–100 | Megadja a maximális lehetséges kedvezményt. Csak számmal, százalék nélkül adja meg. |
| applyDiscountCoupon | nem | 0;1 | Lehetővé teszi az egyes tételeknél annak beállítását, hogy használható-e rájuk kedvezménykupon. 1. érték: lehetséges a kedvezménykupon használata. 0. vagy kitöltetlen érték: nem alkalmazható kedvezménykupon az adott tételre. |
| applyLoyaltyDiscount | nem | 0;1 | Lehetővé teszi az egyes tételeknél annak beállítását, hogy érvényesíthető-e rájuk a hűségkedvezmény. 1 érték: érvényesíthető a hűségkedvezmény. 0. vagy kitöltetlen érték: nem érvényesíthető hűségkedvezmény az adott tételre. |
| applyQuantityDiscount | nem | 0;1 | Lehetővé teszi az egyes tételeknél annak beállítását, hogy érvényesíthető-e rá darabszám alapján adott kedvezmény. 1 érték: használható a kedvezmény. 0. vagy kitöltetlen érték: nem alkalmazható a kedvezmény az adott tételre. |
| applyVolumeDiscount | nem | 0;1 | Lehetővé teszi az egyes tételeknél annak beállítását, hogy érvényesíthető-e rá kedvezmény a vásárlás értéke alapján. 1 érték: használható a kedvezmény. 0. vagy kitöltetlen érték: nem alkalmazható a kedvezmény az adott tételre. |
| variant:-név- | nem | max. 128 karakter | Helyes megadásához ki kell tölteni a pairCode oszlopot. Az -név- meghatározza a változat-paraméter nevét, az ebben az oszlopban lévő sorok határozzák meg a paraméter értékeit. Például: az oszlop neve variant:Szín és az egyforma pairCode-dal rendelkező sorokban egy Fehér egy Kék és egy Zöld értéke szerepel. Ezzel léterhozunk egy terméket, amelynek három változata lesz: fehér, kék és zöld. Egy változatra legfeljebb három paraméter adható meg. |
| filteringProperty:-név- | nem |
| A terméknek azok a szűrési paraméterei, amikből létrehozható a paraméterszűrő. A fájlban az oszlop nevének hozzáadása filteringProperty:Paraméter_név formában történik. |
| surchargeParameter:-név- | nem | max. 255 karakter | Paraméter-név |
| surchargeParameter:-név-:includingVat | nem | 0;1 | ÁFA-mérték. Ha nincs megadva, az alapértelmezett érték kerül hozáadásra - 1 (tehát az ár az ÁFA-át tartalmazni fogja) |
| surchargeParameter:-név-:currency | nem | max. 3 karakter, pl. HUF vagy EUR | Pénznem |
| surchargeParameter:-név-:requiredValue | nem | 0;1 | Kötelező/nem kötelező |
| surchargeParameter:-név-:description | nem |
| Paraméter leírása |
| surchargeParameter:-név-:shortName | nem |
| A név, amely a terméklapon fog megjelenni. |
| recyclingFeesCategory | nem |
| Újrahasznosítási díj kategória. A mező értéke az adott újrahasznosítási díj kategória neve. |
| recyclingFeesPrice | nem |
| Újrahasznosítási díj ára |
| recyclingFeesCurrency | nem | max. 3 karakter, pl. HUF vagy EUR | Újrahasznosítási díj pénzneme |
| recyclingFeesType | nem | 1;2 | Az újrahasznosítási díj típusa. Az 1-es érték azt jelzi, hogy a díj egységenként, míg a 2-es érték azt, hogy súlyonként (kg-onként) értendő. |
| stock | nem | max. 9 999 999,999 | Raktáron lévő (termék vagy változat) darabszám. Az oszlop használatának csak akkor van értelme, ha a webáruháza rendelkezik aktív Raktárkészlet-gazdálkodás alkalmazással. Csak a számot kell megadni. Amennyiben Több raktárat használ, úgy az oszlop neve stock: és annak a konkrét raktárnak a neve, amit az adminisztrátorában megadott, így pl.: stock:Raktár Budapest (alapértelmezett) illetve stock:Raktár Szeged. |
| stockLocation | nem |
| A termék raktári helye. Ennek a mezőnek az értéke azt a helyet mutatja meg, ahol a raktárban az áru megtalálható, pl.: R2/P10 (2. sor / 10. polc). Amennyiben Több raktárat használ, úgy az oszlop neve stockLocation: és annak a konkrét raktárnak a neve, amit az adminisztrátorában megadott, így pl.: stockLocation:Raktár Budapest (alapértelmezett) illetve stockLocation:Raktár Szeged. |
| stockMinSupply | nem |
| Minimális raktárkészlet. |
| negativeAmount | nem | 0;1 | Azt jelzi, hogy a termék akkor is megvásárolható-e, ha a raktárkészlet mínuszba megy át. Az oszlop használatának csak akkor van értelme, ha a webáruház rendelkezik aktív Raktárkészlet-gazdálkodás alkalmazással. |
| availability | nem |
| Termék vagy változat hozzáférhetősége kikapcsolt Raktárkészlet-gazdálkodás esetén. |
| availabilityOutOfStock |
|
| Termék vagy változat hozzáférhetősége bekapcsolt Raktárkészlet-gazdálkodás esetén. Hozzáférhetőség kiárusítás esetén. |
| availabilityInStock | nem |
| Termék vagy változat hozzáférhetősége bekapcsolt Raktárkészlet-gazdálkodás esetén. Áru raktári hozzáférhetősége. |
| unit | nem | max. 255 karakter | Termék egysége. |
| decimalCount | nem | 0-3 | Jelzi, hogy hány tizedes értékig helyezhető termék darabszám arány a kosárba. Azaz, 1 db helyett, egy tizedes érték esetén 1,8 db, vagy két tizedes érték esetén 2.88 db is a kosárba helyezhető. Ennek megfelelően vonódik majd le a raktárkészletből (így a raktáron például 3,4 db termék is lehet). Ezt a beállítást az adminisztrátorban a termékinformációk beállításában a „Tizedesvessző utáni számjegyek száma“ elnevezés alatt találja meg. |
| warranty | nem | max. 100 karakter | Garancia. Számmal és betűvel is megadható, pl.: 3 év kiterjesztett garancia. |
| weight | nem |
| Termék vagy változatok tömege. Kilogrammban kell megadni, de mértékegység nélkül. Példa: 200g: 0.2, 2kg: 2, stb. |
| height | nem |
| A csomag magassága. Ez a csomagolás mérete, nem pedig maga a termék. |
| width | nem |
| A csomag szélessége. Ez a csomagolás mérete, nem pedig maga a termék. |
| depth | nem |
| A csomag mélysége. Ez a csomagolás mérete, nem pedig maga a termék. |
| hsCode | nem | 6-10 számjegy | HS-kód (Harmonized System), vagyis az áru vámtarifaszáma. Az EU-n kívüli országokból származó áruk vámkezeléséhez használható. A mező termékszinten állítható be, és üresen is hagyható. Ha az import érvénytelen formátumú értéket tartalmaz, csak a HS-kód marad ki, a termék többi adata frissül. |
| boxRestriction | nem | 0;1 | Ha aktív, a vásárlók nem fogják tudni a Z-BOX átvevőhelyeket kiválasztani. Ez a korlátozás nem minden szállítóval és fuvarozócéggel kompatibilis. |
| recommendedPackaging
| nem |
| A küldemény ajánlott csomagolása. |
| relatedProduct | nem |
| Kapcsolódó termék kódja (több termék esetén új oszlop, illetve oszlopok hozzáadása szükséges: relatedProduct, relatedProduct2, relatedProduct3 stb.). |
| alternativeProduct | nem |
| Hasonló termék kódja (több termék esetén új oszlop illetve oszlopok hozzáadása szükséges: alternativeProduct, alternativeProduct2, alternativeProduct3 stb.). |
| gifts | nem |
| Termékhez tartozó ajándék kódja (több termék esetén új oszlopot illetve oszlopok hozzáadása szükséges: gifts2, gifts3, gifts4 stb.). |
| textProperty | nem | max. 255 karakter | Leíró paraméterek a termékhez. Amennyiben több van belőle, úgy azok a textProperty, textProperty2 stb. oszlopokban adhatók meg. pl.: Szín;Narancssárga. A további információk a Szöveges paraméterek importálása bekezdés alatt találhatók. |
| externalCode | nem | max. 32 karakter | Termék gyártójának a kódja. |
| variantVisibility | nem | 0;1 | Változat (termékcikk) elrejtése: a megjelenítéshez az 1 értéket, az elrejtéshez a 0 értéket adja meg. Ne hagyja a mezőket kitöltetlenül. |
| productVisibility | nem | hidden;visible | Termék elrejtése és megjelenítése: a hidden érték elrejti a terméket, a visible érték az az alapértelmezett állapot, amikor a termék látható. További lehetséges értékek: blocked: meggátolja a termék megrendelését, showRegistered: a termék csak a regisztrált ügyfelek számára látható, blockUnregistered: a terméket nem regisztrált ügyfél nem vásárolhatja meg, *cashDeskOnly: csak a pénztáron jelenjen meg, detailOnly: a termék csak közvetlen hivatkozáson keresztül lesz elérhető, nem pedig a menün vagy a webáruház keresőjén keresztül. |
| adult | nem | 0;1 | Jelzi, hogy a termék csak felnőtteknek való-e. 0: korlátozás nélkül. 1: kizárólag felnőtteknek. |
| atypicalShipping | nem | 0;1 | Szokatlan szállítás: Amennyiben ez az utasítás a termék nevében bejelölésre kerül, az értéke automatikusan 1. |
| atypicalBilling | nem | 0;1 | Szokatlan fizetés. Amennyiben ez az utasítás a termék nevében bejelölésre kerül, az értéke automatikusan 1. |
| actionFlagActive | nem | 0;1 | Meghatározza, hogy a terméknél megjelenik-e az Akció matrica. |
| actionFlagValidFrom | nem | YYYY-MM-DD | Akció kezdete |
| actionFlagValidUntil | nem | YYYY-MM-DD | Akció vége |
| newFlagActive | nem | 0;1 | Meghatározza, hogy a terméknél megjelenik-e az Újdonság címke. |
| newFlagValidFrom | nem | YYYY-MM-DD | Az a dátum, amelytől az áru újként lesz megjelölve |
| newFlagValidUntil | nem | YYYY-MM-DD | Az a dátum, ameddig az áru újként lesz megjelölve |
| tipFlagActive | nem | 0;1 | Meghatározza, hogy a terméknél megjelenik-e a Tipp matrica. |
| tipFlagValidFrom | nem |
| Az a dátum, ameddig az áru a „Tipp" matricát hordozza. YYYY-MM-DD formátum |
| tipFlagValidUntil | nem |
|
|
| custom1FlagActive | nem | 0;1 | Egyéni címke. pl.: Kiárusítás. (Több egyéni címkéhez további oszlopokat kell beszúrni: custom2, custom3, custom4 stb.). |
| custom1FlagValidFrom | nem | YYYY-MM-DD | Az a dátum, amelytől az áru a választott címkét megkapja. |
| custom1FlagValidUntil | nem |
YYYY-MM-DD | Az a dátum, ameddig az áru a választott címkét hordozza. |
| relatedVideo | nem | max. 2 048 karakter | Adatok a kapcsolódó videókhoz - név;url-cím formátumban kell megadni. Például: Útmutató;https://www.youtube.com/video További videók relatedVideo2, relatedVideo3 stb. oszlopokon keresztül importálhatók. |
| allowsPayOnline | nem | 0;1 | Megadja, hogy a terméknél engedélyezett-e az online fizetés. |
| xmlFeedName | nem | 1–255 karakter | Termék neve az XML feedben. Ha a mező ki van töltve, az árösszehasonlító oldalak számára automatikusan ez a név lesz elküldve a webáruházban megjelenő név helyett. |
| packageAmount | nem |
| Kiszerelési mennyiség. |
| packageAmountUnit | nem | max. 255 karakter | Kiszerelési mennyiség egysége. A webáruház adminisztrátorában a következő egységek állíthatók be: pcs, g, kg, t, cm, m, cm2, m2, ml, l, cm3, dm3, m3 |
| measureAmount | nem |
| Mértékegység. |
| measureAmountUnit | nem | max. 255 karakter | Mértékegység egysége. A webáruház adminisztrátorában a következő egységek állíthatók be: pcs, g, kg, t, cm, m, cm2, m2, ml, l, cm3, dm3, m3 |
| internalNote | nem |
| Belső megjegyzés. |
| depositCode | nem | max. 64 karakter | Betétdíj kódja (alkalmazás szükséges). |
| depositLogic | nem | per-order; per-product | Betétdíj viselkedési logikája. per-order: rendelésekénti betétdíj; per-product: termékenténti betétdíj. (alkalmazás szükséges) |
| ossTaxRate:célországRövidítése | nem | high; low; third; none. | high: Általános adómérték; low: Kedvezményes adómérték; third: Kiemelten kedvezményes adómérték; none: Nullakulcsos ÁFA. |
Árösszehasonlítók és további Alkalmazások import tag-ek táblázata:
| Oszlop neve | Platform | Használt értékek | Leírás |
|---|---|---|---|
| arukeresoHidden | Árukereső.hu |
| A termék nem lesz exportálva a feed-be és nem fog megjelenni az Árukereső oldalán. |
| arukeresoMarketplaceHidden | Árukereső.hu |
| A termék exportálásra kerül az Árukereső feed-be, azonban az Árukereső Marketplace-ről elrejtettnek lesz jelölve. |
| googleCategoryId | |
| Google shopping kategória ID. |
| glamiCategoryId | Glami |
| Glami kategória ID. |
| heurekaCategoryId | Heureka.cz; Heureka.sk |
| Heuréka kategória ID. |
| zboziCategoryId | Zboží.cz |
| Zboží.cz kategória ID. |
| itemConditionGrade
| Zboží.cz | open_box; refurbished; used | Használt termék állapotának meghatározása a Zboží.cz számára. Lehetséges értékek: kicsomagolt (open_box), felújított (refurbished), használt (used). |
| itemConditionDescription | Zboží.cz |
| A használt termék állapotának szöveges leírása. |
| firmyCz | Zboží.cz | 0;1 | Meghatározza, hogy a termék megjelenjen-e a vállalat profiljában a Firmy.cz szerveren. |
| allowsIPlatba | iPlatba (cz) | 0;1 | Megadja, hogy iPlatba (hitel) segítségével megvásárolható-e a termék. |
| zboziCpc | Zboží.cz |
| Legmagasabb kattintási díj a termékinformációban CZK-ban a Zboží.cz szolgáltatásban. Ha beállítja az átkattintás legmagasabb díját, amit hajlandó kifizetni az adott tételért a részletezésben, a Zboží.cz kiszámítja azt az átkattintás díjat, ami az adott pozíció megőrzéséhez (second-price) szükséges. Ha az ügyfél a kínálat legolcsóbbtól induló sorba rendezését használja, csak az árjegyzéki ár kerül kiszámlázásra. |
| zboziSearchCpc | Zboží.cz |
| Maximális átkattintási díj teljes szöveges keresési eredményben (rendezetlen kínálatokban) CZK-ban. Ha beállítja az átkattintás maximális díját, amit a teljes szövegben az adott tételért hajlandó fizetni, a Zboží.cz kiszámítja az adott pozíció megőrzéséhez (second-price) szükséges átkattintás díját. Ha az ügyfél a kínálat legolcsóbbtól induló sorba rendezését használja, csak az árjegyzéki ár kerül kiszámlázásra. |
| sizeld | magyar projekteken egyelőre nem elérhető |
| SizeID id (SizeID alkalmazást igényel). |
| sizeIdLabel | magyar projekteken egyelőre nem elérhető |
| SizeID leírás (SizeID alkalmazást igényel). |
| heurekaCpc | Heureka.cz; Heureka.sk |
| Kattintási díj a Heureka.cz-n. A kattintási díj (CPC) mértékét a Heureka.cz szolgáltatón Ügyfél-hitelesítési tanúsítvány megszerzése után lehet beállítani. |
| heurekaHidden | Heureka.cz; Heureka.sk | 0;1 | A termék nem lesz exportálva a feed-be és nem fog megjelenni az Heureka oldalán. |
| heurekaCartHidden | Heureka.cz; Heureka.sk | 0;1 | A termék exportálásra kerül az Árukereső feed-be, azonban az Heureka Marketplace-ről elrejtettnek lesz jelölve. |
Amennyiben az előbb felsorolt jelek valamelyikének jelentésével kapcsolatban tanácstalan lenne, keresse ki közvetlenül a webáruház adminisztrációban (Termékek → Termék részletei: Árlista / Raktár / Kedvezmények / Kategóriák valamelyikében).
Az adminisztrátorban a legtöbb jel neve mellett „i“ betűvel ellátott ikon található. Az egeret rámozgatva az ikonra megjelenik a jelre vonatkozó információ, valamint a jel tulajdonsága.
Termékek importálása változatok nélkül és változatokkal
A termék mindkét típusa teljesen egyformán másolódik be az importálandó fájlba. Egyetlen különbség a pairCode oszlop.
- ez egy kötelező oszlop
- balról másodikként kell elhelyezni a táblázatban
- a változatok nélküli termékek esetén ez az oszlop üres
- a változatokkal rendelkező termékek oszlopába azok az értékek vannak benne, melyek ugyanannak a terméknek minden változatánál egyformák.
- pl.: ha 4 változattal rendelkező terméket akar importálni, úgy a táblázatban 4 egymást követő sorban ugyanaz a pairCode lesz.
- az azonos pairCode kóddal rendelkező változatoknak közvetlenül egymás alatt kell lenniük a táblázatban
- pl.: ha az egyik ilyen változat más helyen lenne, akkor önálló kiegészítő termékként töltődne fel
- a pairCode érték tetszőleges, 0-9 és A-Z karaktereket tartalmazhat, de speciális karakterek nem lehetnek benne
Kategóriák importálása
A kategóriák különböző csoportokra osztják a termékeket a webáruházban, például: végfelhasználók, ágazatok, terméktípusok stb. szerint. Amennyiben még nincsenek a webáruházban létrehozva kategóriák, azokat a webáruház a táblázat információiból hozza létre. A kategóriák képeinek feltöltése csak az admin felülettel lehetséges.
- a termékeket két jel: defaultCategory és categoryText alapján soroljuk kategóriákba
- a kategóriák fastruktúrában, azaz főkategória > 1. alkategória > 2. alkategória szerint töltődnek fel; az alkategóriák száma nincs korlátozva (02. ábra).
- a kacsacsőr > előtt és után is szóköz szerepel
- dupla-kacsacsőr használatakor >> a termék csak a konkrét kategóriába kerül besorolásra
- pl. ha a táblázatban a kategória értéke: A > B > C > D >> E, a termék csak az E kategóriába kerül besorolásra
- ha a táblázatban a kategória értéke: >> A > B >> C > D >> E, a termék az A, C és E kategóriákba kerül besorolásra

Csak egy defaultCategory jel (alapértelmezett kategória) lehet. Amennyiben nem adja meg, a termék nem jelenik meg az ügyfeleknek a webáruházban.
- a főkategóriára csak a név defaultCategory oszlopban történő megadásával lehet hivatkozni
- az alkategóriákhoz használja a név fastruktúrát, például: Ruházat, Póló, Rövid ujjú
A categoryText jel további (más) kategóriákba sorolja be a terméket, mint a defaultCategory. Beírására ugyanazok a szabályok érvényesek.
- a termék több kategóriába történő besorolásához szúrjon be még egy oszlopot és adja neki a categoryText2 nevet
Azonos nevű kategóriák. Hogyan kerülhetők el az átfedések?
A webáruház rendszerében meg kell különböztetni azokat a kategóriákat, melyeknek a neve megegyezik. Például három kategória van Gyógyteák néven. Nem biztos, hogy importáláskor a termékek abba a kategóriába töltődnek fel, ahová éppen szeretné. A megoldás egyszerű.
- a webáruház adminisztrációjában válassza a Termékek → Termékkategóriák lehetőséget
- válassza ki az első, Termékkategóriákfület
- nyissa meg a kategóriaszerkesztést úgy, hogy rákattint a nevére
- válassza ki az Haladó könyvjelzőt
- válassza ki a Link szöveg (menüben) mezőt
- mind a három kategóriánál írja be ebbe a mezőbe a Gyógyteák elnevezést
- ezután nevezze át az adott kategóriák elnevezését (Általános információk könyvjelző) úgy, hogy különbözzenek egymástól (pl.: Fekete gyógyteák, Zöld gyógyteák és Koffeinmentes gyógyteák)
- amennyiben a címnél a menüben a Gyógyteákat választotta, ne használja ezt a nevet az oldal címében
- az importálásban minden kategóriához azok új nevét használja
- ezek a kibővített nevek nem jelennek majd meg a webáruházban a kategóriák menüjében, azonban az adott kategória fejlécében láthatóak lesznek
Szöveges paraméterek importálása
A szöveges paraméterek a termékek valamilyen tulajdonságát írják le. A szöveges paramétereket a Shoptet adminisztrátorában a Paraméterek könyvjelző alatt a termékinformációkban találja.
- a Shoptetbe csak a Paraméter név (pl.: Szín) és a Leíró paraméter értéke (pl.: Narancssárga) importálható, a Paraméter név magyarázata a webáruház adminisztrációban manuálisan egészíthető ki (03. ábra)

- válassza ki a textProperty oszlopban a mezőt
- Válassza el a táblázat cellájában pontosvesszővel egymástól (szóköz nélkül) a Paraméter nevet és a Leíró paraméter értéket (04. ábra)
- semmilyen további pontosvesszőt ne tegyen már ebbe a cellába
- amennyiben több szöveges paramétert szeretne importálni, illesszen be a táblázatba oszlopokat: textProperty2, textProperty3 stb.
- változatokkal rendelkező termék esetén minden változathoz a textProperty adja meg

Akciós árak importálása
Az akciós árakat (actionPrice) mindig actionFrom és actionUntil paraméterekkel importálja. Az adott akció érvényességére vonatkoznak. A dátumot YYYY-MM-DD formátumban adja meg (pl.: ha az 2021 szeptember 27., akkor 2021-09-27 alakban adja meg), a cella formátuma szövegként van beállítva (így az Excelben a modifikáció során nem állítódik át automatikusan a formátuma).
Hogyan végezhető el a termékek importálása
- lépjen be a webáruháza adminisztrációjába, kattintson a Termékek → Termékek importálása részhez (05. ábra)
- válassza az Importálás fület
- a Napló fülön pedig megnézheti a már végrehajtott importálásokra vonatkozó információkat

- az import Beállítások alatt három lehetőség közül választhat:
- Hagyjon változatlanul minden olyan terméket és változatot, amely nem szerepel az importálásban: minden megmarad a webáruházban, egyetlen termék sem kerül törlésre - az importált fájlban lévő termékek módosításra kerülnek.
- Csak az importban szereplő termékeket változtassa meg, és törölje az importált termékek azon variációit, amelyek nem tartoznak az importálásba: minden olyan változatot kitöröl, amik a webáruházba bevitelre kerültek, de nincsenek megadva a termékeknél az importált fájlban.
- Törölje azokat a termékeket és változatokat, amelyek nem szerepelnek az importban: mindent összességében kitöröl, ami nincs benne az importált fájlban. Ha például csak egy terméket szeretne importtal módosítani, és ezt a lehetőséget jelölte be, mindent kitöröl, és a webáruházban mindössze egy termék marad.
- a többi lehetőséget hagyja meg
- válassz ki az importálni kívánt fájlt
- kattintson jobb oldalt fent az Importálás gombra
- az importálás automatikusan befejeződik
- ellenőrizze az adminisztrációban (Termékek → Termékek importálása), hogy az importálás megfelelően megtörtént-e
Adatátvitel befejezése
Ha elolvasta a webáruház Shoptetre történő áttérésről szóló valamelyik bejegyzést, ezt az útmutatót alkalmazza a befejezéshez.
Megmutatjuk, hogyan lehet a termék összes tulajdonságának importálásához és beállításához a Shoptetről történő exportálást hasznosítani. Továbbá rávilágítunk, hogy milyen importálásra vonatkozó szabályok léteznek, valamint a különböző jelek jelentésére. Megtudhatja, hogy mit kezdjen az olyan specifikus jelekkel, mint a termékek változatokkal, kategóriák, szöveges paraméterek vagy akciós ár.
Ehhez az eljáráshoz készítsen exportot valahová az eredeti e-boltján kívülre, vagy egy másik kereső ablakban nyissa meg közvetlenül annak adminisztrátorát. Ha már minden eredeti információ a termékeiről a keze ügyében lesz, sokkal egyszerűbben elvégezheti ezt a műveletet. Ezek elsősorban olyan információk (jelek), melyek az exportálás/importálásban nem voltak jelen, így most manuálisan kell beállítani azokat.
A továbbiakban az ebben a szövegben található útmutató szerint járjon el. A következő lépés pedig a Mintafájl létrehozása az importáláshoz lesz.