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ás | Példa | Kötelező |
---|---|---|---|
Azonosító | A termék egyedi azonosítója a webshopodban. | 123 , WS-123 | Kötelező |
Gyártó | A termék gyártója. | Apple | Kötelező |
GTIN | A termék GTIN vagy EAN kódja. | 0194252689905 | Ajánlott |
Név | A termék neve a webshopodban. | Apple iPhone 13 mini | Kötelező |
Kategória | A termék kategóriája a webshopodban. | Okostelefonok > Apple | Ajánlott |
URL | Link a termékre a webshopodban. | https://pledawebshop.hu/iphone-13-mini | Kötelező |
Ár | A termék bruttó ára forintban. | 320000 | Kötelező |
Gyártói cikkszám | A termék gyárói cikkszáma. | A2628 | Ajánlott |
Készlet | A termék készletinformációja. | in_stock | Ajánlott |
Kiszállítási idő | A termék kiszállítási ideje munkanapokban számolva. | 3 | Ajánlott |
Kiszállítási ár | A termék bruttó szállítási költsége forintban. | 990 | Ajánlott |
Leírás | A 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épek | Képek a termékről. | https://pledawebshop.hu/iphone-kep-1.png , https://pledawebshop.hu/iphone-kep-2.jpg | Opcionális |
Specifikációk | A 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
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:
Állapot | Enum elnevezés | Leírás |
---|---|---|
Raktáron | inStock | A termék elérhető kiszállítással, vagy készleten van egy boltban. |
Rendelhető | orderable | A terméket kiszállítás előtt még be kell szerezni. |
Nem elérhető | outOfStock | A 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ág | Típus | Példa |
---|---|---|---|
Azonosító | identifier | string | "identifier": "123" |
Gyártó | manufacturer | string | "manufacturer": "Apple" |
GTIN | gtin | string | "gtin": "0888462734868" |
Név | name | string | "name": "Apple iPhone SE 16GB - Space Gray" |
Kategória | category | string | "category": "Műszaki cikk > Mobil, navigáció > Mobiltelefon" |
URL | url | string | "url": "https://pledawebshop.hu/iphone-se-16gb-space-gray" |
Ár | price | number | "price": 120000 |
Gyártói cikkszám | manufacturerNumber | string | "manufacturerNumber": "A2783" |
Készlet | availability | enum(inStock, orderable, outOfStock) | "availability": "inStock" |
Kiszállítási ár | deliveryPrice | number | "deliveryPrice": 999 |
Kiszállítási idő | deliveryTimeInDays | number | "deliveryTimeInDays": "3" |
Leírás | description | string | "description": "..." |
Képek | images | string array | "images": ["https://pledawebshop.hu/iphone-kep-1.png", "https://pledawebshop.hu/iphone-kep-2.jpg"] |
Specifikációk | specifications | object 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ág | Típus | Példa |
---|---|---|---|
Azonosító | identifier | string | <identifier>123</identifier> |
Gyártó | manufacturer | string | <manufacturer>Apple</manufacturer> |
GTIN | gtin | string | <gtin>0888462734868</gtin> |
Név | name | string | <name>Apple iPhone SE 16GB - Space Gray</name> |
Kategória | category | string | <category>Műszaki cikk > Mobil, navigáció > Mobiltelefon</category> |
URL | url | string | <url>https://pledawebshop.hu/iphone-se-16gb-space-gray</url> |
Ár | price | number | <price>120000</price> |
Gyártói cikkszám | manufacturerNumber | string | <manufacturerNumber>A2783</manufacturerNumber> |
Készlet | availability | enum(inStock, orderable, outOfStock) | <availability>inStock</availability> |
Kiszállítási ár | deliveryPrice | number | <deliveryPrice>999</deliveryPrice> |
Kiszállítási idő | deliveryTimeInDays | number | <deliveryTimeInDays>3</deliveryTimeInDays> |
Leírás | description | string | <description>...</description> |
Képek | images | array of image | <images><image>https://pledawebshop.hu/iphone-kep-1.png</image><image>https://pledawebshop.hu/iphone-kep-2.jpg</image></images>] |
Specifikációk | specifications | array 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 "" />
<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ág | Típus | Példa |
---|---|---|---|
Azonosító | identifier | string | 123 |
Gyártó | manufacturer | string | Apple |
GTIN | gtin | string | 0888462734868 |
Név | name | string | Apple iPhone SE 16GB - Space Gray |
Kategória | category | string | "Műszaki cikk > Mobil, navigáció > Mobiltelefon" |
URL | url | string | https://pledawebshop.hu/iphone-se-16gb-space-gray |
Ár | price | number | 120000 |
Gyártói cikkszám | manufacturerNumber | string | A2783 |
Készlet | availability | enum(inStock, orderable, outOfStock) | inStock |
Kiszállítási ár | deliveryPrice | number | 999 |
Kiszállítási idő | deliveryTimeInDays | number | 3 |
Leírás | description | string | ... |
Képek | images | string | "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év | Name |
Kategória | Category |
URL | ProductUrl |
Ár | Price |
Gyártói cikkszám | ProductNumber |
Kiszállítási ár | DeliveryCost |
Kiszállítási idő | DeliveryTime |
GTIN | EanCode |
Leírás | Description |
Képek | ImageUrl és ImageUrl2 |
Specifikációk | Attributes |
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 munkanap | Készleten |
NO | Nem elérhető |
egyéb | Rendelhető |
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év | title |
Kategória | product_type vagy, ha ez nincs kitöltve, akkor google_product_category |
URL | link |
Ár | price, illetve, ha van megadva akciós ár (sale_price), akkor ez utóbbi felülírja az árat. |
Gyártói cikkszám | mpn |
Készlet | availability 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 ár | shipping |
Kiszállítási idő | shipping |
GTIN | gtin |
Leírás | description |
Képek | image_link és additional_image_link |
Specifikációk | product_detail |