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 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 | 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 | 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í 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.
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/.
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ů
- 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
- 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
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.
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:
Takto vypadá tento produkt (za běžnou cenu 133 PLN) se dvěma cenovými hladinami.
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í:
A stejná nabídka znovu:
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:
Nabídka vypadá následovně:
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:
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:
Nabídka vypadá následovně:
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
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).
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.