Import produktů

Obsah:

Import produktů
Dokončení převodu dat
Vytvoření vzorového souboru pro import
Pravidla importu
Tabulka značek a pravidel
Import produktu bez variant a s variantami
Import kategorií
Import textových parametrů
Import akční ceny
Jak provést import produktů

Import produktů vám usnadní práci při zadávání nových produktů do e-shopu. Pokud chcete do e-shopu přidat například 1 000 položek, zabralo by příliš mnoho času přidávat je po jedné. Ač vám může import produktů připadat složitý, po prvním nahrání zjistíte, že tomu tak není. Import produktů naleznete v administraci e-shopu pod záložkou Produkty → Import.

Následující návod vám vysvětlí jednotlivé kroky potřebné ke správnému nastavení importu. Seznámíte se značkami, které jsou pro systém Shoptetu přípustné. Dozvíte se také, jak si vytvořit vzor pro import.

Importovat produkty můžete ze souboru s příponou *.xlsx, *.csv nebo *.xml. Soubor musí mít kódování Windows-1250 (CP-1250). Formát *.xls není podporován.

O importu ve formátu *.xml se dozvíte více v článku XML validace.

My si ukážeme, jak importovat ve formátu *.xlsx. Jeho použitím odpadá řada dodatečných nastavování. Budete potřebovat software podporující *.xlsx, tedy Microsoft Excel, Google Tabulky nebo Libre Office (zdarma).

Vytvoření vzorového souboru pro import

Jako vzor pro budoucí import použijeme export produktů přímo z administrace Shoptetu. Potom stačí pouze upravit konkrétní sloupce a následně tento soubor importovat zpět do Shoptetu.

Ukážeme si, jak exportovat soubor se všemi dostupnými značkami (tedy všemi sloupci tabulky), které Shoptet používá. Tak budeme mít jistotu, že žádnou z vlastností produktu nevynecháme. Vyhneme se tak jejich dodatečnému nastavování v administraci.

Pro exportovaný soubor použijeme formát *.xlsx.

vstupte do administrace svého e-shopu, Produkty → Export (obrázek 01)

obrázek 01

vyberte záložku Export
z nabídky vyberte možnost Vytvořit vlastní typ exportu
- zvolte nadpis (např. Úplný)
- ve všech nabídkách níže vyberte možnost Označit vše
- klikněte na tlačítko Uložit
vraťte se do záložky Export
Typ zvolte vlastní: Úplný
Formát zvolte *.xlsx
ostatní nastavení vynechejte
klikněte na tlačítko Exportovat

Je třeba si uvědomit, že i při dodržení tohoto postupu mohou některé značky v tabulce chybět. Typickým příkladem je DPH. Pokud máte v administraci e-shopu nastaveno, že nejste plátcem DPH, tak export nebude zahrnovat značky, které se k placení DPH vztahují.

Pravidla importu

Aby byly produkty úspěšně naimportovány, je potřeba údaje vyplnit podle následujících pravidel:

sloupce code, pairCode a name jsou vždy první zleva
na pořadí ostatních sloupců nezáleží
řádky produktů na sebe musí navazovat – není možné mít prázdné řádky
- např. pokud máte uprostřed souboru několik prázdných řádků, systém je vyhodnotí jako konec importu
sloupce označené jako nepovinné nemusí být v importovaném souboru uvedeny
pokud upravujete produkty, které v e-shopu již existují, můžete uvést jen ty sloupce, které chcete změnit
nenechávejte v importním souboru prázdné sloupce a prázdné řádky
sloupce označené jako povinné (code, pairCode, name) musí být v souboru uvedeny vždy. Platí to v případě nového produktu i v případě, že importem upravujete již existující produkty.

Je rozdíl mezi:

Nepovinný sloupec není v souboru uveden.
Sloupec je uveden, ale nejsou vyplněny jeho hodnoty.

Je třeba na to dát pozor zejména u produktu, který již v e-shopu existuje a vy chcete importem jeho vlastnosti aktualizovat. V případě 1. budou původní vlastnosti produktu zachovány. V případě 2. budou původní vlastnosti produktu přepsány prázdnými hodnotami.

Tabulka značek a pravidel

Následující tabulka ukazuje seznam všech značek (v případě importní tabulky sloupců), se kterými se v exportu a importu Shoptetu setkáte. Každá značka zastupuje vlastnost některé z položek ve vašem e-shopu.

V tabulce naleznete informace, jestli se jedná o značku povinnou, její možné hodnoty a stručný popis. V popisu najdete informace, které do políček ve sloupcích tabulky budete vyplňovat.

Název sloupce	Povinný	Možné hodnoty	Popis
code	ano		Kód produktu nebo varianty. Musí být jedinečný v rámci celého e-shopu. Kód produktu může mít maximálně 64 znaků.
pairCode	ano		Párovací kód označující variantu produktu. Všechny varianty jednoho produktu musí mít stejný párovací kód. V případě, že vaše produkty varianty nemají, ponechte sloupec pairCode prázdný. pairCode může obsahovat znaky 0-9 a A-Z. Nesmí obsahovat speciální znaky. Více v Import produktu s variantami a bez variant.
name	ano		Název produktu
guid	ne		Interní údaj Shoptetu. Není nutné věnovat mu při importu pozornost.
appendix	ne		Doplněk názvu
shortDescription	ne		Stručný popis produktu. Tento popis se zobrazuje např. ve výpisu kategorie produktu nebo se exportuje vyhledávačům zboží.
description	ne		Podrobný popis produktu. Zobrazuje se v detailu produktu.
manufacturer	ne		Výrobce produktu
metaDescription	ne		Meta popisek produktu
itemType	ne		Druh položky: Zde můžete zvolit, zda se jedná o nový produkt (product), bazarový produkt (bazaar) nebo službu (service). Tato informace se bude odesílat do vyhledávačů zboží.
ean	ne		EAN produktu nebo varianty. Může mít až 14 míst.
productNumber	ne		Produktové číslo produktu nebo varianty (ISBN)
partNumber	ne		Part number produktu nebo varianty
serialNumber	ne		Sériové číslo produktu nebo varianty
plu	ne		PLU (kód pro dohledání ceny) produktu nebo varianty
defaultImage	ne		Absolutní cesta k obrázku u varianty produktu. Ke každé variantě produktu lze přiřadit jeden obrázek.
image	ne		Absolutní cesta k obrázku produktu. Při importu více obrázků lze použít názvy sloupců image2, image3. Zároveň je ale nutné mít v souboru i sloupec image.
imageDesc	ne		Alternativní popis obrázku. Při importu více obrázků lze použít názvy sloupců imageDesc2, imageDesc3. Zároveň je ale nutné mít v souboru i sloupec image.
defaultCategory	ne		Výchozí kategorie. Jedná se o kategorii, ve které je produkt na e-shopu umístěn. Sloupec defaultCategory je třeba vyplnit, aby se zboží na e-shopu zobrazilo. Více v Import kategorií.
categoryText	ne		Zařazení produktu do další (jiné) kategorie, než je výchozí defaultCategory. Pokud produkt chcete umísit do více kategorií v různých stromech, je třeba přidat sloupec categoryText2, categoryText3 atd. Více v Import kategorií.
price	ne		Cena produktu nebo varianty, uvádí se pouze číselná hodnota bez speciálních znaků. Cenu uveďte u každého produktu a každé varianty.
priceRatio	ne		Cenový koeficient. Cena produktu se počítá vynásobením zadané ceny a tohoto koeficientu. Pokud chcete, aby výsledná cena byla stejná jako v políčku Cena, nastavte koeficient na 1.
standardPrice	ne		Původní cena produktu nebo varianty
purchasePrice	ne		Nákupní cena produktu nebo varianty
currency	ne		Kód měny, ve které je uvedena cena produktu nebo varianty.
includingVat	ne	0;1	Uvádí, zda jsou uvedené ceny bez DPH nebo včetně. DPH. Hodnota 0 je určena pro bez DPH a hodnota 1 je určena pro včetně DPH.
percentVat	ne		Procentuální sazba daně produktu nebo varianty.
actionPrice	ne		Akční cena produktu. Více v Import akční ceny.
actionFrom	ne		Od jakého data bude platit akční cena (formát YYYY-MM-DD).
actionUntil	ne		Do jakého data bude platit akční cena (formát YYYY-MM-DD).
minimumAmount	ne		Minimální objednatelné množství.
maximumAmount	ne		Maximální objednatelné množství.
freeShipping	ne	0;1	Uvádí, zda bude mít produkt povolenou dopravu zdarma.
freeBilling	ne	0;1	Uvádí, zda bude mít produkt povolenou platbu zdarma.
maxDiscount	ne		Uvádí maximální možnou slevu. Zadávejte bez procent, pouze číslo.
applyDiscountCoupon	ne	0;1	Umožňuje nastavit u jednotlivých položek, zda je pro ně možné použít slevový kupon. Hodnota 1: slevový kupon bude možné použít. Hodnota 0 nebo nevyplněná hodnota: slevový kupon nebude možné na položku aplikovat.
applyLoyaltyDiscount	ne	0;1	Umožňuje nastavit u jednotlivých položek, zda je na ně možné uplatnit věrnostní slevu. Hodnota 1: věrnostní slevu bude možné uplatnit. Hodnota 0 nebo nevyplněná hodnota: věrnostní slevu nebude možné na položku aplikovat.
applyQuantityDiscount	ne	0;1	Umožňuje nastavit u jednotlivých položek, zda je na ně možné uplatnit množstevní slevu. Hodnota 1: množstevní slevu bude možné použít. Hodnota 0 nebo nevyplněná hodnota: množstevní slevu nebude možné na položku aplikovat.
applyVolumeDiscount	ne	0;1	Umožňuje nastavit u jednotlivých položek, zda je na ně možné uplatnit objemovou slevu. Hodnota 1: objemovou slevu bude možné použít. Hodnota 0 nebo nevyplněná hodnota: objemovou slevu nebude možné na položku aplikovat.
variant:hodnota	ne		Pro správné zadání musí být vyplněný sloupec pairCode. Pojem hodnota ve jménu sloupce určuje název parametru. Jednotlivé řádky v tomto sloupci určují hodnoty parametru. Příklad: název sloupce je variant:Barva a v řádku, který má stejný pairCode, je uvedeno Bílá a v dalším takovém řádku Modrá. Znamená to, že máme produkt ve dvou barvách – Bílá a Modrá. Maximum jsou tři parametry na variantu.
stock	ne		Počet kusů (produktu nebo varianty) skladem. Sloupec má smysl, pouze pokud máte na svém e-shopu aktivní doplněk Skladové hospodářství. Zadáváte pouze číslo.
stockMinSupply	ne		Minimální zásoba na skladě.
negativeAmount	ne	0;1	Uvádí, zda lze produkt nakupovat i do mínusových skladových zásob. Sloupec má smysl pouze pokud máte na svém e-shopu aktivní doplněk Skladové hospodářství.
availability	ne		Dostupnost produktu či varianty při vypnutém skladovém hospodářství.
availabilityOutOfStock			Dostupnost při zapnutém skladovém hospodářství. Dostupnost při vyprodání.
availabilityInStock	ne		Dostupnost při zapnutém skladovém hospodářství. Dostupnost zboží na skladě.
unit	ne		Jednotka produktu nebo varianty
decimalCount	ne	0-3	Uvádí, na kolik desetinných míst lze vložit poměr množství kusu produktu do košíku. Tj. místo vložit do košíku 1 ks, můžete vložit 1.8 ks, v případě jednoho desetinného místa, nebo 2.88 ks v případě 2 desetinných míst. Adekvátně k tomuto nastavení se odpočítává sklad (na skladě je tak možné mít například 3.4 ks produktu). V administraci naleznete toto nastavení v detailu produktu pod názvem „Počet číslic za desetinnou čárkou“.
warranty	ne		Záruka
weight	ne		Hmotnost produktu nebo varianty. Zadává se v kilogramech. Gramy je možné zadat ve formátu 0.2 kg.
tollfree	ne	0;1	Údaj pouze pro Zboží.cz. zdali zobrazovat produkt, nebo nezobrazovat.
firmyCz	ne	0;1	Uvádí, zda se má produkt objevit v profilu firmy na serveru Firmy.cz.
relatedProduct	ne		Kód souvisejícího produktu (pro více produktů je třeba přidat sloupec či sloupce: relatedProduct, relatedProduct2, relatedProduct3 atd.).
alternativeProduct	ne		Kód podobného produktu (pro více produktů je třeba přidat sloupec či sloupce: alternativeProduct, alternativeProduct2, alternativeProduct3 atd.).
textProperty	ne		Popisné parametry k produktu. Pokud je jich více, jsou v souboru jako textProperty, textProperty2 atd. Hodnoty ve sloupcích jsou ve tvaru například: Barva;Oranžová. Přičemž před středníkem je parametr a za středníkem je jeho hodnota. Více v Import textových parametrů.
filteringProperty	ne		Parametry pro filtrování u produktu, z nich je pak možné vytvořit parametrické filtry. V souboru se název sloupce přidává v tomto tvaru filteringProperty:Název_parametru. Do sloupce se pak zadávají hodnoty parametrů.
externalCode	ne		Kód výrobce produktu nebo varianty
variantVisibility	ne	0;1	Skrývání a zobrazování variant: uvádějte hodnoty 1 pro zobrazení, 0 pro skrytí. Nenechávejte políčka nevyplněná.
productVisibility	ne	hidden;visible	Skrývání a zobrazování produktu: hodnota hidden produkt skryje, hodnota visible je výchozí stav, produkt bude vidět. Další možné hodnoty: blocked: zamezí objednání produktu, showRegistered: produkt je viditelný pouze pro registrované uživatele, blockUnregistered: produkt nelze zakoupit, pokud zákazník není registrován, cashDeskOnly: zobrazit jen na pokladně, detailOnly: produkt bude přístupný pouze přes přímý odkaz, nikoli přes menu či vyhledávání e-shopu.
adult	ne	0;1	Uvádí, zda je produkt pro dospělé. 0: bez omezení. 1: je pouze pro dospělé.
action	ne	0;1	Uvádí, zda bude u produktu zobrazen příznak Akce.
actionDateTo	ne		Datum, do kterého akce probíhá. Formát YYYY-MM-DD
new	ne	0;1	Uvádí, zda bude u produktu zobrazen příznak Novinka.
newDateTo	ne		Datum, do kterého je zboží označeno jako nové. Formát YYYY-MM-DD
tip	ne	0;1	Uvádí, zda bude u produktu zobrazen příznak Tip.
tipDateTo	ne		Datum, do kterého zboží ponese příznak „Tip“. Formát YYYY-MM-DD
custom1	ne	0;1	Volitelný příznak. Možné je použít např. Výprodej. (Pro více volitelných příznaků je třeba přidat sloupec či sloupce: custom2, custom3, custom4 atd.).
custom1DateTo	ne		Datum, do kterého zboží ponese zvolený příznak. Formát YYYY-MM-DD. (Pro více dat volitelných příznaků je třeba přidat sloupec či sloupce: custom2DateTo, custom3DateTo atd.).
relatedVideo	ne		Importuje související videa, je třeba zadat ve formátu název;url adresa. Tedy například: Instrukce;https://www.youtube.com/watch_random_video Další videa je možné importovat přes sloupečky relatedVideo2, relatedVideo3 atd.
allowsIPlatba	ne	0;1	Uvádí, zda bude možné produkt zakoupit přes Iplatbu (na splátky).
allowsPayOnline	ne	0;1	Uvádí, zda jsou u produktu povoleny online platby.
xmlFeedName	ne		Jméno produktu v XML feedu. Je-li políčko vyplněno, bude se do vyhledávčů zboží automaticky odesílat uvedený název místo názvu, který máte na e-shopu. U produktů s variantami budou doplněny varianty.
seoTitle	ne		Nadpis ve zdrojovém html kódu, v tagu `<title>`. Můžete použít v případech, kdy chcete mít v titulku stránky jiný text, než je hlavní nadpis stránky (většinou název produktu).
heurekaCpc	ne		Cena za proklik naHeureka.cz. Vyšší cenu za proklik (CPC) na službě Heureka.cz je možné nastavit po získání certifikátu Ověřeno zákazníky.
zboziCpc	ne		Maximální cena za proklik v detailu produktu v Kč ve službě Zboží.cz. Pokud si nastavíte maximální cenu za proklik, kterou jste ochoten pro danou položku v detailu zaplatit, Zboží.cz spočítá cenu prokliku, která je nutná k udržení na dané pozici (second-price). Použije-li zákazník řazení od nejlevnější nabídky, účtuje se pouze ceníková cena.
zboziSearchCpc	ne		Maximální cena za proklik ve fulltextovém výsledku hledání (nezařazené nabídky) v Kč. Pokud si nastavíte maximální cenu za proklik, kterou jste ochoten pro danou položku ve fulltextu zaplatit, Zboží.cz spočítá cenu prokliku, která je nutná k udržení na dané pozici (second-price). Použije-li zákazník řazení od nejlevnější nabídky, účtuje se pouze ceníková cena.
sizeld	ne		SizeID id (vyžaduje propojení se SizeID for Business)
sizeIdLabel	ne		SizeID popis (vyžaduje propojení se SizeID for Business)
packageAmount	ne		Množství v balení
packageAmountUnit	ne		Jednotka množství v balení. V administraci e-shopu je možné nastavit tyto jednotky: ks, g, kg, t, cm, m, cm2, m2, ml, l, cm3, dm3, m3
measureAmount	ne		Měrná jednotka
measureAmountUnit	ne		Jednotka měrné jednotky. V administraci e-shopu je možné nastavit tyto jednotky: ks, g, kg, t, cm, m, cm2, m2, ml, l, cm3, dm3, m3
internalNote	ne		Interní poznámka

tabulka 01

V případě, že si nevíte rady s významem některé z výše uvedených značek, vyhledejte si ji přímo v administraci e-shopu (v umístění Produkty → Přehled/Ceny/Sklad/Slevy/Kategorie).

Většina značek má v administraci vedle názvu ikonku s písmenem „i“. Po najetí myší na ikonku se objeví informace a vlastnosti značky.

Import produktu bez variant a s variantami

Oba typy produktu se zapisují do importovacího souboru zcela stejně. Jediným rozdílem je sloupec pairCode.

jedná se o povinný sloupec
musí být umístěný v tabulce jako druhý zleva
produkty bez variant mají tento sloupec prázdný
produkty s variantami mají sloupec vyplněný hodnotou, která je pro všechny varianty stejného produktu stejná
- např. chceme-li importovat produkt se 4 variantami, tak 4 po sobě následující řádky v tabulce budou mít stejný pairCode
varianty se stejným pairCode je třeba mít v tabulce hned pod sebou
- např. pokud bude jedna taková varianta na odlišném místě, nahraje se jako samostatný duplicitní produkt
hodnota pairCode je libovolná, lze použít znaky 0-9 a A-Z, ale nesmí obsahovat speciální znaky

Import kategorií

Kategorie dělí zboží v e-shopu do různých skupin, např. podle koncového zákazníka, odvětví, typu produktu atd. Pokud kategorie ještě nejsou založené v e-shopu, e-shop je vytvoří z informací z tabulky.

produkty přiřazujeme do kategorií na základě dvou značek: defaultCategory a categoryText
kategorie se zapisují ve stromové struktuře, tedy hlavní kategorie > 1. podkategorie > 2. podkategorie. Počet podkategorií je neomezený (obrázek 02).
před i za znakem > se nachází mezera
použití dvojitého znaku >> zařadí produkt pouze do konkrétní kategorie
hodnota v tabulce A > B > C > D >> E způsobí, že produkt bude zařazen pouze do kategorie E
hodnota v tabulce: >> A > B >> C > D >> E způsobí, že produkt bude zařazen pouze do kategorií A, C, E

obrázek 02

Značka defaultCategory (výchozí kategorie) může být jen jedna. Pokud ji neuvedete, produkt se uživatelům na e-shopu nezobrazí.

na hlavní kategorii lze odkázat pouze uvedením názvu do sloupečku defaultCategory
na podkategorii použijte stromovou strukturu názvu, např. Oblečení > Tričko >> Krátký rukáv

Značka categoryText zařadí produkt do další (jiné) kategorie, než je defaultCategory. Pro její zápis platí stejná pravidla.

pro zařazení produktu do více kategorií, přidejte další sloupeček a nazvěte ho categoryText2

Kategorie, které se jmenují stejně. Jak zamezit duplicitě?

V systému e-shopu je třeba odlišit kategorie, které jsou stejně nazvané. Například tři kategorie s názvem Bylinné čaje. Při importu se produkty nemusí nahrát do kategorie, do které je zrovna chcete. To lze jednoduše vyřešit.

v administraci e-shopu zvolte Produkty → Kategorie
vyberte záložku Kategorie produktu
otevřete editaci kategorie tak, že kliknete na její název
vyberte záložku Pokročilé
vyberte pole Text odkazu (v menu)
u všech tří kategorií vepište do tohoto pole název Bylinné čaje
poté přejmenujte názvy (záložka Obecné informace) daných kategorií tak, aby se lišily (např. Bylinné čaje černé, Bylinné čaje zelené a Bylinné čaje žluté)
pokud máte u nadpisu v menu zvoleno Bylinné čaje, nevyužívejte tento název v nadpisu stránky
v importu použijte pro každou kategorii její nový název
tyto rozšířené názvy se nezobrazí v e-shopu v menu kategorií, budou však vidět v záhlaví dané kategorie

Import textových parametrů

Textové parametry popisují nějaké vlastnosti produktu. Textové parametry naleznete v administraci Shoptetu v detailu produktu pod záložkou Parametry.

do Shoptetu lze importovat pouze Název parametru (např. Barva) a Hodnota popisného parametru (např. Oranžová), Vysvětlivku názvu parametru lze doplnit ručně v administraci e-shopu (obrázek 03)

obrázek 03

zvolte pole ve sloupci textProperty
Název parametru a Hodnotu popisného parametru oddělte v buňce tabulky středníkem (bez mezer) (obrázek 04)
do této buňky už žádné další středníky nevkládejte
pokud chcete importovat více textových parametrů, vložte do tabulky sloupce: textProperty2, textProperty3 atd.
v případě produktu s variantami vyplňte textProperty pro každou variantu

obrázek 04

Import akční ceny

Akční cenu (actionPrice) importujte vždy s parametry actionFrom a actionUntil. Jedná se o platnost dané akce. Datum zadáváte ve formátu YYYY-MM-DD (např. 27. září 2018 zapište jako 2018-09-27), formát buňky je nastaven jako text (při modifikaci v Excelu nedochází k automatickému přeformátování).

Jak provést import produktů

vstupte do administrace svého e-shopu, Produkty → Import (obrázek 05)
vyberte záložku Import
v záložce Log máte k dispozici informace o už provedených importech

obrázek 05

v Nastavení importu máte tři možnosti:
- Neměnit produkty a varianty, které nejsou obsaženy v importovaném souboru: vše na e-shopu zůstává, žádný produkt nebude smazán – produkty obsažené v importovaném souboru budou upraveny.
- Změnit jen produkty obsažené v importu a smazat u těchto produktů varianty, které nejsou obsaženy v importovaném souboru: smaže všechny varianty, které jsou zadané v e-shopu, ale nebudou zadané v importovaném souboru u produktů.
- Smazat produkty a varianty, které nejsou obsaženy v importovaném souboru: maže kompletně vše, co není v importovaném souboru. Pokud byste například chtěli upravit importem jen jeden produkt a zaškrtli tuto možnost, vše se smaže a na e-shopu zůstane pouze jeden produkt.
ostatní možnosti ponechejte
vyberte soubor pro import
vpravo nahoře klikněte na tlačítko Importovat
import se automaticky dokončí
zkontrolujte v administraci (Produkty → Import), že import proběhl správně

Dokončení převodu dat

Pokud jste právě dočetli některý z článků o převodu e-shopu na Shoptet, využijete k jeho dokončení tento návod.

Ukážeme si, jak k importu a nastavení všech vlastností produktu využít export ze Shoptetu. Dále si vysvětlíme, jaká existují pro import pravidla a význam jednotlivých značek. Dozvíte se také, jak si poradit se specifickými značkami jako jsou produkty s variantami, kategorie, textové parametry či akční ceny.

Pro tento postup si někam stranou připravte export z vašeho původního e-shopu nebo si v další kartě prohlížeče otevřete přímo jeho administraci. Pokud budete mít při ruce původní informace o vašich produktech, bude pro vás tento postup jednodušší. Jedná se zejména o informace (značky), které nebyly při migraci exportovány/importovány a bude třeba je nastavit nyní.

Dále postupujte podle návodu v tomto textu. Dalším krokem je Vytvoření vzorového souboru pro import.

Články v tomto oddílu