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

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:

Á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 &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á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

Adatformátum

Infó

Mezők​

Azonosító​

Gyártó​

GTIN​

Tipp

Név​

Kategória​

URL​

Tipp

Ár​

Gyártói cikkszám​

Készlet​

Lehetséges állapotok:​

Kiszállítási idő​

Kiszállítási ár​

Extra termékadatok​

Leírás​

Képek​

Specifikációk​

Formátumok​

JSON​

Példa:​

XML​

Kép​

Specfikáció​

Példa:​

CSV​

Figyelem

Példa:​

Árukereső​

Mezők​

Figyelem

Dinamikus mezőnevek​

Google Product Feed​

Mezők

Azonosító

Gyártó

GTIN

Név

Kategória

URL

Ár

Gyártói cikkszám

Készlet

Lehetséges állapotok:

Kiszállítási idő

Kiszállítási ár

Extra termékadatok

Leírás

Képek

Specifikációk

Formátumok

JSON

Példa:

XML

Kép

Specfikáció

Példa:

CSV

Példa:

Árukereső

Mezők

Dinamikus mezőnevek

Google Product Feed