Dokumentácia CSV - produkty

Základní pravidla

• Varianty vytvoríte tak, že si pre každý variant vytvoríte samostatný riadok. Do každého riadku dáte rovnakú hodnotu stĺpca [PRODUCT_CODE]. Pri každom riadku musí byť označené, ktorý z nich je produkt a ktoré riadky sú varianty (stĺpec [VARIANT_YN]). Pokiaľ sa varianty vôbec neimportujú, môže sa stĺpec [VARIANT_YN] úplne odstrániť.
• Pokiaľ je konkrétny riadok označený ako variant ([VARIANT_YN] bude 1), ignorujú sa pri ňom stĺpce, ktoré sa pri variante nepoužívajú. Napr. benefity, kategórie, súvisiace a iné.
• Stĺpce, ktoré majú v úvodzovkách nejaký text, je možné zapísať viackrát (napr. [PRICE_ORIGINAL „název ceníku“]). Text v úvodzovkách bude v tomto prípade zodpovedať názvu cenníka. Príklad: [PRICE_ORIGINAL „Velkoobchodní“]- jedná sa o pôvodnú cenu produktu pre cenník Veľkoobchodný.

Import

• Súbor so vzorovým obsahom (kódovanie Windows-1250)
• Importujú sa všetky stĺpce okrem tých, ktoré sú označené (iba export) podľa Definície záhlaví jednotlivých stĺpcov.
• Produkty, varianty a kategórie sa pri importe párujú podľa kódu (tag [PRODUCT_CODE] a [VARIANT_CODE]). Pokiaľ chcete produkty a varianty importom aktualizovať, musia byť tagy s kódmi vyplnené (pre varianty vrátane tagu [VARIANT_YN]). Prípadne si v nastavení importu zvoľte možnosť Párovanie produktov s variantmi na spracovanie samotných variantov.
• Všetky stĺpce sú nepovinné. Pri importe nových produktov je povinný stĺpec [TITLE], pretože z názvu produktu sa tvorí URL. Vo variantoch sú povinné parametre variantu pri importe nových variant. Pre aktualizáciu existujúcich variantov je potrebné v CSV zadať všetky parametre alebo v nastavení importu zvoliť, aby sa parametre variantov nespracovávali.
• Ignorujú sa všetky stĺpce, ktoré majú neznámy názov v záhlaví (viď. Definície záhlaví jednotlivých stĺpcov).
• Pokiaľ bude nejaká hodnota v CSV prázdna, na e-shope dôjde po importe k jej zmazaniu.  (neplatí pre ceny)
• Pri produkte je potrebné ponechať stĺpce so všetkými existujúcimi parametrami. Ak niektoré stĺpce s parametrami vynecháte v CSV súbore, systém tieto parametre pri produkte odstráni.
• 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.
• Ďalšie veci môžete ovplyvniť nastavením importu v administrácii (viď nápoveda).

Malý import

• Súbor so vzorovým obsahom
• V malom importe sa spracovávajú iba nasledujúce stĺpce (vrátane všetkých vnorený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ú sa všetky stĺpce podľa Definície záhlaví jednotlivých stĺpcov.

Malý export

• Do malého exportu sa vkladajú iba nasledujúce stĺpce:
  • [PRODUCT_CODE]
  • [VARIANT_YN]
  • [VARIANT_CODE]
  • [MAIN_YN]
  • [ACTIVE_YN]
  • [ARCHIVED_YN]
  • [CAN_ADD_TO_BASKET_YN]
  • [LANGUAGE]
  • [AVAILABILITY]
  • [STOCK]
  • Ceny
  • Parametre

Dátové typy

Vysvetlivky, aké hodnoty je možné vkladať do daných stĺpcov.

• bool - true / false, 1 / 0, ano / ne, yes / no
• string - štandardný reťazec znakov
• int - celé číslo
• float - desatinné číslo, ako oddeľovač desatinných miest používajte bodkočiarku
• array - pole hodnôt oddelených bodkočiarkou. Napr. obrazek1.jpg;obrazek2.png;obrazek3.svg
• email - validná e-mailová adresa
• date - dátum zapísaný ako reťazec znakov vo formáte YYYY-MM-DD podľa ISO 8601. Y je rok, M je mesiac a D je deň. Príklad: 2020-12-30
• language - kód jazyka podľa ISO 639-1
• currency - kód meny podľa ISO 4217
• country - kód krajiny podľa ISO 3166-1 alpha-2

Definície záhlaví jednotlivých stĺpcov

• [PRODUCT_CODE] (string) - Kód produktu. Páruje sa podľa existujúcej hodnoty v databáze, alebo vytvorí nový produkt.
• [VARIANT_YN] (string) - Príznak varianty. Ak je hodnota 1, riadok je variant a naimportuje sa k produktu s kódom v stĺpci [PRODUCT_CODE].
• [VARIANT_CODE] (string) - Kód variantu - JE POVINNÝ, AK JE RIADOK VARIANTA. Páruje sa podľa existujúcej hodnoty v databáze, alebo vytvorí novú.
• [MAIN_YN] (bool) - Hlavná variant - iba ak je riadok variant. V prípade, že sa vyskytne viac hlavných variant v jednom produkte, berie sa ten prvý v poradí.
• [ACTIVE_YN] (bool) - Zobraziť produkt/variantu na e-shope.
• [DISABLED_YN] (bool) - Nezobrazovať na e-shope (opačná hodnota k [ACTIVE_YN]) (iba import)
• [ARCHIVED_YN] (bool) - Archivovaný produkt.
• [CAN_ADD_TO_BASKET_YN] (bool) - Je možné vložiť do košíka.
• [NEW_YN] (bool) - Zobrazenie štítku Novinka.
• [NEW_FROM] (date) - Dátum, od ktorého sa zobrazí štítok Novinka.
• [NEW_TO] (date) - Dátum, do ktorého je zobrazený štítok Novinka.
• [SPECIAL_YN] (bool) - Zobrazenie štítku Akcia.
• [SPECIAL_FROM] (date) - Dátum, od ktorého sa zobrazí štítok Akcia.
• [SPECIAL_TO] (date) - Dátum, do ktorého je zobrazený štítok Akcia.
• [SELLOUT_YN] (bool) - Zobrazenie štítku Výpredaj.
• [SELLOUT_FROM] (date) - Dátum, od ktorého sa zobrazí štítok Výpredaj.
• [SELLOUT_TO] (date) - Dátum, do ktorého je zobrazený štítok Výpredaj.
• [LABEL_ACTIVE_YN „název štítku“] (bool) - Zobrazenie daného štítku. Pre štítok akcie sú možné hodnoty 1 (neberie sa do úvahy dátum od do a štítok je "natvrdo" aktívny) a 0 (štítok je neaktívny a berie sa do úvahy dátum od do).
• [LABEL_ACTIVE_FROM „název štítku“] (date) - Dátum, od ktorého sa zobrazí daný štítok.
• [LABEL_ACTIVE_TO „název štítku“] (date) - Dátum, do ktorého je zobrazený daný štítok.
• [LENGTH_ACTIVE_YN] (bool) - Množstvo aktívne.
• [LENGTH_LABEL] (string) - Popisok množstvo.
• [LENGTH_FROM] (int) - Minimálne množstvo.
• [LENGTH_TO] (int) - Maximálne množstvo.
• [LENGTH_STEPS_TYPE] (string) - Typ krokovania metráže, možné hodnoty: neither (žiadne krokovanie, predvolené), multiples (násobky), select (výber z možností).
• [LENGTH_UNIT] (string) - Názov mernej jednotky (páruje sa podľa rovnakej hodnoty, alebo založí novú).
• [LENGTH_STEPS] (string) - Podľa typu krokovania: neither - môže byť prázdne, multiples - hodnota násobku, select - každá hodnota na nový riadok.
• [LENGTH_NOTE] (string) - Poznámka k množstvu.
• [LANGUAGE] (language) - Špecifikácia jazykovej mutácie. Pokiaľ nebude pri importe uvedené, budú sa všetky dáta na riadku importovať v predvolenom jazyku.
• [LANGUAGE_ACTIVE_YN] (bool) - Aktívne v jazykovej mutácii. Ak sa neuvedie, berie sa ako aktívny. 
• [URL] (string) - URL produktu. Pri importe sa vytvorí presmerovanie zo zadanej adresy na adresu produktu, vezme sa všetko za doménou. Pri exporte sa exportuje kompletná URL adresa produktu.
• [TITLE] (string) - Názov (POVINNÝ v prípade vytvárania nového produktu). Ak nie je definovaný, nezaloží sa ani jazyková mutácia produktu (súvisiace dáta sa preskočia).
• [SHORT_DESCRIPTION] (string) - Krátky popis. Bez HTML formátovania.
• [LONG_DESCRIPTION] (string) - Dlhý opis. Formátovanie iba pomocou HTML značiek.
• [SEO_URL] (string) - Vlastná koncovka URL adresy.
• [SEO_TITLE] (string) - SEO titulok produktu.
• [SEO_DESCRIPTION] (string) - META popis stránky produktu.
• [SUPPLIER_CODE] (string) - Kód dodávateľa.
• [EAN] (string) - Čiarkový kód.
• [MANUFACTURER] (string) - Názov výrobcu. Páruje sa podľa existujúcej hodnoty v databáze alebo vytvorí novú.**
• [AVAILABILITY] (string) - Názov dostupnosti. Páruje sa podľa existujúcej hodnoty v databáze alebo vytvorí novú. Neimportuje sa pri položkách s nastavením dostupnosti podľa stavu zásob. Pokiaľ však v tomto prípade stav zásob nie je definovaný (stĺpec [STOCK] musí byť prázdny alebo úplne chýbať), dostupnosť sa importuje.
• [AVAILABILITY_NOTE] (string) - Poznámka k dostupnosti varianty pre daný jazyk (berie sa iba ak je riadok variant).
• [STOCK] (float) - Počet jednotiek na sklade.
• [WEIGHT] (float) - Hmotnosť v gramoch pre výber dopravy.
• [UNIT] (string) - Názov mernej jednotky. Páruje sa podľa rovnakej hodnoty alebo založí novú.**
• [SHIPMENT_GROUP] (string) - Skupina doprav.*
• [VAT] (string) - Percentuálna sadzba DPH pre daný jazyk. Páruje sa podľa existujúcej hodnoty v databáze alebo vytvorí novú. Pokiaľ nie je vyplnené, berie sa východisková DPH pre daný jazyk.**
• [IS_PRICES_WITH_VAT_YN] (bool) - Ceny s DPH alebo bez DPH. Pokiaľ nie je uvedené, berie sa podľa nastavenia v administrácii.
• [PRICE_ORIGINAL „název ceníku“] (float) - Základná cenníková cena, od ktorej sa odvodzujú ďalšie. Do názvu cenníka si doplníte názov cenníka z administrácie. Pokiaľ bude bez názvu (len [PRICE_ORIGINAL]), berie sa východiskový cenník. (neexportuje sa do odberateľského feedu)
• [PRODUCT_DISCOUNT „název ceníku“] (float) - Zľava na produkt v percentách. Do názvu cenníka si doplníte názov cenníka z administrácie. Pokiaľ bude bez názvu (len [PRICE_ORIGINAL]), berie sa východiskový cenník. (neexportuje sa do odberateľského feedu)
• [PRODUCT_DISCOUNT_REAL „název ceníku“] (float) - Reálna zľava na produkt použitá na výpočet výslednej ceny (len export, neexportuje sa do odberateľského feedu), vypočítava sa takto:
  • hodnota zľavy na produkt ([PRODUCT_DISCOUNT „název ceníku“]) + zľava na výrobcu + zľava na kategóriu (berie sa zľava z hlavnej kategórie, do ktorej je produkt zaradený). Výsledná hodnota zľavy sa obmedzí na hodnotu z nastavenia Maximálne percento zľavy.
• [PRICE_SALE „název ceníku“] (float) - Exportuje sa iba vtedy, ak je produkt v akcii (štítok akcie). (neexportuje sa do odberateľského feedu)
• [PRICE_WITH_VAT „název ceníku“] (float) - Výsledná cena po zľavách s DPH (len export, exportuje sa iba do odberateľského feedu).
• [PRICE_WITHOUT_VAT „název ceníku“] (float) - Výsledná cena po zľavách bez DPH (len export, exportuje sa iba do odberateľského feedu).
• [PRICE_BUY] (float) - Nákupná cena (interný údaj pre orientáciu administrátora) (neexportuje sa do odberateľského feedu).
• [PRICE_COMMON] (float) - Bežná cena (napr. v kamenných obchodoch; pre orientáciu pri nákupe) (neexportuje sa do odberateľského feedu).
• [PRICES_FORMULAS] (array) - Názvy vzorcov oddelené bodkočiarkou (;). Páruje sa podľa existujúcej hodnoty v databáze.*
• [RECYCLING_FEE] (string) - Interný názov recyklačného poplatku. Páruje sa podľa existujúcej hodnoty v databáze.*
• [CATEGORIES] (array) - Kódy kategórií oddelené bodkočiarkou (;). Viac tu. Je možné vložiť viac kódov kategórií oddelených bodkočiarkou (1 hlavnou a x podkategóriou). Iba ak je riadok produkt.*
• [IMAGES] (array) - URL adresy obrázkov oddelené bodkočiarkou (;). Pokiaľ je riadok variant, berie sa iba prvý obrázok. Prvý obrázok uvedený v poli je nastavený ako Hlavný a Zoznam.
• [FILES] (array) - URL adresy súborov oddelené bodkočiarkou (;). Iba ak je riadok produkt.
• [BENEFITS] (array) - Benefity oddelené bodkočiarkou (;). Iba ak je riadok produkt.**
• [PARAMETER „název prametru“] (array) - Parametre oddelené bodkočiarkou (;). Pri produkte, kde parameter nie je, bude hodnota prázdna. Pri produkte je potrebné ponechať stĺpce so všetkými existujúcimi parametrami. Ak niektoré stĺpce s parametrami vynecháte v CSV súbore, systém tieto parametre pri produkte odstráni.**
• [RELATED] (array) - Kódy súvisiacich produktov oddelené bodkočiarkou (;). Iba ak je riadok produkt.
• [ALTERNATIVE] (array) - Kódy alternatívnych produktov oddelené bodkočiarkou (;). Iba ak je riadok produkt.
• [ACCESSORIES] (array) - Kódy príslušenstva oddelené bodkočiarkou (;). Iba ak je riadok produkt.
• [GIFTS] (array) - Kódy darčekov oddelené bodkočiarkou (;). Iba ak je riadok produkt.
• [SETS] (array) - Sada, kódy produktov oddelené bodkočiarkou (;). Iba ak je riadok produkt.
• [META „kľúč vlastného poľa“] (array) - Vlastné pole. V prípade vyplnenia Kľúča vlastného poľa sú povolené znaky iba malé písmená, čísla (nesmú byť na prvej pozícii) a podčiarknutie.
• [STOCK_POSITION] - Pozícia na sklade
• [STOCK_STOCK "kód skladu"] - Stav zásob konkrétneho skladu
• [STOCK_STOCK_POSITION "pozice na skladě"] - Pozícia na sklade

* Páruje sa podľa existujúcej hodnoty v administrácii. Ak hodnota neexistuje ignoruje sa.
** Páruje sa podľa existujúcej hodnoty v administrácii. Ak hodnota neexistuje, vytvorí sa v nastavení nová.