Help Center
Vítejte v nápovědě na merXu
Zde najdete veškeré informace o nákupu a prodeji na evropském tržišti merXu určeném pro firmy a živnostníky

Help Center

Přehled atributů používaných v souborech ve formátu merXu (.xls, .xlsx nebo .csv)

Přehled atributů

Všimněte si prosím atributů, které jsme označili jako povinné. Jejich správné vyplnění je základním předpokladem pro zahájení prodeje na merXu. 

Další (volitelné / doplňkové) atributy obohacují nabídku a činí ji atraktivnější.

Název atributu popis
 supplier_product_id
 povinný atribut

kód produktu dodavatele; musí být unikátní a určený pouze pro jeden konkrétní produkt

jeden kód = jeden produkt

Pokud omylem přiřadíte stejný kód dvěma nebo více produktům, způsobí to chyby při nahrání souboru a chyby v popisech a parametrech vašich produktů.

 name
 povinný atribut
Název produktu je uveden v seznamu nabídek dostupných pro kupující nebo ve výsledcích vyhledávání.
 merxu_category_path
cesta kategorie na merXu
Příklad: Elektrotechnika / Elektrické přístroje/ Spínače a odpojovače

 description

popis produktu

Počet znaků je omezen na max. 3000
Popis produktu se zobrazuje v prostém souvislém textu. Chcete -li jej atraktivně formátovat, použijte HTML. Popis můžete poskytnout v mnoha jazycích. Stejně jako v případě dalšího pole názvu v jiném jazyce přidejte samostatný sloupec a do názvu atributu přidejte dvoupísmenný kód jazyka, který používáte, například:

description-en, description-sk, description-lt.

 manufacturer
název výrobce
Například: Philips, Bosch, Makita
 manufacturer_product_id globální, katalogový kód výrobce. Pokud jste výrobcem a vystavujete své výrobky na merXu, můžete použít katalogový kód jako dodavatelský kód (manufacturer_id = supplier_product_id).
 ean 
čárový kód
Čárový kód v souladu s: https://cs.wikipedia.org/wiki/European_Article_Number

 production_country

země původu

Zadejte dvoumístný kód země původu produktu, např. CZ pro produkty z České republiky. Použijte velká písmena
https://cs.wikipedia.org/wiki/ISO_3166-1

 main_image_url

hlavní fotografie produktu

URL odkaz hlavní fotografie nebo název souboru případně cestu k souboru uvedete při importu CSV. Pokud váš soubor neobsahuje hlavní fotografii, vložíme na její místo první fotografii z dalších obrázků ze sloupce other_images_urls

Příklad: odkaz na fotografii, image.jpg, product-images/image.jpg

 other_images_urls
 další fotografie

Limit: 10 fotografií. Políčko by mělo obsahovat URL adresy nebo názvy připojených dalších obrázkových souborů, případně cesty k obrázkovým souborům, které jsou vždy oddělené středníkem ";" 

 video_youtube
 
K jednotlivým produktům můžete také přidat video zobrazující výhody a vlastnosti produktu. Do tabulky ve sloupci video_youtube zadejte adresu URL videa z YouTube.
 etim_class Pokud tuto klasifikaci používáte pro své produkty, můžete do souboru zahrnout kód etim.

 currency

měna

povinný atribut

Cena, za kterou prodáváte produkt, může být uvedena pouze v jedné měně Např. PLN, CZK, EUR atd. 

 price

cena
povinný atribut

Prodejní cena produktu bez DPH. Cena se uvádí následovně: Napište celkovou cenu souvisle, aniž byste použili mezery nebo jiné znaky; cenu např. s haléři lze napsat pouze pomocí tečky jako oddělovače.

Například 10000, 120.50, 399.99

 hidden_price

skrytá cena

zaškrtávací políčko 1/0;

Pokud zaškrtnete políčko „1“, cena vaší nabídky zůstane skrytá.

Nabídky se skrytou cenou budou zpravidla zařazeny ve spodní části výpisu dostupných nabídek.

 vat

DPH
 povinný atribut

Sazba DPH u produktu. Název atributu musí být malými písmeny. Uvádějte sazbu bez znaku %.

Například 21, 19

 price_unit

cena za jednotku

Výchozí prodejní jednotka je za kus. Pokud ji chcete změnit, zadejte příslušnou hodnotu - symbol jednotky. Můžete si vybrat z: metr (zadejte „m“), metr čtvereční (zadejte „m2“), metr krychlový (zadejte „m3“), litr (zadejte „l“) nebo kilogram (zadejte „kg“).

 price_quantity
 na jaké množství zboží se uvedená cena vztahuje

Příklad: pokud je cena 100 PLN za 5 vrtáků, zadejte do položky price_quantity „5“. V nabídce zobrazíme cenu za 1 vrták.

 order_increment
Příklad: chcete prodávat lepicí tuby v balení po 12 ks. Můžete zadat cenu 100 Kč za jeden kus a nastavit order_increment na „12“. Poté si zákazník bude moci zakoupit 12, 24, 36 položek atd.

in_stock

skladem

1 - produkt je skladem a připraven k odeslání
0 - produkt není skladem, ale lze jej objednat.

Produkty s atributem "in_stock", kde je uvedeno číslo 1, budou označeny na stránce nabídky a výpisu jako "připraveno k odeslání"

 condition

stav produktu

Vyberte a zadejte jednu ze tří možností odpovídajícího  stavu nabízeného produktu: Nový, použitý, renovovaný

I. Povinné atributy

supplier_product_id

kód produktu dodavatele (povinný atribut)

Toto je nejdůležitější atribut v souboru. Pomocí tohoto atributu merXu rozpoznává vaše produkty. Jako prodejce vytvoříte a přiřadíte tento kód svým položkám.

ID produktu může být libovolné povahy - to znamená, že můžete použít písmena a čísla, může to být např. EAN nebo dokonce globální kód výrobce. Toto označení nemá požadovanou délku.

Je důležité, aby byl jedinečný, tj. přiřazený a použitelný pro jeden konkrétní produkt, a aby se neopakoval ve vašem katalogu produktů, a to ani po delší době.

Pokud omylem přiřadíte stejný kód dvěma nebo více produktům, způsobí to chyby při nahrání souboru a chyby v popisech a parametrech vašich produktů.

name

název (povinný atribut)

Název produktu je uveden v seznamu nabídek dostupných pro kupující nebo ve výsledcích vyhledávání.

Název můžete sdílet ve více jazycích. V takovém případě přidejte samostatný sloupec a rozšiřte jeho název o dvoumístný kód jazyka, který používáte: polsky - pl, česky - cs, estonsky - et, litevsky - lt, slovensky - sk.

Příklady: name-en, name-cs, name-et. 

Podle ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Název má omezený počet znaků: maximálně 255 znaků pro název v každém jazyce.

V této části se také objeví atributy, které vyžadují, aby byla na řádku uvedena hodnota "1" nebo "0".

„1“ znamená „ano“, například: aktivovat, sdílet, skrýt, povolit.

„0“ znamená „ne“, například: neuvádět, nesdílet.

 

currency

měna (povinný atribut)

Cena, za kterou prodáváte produkt, může být uvedena pouze v jedné měně. Např. PLN, CZK, EUR.

Do pole vložte třímístný kód příslušné měny v souladu s ISO 4217. Seznam kódů měn najdete zde: https://cs.wikipedia.org/wiki/Seznam_m%C4%9Bn

Produkty můžete prodávat v různých měnách. V takovém případě je zapotřebí daný produkt zveřejnit jako novou nabídku. Přiřaďte mu unikátní kód supplier_product_id a vyberte požadovanou měnu.

Na obrázku je uveden příklad, jak postupovat při prodeji stejné položky (název, EAN) nabízené v různých měnách.

Different Currencies   Screenshot

price

cena bez DPH (povinný atribut)

Prodejní cena produktu bez DPH. Cena se uvádí následovně:

Napište celkovou cenu souvisle, aniž byste použili mezery nebo jiné znaky;

cenu např. s haléři lze napsat pouze pomocí tečky jako oddělovače.

Například 10000, 120.50, 399.99.

V případě, kdy se rozhodnete Vaši cenu skrýt uveďte do políčka alespoň katalogovou cenu produktu.

vat

Sazba DPH u produktu.

Název atributu musí být malými písmeny. Uvádějte sazbu bez znaku %.

Například 21, 19

 

II. Volitelné atributy obohacující nabídku

 

V této sekci se také objeví atributy, které v řádku vyžadují „1“ nebo „0“.

„1“ znamená „ano“, například: aktivovat, sdílet, skrýt, povolit.

"0" znamená ne, například pauza, neposílat feed, nesdílet.

merxu_category_path

cesta kategorie na merXu

V souboru máte možnost poskytnout úplnou a podrobnou cestu ke kategorii pro vaše produkty, například:

Elektrotechnika / Osvětlení / Světelné zdroje / LED žárovky

Tento parametr je velmi důležitý - umožňuje nám správně kombinovat váš produkt s příslušnou kategorií v merXu. Produkty nebudou kategorizovány automaticky - což znamená, že cesta nám pomáhá při manuální klasifikaci.

Pole je omezeno na 255 znaků; „/“ a další speciální znaky můžete použít k oddělení následujících segmentů cesty.

description

popis produktu

Popis produktu se zobrazuje v prostém souvislém textu. Chcete -li jej atraktivně formátovat, použijte HTML. Zkontrolujte znaky, které používáme na našich stránkách: https://merxu.com/cs/html/

<br> nový řádek textu

<p>...</p> odstavec

<ul> seznam odrážek

<ol> seznam čísel

<b> ... </b> tučný nápis

<u> ... </u> podtržený nápis

<i> ... </i> kurzíva nápis

Popis můžete poskytnout v mnoha jazycích. Stejně jako v případě dalšího pole názvu v jiném jazyce přidejte samostatný sloupec a do názvu atributu přidejte dvoupísmenný kód jazyka, který používáte, například:

description-en, description-sk, description-lt.

Použijte malá písmena. Počet znaků je omezen na max. 3000.

Podle ISO 639-1 https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

manufacturer

Název výrobce

Například: Philips, Bosch, Makita

manufacturer_product_id

globální, katalogový kód výrobce

Kód přiřazený výrobku jeho výrobcem. Je veřejný a používá se pro globální identifikaci produktu. Pokud jste výrobcem a vystavujete své výrobky na merXu, můžete použít katalogový kód jako dodavatelský kód (manufacturer_id = supplier_product_id).

ean

Čárový kód

Čárový kód v souladu s: https://cs.wikipedia.org/wiki/European_Article_Number

production_country

země původu

Zadejte dvoumístný kód země původu produktu, např. PL pro produkty z Polska, DE - z Německa atd. Použijte velká písmena. Seznam kódů naleznete v odkazu - je součástí tabulky označované jako alfa-2.

Podle ISO 3166-1 https://cs.wikipedia.org/wiki/ISO_3166-1

main_image_url

hlavní fotografie produktu

Hlavní fotografie produktu bude viditelná ve výsledcích vyhledávání - v seznamu nabídek.

Fotografie můžete nahrávat třemi způsoby:

  • poskytnutím URL hlavní fotografie v tabulce, pokud máte veřejnou databázi fotografií a zpřístupníte ji ke stažení MerXu:

Příklad odstavce main_image_url s vyplněnými  URL adresami hlavních fotografií 2 produktů

Main Image C Z

  • zadáním názvu souboru s fotografií v šabloně, který si později sami přidáte pomocí karty „Produktový katalog“ v hlavním panelu MerXu.

Nezapomeňte, že název souboru s fotkou, který uvedete v tabulce, musí obsahovat příponu označující typ obrázkového souboru. Akceptujeme soubory .gif, .jpg, .jpeg, .png. Důležité je také zadat do tabulky přesný název souboru s fotografií. Velká nebo malá písmena musí být konzistentní (to platí i pro příponu souboru).

Příklad znázorňující soubor hlavního obrázku s příponou .jpg

Image17

 

  • zadáním cesty k souboru s obrázky do tabulky

Pokud chcete nahrát všechny obrázky společně do jedné složky, název složky musí být uveden v tabulce před názvem souboru obrázku. Sloupec by měl být uveden v podobě: folder_name/image_name. Příklad: product-images/image.jpg

Vezměte prosím na vědomí, že cesta k názvu souboru obrázku, který zadáte v tabulce, musí obsahovat příponu označující typ souboru obrázku. Akceptujeme následující soubory: .gif, .jpg, .jpeg, .png. Důležité také je, abyste do listu zadali přesný název souboru obrázku. V názvu souboru musí být rozlišována malá a velká písmena (to platí i pro příponu souboru).

Pokud váš soubor neobsahuje hlavní fotografii, vložíme na její místo první fotografii z dalších obrázků ze sloupce other_images_urls.

Technické požadavky pro fotografie:

  • Maximální rozlišení fotografie: 2560 x 2560 pixelů.
  • Minimální rozlišení fotografie: 500 x 500 pixelů.
  • Přijatelný formát fotografie: .gif, .jpg.,jpeg., .png.
  • Maximální velikost fotografie: 10 MB.
  • Hlavní fotografie by měla zobrazovat pouze produkt s čistým pozadím, bez ohraničení.
  • Produkt by měl zabírat 80-90% prostoru dané fotografie, která by měla zobrazovat co nejvíce detailů.
  • Fotografie nesmí obsahovat ochranné známky, vodoznaky ani odrazy.

Pamatujte, že stahujeme obrázky dané položky před zpřístupněním nabídky, takže pokud použijete obrázky produktů, které jsou umístěny na externím serveru a aktualizujete je na tomto serveru, obrázky nebudou na merXu automaticky aktualizovány.

other_images_urls

další fotografie

Limit: 10 fotografií

Políčko by mělo obsahovat URL adresy nebo názvy připojených dalších obrázkových souborů, případně cesty k obrázkových souborům, které jsou vždy oddělené  ; 

Příklad: odstavec other_images_urls s vyplněnými 3 dalšími fotografiemi 

Image20

Další fotografie by měly splňovat stejná kritéria a technické požadavky jako pro hlavní fotografie. Mohou zobrazovat nabízený produkt, detailní informace o důležitých funkcích, produkt zobrazený z různých úhlů (z různých stran), balení produktu, příslušenství, různé stavy produktu (složené, rozložené, otevřené, uzavřené atd.).

video_youtube

produktové video

K jednotlivým produktům můžete také přidat video zobrazující výhody a vlastnosti produktu. Do tabulky ve sloupci video_youtube zadejte adresu URL videa z YouTube.

etim_class

Pokud tuto klasifikaci používáte pro své produkty, můžete do souboru zahrnout kód etim. Klasifikace se vztahuje na odvětví, jako jsou: elektrotechnika, stavební materiály, vzduchotechnika a klempířství a nářadí.

Klasifikace ETIM: https://www.etim-international.com/classification/

Příklad: EC001743

hidden_price

skrytá cena

zaškrtávací políčko 1/0; Pokud zaškrtnete políčko „1“, cena vaší nabídky zůstane skrytá.

Nabídky se skrytou cenou budou zpravidla zařazeny ve spodní části výpisu dostupných nabídek.

Image18

 

Cenové hladiny

 

Tento atribut můžete využít v případech, kdy máte zájem, aby se výše ceny odvíjela od velikosti objednávky.

U jednoho produktu můžete definovat až pět takových rozpětí přidáním nových sloupců do tabulky. 

V současné době můžete cenové hladiny nastavit dvěma metodami. Vyberte si ten, který vám nejvíce vyhovuje, a držte se ho, nemíchejte to mezi sebou.

Způsob č. 1

price_quantity

Berte prosím na vědomí, že se zde kromě ceny mění také název sloupce. Je tak zapotřebí vyplnit příslušné parametry do řádku i názvu sloupce.

Na obrázku je uveden příklad pro produkt, kde prodejce uvedl dvě cenové hladiny v závislosti na velikosti objednávky:

Tier Pricing 1

Takto vypadá tento produkt (za běžnou cenu 133 PLN) se dvěma cenovými hladinami.

Tier Pricing 2

price - cena za kus při nákupu 1-29 kusů; 

price_30 -  cena za kus při nákupu 30 až 59 kusů;

price_60 - cena za kus při nákupu 60 a více kusů..

Všimněte si, jak se mění název atributu: v (základní) nedokončené podobě je to price_quantity.

Definovaný a vyplněný atribut označuje velikost objednávky price_30 a cenu k němu přiřazenou. Nahraďte slovo quantity číselnou hodnotou.

Způsob č. 2

tier_price1 and tier_quantity1

Při použití této metody je třeba přidat oba parametry.

  • tier_price - určuje cenu produktu v tomto konkrétním rozpětí
  • tier_quantity - určuje minimální počet produktů v tomto konkrétním rozpětí

Další rozpětí se přidávají přidáním další dvojice parametrů: tier_price2 + tier_quantity2, tier_price3 + tier_quantity3, atd.

Na screensotu můžete vidět příklad dvou rozpětí:

Tier Pricing 3

A stejná nabídka znovu:

Tier Pricing 4

price_unit

cena za jednotku

Výchozí prodejní jednotka je za kus. Pokud ji chcete změnit, zadejte příslušnou hodnotu - symbol jednotky. Můžete si vybrat z: metr (zadejte „m“), metr čtvereční (zadejte „m2“), metr krychlový (zadejte „m3“), litr (zadejte „l“) nebo kilogram (zadejte „kg“).

price_quantity

na jaké množství zboží se uvedená cena vztahuje

Příklad: pokud je cena 100 PLN za 5 vrtáků, zadejte do položky price_quantity „5“. V nabídce zobrazíme cenu za 1 vrták.

                                                                           Zobrazení v tabulce:

Tier Pricing 5

                                                                         Nabídka vypadá následovně:

Tier Pricing 6

 

order_increment

 

Příklad 1: chcete prodávat lepicí tuby v balení po 12 ks. Můžete zadat cenu 10 Kč za jeden kus a nastavit order_increment na „12“. Poté si zákazník bude moci zakoupit 12, 24, 36 položek atd.

                                                                  Zobrazení v tabulce:

                                               Order Increment 1

Příklad 2: chcete prodávat šrouby za 3,50 PLN za 100 ks a násobky 5 (protože prodáváte plná balení za 500 ks). Nastavte tedy cenu na „3,5“, price_quantity na 100 a order_increment na 500. Zákazník si bude moci objednat minimálně 5 balení po 100 kusech.

Zobrazení v tabulce:

Image25

Nabídka vypadá následovně:

Image12

special_price

speciální (akční) cena 

Pro váš produkt si můžete nastavit speciální (akční) cenu. 

Speciální cenu určíte zadáním aktuální hodnoty této ceny, tj. pokud má produkt za běžnou cenu 1000 Kč stát 890 Kč, pak se tato snížená hodnota vyplní v tabulce.

Dobu trvání této zvýhodněné ceny lze libovolně měnit pomocí atributů  special_price_from a special_price_to.

special_price_discount

Pro Vás produkt si můžete nastavit speciální (akční) cenu v procentech (např. hodnota 5.5) znamená, že daný produkt bude levnější o 5.5%. 

Dobu trvání této zvýhodněné ceny lze libovolně měnit pomocí atributů  special_price_from a special_price_to.

special_price_from

Pokud jste atribut enabled označili hodnotou „1“ a zároveň nevyplníte atribut special_price_from, bude váš produkt po nahrání dat zpřístupněn k prodeji a speciální cena bude spuštěna okamžikem zahájení prodeje.

Pokud chcete, aby speciální nabídka začala ve vámi preferovaném čase, vyplňte pole s datem a časem zahájení této speciální nabídky. 

Formát pro vyplnění času je následující:

YYYY-MM-DD HH:MM:SS

special_price_to

Vyplňte políčko s datem a časem ukončení speciální ceny pro danou nabídku v následujícím formátu:

YYYY-MM-DD HH:MM:SS

Pokud neuvedete časové období, bude akční cena aktivní, dokud nebude „ručně“ vypnuta (aktualizací nabídky).

condition

stav produktu

Vyberte a zadejte jednu ze tří možností odpovídajícího  stavu nabízeného produktu: Nový, použitý, renovovaný.

stock

sklad

očekávaný výstup je konkrétní číslo. Pokud je uvedena 0 nebo záporné číslo, znamená to, že produkt není k dispozici a nabídka s takovým produktem nebude na merXu aktivní (viditelná). Je-li je uvedeno kladné číslo, pak to znamená, že takový počet kusů máte skladem.

enabled

zveřejnění nabídky

zaškrtávací políčko 1/0

Uveďte „1“ nebo ponechte toto pole prázdné, pokud chcete, aby byl produkt po jeho nahrání aktivní a aby zákazníci mohli okamžitě provést nákup. Pokud chcete, aby se nabídka na merXu po načtení souboru nezobrazila, zadejte „0“.

dispatch_time

doba odeslání

Zadejte dobu, za kterou jste schopni odeslat zboží kupujícímu (předat zboží přepravci). Zadává se příslušný počet dní, např. 2 (nikoliv 1-2).

country_of_dispatch

Země, ze které budete odesílat objednané produkty. Zadejte dvoumístný kód podle ISO 3166-1, např. PL, CZ, EE, uvedené v alfa-2 části tabulky.

https://cs.wikipedia.org/wiki/ISO_3166-1

Používejte velká písmena.

Pokud ponecháte toto políčko prázdné, předpokládá se, že budete chtít své zboží a služby nabízet do všech států EU.

destination_countries

Uvedení zemí EU, do kterých si přejete prodávat své zboží a služby. Zadejte dvoumístný kód velkými písmeny a jednotlivé kódy zemí oddělte středníkem např. PL; CZ; ET.

Kódy zemí z EU jsou uvedeny zde, resp. tady :

CZ,BE,BG,DK,EE,FI,FR,IE,IT,CY,LT,LV,LU,HU,MT,DE,NL,PL,PT,AT,RO,GR,SK,SI,ES,SE,HR

shipping_pricing_external_id

ID ceníku dopravy, který jste vytvořili ve svém účtu. Jeho přidáním zpřístupníte kupujícím tlačítko KOUPIT HNED.

Návod na tvorbu ceníku najdete zde: https://lp.merxu.com/cs/shipping-pricing

III. Další atributy

Na tom tomto místě Vám přinášíme informace, jak si můžete vytvořit další podrobné atributy, které budou zásadní pro efektivní a snadné nalezení a pro prodej vašich produktů. Tyto atributy si vytvoříte sami.

Na rozdíl od produktových a nabídkových atributů,  uveďte názvy volitelných atributů češtině.

Maximální počet znaků činí 199.

Pokud chcete vytvořit nový atribut, definujte název sloupce, který bude přesně popisovat jeho význam. Popisuje-li sloupec hodnotu vyjádřenou v určitých jednotkách, zadejte název této jednotky uzavřený do hranatých závorek, jak je uvedeno v následujícím příkladu (název a jednotka jsou odděleny mezerou).

Další Atributy

Název atributu začněte velkým písmenem, zbytek text může být uveden malými písmeny (např. Barva, Tloušťka apod.) Měrné jednotky v závorkách mohou být uvedeny malými nebo velkými písmeny.

Pamatujte, že název atributu se zobrazí ve stejném tvaru, jak jej uvedete zde, včetně všech znaků. Vyhněte se prosím podtržítek, pomlček mezi slovy apod.