Dokumentácia CSV - produkty

Základní pravidla

• CSV se používá pro import do Upgates i export z Upgates
• hodnoty ve sloupcích jejíchž název končí na _YN jsou typu boolean a mohou hodnoty 0, 1, true, false
• všechny sloupce reprezentující datum (většinou končící na _FROM nebo _TO) používají formát YYYY-MM-DD, kde Y je rok, M je měsíc a D je den (např. 2017-03-07)
• číslelné hodnoty se uvádí nezformátované bez znaku jednotky (např. ceny, hmotnost nebo DPH). Jako oddělovač desetinných míst použijte tečku nebo čárku.
• varianty se tvoří tak, že se vytvoří více řádků které mají stejnou hodnotu sloupce [PRODUCT_CODE], a zároveň musí být označeno který řádek je produkt a které jsou varianty (sloupec [VARIANT_YN]). Pokud se varianty vůbec neimportují může se sloupec [VARIANT_YN] vynechat.
• pokud je konkrétní řádek označen jako varianta ([VARIANT_YN] bude 1), tak se některé sloupce u tohoto řádku ignorují (ty které nemají u varianty smysl) např. benefity, kategorie, související a jiné (viz. administrace)
• 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.

Import

• 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 poznámky a jiné věci, které se nebudou importovat, si můžete vytvářet další sloupce. Tzn. že se ignorují všechny sloupce, které mají neznámý název záhlaví (viz. definice záhlaví jednotlivých sloupců)
• pokud bude nějaká hodnota v CSV prázdná (např. obrázek), na eshopu dojde po importu k jejímu smazání.
• nepoužívané sloupce můžete smazat (pozor, ale i se záhlavím)
• nezáleží na pořadí sloupců
• produkty, varianty a kategorie se při importu párují podle kódu. Pokud chcete produkty a varianty importem aktualizovat, musí být kódy vyplněny
• 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 pak povinné parametry, opět pouze při importu nových variant
• další věci můžete ovlivnit nastavením importu v administraci
• více informací o importu najdete v článku Import dat do e-shopu

Export

• exportuji se všechny sloupce

Definice záhlaví jednotlivých sloupců

• [PRODUCT_CODE] - Kód produktu, páruje se podle existující hodnoty v databázi, nebo vytvoří nový produkt
• [VARIANT_YN] - Příznak varianty, pokud je hodnota 1, řádek je varianta a naimportuje se k produktu s kódem ve sloupci [PRODUCT_CODE]
• [VARIANT_CODE] - Kód varianty (POVINNÝ POKUD JE ŘÁDEK VARIANTA). Páruje se podle existující hodnoty v databázi, nebo vytvoří novou
• [MAIN_YN] - 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 první v pořadí
• [ACTIVE_YN] - Zobrazit produkt/varianta na webu
• [DISABLED_YN] - Nezobrazovat na webu (opačná hodnota k [ACTIVE_YN])
• [ARCHIVED_YN] - Archivovaný produkt
• [CAN_ADD_TO_BASKET_YN] - Lze vložit do košíku

• [NEW_YN] - Zobrazení příznaku Novinka
• [NEW_FROM] - Datum, od kterého se zobrazí příznak Novinka
• [NEW_TO] - Datum, do kterého je zobrazen příznak Novinka
• [SPECIAL_YN] - Zobrazení příznaku Akce
• [SPECIAL_FROM] - Datum, od kterého se zobrazí příznak Akce
• [SPECIAL_TO] - Datum, do kterého je zobrazen příznak Akce
• [SELLOUT_YN] - Zobrazení příznaku Výprodej
• [SELLOUT_FROM] - Datum, od kterého se zobrazí příznak Výprodej
• [SELLOUT_TO] - Datum, do kterého je zobrazen příznak Výprodej
• [LABEL_ACTIVE_YN „název štítku“] - Štítek aktivní
• [LABEL_ACTIVE_FROM „název štítku“] - Datum od kterého bude štítek aktivní
• [LABEL_ACTIVE_TO „název štítku“] - Datum do kterého bude štítek aktivní

• [LENGTH_ACTIVE_YN] - Množtví aktivní
• [LENGTH_LABEL] - Popisek množtví
• [LENGTH_FROM] - Minimální množství
• [LENGTH_TO] - Maximální množství
• [LENGTH_STEPS_TYPE] - 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] - Název měrné jednotky (páruje se podle stejné hodnoty, nebo založí novou)
• [LENGTH_STEPS] - Podle typu krokování: neither - může být prázdné, multiples - hodnota násobku, select - každá hodnota na nový řádek
• [LENGTH_NOTE] - Poznámka množství

• [LANGUAGE] - Specifikace jazykové mutace podle ISO 639-1. Pokud nebude při importu uvedeno, budou se všechna data na řádku importovat ve výchozím jazyce.
• [LANGUAGE_ACTIVE_YN] - Aktivní v jazykové mutaci, pokud se neuvede tak se bere jako aktivní. Použitelné pouze pro deaktivaci v jazykové mutaci.

• [URL] - 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 URL adresa produktu.
• [TITLE] - 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] - Krátký popis. Bez HTML formátování
• [LONG_DESCRIPTION] - Dlouhý popis. Formátování pouze pomocí HTML značek

• [SEO_URL] - Vlastní koncovka URL adresy
• [SEO_TITLE] - SEO titulek produktu
• [SEO_DESCRIPTION] - META popisek stránky produktu
• [SEO_KEYWORDS] - Klíčová slova stránky produktu, oddělená čárkou

• [SUPPLIER_CODE] - Kód u dodavatele
• [EAN] - Čárkový kód
• [MANUFACTURER] - Název výrobce - páruje se podle existující hodnoty v databázi, nebo vytvoří novou
• [AVAILABILITY] - 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] - Poznámka k dostupnosti varianty pro daný jazyk (bere se pouze pokud je řádek varianta)
• [STOCK] - Počet jednotek na skladě. V případě mínusové hodnoty se zapíše 0
• [WEIGHT] - Hmotnost v gramech pro výběr dopravy
• [UNIT] - Název měrné jednotky Páruje se podle stejné hodnoty, nebo založí novou.
• [SHIPMENT_GROUP] - Skupina doprav

• [VAT] - 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] - Ceny s DPH nebo bez DPH. Pokud není uvedeno bere se podle nastavení v administraci.
• [PRICE_ORIGINAL „název ceníku“] - Původní cena, 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.
• [PRODUCT_DISCOUNT „název ceníku“] - 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.
• [PRODUCT_DISCOUNT_REAL „název ceníku“] - Reálná sleva na produkt použitá pro výpočet výsledné ceny (pouze export), 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 e 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“] - Akční cena, exportuje se pouze tehdy, pokud je produkt v akci (štítek akce)
• [PRICE_WITH_VAT „název ceníku“] - Koncová cena s DPH (pouze export)
• [PRICE_WITHOUT_VAT „název ceníku“] - Koncová cena bez DPH (pouze export)
• [PRICE_BUY] - Nákupní cena (interní údaj pro orientaci administrátora)
• [PRICE_COMMON] - Běžná cena (např. v kamenných obchodech; pro orientaci při nákupu)

• [CATEGORIES] - Kódy kategorií oddělené středníkem (;), pouze pokud je řádek produkt
• [IMAGES] - URL adresy obrázků oddělené středníkem (;), pokud je řádek varianta bere se pouze první obrázek
• [FILES] - URL adresy souborů oddělené středníkem (;), pouze pokud je řádek produkt
• [BENEFITS] - Benefity oddělené středníkem (;), pouze pokud je řádek produkt
• [PARAMETER „název prametru“] - Parametry oddělené středníkem (;). U produktu kde parameter není, bude hodnota prázdná
• [RELATED] - Kódy souvisejících produktů oddělené středníkem (;), pouze pokud je řádek produkt
• [ALTERNATIVE] - Kódy alternativních produktů oddělené středníkem (;), pouze pokud je řádek produkt
• [ACCESSORIES] - Kódy příslušenství oddělené středníkem (;), pouze pokud je řádek produkt
• [GIFTS] - Kódy dárků oddělené středníkem (;), pouze pokud je řádek produkt
• [META „klíč vlastního pole“] - Vlastní pole