Dokumentace CSV - produkty

Základní pravidla

• Varianty vytvoříte tak, že si pro každou vytvoříte samostatný řádek. Do každého dáte stejnou hodnotu sloupce [PRODUCT_CODE]. U každého řádku musí být označeno, který je produkt a které 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é u varianty nemají smysl. Např. benefity, kategorie, související a jiné.
• Sloupce, které mají v uvozovkách nějaký text, např. [PRICE_ORIGINAL „název ceníku“], je možno zapsat vícekrát. 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 mimo těch, co 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í.
• 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ásleují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

• Exportuji 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 / no
• string - standardní řetězec znaků v UTF-8
• int - celé číslo
• float - desetinné číslo, jako oddělovač desetinných míst používejte tečku
• array - pole hodnot oddělených středníkem. Např. obrazek1.jpg;obrazek2.png;obrazek3.svg
• email - validní emailová adresa
• date - datum zapsané jako řeťezec 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-30
• language - kód jazyka dle ISO 639-1
• currency - kód měny dle ISO 4217
• country - 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) - Výchozí varianta - pouze pokud je řádek varianta. V případě, že se vyskytne více výchozí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])

• [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í.

• [LENGTH_LABEL] (string) - Popisek množství.

• [LENGTH_FROM] (int) - Minimální množství.

• [LENGTH_TO] (int) - Maximální množství.

• [LENGTH_STEPS_TYPE] (string) - Typ krokování metřáže, možné hodnoty: neither (žádné krokování, výchozí), multiples (násobky), select (výběr z možností).

• [LENGTH_UNIT] (string) - Název měrné jednotky (páruje se podle stejné hodnoty, nebo založí novou).

• [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.

• [LENGTH_NOTE] (string) - Poznámka množství.

• [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í. Použitelné pouze pro deaktivaci v jazykové mutaci.

• [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čí).

• [SHORT_DESCRIPTION] (string) - Krátký popis. Bez HTML formátování.

• [LONG_DESCRIPTION] (string) - Dlouhý popis. Formátování pouze pomocí HTML značek.

• [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] (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.**

• [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.

• [PRICE_SALE „název ceníku“] (float) - Akční cena, exportuje se pouze tehdy, pokud je produkt v akci (štítek akce). (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).

• [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).

• [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.*

• [CATEGORIES] (array) - Kódy kategorií oddělené středníkem (;). Více zde. Pouze pokud je řádek produkt.*

• [IMAGES] (array) - URL adresy obrázků oddělené středníkem (;). Pokud je řádek varianta, bere se pouze první obrázek.

• [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.

* 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á.