Compari specifikace feedu
Aby mohlo dojít k importu produktů do našeho vyhledávače, je zapotřebí mít vytvořený tzv. XML soubor nebo csv souboru (feed). Jde o jednoduchý datový formát, pomocí kterého nám předáte informace o zboží a jeho cenách. Feed je automaticky generován z vašich stránek, a proto jeho vytvoření či úpravy konzultujte se svým webmasterem.
Váš feed stahujeme každý den v 16 hodin, aktualizaci daných produktů zobrazuje následující den. V případě potřeby časnějších aktualizací doporučujeme prémiový balíček.
Povinná pole
Povinná pole
|
Identifier
|
Jedinečný identifikátor produktu používaný internetovým obchodem. Jeho hodnota zůstává nezměněna.
|
Manufacturer
|
Název výrobce produktu. Volitelně jej lze zadat také na začátek názvu produktu do pole Název.
Příklad: Sony
|
Name
|
Název produktu. Na začátku s velkým písmenem, použití dalších velkých písmen je povoleno pouze v odůvodněných případech (např. zkratka). Název musí obsahovat celý název. Nesmí naopak obsahovat reklamu.
Příklad: Cyber-shot DSC-H10
Pokud nemůžete zadat název výrobce do samostatného pole, zadejte jej zde před název produktu.
Příklad: Sony Cyber-shot DSC-H10
|
Category
|
Zařazení produktu do kategorie. Dokážeme zpracovat plynulé, hierarchicky strukturované kategorie. Všechny používané kategorii můžete najít zde: https://www.compari.ro/MainCategories.php
Příklad: Electronice > Camere foto si video > Aparate foto
|
ProductUrl
|
Odkaz (URL) na stránku produktu.
Příklad: http://www.example.com/products.php?id=45884
|
Price
|
Cena produktu pro koncového uživatele (cena včetně DPH a dalších daní, které musí spotřebitel zaplatit za daný produkt). Cena minimálního množství, které lze objednat a je uvedeno na stránkách produktu.
|
Další doporučená pole
Další doporučená pole
|
ProductNumber
|
Kód produktu poskytnutý výrobcem.
ProductNumber musí být uvedeno ve feedu v případě elektroniky, IT, domácího zboží a v těch kategoriích, ve kterých zpracování probíhá na základě kódu produktu.
Přijímáme pouze kódy produktů používané výrobcem.
Příklady: KD-55XF9005, GV-N166TOC-6GD, 90MP00M1-B0UA00
|
MaxCPCMultiplier
|
Multiplikátor max. nabídky produktu. S jeho pomocí určujete násobení ceníkové ceny. Tzn. cena za proklik doporučené pozice, kterou jste ochotni zaplatit v porovnání se základní cenou kategorie.
Hodnoty nabídek uvedené ve feedu jsou akceptovány systémem Compari.ro, pokud jsou splněny následující podmínky:
-
Před multiplikátor nabídky je vložen výraz „BIDx“.
-
Hodnota multiplikátoru nabídky je číslo mezi 1,5 a 100,0.
-
Hodnota násobitele nabídky obsahuje maximálně jedno desetinné místo.
-
Správné formáty: "BIDx1,5"; "BIDx1,5"; "BIDx2"; "BIDx9.4".
-
Nesprávné formáty: "1.5"; "BID:1,5";„BIDx1,55“.
Multiplikator max. nabídky produktu zohledňujeme pouze v případě produktu, který zobrazujeme na Compari.
Pokud je pro produkt nastaven multiplikátor nabídky jak v administraci obchodu, tak ve feedu, systém zohlední nabídku zadanou v administraci obchodu.
|
DeliveryCost
|
Náklady na doručení produktu domů.
Pokud jsou náklady na dopravu produktu po celé zemi zdarma, bez ohledu na váhu a cenu produktu, správné formáty jsou: FREE, gratuit, gratis, fara cost
Pokud jsou náklady na dopravu produktu po celé zemi stanoveny bez ohledu na váhu a cenu produktu, např. 30 RonF (částka včetně DPH), správné formáty jsou: 30; 30 RON.
|
DeliveryTime
|
Dodací lhůta produktu. Daný produkt bude dodán do tohoto počtu pracovních dnů ode dne uskutečnění objednávky. Údaj je nutné uvádět ve dnech.
Správné formáty: 2; 2 zile; 2 zile lucratoare (2 pracovní dny – ve feedu se musí zobrazit maďarská verze)
Nesprávné formáty: 1 saptamana; 2-4 zile; In stoc (1 týden; 2–4 dny; na skladě; skladem)
Pro produkty, které lze odeslat okamžitě (nebo následující pracovní den), je správný formát: is: 1; 1 zi; 1 zi lucratoare (1 pracovní den – ve feedu se musí zobrazit rumunská verze)
Pokud produkt nelze objednat, zadejte do pole “NO” („NE“) a výrobek se na Compari.ro neobjeví.
Poskytované informace se zobrazují následovně: In stoc ( Skladem), Livrare: max 3 zile (Dodání: max. 3 dny), Livrare: max 1 sapt (Dodání: max. 1 týden), Szállítás: max 2 hét (Dodání: max. 2 týdny) , Livrare: max 2 sapt (Dodání: min. 2 týdny)
Tyto údaje můžeme zobrazit pouze v případě, že je lze nalézt také na stránce produktu. V případě produktových stránek obsahujících několik nabídek musí být jasně identifikovatelné, na kterou nabídku se informace vztahuje.
|
EanCode
|
Min. 8místný, max. 13místný identifikátor produktu poskytnutý výrobcem; Musí být jedinečný.
|
ShoppingDisabled
|
Zakázání produktu ve službě Compari Shopping
V seznamu produktů zadejte následující:
1 ⇒ Pokud si nepřejete zobrazovat daný produkt ve službě Compari Shopping.
0 (nebo prázdné polo) ⇒ Daný produkt lze zobrazit ve službě Compari Shoping.
|
EnergyEfficiencyA-G
|
Třída energetické účinnosti daného produktu platná od 1. 3. 2021, která může být A–G.
|
EnergyLabelA-G
|
Odkaz (URL) na obrázek nového energetického štítku výrobku, který vstoupil v platnost 1. 3. 2021.
Příklad: http://www.example.com/energylabels/45884.jpg
|
DetailedSpecificationA-G
|
Odkaz (URL) na nový podrobný technický list produktu, který vstoupil v platnost 1. 3. 2021. Žádáme o předání podrobného datového listu ve formátu pdf nebo jpg/png.
Příklad: http://www.example.com/datasheet/93812.pdf
|
Description
|
Popis produktu, který obsahuje důležité parametry. Aby zákazníci mohli získat přesné informace.
|
ImageUrl
|
Odkaz (URL) na fotografii produktu. Pokud je obrázek k dispozici v několika velikostech, vyplatí se uvést odkaz na nejlepší kvalitu. Minimální velikost, kterou můžeme zobrazit, je 150 × 150 pixelů. Uveďte prosím skutečný obrázek produktu. Obrázek který obsahuje pouze informaci „Brzy bude nahrán“ nebo logo společnosti jsou považovány za neplatné.
Příklad: http://www.example.com/images/45884.jpg
|
ImageUrl2
|
Odkaz (URL) na fotografii produktu v případě, že máte více obrázků.
Příklad: http://www.example.com/images/45885.jpg
|
Color
|
Dominantní barva produktu. Pole se používá pouze v kategorii móda.
U produktu zadejte pouze jednu barvu. Pokud má produkt více barevných variant, zadejte produkt do feedu s jedinečným identifikátorem a názvem tolikrát, kolikrát je dostupný v různých barvách.
Barvu můžeme přijmout pouze v případě, že barva produktu na přiloženém obrázku odpovídá barvě uvedené v tomto poli. Nepoužívejte prosím stejný obrázek produktu pro každou verzi.
|
Size
|
Velikost produktu. Pole se používá pouze v kategorii Móda.
U produktu zadejte pouze jednu velikost. Pokud má produkt více velikostních variant, zadejte produkt do feedu s jedinečným identifikátorem a názvem tolikrát, kolikrát je v různých velikostech k dispozici.
Náš systém dokáže interpretovat pouze velikosti EU a International (S/M/L), jiné velikosti nemůžeme akceptovat..
|
GroupId
|
Seskupení produktů, které jsou zahrnuty v produktovém feedu několikrát. Variace může být způsobena barvou, velikostí, vzorem nebo jinými vlastnostmi produktu (např. velikost paměti).
|
Attributes
|
Pole vhodné pro přenos vlastností produktu. Produkty odeslané s parametry jsou automaticky filtrovány v kategoriích. Čím více informací poskytnete, tím snáze budou vaše produkty dohledatelné.
Charakteristiky produktu můžeme zpracovat v XML bez ohledu na typ seznamu produktů, který lze zpřístupnit následujícím způsobem:
<Atributy>
<Atribut>
<Attribute_name>Típus</Attribute_name>
<Attribute_value>Fejhallgató</Attribute_value>
</Attribute>
<Atribut>
<Attribute_name>Vezeték nélküli</Attribute_name>
<Attribute_value>Igen</Attribute_value>
</Attribute>
</Atributes>
V případě feedu ve formátu CSV lze obsah mezi tagy Attributes v příkladu umístit do sloupce Attributes v CSV. V takovém případě nejsou úvodní a závěrečné tagy Attributes v příkladu potřeba. Pro ilustraci pomůže příklad v dolní části stránky.
U charakteristických hodnot produktu vždy uvádějte měrnou jednotku!
|
Speciální kategorie
Pro následující speciální kategorie požadujeme jiné informace a tagy: DVD, Knihy, Pneumatiky a Parfémy.
Požadavky v kategorii DVD FILM
|
Povinná pole:
|
ReleaseDate – Rok vydání filmu
OriginalTitle – původní anglický název filmu
Name – Název filmu v maďarštině
Price – Hrubá cena produktu
Category – Zařazení produktu do kategorie
ProductUrl – Jedinečná URL adresa produktu
|
Doporučené pole:
|
Description – Stručný popis DVD
|
Požadavky v kategorii KNIHA
|
Povinná pole:
|
ISBN13 – 13místné číslo (identifikátor produktu, musí být jedinečný)
Name – Název produktu (Titul knihy)
Price – Hrubá cena produktu
ProductUrl – Jedinečná URL adresa produktu
Category – Zařazení produktu do kategorie
|
Doporučená pole:
|
ImageUrl – URL link na produktové foto
Author – Jméno autora knihy
Description – Stručný popis knihy
ReleaseDate – Rok publikace
Pages – Počet stran
Weight – Hmotnost včetně měrné jednotky (kg, g) např: 1 000 g
Language – Jazyk
|
Požadavky v kategorii PNEUMATIKY
|
Povinné informace v tagu “Name”
|
Typ – např. ContiPremiumContact 2
Velikost 1 – např. 205/60
Velikost 2 – např. R16
LI (hmotnostní index) – např. 96
SI (rychlostní index) – např. H
Dojezdové/vyztužené pneumatiky – např. RFT, XL
|
Název produktu, který akceptujeme pro tuto pneumatiku, je: Continental ContiPremiumContact 2 SSR XL 205/60 R16 96H. Pořadí jednotlivých parametrů se může měnit, ale výrobce by měl být přednostně uveden buď samostatně, nebo na začátku názvu produktu.
Požadavky v kategorii slitinové kolo
|
Povinné informace v tagu “Name”
|
Typ – např. Dark Blade AN
Počet šroubů, roztečná kružnice – např. 4/100
Průměr a šířka ráfku – např. 15 × 6,5
Hloubka zasunutí – např. ET38
Velikost středové díry – např. CB72,3
|
Název produktu, který akceptujeme pro toto alu kolo je: MOMO Dark Blade AN CB72.3 4/100 15x6.5 ET38.Pořadí jednotlivých parametrů se může měnit, ale pořadí v rámci parametrů nikoliv. Pro průměr a šířku ráfku nemůžeme akceptovat verzi 6,5 × 15. Výrobce by měl být uveden buď samostatně, nebo na začátku názvu produktu.
Požadavky kategorii PARFÉM
|
Povinné informace v tagu “Name”
|
Manufacturer: HUGO BOSS
Název – např.: Baldessarin;
Typ – koncentrace vůně např.: EDP
Balení – velikost balení např.: 75 ml
Balení – V případě testerů uveďte v názvu slovo „Tester“ nebo „Teszter“
Cílová skupina: např.: Muži
|
Název produktu, který akceptujeme pro tento parfém je: HUGO BOSS Baldessarini EDP 75ml for men Tester: : HUGO BOSS Baldessarini EDP 75ml Tester for menPořadí jednotlivých parametrů se může měnit, ale výrobce by měl být přednostně uveden buď samostatně, nebo na začátku názvu produktu.
Povinná pole pro Compari Marketplace
Doporučená pole, která jsou povinná pro partnery využívající službu Compari Marketplace
|
Description
|
Popis produktu, který obsahuje důležité parametry. Aby zákazníci mohli získat přesné informace.
|
ImageUrl
|
Odkaz (URL) na fotografii produktu. Pokud je obrázek k dispozici v několika velikostech, vyplatí se uvést odkaz na nejlepší kvalitu. Minimální velikost, kterou můžeme zobrazit, je 150 ×150 pixelů. Uveďte prosím skutečný obrázek produktu, obrázek typu „Brzy bude nahrán“ nebo logo společnosti není platný.
Příklad: http://www.example.com/images/45884.jpg
|
DeliveryTime
|
Dodací lhůta produktu. Produkt bude dodán do tohoto počtu pracovních dnů ode dne uskutečnění objednávky. Údaj je nutné uvádět ve dnech.
Správné formáty: 2; 2 zile; 2 zile lucratoare ( pracovní dny – ve feedu se musí zobrazit rumunská verze).
Nesprávné formáty: 1 saptamana; 2-4 zile; In stoc (1 týden; 2–4 dny; na skladě; skladem).
Pro produkty, které lze odeslat okamžitě (nebo následující pracovní den), je správný formát:is: 1; 1 zi; 1 zi lucratoare (1 pracovní den – ve feedu se musí zobrazit maďarská verze)
Pokud produkt nelze objednat, zadejte do pole “NO” („NE“) a výrobek se na Compari.ro neobjeví.
Poskytované informace se zobrazují následovně: In stoc (Skladem), Livrare: max 3 zile ( Dodání: max 3 dny), Livrare: max 1 sapt (Dodání: max 1 týden), Szállítás: max 2 hét (Dodání: max 2 týdny) , Livrare: max 2 sapt (Dodání: min. 2 týdny).
Tyto údaje můžeme zobrazit pouze v případě, že je lze nalézt také na stránce produktu. V případě produktových stránek obsahujících několik nabídek musí být jasně identifikovatelné, na kterou nabídku se informace vztahuje.
|
Aby prodejci, kteří využívají službu Compari Marketplace, mohli zobrazit nabídky kombinovaných produktů v určitých kategoriích, je kromě názvu používaného výrobcem vyžadována přítomnost barvy (například: ‚Huawei P20 lite 64GB DUAL SIM noční černá“, „Sluchátka JBL T110, bílá“, „Nikon Coolpix B500 (fialová)“). Barvu není možné označit pomocí tagu “Color”, jelikož jej lze z technických důvodů využít pouze v kategorii Móda.
Doporučená pole pro Compari Marketplace
Doporučená pole pro naše partnery účastnící se Compari Marketplace
|
BasketDisabled
|
Nezobrazujte produkt v Compari Marketplace .
V seznamu produktů zadejte následující:
1 ⇒ Pokud si nepřejete zobrazovat daný produkt na Comapri Marketplace.
0 (nebo prázdné pole) ⇒ Daný produkt lze zobrazit na Compari Marketplace.
|
FreeDelivery
|
Doručení domů zdarma je možné uvést v případě, že má produkt doručení v Rumunsku zdarma. A to i přes to, co je uvedeno v tabulce poplatků v administraci obchodu.
Jeho zadání je nepovinné a výchozí hodnota je 0. Poplatek za doručení se vypočítá podle tabulky poplatků za doručení z administrace obchodu.
V seznamu produktů zadejte následující:
1 ⇒ Pokud je poplatek za doručení produktu v Rumunsku 0 Ron. Bez ohledu na to, co je uvedeno v tabulce poplatků za doručení.
0 ⇒ Pokud chcete zobrazit poplatek za doručení produktu podle tabulky Poplatek za doručení.
|
Oversize
|
U nadrozměrných produktů nabízí administrace obchodu možnost stanovení speciálních poplatků za doručení.
V seznamu produktů jej prosím zadejte následovně:
1 ⇒ U produktů, které podléhají poplatkům za dopravu „nadrozměrných produktů“ uvedených v Tabulce poplatků za dopravu.
0 ⇒ Pro všechny ostatní produkty.
|
Weight
|
Hrubá hmotnost produktu kalkulovaná se základním příslušenstvím a balením. Kromě hmotnosti výrobku je povinné uvést měrnou jednotku, kterou může být kg nebo g.
Správné formáty: 2 kg; 1 000 g.
Nesprávné formáty: 2; 1 000 gramů.
|
DeliveryCostByProduct
|
Náklady na doručení daného produktu se vypočítávají na základě počtu stejných položek v košíku.
Zadání tohoto tagu je nepovinné a jeho výchozí hodnota je 0. Poplatek za doručení se vypočítá podle tabulky poplatků za doručení z administrace obchodu.
Ve feedu jej prosím vyplňte následovně:
1 ⇒ Určuje produkty, na které se vztahuje poplatek za doručení podle počtu produktů v košíku.
0 ⇒ Nezáleží na tom, kolik produktů bude vloženo do košíku. Náklady na dopravu budou účtovány pouze jednou.
|
Výše uvedená data lze odeslat ve formátu CSV/TSV nebo XML formátu.
Použití formátu CSV/TSV
Pro vyplnění můžete použít čárky, středníky, tabulátory. První řádek by měl obsahovat název polí, ostatní řádky údaje o daném produktu. Oddělovací znak v datovém poli se může objevit pouze v případě, že je dané pole v uvozovkách. V takových případech by měly být uvozovky "escapovány". Náš systém podporuje jako řešení také zdvojení (""xy"") a zpětné lomítko (\"xy\"). Podobně jako v případě CSV lze i v případě TSV změnit tabulátory v datových polích na "mezeru". To je důvod, proč je použití TSV v praxi jednodušší. Například funkce "fputcsv" programovacího jazyka PHP funguje podle výše uvedeného popisu.
Příklad CSV
"category";"manufacturer";"name";"description";"price";"imageurl";"producturl";"deliverytime";"deliverycost";"identifier";"eancode";"attributes"
"Calculatoare>Laptop";"HP";"ProBook 655 F1P82EA";"Tipul de produs: Notebook...";"4033";"http://www.example.com/images/12554.jpg";"http://www.example.com/products.php?id=1231231";"1 zile";"20 RON";"1231231";"0888182757192";"<Attribute><Attribute_name>Capacitate memorie</Attribute_name><Attribute_value>8 GB</Attribute_value></Attribute> <Attribute><Attribute_name>Rezolutie ecran</Attribute_name><Attribute_value>1920 x 1080</Attribute_value></Attribute> <Attribute><Attribute_name>Capacitate Hard Disk</Attribute_name><Attribute_value>128 GB</Attribute_value></Attribute> <Attribute><Attribute_name>Bluetooth</Attribute_name><Attribute_value>Da</Attribute_value></Attribute>"
"Calculatoare>Laptop";"Lenovo";"IdeaPad 100 80T70079RI";"Laptop Lenovo IdeaPad 110-15IBR, 15.6" HD (1366x768)...";"999";"http://www.example.com/images/12555.jpg";"http://www.example.com/products.php?id=1231232";"5 zile";"FREE";"1231232";"";"<Attribute><Attribute_name>Capacitate memorie</Attribute_name><Attribute_value>4 GB</Attribute_value></Attribute> <Attribute><Attribute_name>Rezolutie ecran</Attribute_name><Attribute_value>1366 x 768</Attribute_value></Attribute> <Attribute><Attribute_name>Capacitate Hard Disk</Attribute_name><Attribute_value>500 GB</Attribute_value></Attribute> <Attribute><Attribute_name>Bluetooth</Attribute_name><Attribute_value>Da</Attribute_value></Attribute>"
"Calculatoare>Mouse";"Hama";"uRage Illuminated 113722";"Mouse uRage Illuminated cu senzor optic.";"125";"http://www.example.com/images/12556.jpg";"http://www.example.com/products.php?id=1231233";"1 zile";"20 RON";"1231233";"4047443184320";"<Attribute><Attribute_name>Tip senzor</Attribute_name><Attribute_value>Optical</Attribute_value></Attribute> <Attribute><Attribute_name>Conectivitate</Attribute_name><Attribute_value>Usb</Attribute_value></Attribute> <Attribute><Attribute_name>Wireless</Attribute_name><Attribute_value>Nu</Attribute_value></Attribute>"
"Electronice>Obiectiv aparat foto";"Canon";"EF 50mm f/1.8 STM 0570C005AA";"Canon EF 50mm f/1.8 STM este un obiectiv DSLR pe montura Canon EF...";"520";"http://www.example.com/images/12551.jpg";"http://www.example.com/products.php?id=1231234";"3 zile";"20 RON";"1231234";"0018208021994";"<Attribute_name>Compatibil cu tip montare baioneta</Attribute_name><Attribute_value>Baioneta Canon</Attribute_value></Attribute> <Attribute><Attribute_name>Distanta focala</Attribute_name><Attribute_value>50 mm</Attribute_value></Attribute> <Attribute><Attribute_name>Numar de lamele ale diafragmei</Attribute_name><Attribute_value>7</Attribute_value></Attribute> <Attribute><Attribute_name>Greutate</Attribute_name><Attribute_value>160 g</Attribute_value></Attribute>"
Použití formátu XML
Feed můžete vytvořit také ve formátu XML, ve kterém musí být všechny produkty obsaženy v tagu <products> a </products> a informace o konkrétním produktu musí být seskupeny v tagu <product> a </product>.
Příklad XML
<?xml version="1.0" encoding="UTF-8" ?>
<Products>
<Product>
<Identifier>00010</Identifier>
<Manufacturer>HP</Manufacturer>
<Name>ProBook 655 F1P82EA</Name>
<ProductUrl>http://www.example.com/products/00010/probook_655.html</ProductUrl>
<Price>4033</Price>
<ImageUrl>http://www.example.com/images/pb655.jpg</ImageUrl>
<Category>Calculatoare>Laptop</Category>
<Description>Tipul de produs: Notebook...</Description>
<DeliveryTime>1 zile</DeliveryTime>
<DeliveryCost>20 RON</DeliveryCost>
<EanCode>8806088369228</EanCode>
<Attributes>
<Attribute>
<Attribute_name>Capacitate memorie</Attribute_name>
<Attribute_value>8 GB</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Rezolutie ecran</Attribute_name>
<Attribute_value>1920 x 1080</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Capacitate Hard Disk</Attribute_name>
<Attribute_value>128 GB</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Bluetooth</Attribute_name>
<Attribute_value>Da</Attribute_value>
</Attribute>
</Attributes>
</Product>
<Product>
<Identifier>00011</Identifier>
<Manufacturer>Canon</Manufacturer>
<Name>EF 50mm f/1.8 STM 0570C005AA</Name>
<ProductUrl>http://www.example.com/products/00011/ef-50mm-stm.html</ProductUrl>
<Price>520</Price>
<ImageUrl>http://www.example.com/images/ef-50mm-stm.jpg</ImageUrl>
<Category>Electronice>Obiectiv aparat foto</Category>
<Description>Canon EF 50mm f/1.8 STM este un obiectiv DSLR pe montura Canon EF...</Description>
<DeliveryTime>7 zile</DeliveryTime>
<DeliveryCost>FREE</DeliveryCost>
<EanCode>0885909934140</EanCode>
<Attributes>
<Attribute>
<Attribute_name>Compatibil cu tip montare baioneta</Attribute_name>
<Attribute_value>Baioneta Canon</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Distanta focala</Attribute_name>
<Attribute_value>50 mm</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Numar de lamele ale diafragmei</Attribute_name>
<Attribute_value>7</Attribute_value>
</Attribute>
<Attribute>
<Attribute_name>Greutate</Attribute_name>
<Attribute_value>160 g</Attribute_value>
</Attribute>
</Attributes>
</Product>
</Products>
Ceník
Ceník služeb najdete přímo na webových stránkách Compari.