Dokumentace CSV - produkty
Základní pravidla
- Varianty vytvoříte tak, že si pro každou variantu vytvoříte samostatný řádek. Do každého řádku dáte stejnou hodnotu sloupce
[PRODUCT_CODE]
. U každého řádku musí být označeno, který z nich je produkt a které řádky jsou varianty (sloupec[VARIANT_YN]
). Pokud se varianty vůbec neimportují, může se sloupec[VARIANT_YN]
úplně odstranit. - Pokud je konkrétní řádek označen jako varianta (
[VARIANT_YN]
bude 1), ignorují se u něj sloupce, které se u varianty nepoužívají. Např. benefity, kategorie, související a jiné. - Sloupce, které mají v uvozovkách nějaký text, je možno zapsat vícekrát (např.
[PRICE_ORIGINAL „název ceníku“]
). Text v uvozovkách bude v tomto případě odpovídat názvu ceníku. Příklad:[PRICE_ORIGINAL „Velkoobchodní“]
- jedná se o původní cenu produktu pro ceník Velkoobchodní.
Import
- Soubor se vzorovým obsahem (kódování Windows-1250)
- Importují se všechny sloupce kromě těch, které jsou označeny (pouze export) dle Definice záhlaví jednotlivých sloupců.
- Produkty, varianty a kategorie se při importu párují podle kódu (tag
[PRODUCT_CODE]
a[VARIANT_CODE]
). Pokud chcete produkty a varianty importem aktualizovat, musí být tagy s kódy vyplněny (pro varianty včetně tagu[VARIANT_YN]
). Případně si v nastavení importu zvolte možnost Párování produktů s variantami pro zpracování samotných variant. - Všechny sloupce jsou nepovinné. Při importu nových produktů je povinný sloupec
[TITLE]
, protože z názvu produktu se tvoří URL. Ve variantách jsou povinné parametry varianty při importu nových variant. Pro aktualizaci existujících variant je potřeba v CSV zadat všechny parametry nebo v nastavení importu zvolit, aby se parametry variant nezpracovávaly. - Ignorují se všechny sloupce, které mají neznámý název v záhlaví (viz. definice záhlaví jednotlivých sloupců).
- Pokud bude nějaká hodnota v CSV prázdná, na e-shopu dojde po importu k jejímu smazání. (neplatí pro ceny)
- U produktu je potřeba ponechat sloupce se všemi stávajícími parametry. Pokud některé sloupce s parametry vynecháte v CSV souboru, systém tyto parametry u produktu odstraní.
- Nepoužívané sloupce můžete smazat (pozor, ale i se záhlavím).
- Nezáleží na pořadí sloupců.
- Pokud má systém nově vytvořeným produktům automaticky přiřadit štítek novinka, pak je potřeba v nastavení importu povolit zpracování položky Štítky -> Novinka (do). To je potřeba provést i když tento štítek nenastavujete přes importní soubor.
- Další věci můžete ovlivnit nastavením importu v administraci (viz. nápověda).
Malý import
- Soubor se vzorovým obsahem
- V malém importu se zpracovávají pouze následující sloupce (včetně všech vnořených):
[PRODUCT_CODE]
[VARIANT_CODE]
[VARIANT_YN]
[MAIN_YN]
[ACTIVE_YN]
[ARCHIVED_YN]
[REPLACEMENT_PRODUCT_CODE]
[CAN_ADD_TO_BASKET_YN]
[LABELS]
[LANGUAGE]
[AVAILABILITY]
[STOCK]
- Ceny
[METAS]
Export
- Exportují se všechny sloupce dle Definice záhlaví jednotlivých sloupců.
Malý export
- Do malého exportu se vkládají pouze následující sloupce:
[PRODUCT_CODE]
[VARIANT_YN]
[VARIANT_CODE]
[MAIN_YN]
[ACTIVE_YN]
[ARCHIVED_YN]
[CAN_ADD_TO_BASKET_YN]
[LANGUAGE]
[AVAILABILITY]
[STOCK]
- Ceny
- Parametry
Datové typy
Vysvětlivky, jaké hodnoty je možné vkládat do daných sloupců.
bool
- true / false, 1 / 0, ano / ne, yes / nostring
- standardní řetězec znakůint
- celé číslofloat
- desetinné číslo, jako oddělovač desetinných míst používejte tečkuarray
- pole hodnot oddělených středníkem. Např. obrazek1.jpg;obrazek2.png;obrazek3.svgemail
- validní emailová adresadate
- datum zapsané jako řetězec znaků ve formát YYYY-MM-DD dle ISO 8601. Y je rok, M je měsíc a D je den. Příklad: 2020-12-30language
- kód jazyka dle ISO 639-1currency
- kód měny dle ISO 4217country
- kód země dle ISO 3166-1 alpha-2
Definice záhlaví jednotlivých sloupců
[PRODUCT_CODE]
(string) - Kód produktu. Páruje se podle existující hodnoty v databázi, nebo vytvoří nový produkt.[VARIANT_YN]
(string) - Příznak varianty. Pokud je hodnota 1, řádek je varianta a naimportuje se k produktu s kódem ve sloupci[PRODUCT_CODE]
.[VARIANT_CODE]
(string) - Kód varianty - JE POVINNÝ, POKUD JE ŘÁDEK VARIANTA. Páruje se podle existující hodnoty v databázi, nebo vytvoří novou.[MAIN_YN]
(bool) - Hlavní varianta - pouze pokud je řádek varianta. V případě, že se vyskytne více hlavních variant v jednom produktu, bere se ta první v pořadí.[ACTIVE_YN]
(bool) - Zobrazit produkt/variantu na e-shopu.[DISABLED_YN]
(bool) - Nezobrazovat na e-shopu (opačná hodnota k[ACTIVE_YN]
) (pouze import)[ARCHIVED_YN]
(bool) - Archivovaný produkt.[CAN_ADD_TO_BASKET_YN]
(bool) - Lze vložit do košíku.[NEW_YN]
(bool) - Zobrazení štítku Novinka.[NEW_FROM]
(date) - Datum, od kterého se zobrazí štítek Novinka.[NEW_TO]
(date) - Datum, do kterého je zobrazen štítek Novinka.[SPECIAL_YN]
(bool) - Zobrazení štítku Akce.[SPECIAL_FROM]
(date) - Datum, od kterého se zobrazí štítek Akce.[SPECIAL_TO]
(date) - Datum, do kterého je zobrazen štítek Akce.[SELLOUT_YN]
(bool) - Zobrazení štítku Výprodej.[SELLOUT_FROM]
(date) - Datum, od kterého se zobrazí štítek Výprodej.[SELLOUT_TO]
(date) - Datum, do kterého je zobrazen štítek Výprodej.[LABEL_ACTIVE_YN „název štítku“]
(bool) - Zobrazení daného štítku. Pro štítek akce jsou možné hodnoty 1 (nebere se v potaz datum od do a štítek je "natvrdo" aktivní) a 0 (štítek je neaktivní a bere se v potaz datum od do).[LABEL_ACTIVE_FROM „název štítku“]
(date) - Datum, od kterého se zobrazí daný štítek.[LABEL_ACTIVE_TO „název štítku“]
(date) - Datum, do kterého je zobrazen daný štítek.[LENGTH_ACTIVE_YN]
(bool) - Množství aktivní. (Slouží pouze pro import)[LENGTH_LABEL]
(string) - Popisek množství. (Slouží pouze pro import)[LENGTH_FROM]
(int) - Minimální množství. (Slouží pouze pro import)[LENGTH_TO]
(int) - Maximální množství. (Slouží pouze pro import)[LENGTH_STEPS_TYPE]
(string) - Typ krokování metráže, možné hodnoty: neither (žádné krokování, výchozí), multiples (násobky), select (výběr z možností). (Slouží pouze pro import)[LENGTH_UNIT]
(string) - Název měrné jednotky (páruje se podle stejné hodnoty, nebo založí novou). (Slouží pouze pro import)[LENGTH_STEPS]
(string) - Podle typu krokování: neither - může být prázdné, multiples - hodnota násobku, select - každá hodnota na nový řádek. (Slouží pouze pro import)[LENGTH_NOTE]
(string) - Poznámka k množství. (Slouží pouze pro import)[LANGUAGE]
(language) - Specifikace jazykové mutace. Pokud nebude při importu uvedeno, budou se všechna data na řádku importovat ve výchozím jazyce.[LANGUAGE_ACTIVE_YN]
(bool) - Aktivní v jazykové mutaci. Pokud se neuvede, bere se jako aktivní. (Slouží pouze pro import)[URL]
(string) - URL produktu. Při importu se vytvoří přesměrování ze zadané adresy na adresu produktu, vezme se vše za doménou. Při exportu se exportuje kompletní URL adresa produktu.[TITLE]
(string) - Název (POVINNÝ v případě vytváření nového produktu). Pokud není definovaný, nezaloží se ani jazyková mutace produktu (související data se přeskočí).[LONG_DESCRIPTION]
(string) - Dlouhý popis. Formátování pouze pomocí HTML značek.[SHORT_DESCRIPTION]
(string) - Krátký popis. Bez HTML formátování.[SEO_URL]
(string) - Vlastní koncovka URL adresy.[SEO_TITLE]
(string) - SEO titulek produktu.[SEO_DESCRIPTION]
(string) - META popisek stránky produktu.[SUPPLIER_CODE]
(string) - Kód dodavatele.[EAN]
(string) - Čárkový kód.[MANUFACTURER]
(string) - Název výrobce. Páruje se podle existující hodnoty v databázi nebo vytvoří novou.**[AVAILABILITY]
(string) - Název dostupnosti. Páruje se podle existující hodnoty v databázi nebo vytvoří novou. Neimportuje se u položek s nastavením dostupnosti dle stavu zásob. Pokud však v tomto případě stav zásob není definován (sloupec[STOCK]
musí být prázdný nebo úplně chybět), dostupnost se importuje.[AVAILABILITY_NOTE]
(string) - Poznámka k dostupnosti varianty pro daný jazyk (bere se pouze pokud je řádek varianta).[STOCK]
(float) - Počet jednotek na skladě.[WEIGHT]
(float) - Hmotnost v gramech pro výběr dopravy.[UNIT]
(string) - Název měrné jednotky. Páruje se podle stejné hodnoty nebo založí novou.**[SHIPMENT_GROUP]
(string) - Skupina doprav.*[VAT "jazyk země"]
(string) - Procentní sazba DPH pro daný jazyk. Páruje se podle existující hodnoty v databázi nebo vytvoří novou. Pokud není vyplněno, bere se výchozí DPH pro daný jazyk.**[CATEGORIES]
(array) - Kódy kategorií oddělené středníkem (;
). Více zde. Lze vložit více kódů kategorií oddělených středníkem (1 hlavní a x podkategorií). Pouze pokud je řádek produkt.*[IS_PRICES_WITH_VAT_YN]
(bool) - Ceny s DPH nebo bez DPH. Pokud není uvedeno, bere se podle nastavení v administraci.[PRICE_ORIGINAL „název ceníku“]
(float) - Základní ceníková cena, od které se odvozují další. Do názvu ceníku si doplníte název ceníku z administrace. Pokud bude bez názvu (pouze[PRICE_ORIGINAL]
), bere se výchozí ceník. (neexportuje se do odběratelského feedu)[PRODUCT_DISCOUNT „název ceníku“]
(float) - Sleva na produkt v procentech. Do názvu ceníku si doplníte název ceníku z administrace. Pokud bude bez názvu (pouze[PRICE_ORIGINAL]
), bere se výchozí ceník. (neexportuje se do odběratelského feedu)[PRODUCT_DISCOUNT_REAL „název ceníku“]
(float) - Reálná sleva na produkt použitá pro výpočet výsledné ceny (pouze export, neexportuje se do odběratelského feedu), vypočítává se takto:- hodnota slevy na produkt (
[PRODUCT_DISCOUNT „název ceníku“]
) + sleva na výrobce + sleva na kategorii (bere se sleva z hlavní kategorie, do které je produkt zařazen). Výsledná hodnota slevy se omezí na hodnotu z nastavení Maximální procento slevy.
- hodnota slevy na produkt (
[PRICE_SALE „název ceníku“]
(float) - Akční cena. Exportuje se pouze tehdy, pokud má produkt přiřazený štítek akce. Neexportuje se pokud je akční cena totožná s výchozí cenou.[PRICE_BUY]
(float) - Nákupní cena (interní údaj pro orientaci administrátora) (neexportuje se do odběratelského feedu).[PRICE_COMMON]
(float) - Běžná cena (např. v kamenných obchodech; pro orientaci při nákupu) (neexportuje se do odběratelského feedu).[PRICE_WITH_VAT „název ceníku“]
(float) - Výsledná cena po slevách s DPH (pouze export, exportuje se pouze do odběratelského feedu).[PRICE_WITHOUT_VAT „název ceníku“]
(float) - Výsledná cena po slevách bez DPH (pouze export, exportuje se pouze do odběratelského feedu).[PRICES_FORMULAS]
(array) - Názvy vzorců oddělené středníkem (;
). Páruje se podle existující hodnoty v databázi.*[RECYCLING_FEE]
(string) - Interní název recyklačního poplatku. Páruje se podle existující hodnoty v databázi.* (Slouží pouze pro import)[IMAGES]
(array) - URL adresy obrázků oddělené středníkem (;
). Pokud je řádek varianta, bere se pouze první obrázek. První obrázek uvedený v poli se nastaví jako Hlavní a Seznamový.[FILES]
(array) - URL adresy souborů oddělené středníkem (;
). Pouze pokud je řádek produkt.[BENEFITS]
(array) - Benefity oddělené středníkem (;
). Pouze pokud je řádek produkt.**[PARAMETER „název prametru“]
(array) - Parametry oddělené středníkem (;
). U produktu, kde parameter není, bude hodnota prázdná. U produktu je potřeba ponechat sloupce se všemi stávajícími parametry. Pokud některé sloupce s parametry vynecháte v CSV souboru, systém tyto parametry u produktu odstraní.**[RELATED]
(array) - Kódy souvisejících produktů oddělené středníkem (;
). Pouze pokud je řádek produkt.[ALTERNATIVE]
(array) - Kódy alternativních produktů oddělené středníkem (;
). Pouze pokud je řádek produkt.[ACCESSORIES]
(array) - Kódy příslušenství oddělené středníkem (;
). Pouze pokud je řádek produkt.[GIFTS]
(array) - Kódy dárků oddělené středníkem (;
). Pouze pokud je řádek produkt.[SETS]
(array) - Sada, kódy produktů oddělené středníkem (;
). Pouze pokud je řádek produkt.[META „klíč vlastního pole“]
(array) - Vlastní pole. V případě vyplnění Klíče vlastního pole jsou povolené znaky pouze malá písmena, čísla (nesmí být na první pozici) a podtržítko.[STOCK_POSITION]
- Pozice na skladě[STOCK_STOCK "kód skladu"]
- Stav zásob konkrétního skladu[STOCK_STOCK_POSITION "pozice na skladě"]
- Pozice na skladě
* Páruje se podle existující hodnoty v administraci. Pokud hodnota neexistuje ignoruje se.
** Páruje se podle existující hodnoty v administraci. Pokud hodnota neexistuje, vytvoří se v nastavení nová.