Feed integrációs dokumentáció
Az Árössze árösszehasonlítóra kétféle formátumban lehet termékeket beküldeni: XML és CSV/TSV.
Hogyan történik a termékpárosítás?
A termékek besorolása elsősorban a <CATEGORY> mezőben megadott kategórianév, valamint a <MANUFACTURER> és a <NAME> mezőkben megadott gyártó+terméknév alapján történik.
Azonban kategóriától függően szükséges lehet a <PRODUCTNUMBER> (gyártói termékkód), az <ISBN13> és az <EAN_code> megadása is a pontos párosításhoz.
Ezért minél több mezőt adj meg a termékeidről. Minden esetben kizárólag hivatalos kódokat használj, pontosan abban a formában, ahogy a gyártó meghatározta.
EAN kód
Az EAN kód általában 13 számjegyű, gyártó által adott termékazonosító. A feldolgozás elsősorban gyártói termékkód alapján történik, de az EAN kód megadása felgyorsítja ezt. Olyan kategóriákban, ahol nincs gyártói termékkód (pl. kozmetikumok), az EAN kód a magasabb feldolgozottság eléréséhez ajánlott.
ISBN kód (könyv kategória)
A könyvek/kiadványok kategóriában a termékek párosításához az ISBN kód megadása szükséges. 13 számjegyű termékazonosítót kell megadni. Hiánya esetén a könyv nem kerül feldolgozásra.
ProductNumber – gyártói termékkód
A ProductNumber alapú párosítás előfeltétele, hogy a <MANUFACTURER> + <PRODUCTNUMBER> mezők értéke egyezzen egy már az oldalon szereplő termék adataival.
A ProductNumber megadásával elkerülhető, hogy terméknév-változtatás esetén az ajánlatok kiessenek a termékoldalakról. Kizárólag a gyártó által meghatározott pontos kódot add meg – nagymértékű hibás adat a feldolgozás leállását okozhatja.
<PRODUCTNUMBER>SCY900/01</PRODUCTNUMBER>
Kötelező mezők
Az alábbi mezők hiányában a termék nem dolgozható fel.
| Mező (XML tag) | Leírás |
|---|---|
| identifier | Egyedi termékazonosító (bolt által használt, változatlan értékű azonosító) |
| manufacturer | Termék gyártójának megnevezése |
| name | Termék pontos megnevezése – a gyártó által használt teljes nevet tartalmazza |
| category | Termékkategória, hierarchikus felépítéssel (pl. Műszaki cikk - Fülhallgató) |
| product_url | A termék egyedi oldalára mutató link (URL) |
| price | Bruttó végfelhasználói ár (ÁFÁ-val, a minimálisan rendelhető mennyiség ára) |
| net_price (ajánlott) | Nettó ár (ÁFÁ-t nem tartalmazó ár) |
| product_number (ajánlott) | Gyártói cikkszám / MPN – gyorsítja a párosítást és stabilan tartja az ajánlatot névváltoztatás esetén is |
XML formátum – minta
A fájl karakterkódolása UTF-8 legyen, gzip tömörítés is elfogadott (.xml.gz).
<?xml version="1.0" encoding="UTF-8"?>
<products>
<product>
<identifier>00010</identifier>
<manufacturer>Samsung</manufacturer>
<name>Gear IconX SM-R150</name>
<product_url>http://www.boltom.hu/products/00010/sm-r150.html</product_url>
<price>379,97</price> <!-- bruttó ár -->
<net_price>299,18</net_price>
<currency>HUF</currency>
<image_url>http://www.boltom.hu/images/smr150.jpg</image_url>
<category>Műszaki cikk - Fülhallgató</category>
<description>Prémium fülhallgató aktív zajszűréssel...</description>
<Delivery_Time>1 munkanap</Delivery_Time>
<Delivery_Cost>990 Ft</Delivery_Cost>
<EAN_code>8806088369228</EAN_code>
<PRODUCTNUMBER>SM-R150NZKAXEH</PRODUCTNUMBER>
<color>fehér</color>
<size>42</size>
<warranty>24</warranty>
<FreeDelivery>0</FreeDelivery> <!-- 1 = ingyenes szállítás -->
<basket_disabled>0</basket_disabled> <!-- 1 = nem rendelhető -->
<!-- Jellemzők – Attributes struktúra -->
<Attributes>
<Attribute>
<Attribute_name>Típus</Attribute_name>
<Attribute_value>Fejhallgató</Attribute_value>
</Attribute>
</Attributes>
<!-- VAGY egyszerű param tagek -->
<param name="Szín">fehér</param>
</product>
</products>
Elfogadott gyökér-elemek
<products>
<items>
<offers>
<shop>
<feed>
Elfogadott termék-elemek
<product>
<termek>
<item>
<shopitem>
CSV / TSV formátum – minta
Vesszővel (,), pontosvesszővel (;) vagy tabulátorral elválasztott fájl. Az első sor fejléc. Karakterkódolás: UTF-8.
"category";"manufacturer";"name";"description";"price";"net_price";"image_url";"product_url";"delivery_time";"delivery_cost";"identifier";"ean_code";"color";"size"
"Számítógép>Laptop";"HP";"655 C4X91EA";"Processzor: AMD E2-1800...";"99900";"78661";"http://pelda.hu/kep/1.jpg";"http://pelda.hu/termek/1";"1 munkanap";"2000 Ft";"1231231";"0887111509581";"fekete";"XL"
"Számítógép>Laptop";"Acer";"Aspire V5-121";"...";"69900";"55039";"http://pelda.hu/kep/2.jpg";"http://pelda.hu/termek/2";"5 munkanap";"FREE";"1231232";;"fehér";"extra_large"
Mezők részletes leírása
Delivery_Cost – szállítási díj
A termék szállítási költsége. Az összegen belül ne használj szóközt ezredesként, ne írj tartományt.
✓ Helyes formátum
✗ Hibás formátum
Delivery_Time – szállítási idő
Szállítási idő munkanapban. Csak az alábbi formátumok érvényesek. Tartomány (3-5) nem elfogadott.
✓ Helyes formátum
✗ Hibás formátum
Értékek megjelenítése:
1/1 nap/1 munkanap→ Raktáron3→ Szállítás: max 3 nap7→ Szállítás: max 1 hét14→ Szállítás: max 2 hét17(vagy több) → Szállítás: min 2 hétNO→ Nem rendelhető – a termék nem jelenik meg az oldalon
Description – termékleírás
A termék szabadszavas leírása, amely a részletes paramétereket tartalmazza, hogy a leendő vevő pontosan tájékozódhasson.
ImageURL – termékkép
A termékkép URL-je. Kiemelten fontos egyedi ajánlatoknál, és mindaddig, amíg a termék feldolgozásra, képgalériával ellátott termékoldalra nem kerül. Termékenként egy kép adható meg.
MaxCPCMultiplier – licitszorzó Ajánlott
Megadható, hogy a kategória alapáréhoz képest hányszoros kattintási árat hajlandó fizetni a kiemelt pozícióért. A BIDx előtag után 1.5–100 közötti értéket lehet megadni, maximum egy tizedesjeggyel. Segítségével az ajánlat a termékoldal „Kiemelt ajánlataink" blokkjában jelenik meg.
✓ Helyes formátum
✗ Hibás formátum
| XML tag / CSV fejléc (elfogadott nevek) | Leírás | Kötelező? |
|---|---|---|
| identifier / id / azonosito | Egyedi termékazonosító (bolt oldali, változatlan) | Igen |
| manufacturer / brand / gyártó | Gyártó neve – pontosan a gyártó által használt formában | Igen |
| name / productName / Terméknév / title | Termék pontos megnevezése | Igen |
| category / categoryText / kategória | Termékkategória; hierarchia: "Főkategória - Alkategória" vagy ">" elválasztóval | Igen |
| product_url / url / link | Termékoldal URL-je a webáruházban | Igen |
| price / ár / bruttó_ár | Bruttó ár a feed pénznemében. Tizedesjel: pont vagy vessző. | Igen |
| net_price / netto_ar | Nettó ár (ÁFÁ-t nem tartalmaz) | Ajánlott |
| product_number / sku / cikkszam / mpn | Gyártói termékkód / MPN – párosítást stabilizálja, névváltoztatás esetén sem esik ki az ajánlat | Ajánlott |
| EAN_code / ean / ean13 / gtin / barcode | EAN-13 / GTIN vonalkód – kötelező egyes kategóriákban (könyvek, kozmetikumok); felgyorsítja a feldolgozást | Ajánlott |
| ISBN13 / isbn | ISBN-13 kód – könyv kategóriában kötelező; 13 számjegy | Kat.-függő |
| image_url / imageUrl / kép | Termékkép URL-je. A rendszer az eredeti szerverről hivatkozik (hotlink). | Ajánlott |
| currency | Pénznem: HUF, EUR, USD stb. (felülírja a feed szintű beállítást) | — |
| Delivery_Cost / delivery_cost | "1190", "1190 Ft", "Free", "ingyenes", "ingyenesen" értékek. Tartomány és ezredes-szóköz hibás. | Ajánlott |
| Delivery_Time / delivery_time | "1", "3 nap", "3 munkanap", "NO" értékek. "NO" = nem rendelhető, nem jelenik meg. | Ajánlott |
| FreeDelivery | 1 = ingyenes szállítás (Delivery_Cost felülírás) | — |
| description / leírás / desc | Termékleírás szövege | — |
| warranty / garancia | Garancia tartama (pl. "24" hónapban) | — |
| basket_disabled | 1 = nem rendelhető / nem elérhető | — |
| color / szín | Szín – jellemzőként tárolódik | — |
| size / méret | Méret – jellemzőként tárolódik | — |
| ProductWeight | Tömeg – jellemzőként tárolódik | — |
| release_date / megjelenes_eve | Film megjelenési éve – DVD film kategóriában kötelező | Kat.-függő |
| original_title / eredeti_cim | Film eredeti (angol) címe – DVD film kategóriában kötelező | Kat.-függő |
| Attributes/Attribute (XML) | <Attribute_name> és <Attribute_value> párokkal; jellemzőként tárolódik | — |
| param name="..." (XML) | Egyedi jellemző: <param name="Szín">piros</param> | — |
| Egyéb CSV oszlopok | Ismeretlen fejlécű oszlopok jellemzőként kerülnek mentésre | — |
| cpc / bid | Kattintásonkénti licit (Ft); felülírja az alapértelmezett CPC-t | — |
| MaxCPCMultiplier | "BIDx1.5" formátum; 1.5–100 közötti érték, max. 1 tizedesjegy. Kiemelt megjelenésre vonatkozó licitszorzó. | — |
Kötelező mezők speciális kategóriákban
Egyes kategóriákban a hagyományostól eltérően további mezők megadása szükséges. Ezek hiányában a termék nem kerül listázásra.
📕 Könyv kategória
Az <ISBN13> mező megadása kötelező, 13 számjegyű termékazonosítóval.
🎬 DVD film kategória
Kötelező mezők: <RELEASE_DATE> (megjelenés éve) és <ORIGINAL_TITLE> (eredeti angol cím).
🚗 Gumiabroncs kategória
A <NAME> mezőnek tartalmaznia kell: Gyártó, Típus, Méret1, Méret2, LI, SI és Defekttűrő/Megerősített jelöléseket.
🔩 Alufelni kategória
A <NAME> mezőnek tartalmaznia kell: Gyártó, Típus, Csavarok száma, Osztókör, Felni átmérő és szélesség, Besajtolási mélység, Center Bore méret.
🌸 Parfüm kategória
A <NAME> mezőnek tartalmaznia kell: Gyártó, Név, Típus, Kiszerelés, Csomagolás, Célcsoport.
📱 Mobiltelefon kategória
Csak kártya- és szolgáltatófüggetlen, teljes gyári tartozéklistával (doboz, töltő stb.) együtt értendő árak jelenhetnek meg.
Pénznem és árfolyam
Alapértelmezés szerint HUF. Ha az árak más pénznemben szerepelnek (pl. EUR), a feed beállításánál add meg a pénznemet – a rendszer az aktuális, admin által beállított árfolyamon váltja forintra. A <currency> mező az XML-ben felülírja a feed szintű beállítást.
Feed beküldése
🔗 URL (automatikus)
Add meg a feed URL-jét a Feedek → Új feed menüben. A rendszer 6 óránként letölti és feldolgozza. Az URL legyen nyilvánosan elérhető az alábbi azonosítók számára:
- • User-Agent:
ArosszeBot/1.0 - • IP-cím:
142.132.238.28
Cloudflare / bot-védelem esetén add hozzá ezeket a kivételekhez.
📁 Fájl feltöltés
Ha a feed nem érhető el URL-en, töltsd fel a Feedek → Új feed → Fájl feltöltése opcióval (XML, CSV, TSV; gzip is elfogadott). Feltöltés után manuálisan indíthatod az importot.
Regisztráció szükséges: A feed beküldéséhez regisztrálj webáruházként. Regisztrálj itt →
Megjelenés szüneteltetése és azonnali leállítás
Ha ideiglenesen le szeretnéd állítani a termékek megjelenítését, az alábbi módszerek valamelyikét alkalmazhatod a feed frissítésén keresztül.
Nincs raktáron – DeliveryTime = NO
Ha a <DeliveryTime> értéke NO, a termék lekerül az oldalról. A teljes megjelenés felfüggesztéséhez minden terméknél állítsd be ezt az értéket.
Ár törlése – Price = 0
Ha a <Price> mező hiányzik vagy értéke 0, a termék automatikusan lekerül az oldalról.
⚠️ Fontos
A módosítás elmentése után a megjelenés csak a legközelebb esedékes feed-frissítésnél áll le – ez az előfizetési csomagtól függően néhány óra, de akár egy nap is lehet.
Ha a feed elérhetetlen lesz vagy törlöd a termékeket, a legutóbbi sikeresen letöltött feed jelenik meg tovább – ez NEM szünteti meg a megjelenést.
Soron kívüli ár- és szállítási frissítés – Prémium csomag
Prémium előfizetéssel napi egy alkalommal elindíthatsz egy extra frissítést egy szabadon választott időpontban (kivéve 0:30–7:30 között). Ez a Fiók → Feedek menüben érhető el.
A Prémium csomagra bármikor előfizethetsz; bankkártyás fizetés esetén a sikeres tranzakciót követően egy órán belül aktiválódik (23:00–06:00 közötti időszak kivételével).
Mi történik csere vagy módosítás esetén?
Bizonyos mezők módosítása vagy a teljes feed cseréje esetén fennáll a veszélye, hogy a termékek kiesnek az összevont termékoldalakról, kategóriákból, vagy nem jelennek meg az oldalon.
Érzékeny mezők – csak indokolt esetben módosítsd
Az alábbi mezők tartalmát csak szükségszerű javítás esetén változtasd meg. Egyetlen karakter megváltoztatása is módosításnak számít.
<CATEGORY>
<MANUFACTURER>
<NAME>
<PRODUCTNUMBER>
<EAN_CODE>
⛔ Ne módosítsd a termékek egyedi azonosítóját az <IDENTIFIER> mezőben.
⛔ Ne használj olyan azonosítót az <IDENTIFIER> mezőben, ami korábban már más terméknél szerepelt.
Mi történik, ha a termékek kiestek a pozíciókból?
Új termékként kerülnek vissza a feldolgozási sorba. Amennyiben továbbra is feldolgozhatók, 5–8 munkanap alatt visszakerülhetnek a helyükre.
Ha a korábbi feedet visszaállítod (az eredeti IDENTIFIER, CATEGORY, MANUFACTURER, NAME, PRODUCTNUMBER értékekkel), akár egy napon belül automatikusan helyreállhat a megjelenés.
Komplett terméklista csere
Új rendszerre való átállás esetén a legjobb megoldás, ha az alábbi mezők értéke változatlan marad az új feedben:
<IDENTIFIER>
<CATEGORY>
<MANUFACTURER>
<NAME>
<PRODUCTNUMBER>
Ha csak a product URL-ek változnak (pl. domain vagy HTTPS váltás), de a fenti mezők tartalma nem, a termékek korábbi pozíciója megmaradhat.
Ha az átmentésre nincs lehetőség, a termékek újrafeldolgozása 5–8 munkanapot vehet igénybe. Ez alatt kategorizálatlanul (csak keresésben) és kép nélkül jelennek meg.
Mely mezők változtathatók szabadon?
Az érzékeny mezőkön kívül minden egyéb mező – ár, szállítási adatok, leírás, kép URL, jellemzők – szabadon módosítható anélkül, hogy a termékek kiesnek az összevont termékoldalakról.
A módosítás megjelenési ideje 1–2 nap (alap csomag), vagy akár néhány óra (Prémium csomag esetén a fix frissítési időpontokban: ~7:30 · 9:00 · 11:30 · 13:30 · 15:30 · 17:30 · 21:30).
Képek és új termékek feldolgozása
Új termék képei
Új termékeknél a feldolgozási idő alatt (általában 5–8 munkanap) a feedben megadott képek még nem jelennek meg az oldalon. A betöltési idő maximum 8 munkanap. Csak vízjel és webshop logó nélküli, jó minőségű képek jeleníthetők meg.
Meglévő termék képének cseréje
Ha lecseréled a termékfotót a feedben, a kép nem frissül automatikusan. A manuális frissítés kérésre elvégezhető:
- • Termékoldalon összevont (product card) képek: manuális, hosszabb átfutással
- • Keresésben / kategóriában egyenként megjelenő termékek: visszaigazolást követő 1 napon belül
Új termék hozzáadása
A rendszer automatikusan érzékeli az új termékeket a napi feed-betöltés során. A betöltés után másnap a keresési eredményekben jelennek meg – egyelőre kategorizálatlanul és kép nélkül.
Ha a terméket korábban már bekategorizáltuk, és az IDENTIFIER, CATEGORY, MANUFACTURER, NAME és PRODUCTNUMBER mezők nem változtak, másnap már kategóriában lesz látható.
Ha az új terméket egy már besorolt kategóriához adod, a feldolgozási idő lerövidül – az ajánlat hamarabb kerülhet összevont termékoldalra.
Feldolgozási idők összefoglalója
- • Új termék kategorizálása: átlagosan 5–8 munkanap (egyes kategóriákban több is lehet)
- • Korábban besorolt, visszatérő termék: akár 1 napon belül
- • Teljes feed csere (fontos mezők változtak): 5–8 munkanap, a feed minőségétől függően
- • Kiesett pozíciók visszaállása (feed visszaállítással): akár 1 nap
- • Ár/szállítás frissítés (Prémium): néhány perc a fix időpontokon belül
Számos kategóriában automatikus feldolgozás is működik. Ha a feed adatai pontosak és teljesek, a termékek akár néhány nap alatt feldolgozásra kerülhetnek.
Marketplace mezők
A Marketplace-ben való részvételhez a szokásos kötelező mezőkön túl az alábbi mezők kitöltése is szükséges. Ezek nélkül a termék nem jelenik meg a Marketplace-ben.
Kötelező Marketplace-mezők
DeliveryTime
Marketplace-kötelezőA Marketplace-ben kizárólag raktáron lévő termékek jelenhetnek meg. A mezőben csak az alábbi három értéket fogadjuk el:
Ha a mező nincs kitöltve, vagy nem „1-es" értéket tartalmaz, a termék nem jelenik meg a Marketplace-ben. A megrendeléstől számítva 1 munkanapon belül fel kell adni a csomagot, a vásárlónak 3 munkanapon belül meg kell kapnia.
ImageUrl
Marketplace-kötelezőA termék fényképére mutató URL. Csak vízjel és webshop logó nélküli, jó minőségű kép fogadható el.
Description
Marketplace-kötelezőA termék szabadszavas leírása, amely tartalmazza a fontos paramétereket (szín, méret, gyártás éve stb.).
Ajánlott Marketplace-mezők
BasketDisabled
AjánlottSzabályozza, hogy a termék megvásárolható-e közvetlenül az oldalon (Marketplace mód), vagy csak a kereskedő webáruházába irányítjuk a vásárlót (PPC mód).
<BasketDisabled>0</BasketDisabled>
— a termék megjelenhet a Marketplace-ben
<BasketDisabled>1</BasketDisabled>
— a termék NEM jelenik meg a Marketplace-ben (csak PPC)
FreeDelivery
AjánlottFelülírja a szállítási díjtáblázat szerinti összeget. Ha az értéke 1, a termékoldalon „ingyenes" szállítási díj jelenik meg függetlenül a díjtáblázattól.
<FreeDelivery>1</FreeDelivery>
— ingyenes házhozszállítás (0 Ft), felülírja a díjtáblázatot
<FreeDelivery>0</FreeDelivery>
— a szállítási díjtáblázat szerint számítódik
Oversize
AjánlottTúlméretes termékek esetén a szállítási díjtáblázatban beállított „túlméretes termék" kategória szerinti szállítási díjat alkalmazza.
<Oversize>1</Oversize>
— túlméretes termék; a speciális szállítási díj érvényes
<Oversize>0</Oversize>
— normál termék
Weight
AjánlottA termék bruttó tömege, alap tartozékokkal és csomagolással együtt. A lehető legpontosabb szállítási díj kiszámításához ajánlott megadni.
DeliveryCostByProduct
AjánlottHa be van állítva, a szállítási díj automatikusan felszorzódik a kosárban lévő termékek számával. Pl. ha a szállítási díj 1 450 Ft és valaki 2 db-ot rendel, a szállítás ára 2 × 1 450 = 2 900 Ft lesz.
<DeliveryCostByProduct>1</DeliveryCostByProduct>
— szállítási díj × darabszám
<DeliveryCostByProduct>0</DeliveryCostByProduct>
— szállítási díj csak egyszer számítódik fel
Shopping mezők
A Shopping szolgáltatásban való részvételhez a szokásos kötelező mezőkön túl az alábbiak megadása is szükséges.
Kötelező Shopping-mezők
EanCode
Shopping-kötelezőA termék vonalkódja. Minimum 8, maximum 13 számjegy.
DeliveryCost
Shopping-kötelezőA termék szállítási költsége országon belül. Ha hiányzik vagy helytelenül van megadva, a rendszer automatikusan 4 990 Ft szállítási díjat jelenít meg.
Ajánlott Shopping-mezők
ShoppingDisabled
AjánlottSzabályozható, hogy az egész terméklista, vagy csak egy része jelenjen meg a Shopping szolgáltatásban. Az 1 érték letiltást, a 0 engedélyezést jelent.
<ShoppingDisabled>0</ShoppingDisabled>
— a termék megjelenhet a Shopping szolgáltatásban
<ShoppingDisabled>1</ShoppingDisabled>
— a termék NEM jelenik meg a Shopping szolgáltatásban
Tippek a minőségi feedhez
- ✓ Gyártói termékkód (MPN) megadása: stabilan tartja az ajánlatokat, névváltoztatás esetén sem esnek ki.
- ✓ EAN/vonalkód megadása: lehetővé teszi az automatikus adatdúsítást és felgyorsítja a feldolgozást.
- ✓ Pontos gyártói adatok: kizárólag a gyártó által meghatározott kódokat adj meg – hibás adatok a feldolgozás leállását okozhatják.
- ✓ Naprakész ár és készlet: a feed frissítési frekvenciája befolyásolja a megjelenési minőséget.
- ✓ Jó minőségű termékképek: fehér háttérű, legalább 500×500 px felbontású képek ajánlottak.
- ✓ Kategória hierarchia: pl.
Műszaki cikk - Fülhallgatóformában. - ✓ Szállítási díj és idő: vásárlók a teljes árat (termék + szállítás) hasonlítják össze.
- ✓ Jellemzők (szín, méret, anyag stb.): minél több jellemző, annál jobb a kereshetőség.
- ✗ delivery_time tartományok elkerülése:
3-5 naphelyett5 munkanap(a max. értéket add meg). - ✗ delivery_cost „0" kerülése:
ingyenesvagyFreeformátum javasolt.