Skip to main content

Adatformátum

Az webshopod termékeit úgynevezett feed-ek segítségével tudod feltöltei az Árcédulára. Ezeket a feed-eket az Árcédula időnként beolvassa, hogy az oldalon a legfrissebb adatok szerepeljenek.

A webshopod feed linkjét az Árcédula parnter felületén a Termékek menüpontban a Feedek fülnél tudod beállítani.

Infó

Egy webshophoz akár több feed url-t is lehet felvenni.

Többféle formátumú feed-et is támogatunk, erről a Formátumok részben esik szó bővebben. A termékek tulajdonságairól általánosságban a Mezők fejezetben van szó.

Mezők

MezőRövid leírásPéldaKötelező
AzonosítóA termék egyedi azonosítója a webshopodban.123, WS-123Kötelező
GyártóA termék gyártója.AppleKötelező
GTINA termék GTIN vagy EAN kódja.0194252689905Ajánlott
NévA termék neve a webshopodban.Apple iPhone 13 miniKötelező
KategóriaA termék kategóriája a webshopodban.Okostelefonok > AppleAjánlott
URLLink a termékre a webshopodban.https://pledawebshop.hu/iphone-13-miniKötelező
ÁrA termék bruttó ára forintban.320000Kötelező
Gyártói cikkszámA termék gyárói cikkszáma.A2628Ajánlott
KészletA termék készletinformációja.in_stockAjánlott
Kiszállítási időA termék kiszállítási ideje munkanapokban számolva.3Ajánlott
Kiszállítási árA termék bruttó szállítási költsége forintban.990Ajánlott
LeírásA termék részletes leírása.Saját fejlesztésű OLED-kijelzőnk 28%-kal nagyobb – akár 800 nites – fényerőre képes...Opcionális
KépekKépek a termékről.https://pledawebshop.hu/iphone-kep-1.png, https://pledawebshop.hu/iphone-kep-2.jpgOpcionális
SpecifikációkA termék specifikációi.Operációs rendszer: iOS 15
Processzor: Apple A15 Bionic
...
Opcionális

Azonosító

A termék egyedi azonosítója a webshopodban.

Az azonosító nem csak numerikus lehet, bármilyen szöveges alapú azonosító is elfogadott.

Gyártó

A termék gyártója.

GTIN

A termék GTIN vagy EAN kódja.

Tipp

A gyors besorolás érdekében érdemes megadni a GTIN kódot, ugyanis a legtöbb esetben ez alapján automatikusan be tudjuk sorolni a termékedet a megfelelő helyre.

Név

A termék neve.

Kategória

A termék kategóriája a webshopban. Érdemes minél pontosabb kategóriát megadni, ugyanis munkatársaink az új termékeket ez alapján gyorsabban be tudják kategorizálni.

URL

A termék URL-je a webshopodon. A felhasználót erre az URL-re irányítjuk, ha ráklikkel az ajánlatra.

Tipp

Érdemes a link végére egy extra URL paramétert tenni, ha a webshopodon szeretnéd követni, hogy melyik kattintások érkeztek az Árcéduláról.

Pl: https://www.pledawebshop.hu/termekurl?came-from-arcedula vagy https://www.pledawebshop.hu/termekurl?from=arcedula.

Ár

A termék bruttó ára forintban.

Gyártói cikkszám

A termék gyártói cikkszáma.

Készlet

Információ a termék elérhetőségéről.

Lehetséges állapotok:

ÁllapotEnum elnevezésLeírás
RaktároninStockA termék elérhető kiszállítással, vagy készleten van egy boltban.
RendelhetőorderableA terméket kiszállítás előtt még be kell szerezni.
Nem elérhetőoutOfStockA termék nem elérhető.

Kiszállítási idő

A termék házhozszállítási ideje munkanapokban.

Kiszállítási ár

A termék bruttó szállítási költsége forintban. Ingyenes kiszállítás esetén 0-t kell megadni.

Extra termékadatok

Ezek az adatok elsősorban akkor kerülnek felhasználásra, ha más webshopoktól nem kaptunk ilyen adatokat egy adott termékhez.

Leírás

A termék részletes leírása.

Képek

Képek a termékről.

Specifikációk

A termék specifikációi.

Formátumok

JSON

MezőJSON tulajdonságTípusPélda
Azonosítóidentifierstring"identifier": "123"
Gyártómanufacturerstring"manufacturer": "Apple"
GTINgtinstring"gtin": "0888462734868"
Névnamestring"name": "Apple iPhone SE 16GB - Space Gray"
Kategóriacategorystring"category": "Műszaki cikk > Mobil, navigáció > Mobiltelefon"
URLurlstring"url": "https://pledawebshop.hu/iphone-se-16gb-space-gray"
Árpricenumber"price": 120000
Gyártói cikkszámmanufacturerNumberstring"manufacturerNumber": "A2783"
Készletavailabilityenum(inStock, orderable, outOfStock)"availability": "inStock"
Kiszállítási árdeliveryPricenumber"deliveryPrice": 999
Kiszállítási idődeliveryTimeInDaysnumber"deliveryTimeInDays": "3"
Leírásdescriptionstring"description": "..."
Képekimagesstring array"images": ["https://pledawebshop.hu/iphone-kep-1.png", "https://pledawebshop.hu/iphone-kep-2.jpg"]
Specifikációkspecificationsobject with string keys and values"specifications": {"Kijelző felbontása": "640 x 1136", "Kijelző mérete": "4 \"", "Processzormagok száma": "2"}

Példa:

[
{
"identifier": "123",
"manufacturer": "Apple",
"gtin": "0888462734868",
"name": "Apple iPhone SE 16GB - Space Gray",
"category": "Műszaki cikk > Mobil, navigáció > Mobiltelefon",
"url": "https://pledawebshop.hu/iphone-se-16gb-space-gray",
"price": 120000,
"manufacturerNumber": "A2783",
"availability": "inStock",
"deliveryPrice": 999,
"deliveryTimeInDays": 3,
"description": "...",
"images": [
"https://pledawebshop.hu/iphone-kep-1.png",
"https://pledawebshop.hu/iphone-kep-2.jpg"
],
"specifications": {
"Kijelző felbontása": "640 x 1136",
"Kijelző mérete": "4 \"",
"Processzormagok száma": "2"
}
},
{
"identifier": "124",
"manufacturer": "Apple",
"gtin": null,
"name": "Apple iPhone SE 128GB - Space Gray",
"category": "Műszaki cikk > Mobil, navigáció > Mobiltelefon",
"url": "https://pledawebshop.hu/iphone-se-16gb-space-gray",
"price": 120000,
"manufacturerNumber": "A2783",
"availability": "outOfStock",
"deliveryPrice": null,
"deliveryTimeInDays": null,
"description": "...",
"images": [],
"specifications": {}
},
{
"identifier": "05dcb383-6e15-490f-8e54-93fbff98e8f7",
"manufacturer": "Apple",
"gtin": null,
"name": "Apple iPhone SE 64GB - Space Gray",
"category": "Műszaki cikk > Mobil, navigáció > Mobiltelefon",
"url": "https://pledawebshop.hu/iphone-se-16gb-space-gray",
"price": 120000,
"manufacturerNumber": null,
"availability": null,
"deliveryPrice": 999,
"deliveryTimeInDays": null,
"description": null,
"images": null,
"specifications": null
},
{
"identifier": "eb4a4278-d041-11ec-9d64-0242ac120002",
"manufacturer": "Apple",
"name": "Apple iPhone SE 32GB - Space Gray",
"category": "Műszaki cikk > Mobil, navigáció > Mobiltelefon",
"url": "https://pledawebshop.hu/iphone-se-16gb-space-gray",
"price": 120000
}
]

XML

MezőJSON tulajdonságTípusPélda
Azonosítóidentifierstring<identifier>123</identifier>
Gyártómanufacturerstring<manufacturer>Apple</manufacturer>
GTINgtinstring<gtin>0888462734868</gtin>
Névnamestring<name>Apple iPhone SE 16GB - Space Gray</name>
Kategóriacategorystring<category>Műszaki cikk > Mobil, navigáció > Mobiltelefon</category>
URLurlstring<url>https://pledawebshop.hu/iphone-se-16gb-space-gray</url>
Árpricenumber<price>120000</price>
Gyártói cikkszámmanufacturerNumberstring<manufacturerNumber>A2783</manufacturerNumber>
Készletavailabilityenum(inStock, orderable, outOfStock)<availability>inStock</availability>
Kiszállítási árdeliveryPricenumber<deliveryPrice>999</deliveryPrice>
Kiszállítási idődeliveryTimeInDaysnumber<deliveryTimeInDays>3</deliveryTimeInDays>
Leírásdescriptionstring<description>...</description>
Képekimagesarray of image<images><image>https://pledawebshop.hu/iphone-kep-1.png</image><image>https://pledawebshop.hu/iphone-kep-2.jpg</image></images>]
Specifikációkspecificationsarray of specification<specifications><specification name="Kijelző felbontása" value="640 x 1136" /><specification name="Kijelző mérete" value="4 \""/><specification name="Processzormagok száma" value="2" /></specifications>

Kép

Az <image> tag tartalma string típusú, tartalmaz egy url-t a termék egyik képéhez.

Specfikáció

A <specification> tag-nek két attribútuma van: a name és a value. A name a specifikáció nevét tartalmazza, a value pedig az értékét. Mindkét attribútum string típusú.

Példa:

<products>
<product>
<identifier>123</identifier>
<manufacturer>Apple</manufacturer>
<gtin>0888462734868</gtin>
<name>Apple iPhone SE 16GB - Space Gray</name>
<category>Műszaki cikk > Mobil, navigáció > Mobiltelefon</category>
<url>https://pledawebshop.hu/iphone-se-16gb-space-gray</url>
<price>120000</price>
<manufacturerNumber>A2783</manufacturerNumber>
<availability>inStock</availability>
<deliveryPrice>999</deliveryPrice>
<deliveryTimeInDays>3</deliveryTimeInDays>
<description>...</description>
<images>
<image>https://pledawebshop.hu/iphone-kep-1.png</image>
<image>https://pledawebshop.hu/iphone-kep-2.jpg</image>
</images>
<specifications>
<specification name="Kijelző felbontása" value="640 x 1136" />
<specification name="Kijelző mérete" value="4 &quot;" />
<specification name="Processzormagok száma" value="2" />
</specifications>
</product>
<product>
<identifier>124</identifier>
<manufacturer>Apple</manufacturer>
<gtin>0888462734868</gtin>
<name>Apple iPhone SE 16GB - Space Gray</name>
<category>Műszaki cikk > Mobil, navigáció > Mobiltelefon</category>
<url>https://pledawebshop.hu/iphone-se-16gb-space-gray</url>
<price>120000</price>
<manufacturerNumber>A2783</manufacturerNumber>
<availability>orderable</availability>
<deliveryPrice>999</deliveryPrice>
<deliveryTimeInDays>3</deliveryTimeInDays>
<description>...</description>
<images>
</images>
<specifications>
</specifications>
</product>
<product>
<identifier>eb4a4278-d041-11ec-9d64-0242ac120002</identifier>
<manufacturer>Apple</manufacturer>
<name>Apple iPhone SE 16GB - Space Gray</name>
<category>Műszaki cikk > Mobil, navigáció > Mobiltelefon</category>
<url>https://pledawebshop.hu/iphone-se-16gb-space-gray</url>
<price>120000</price>
</product>
</products>

CSV

Az Árcádula támogatja a szabványos CSV formátumot, vessző (,) elválasztó karakterrel.

MezőJSON tulajdonságTípusPélda
Azonosítóidentifierstring123
GyártómanufacturerstringApple
GTINgtinstring0888462734868
NévnamestringApple iPhone SE 16GB - Space Gray
Kategóriacategorystring"Műszaki cikk > Mobil, navigáció > Mobiltelefon"
URLurlstringhttps://pledawebshop.hu/iphone-se-16gb-space-gray
Árpricenumber120000
Gyártói cikkszámmanufacturerNumberstringA2783
Készletavailabilityenum(inStock, orderable, outOfStock)inStock
Kiszállítási árdeliveryPricenumber999
Kiszállítási idődeliveryTimeInDaysnumber3
Leírásdescriptionstring...
Képekimagesstring"https://pledawebshop.hu/iphone-kep-1.png,https://pledawebshop.hu/iphone-kep-2.jpg"
Figyelem

A CSV formátum technikai okokból nem tartalmazza a specifikációkat.

Példa:

identifier,manufacturer,gtin,name,category,url,price,manufacturerNumber,availability,deliveryPrice,deliveryTimeInDays,description,images
"123","Apple","0888462734868","Apple iPhone SE 16GB - Space Gray","Műszaki cikk > Mobil, navigáció > Mobiltelefon","https://pledawebshop.hu/iphone-se-16gb-space-gray","120000","A2783","inStock","999","3","...","https://pledawebshop.hu/iphone-kep-1.png,https://pledawebshop.hu/iphone-kep-2.jpg"
"124","Apple","0888462734868","Apple iPhone SE 16GB - Space Gray","Műszaki cikk > Mobil, navigáció > Mobiltelefon","https://pledawebshop.hu/iphone-se-16gb-space-gray","120000","A2783","outOfStock","999","3","...","https://pledawebshop.hu/iphone-kep-1.png"
"eb4a4278-d041-11ec-9d64-0242ac120002","Apple","","Apple iPhone SE 16GB - Space Gray","Műszaki cikk > Mobil, navigáció > Mobiltelefon","https://pledawebshop.hu/iphone-se-16gb-space-gray","120000","","","","","",""

Árukereső

Az Árcédula kompatibilis az Árukeresős feedekkel is.

Mezők

Árcédula mezőÁrukereső mező
AzonosítóIdentifier
GyártóManufacturer
NévName
KategóriaCategory
URLProductUrl
ÁrPrice
Gyártói cikkszámProductNumber
Kiszállítási árDeliveryCost
Kiszállítási időDeliveryTime
GTINEanCode
LeírásDescription
KépekImageUrl és ImageUrl2
SpecifikációkAttributes
Figyelem

Az Árukeresős feed nem tartalmazza a Készlet mezőt, ezt az információt az alábbi táblázat szerint számoljuk ki:

Árukereső Kiszállítási idő (DeliveryTime)Készlet
1, 1 nap, 1 munkanapKészleten
NONem elérhető
egyébRendelhető

Dinamikus mezőnevek

A régebbi Árukeresős feedekben lehetőség volt dinamikus mezőneveket megadni. Ez azt jelenti, hogy a CSV-ben és az XML-ben nem kötelező azt a mezőnevet használni, amit az Árukereső megadott. Ezt az Árcédula is támogatja, de előzetes egyeztetés szükséges az ilyen feedek felvételéhez.

Google Product Feed

Az Árcédula kompatibilis az Google Product Feed-del is.

Árcédula mezőGoogle Product Feed mező
Azonosítóid
Gyártóbrand
Névtitle
Kategóriaproduct_type vagy, ha ez nincs kitöltve, akkor google_product_category
URLlink
Árprice, illetve, ha van megadva akciós ár (sale_price), akkor ez utóbbi felülírja az árat.
Gyártói cikkszámmpn
Készletavailability
Mivel a preorder és backorder értékekkel az Árcédula nem kompatibilis, ezért ilyen esetekben üres adatként értelmezzük ezt a mezőt.
Kiszállítási árshipping
Kiszállítási időshipping
GTINgtin
Leírásdescription
Képekimage_link és additional_image_link
Specifikációkproduct_detail