Export a import produktů¶

Data o produktech lze v BizBoxu snadno vyexportovat, upravit a naimportovat zpět. Export a následný import je velmi výhodný, pokud chcete upravit větší množství produktů nebo chcete založit produkty nové.

Export produktů¶

Export produktů se provádí v modulu Produkty v aplikaci Produkty. Zde je k dispozici tlačítko Export – po kliknutí se zobrazí dialog pro nastavení exportu a jeho obsahový filtr.

Produktové záložky definují, která data o produktech chcete vyexportovat. Často totiž potřebujete jen část dat – především v případě, kdy chcete upravovat již existující produkty.

Výběrem jazyka určíte, ve kterých jazykových mutacích se data vyexportují. Ne všechna pole jsou překládaná; typicky se překládají pouze taková pole, která mohou vidět zákazníci (název, URL adresa, SEO, popisky…). Pokud tedy chcete měnit spíše nastavení (aktivita, výrobce, kategorie, alternativní produkty, prodejnost…) postačí vám export v jednom jazyce.

Rozsah exportu určuje, které produkty budou součástí exportu:

Všechny = celý produktový katalog bez omezení.
Pouze filtrované = v exportu budou pouze produkty, které máte vyfiltrované v aplikaci. Jestliže tedy například chcete upravovat produkty jen od určitého výrobce, před kliknutím na tlačítko Export si v aplikaci Produkty vyfiltrujete jen produkty od daného výrobce
Pouze vybrané = vyexportují se pouze produkty, které jsou v produktové aplikaci žlutě označené (vybrané kliknutím myši, případně i s použitím klávesy CTRL nebo SHIFT).

Následně kliknete na tlačítko Export. Systém váš požadavek zpracuje a po chvíli budete vyzváni k uložení souboru (případně dojde k jeho automatickému stažení a uložení – dle nastavení prohlížeče).

Import produktů¶

Import produktů se rovněž nachází v modulu Produkty v aplikaci Produkty – tlačítko Import v panelu nástrojů.

Pomocí importu můžete:

Vložit nové produkty – pokud aktuálně nahraný soubor obsahuje nějaké produkty, které momentálně katalog nejsou, dojde k jejich přidání.
Aktualizovat (upravovat) existující produkty – upraví se ty produkty, které jsou v aktuálně nahraném souboru změněny.
Smazat existující produkty – smažou se všechny produkty, které nejsou obsažené v aktuálně nahraném importním souboru.

Pokud chcete vytvářet nové produkty, nejjednodušším způsobem tvorby importního souboru (excelu) je export nějakého již existujícího produktu. Tím získáte správně pojmenované sloupce a postačí, když je dle vzoru exportovaného produktu vyplníte. Pokud je v názvu sloupce uvedena i identifikace jazyka (například :cs), jedná se o překládanou hodnotu.

Při importu nových produktů můžete při vložení importního souboru nastavit výchozí hodnoty pro Typ produktu, Typ doručení, Doručovací službu, Jednotku a Prodejnost. Zde nastavené hodnoty se pak použijí jako výchozí a není je potřeba definovat v importním souboru.

Aktualizaci produktů typicky používáte v případě, že jste tyto produkty nejdříve vyexportovali, získaný excel upravili a nyní chcete provedené změny naimportovat zpět.

Pokud chcete nějaké produkty z katalogu smazat, jednoduše si vyexportujete celý katalog a následně z vyexportovaného souboru odstraníte ty produkty, které chcete smazat. Tento soubor poté naimportujete do BizBoxu v režimu Smazat.

Jakmile import spustíte, dojde k naplánování úlohy a jejímu následnému spuštění. Když je import dokončen, objeví se vpravo dole vyskakovací okno. Spolu s tím si můžete zobrazit detaily o průběhu importu – toto je důležité především v případě, že se v importním souboru vyskytly nějaké chyby, které musíte opravit.

Import produktů může nějakou chvíli trvat (v závislosti na objemu importovaných dat) a je potřeba počkat na jeho dokončení, které je indikováno zobrazením zprávy o dokončení importu v pravém dolním rohu.

Průběh importu (případně zobrazení zpráv z importu) můžete sledovat přímo v aplikaci pro naplánované úlohy: kliknete na šipečku vedle vašeho jména vlevo nahoře -> Dávkové úlohy. Otevře se správce dávkového zpracování, kde můžete vidět průběh aktuálního importu (i exportu) a po jeho dokončení jej můžete označit myší a zobrazit si zprávy z průběhu importu. Pokud import skončil s nějakou chybou, můžete si zde vyfiltrovat chybové zprávy. Tyto chyby pak v souboru, který jste importovali, můžete upravit a následně zkusit import znovu.

Seznam sloupců pro import produktů¶

Pokud je nějaký sloupec překládaný, indikuje to určení jazyka (‘cs’) v jeho názvu. Pro vícejazyčné weby můžete daný sloupec vložit do importu vícekrát, pokaždé s jiným určením jazyka (například ‘en’).

Jestliže vkládáte interní název (například pro Produktovou skupinu, Kategorie, Výrobce a podobně), je potřeba, aby daná entita již v systému existovala.

Pro vložení více hodnot (například u kategorií) je potřeba jednotlivé hodnoty oddělovat svislítkem. Například ‘hodnota1|hodnota2|hodnota3’.

Název sloupce	Popis
code	Povinné; tab Obecné, zadejte unikátní kód produktu.
name:cs	Povinné, tab Obecné, zadejte název produktu.
nameUrl:cs	Volitelné; tab Obecné, zadejte unikátní URL adresu tohoto produktu.
productGroup	Volitelné; tab Obecné, zadejte interní název Produktové skupiny, do které produkt patří.
deliveryType	Volitelné; tab Obecné, zadejte Typ doručení (physical = fyzické doručení, electronic = elektronické doručení).
deliveryService	Volitelné; tab Obecné, zadejte Doručovací službu (bizboxManual = produkt bez skladové zásoby, stock = produkt má skladovou zásobu v BizBoxu, bizboxElectronical = pro elektronické produkty).
brand	Volitelné; tab Obecné, zadejte interní název Zbačky (již musí v systému existovat).
active	Volitelné; tab Obecné, zadejte 0 pro NEaktivní produkt 1 pro aktivní produkt. Pokud tento sloupec nebude zahrnut v importním souboru, produkty se naimportují jako aktivní.
archived	Volitelné; tab Obecné, zadejte 0 pro NEarchivovaný produkt a 1 pro archivovaný produkt.
validFrom	Volitelné; tab Obecné, zadejte datum začátku aktivity produktu. Příklad: 2015-09-08 00:00:00.
validUntil	Volitelné; tab Obecné, zadejte datum konce aktivity produktu. Příklad: 2015-09-08 00:00:00.
manufacturer	Volitelné; tab Obecné, zadejte interní název Výrobce (již musí v systému existovat).
supplier	Volitelné; tab Obecné, zadejte interní název Dodavatele (již musí v systému existovat).
tags	Volitelné; tab Obecné, zadejte interní názevy tagů, které chcete produktu nastavit; více hodnot se odděluje svislítkem \|.
productType	Volitelné; tab Obecné, určuje Typ produktu. product = produkt, event = událost, master = základní produkt, bundle = sada, gift = dárek.
externalId	Volitelné; tab Obecné, zadejte Externí ID produktu.
priceCategory	Volitelné; tab Obecné, zadejte interní název Cenové kategorie, do které produkt patří.
purchasePrice	Volitelné; tab Obecné, zadejte nákupní cenu produktu; pro import nákupní ceny musíte v importu zadat všechny purchasePrice sloupce.
purchasePriceTaxRate	Volitelné; tab Obecné, zadejte daňovou sazbu nákupní ceny produktu; pro import nákupní ceny musíte v importu zadat všechny purchasePrice sloupce.
purchasePriceGrossPrice	Volitelné; tab Obecné,zadejte, zda je uvedená nákupní cena s daní (hodnota 1) nebo bez daně (hodnota 0); pro import nákupní ceny musíte v importu zadat všechny purchasePrice sloupce.
purchasePriceCurrency	Volitelné; určuje měnu nákupní ceny produktu (např. CZK, EUR); pro import nákupní ceny musíte v importu zadat všechny purchasePrice sloupce.
eshop:available:INTERNÍ-NÁZEV-ESHOPU	Volitelné; Nastavení pro e-shop; dostupnost pro Nastavení e-shopu (hodnoty 0,1). Místo INTERNÍ-NÁZEV-ESHOPU uveďte interní název Nastavení e-shopu, pro který chcete hodnotu naimportovat.
eshop:freeshipping:INTERNÍ-NÁZEV-ESHOPU	Volitelné; Nastavení pro e-shop; doprava zdarma pro Nastavení e-shopu (hodnoty 0,1). Místo INTERNÍ-NÁZEV-ESHOPU uveďte interní název Nastavení e-shopu, pro který chcete hodnotu naimportovat.
eshop:additionalLoyaltyPoints:INTERNÍ-NÁZEV-ESHOPU	Volitelné; Nastavení pro e-shop; Bonusové věrnostné body – zadáváte počet bodů (číslo). Místo INTERNÍ-NÁZEV-ESHOPU uveďte interní název Nastavení e-shopu, pro který chcete hodnotu naimportovat.
eshopcarrier:service:INTERNÍ-NÁZEV-ESHOPU	Volitelné; Nastavení pro e-shop; Omezení způsobů dopravy: zadáváte interní názvy doprav oddělené svislítkem \|. Místo INTERNÍ-NÁZEV-ESHOPU uveďte interní název Nastavení e-shopu, pro který chcete hodnotu naimportovat.
eshopspecialcarrier:specialService:INTERNÍ-NÁZEV-ESHOPU	Volitelné; Nastavení pro e-shop; Speciální doručovací metody: zadáváte interní názvy doprav oddělené svislítkem \|. Místo INTERNÍ-NÁZEV-ESHOPU uveďte interní název Nastavení e-shopu, pro který chcete hodnotu naimportovat.
eshopcurrency:additionalLoyaltyPoints:INTERNÍ-NÁZEV-ESHOPU	Volitelné; Nastavení pro e-shop; zadávají se všechny měny a věrnostní body, které chcete přidat k danému Nastavení e-shopu - měna:věrnostní body oddělené svislítkem \|. Přéklad: EUR:2\|CZK:1\|HUF:3. Místo INTERNÍ-NÁZEV-ESHOPU uveďte interní název Nastavení e-shopu, pro který chcete hodnotu naimportovat.
description:cs	Volitelné; tab Popis. Zadejte dlouhý popis produktu (je možné vkládat text včetně HTML tagů).
shortDescription:cs	Volitelné; tab Popis. Zadejte krátký popisek (je možné vkládat text včetně HTML tagů).
instructions:cs	Volitelné; tab Popis. Zadejte Pokyny (je možné vkládat text včetně HTML tagů).
seoTitle:cs	Volitelné; tab SEO. Zadejte SEO titulek pro tento produktu. Pokud jej nezadáte, typicky se použije název produktu (záleží na šabloně).
seoDescription:cs	Volitelné; tab SEO. Zadejte popisek produktu pro SEO. Pokud popisek nezadáte, typicky se na webu použije krátký popis produktu (záleží na šabloně).
seoKeywords:cs	Volitelné; tab SEO. Zadejte klíčová slova produktu.
seoTitleSource	Volitelné; tab SEO. Určuje, odkud se na webu bude brát SEO titulek (hodnoty default, specific, none).
seoDescriptionSource	Volitelné; tab SEO. Určuje odkud se na webu bude brát SEO popis (hodnoty default, specific, none).
ean	Volitelné; tab Sklad; EAN produktu.
manufacturerCode	Volitelné; tab Sklad; Kód výrobce.
marketabilityType	Volitelné; tab Sklad; Prodejnost. Hodnoty: always = Vždy, never = Nikdy, until-sold-out = Do vyprodání..
unit	Volitelné; tab Sklad; zadává se jednotka produktu. Hodnoty: kilogram, litre, meter, pallet, person, piece or squareMeter)
weight	Volitelné; tab Sklad; Hmotnost produktu (číslo).
volume	Volitelné; tab Sklad; Objem produktu (číslo).
height	Volitelné; tab Sklad; Výška produktu (číslo).
width	Volitelné; tab Sklad; Šířka produktu (číslo).
depth	Volitelné; tab Sklad; Hloubka produktu (číslo).
length	Volitelné; tab Sklad; Délka produktu (číslo).
material	Volitelné; tab Sklad; zadejte interní název Materiálu (Materiál již musí být v aplikaci definovaný).
masterPackEan	Volitelné; tab Sklad; EAN multi balení.
masterPackQuantity	Volitelné; tab Sklad; Počet kusů v multi balení (číslo).
masterPackLabel	Volitelné; tab Sklad; Označení multi balení.
masterPackPackage	Volitelné; tab Sklad; Obal multi balení.
masterPackStoragePlace	Volitelné; tab Sklad; Skladové místo multi balení.
snAgenda	Volitelné; tab Sklad; Sériové číslo. Hodnota ‘0’ vypne evidenci sériových čísel, hodnota 1 ji zapne. Pokud sloupec do importu nezařadíte, automaticky se vyplní ‘0’.
availability	Volitelné; tab Sklad; Stav při Naskladnění. Hodnoty: currently-unavailable, in-external-stock, in-stock, on-request, out-of-stock or sold-out.
outOfStockAvailability	Volitelné; tab Sklad; Stav při vyprodaném skladu. Hodnoty: currently-unavailable, in-external-stock, in-stock, on-request, out-of-stock or sold-out.
goodsDescription	Volitelné; tab Sklad; Popis zboží (Clo).
hsCode	Volitelné; tab Sklad; HS kód (Clo).
stock:minimumRequiredLevel:STOCK-INTERNAL-NAME	Volitelné; defines the minimum required quantity for the stock. Instead of STOCK-INTERNAL-NAME please use the internal name of the stock for which you want to import this setting.
alternateProducts	Volitelné; tab Vztahy; vazba typu Alternativní. Zadávají se kódy produktů oddělené svislítkem. Příklad: 1234564\|5454545.
crossSellProducts	Volitelné; tab Vztahy; vazba typu Křížový prodej. Zadávají se kódy produktů oddělené svislítkem. Příklad: 1234564\|5454545.
upSellProducts	Volitelné; tab Vztahy; vazba typu Navyšovací prodej. Zadávají se kódy produktů oddělené svislítkem. Příklad: 1234564\|5454545.
accessoryProducts	Volitelné; tab Vztahy; vazba typu Příslušenství. Zadávají se kódy produktů oddělené svislítkem. Příklad: 1234564\|5454545.
masterProduct	Volitelné; dostupné pouze pro variantní produkty; zadává se kód základního produktu varianty.
categoriesSingle	Volitelné; zadávají se kategorie (interní název), do kterých produkt patří. Více hodnot se odděluje svislítkem. Příklad: clothing\|skirts\|sale.
categoriesVariant	Volitelné; zadávají se kategorie (interní název), do kterých bude produkt zařazen jako variantní. Více hodnot se odděluje svislítkem. Příklad: clothing\|skirts\|sale.
defaultCategory	Volitelné; zadává se interní název výchozí kategorie produktu.
bigImages	Volitelné - velký obrázek, zadává se cesta k souboru (Správce souborů nebo úložiště S3). Více hodnot se odděluje pomocí svislítka. Příklad: /website/images/image1.png\|/website/images/image2.png.
smallImages	Volitelné - malý obrázek, zadává se cesta k souboru (Správce souborů nebo úložiště S3). Více hodnot se odděluje pomocí svislítka. Příklad: /website/images/image1.png\|/website/images/image2.png.
galleryImages	Volitelné - zadává se cesta k souboru (Správce souborů nebo úložiště S3). Více hodnot se odděluje pomocí svislítka. Příklad: /website/images/image1.png\|/website/images/image2.png.
certificate	Volitelné - tab Produktové dokumenty (Certifikát), defines path to a file stored in the File Manager. Příklad: /website/files/certificate.pdf.
technicalSpecification	Volitelné - tab Produktové dokumenty (Technická specifikace), zadává se cesta k souboru (Správce souborů nebo úložiště S3). Příklad: /website/files/specification.pdf.
userManual	Volitelné - tab Produktové dokumenty (Uživatelská příručka), zadává se cesta k souboru (Správce souborů nebo úložiště S3). Příklad: /website/files/manual.pdf.
genericDocument1	Volitelné - tab Produktové dokumenty (Obecný dokument 1), zadává se cesta k souboru (Správce souborů nebo úložiště S3). Příklad: /website/files/document.pdf.
genericDocument2	Volitelné - tab Produktové dokumenty (Obecný dokument 2), zadává se cesta k souboru (Správce souborů nebo úložiště S3). Příklad: /website/files/document.pdf.
genericDocument3	Volitelné - tab Produktové dokumenty (Obecný dokument 3), zadává se cesta k souboru (Správce souborů nebo úložiště S3). Příklad: /website/files/document.pdf.
demoDownload	Volitelné - tab Produktové URL, URL adresa pro Stažení demoverze. Přidáním zkratky jazyka v názvu sloupce (: cs) je možné určit jazyk, ke kterému bude hodnota naimportována.
fullDownload	Volitelné - tab Produktové URL, URL adresa pro Stažení plné verze. Přidáním zkratky jazyka v názvu sloupce (: cs) je možné určit jazyk, ke kterému bude hodnota naimportována.
reviewUrl	Volitelné - tab Produktové URL, URL adresa pro Recenzi. Přidáním zkratky jazyka v názvu sloupce (: cs) je možné určit jazyk, ke kterému bude hodnota naimportována.
videoUrl	Volitelné - tab Produktové URL, URL adresa pro Video. Přidáním zkratky jazyka v názvu sloupce (: cs) je možné určit jazyk, ke kterému bude hodnota naimportována.
manufacturerWebsiteUrl	Volitelné - tab Produktové URL, URL adresa Webová stránka výrobce. Přidáním zkratky jazyka v názvu sloupce (: cs) je možné určit jazyk, ke kterému bude hodnota naimportována.
otherUrl	Volitelné - tab Produktové URL, URL adresa pro Jiné URL. Přidáním zkratky jazyka v názvu sloupce (: cs) je možné určit jazyk, ke kterému bude hodnota naimportována.
warranty	Volitelné - tab Pokročilá nastavení, zadává se počet měsíců záruky (číslo).
allowAnyAccessory	Volitelné - tab Pokročilá nastavení; hodnota 0 nebo 1. Hodnota 1 = každý koupitelný produkt z katalogu může být zakoupen jako příslušenství tohoto produktu. Hodnota 0 = pouze produkty, které jsou nastavené jako příslušenství mohou být zakoupeny jako příslušenství tohoto produktu.
minimumQuantity	Volitelné - tab Pokročilá nastavení, (Minimální množství), minimální počet jednotek produktu, které je možné vložit do košíku (číslo).
quantityLimit	Volitelné - tab Pokročilá nastavení, (Maximální množství), maximální počet jednotek, které je možné vložit do košíku (číslo).
relevance	Volitelné - tab Pokročilá nastavení, zadává se hodnota Relevance (číslo 1-1 000 000 ).
custom:NÁZEV:cs	Volitelné - rozšiřující atribut. Místo NÁZEV uveďte interní název rozšiřujícího atributu, jehož hodnotu chcete naimportovat. Pokud importujete hodnotu produktové varianty, je potřeba vložit její interní název. Pokud chcete naimportovat hodnoty pro více rozšiřujících atributů, je potřeba jednotlivé hodnoty oddělit svislítkem.
extraEntities	Volitelné - interní názvy extra entit oddělené svislítkem. Příklad: interni-nazev\|interni-nazev2.