Omnix · dokumentace · import produktů

Import produktů {pomocí CSV}

Dokumentace popisuje strukturu importního CSV souboru pro systém Omnix, základní pravidla importu a význam jednotlivých sloupců. Je určená pro uživatele, kteří chtějí produkty hromadně zakládat nebo upravovat pomocí importu.

Základní {pravidla}

Jeden řádek = jeden produktový záznam

Každý datový řádek v CSV představuje jeden produkt nebo jednu položku, která se má pomocí importu vytvořit nebo upravit.

Párování podle code

Produkt se při importu vyhledává a páruje podle sloupce code. Hodnota musí být v systému jedinečná a dlouhodobě konzistentní.

Povinná pole pro nový produkt

Při založení nového produktu je potřeba vyplnit alespoň code, price a name.

Prázdná hodnota maže data

Pokud je v importovaném sloupci prázdná hodnota, stávající hodnota se smaže. Výsledné chování mohou dále upravit volby nastavení importu.

Formát souboru

CSV se středníkem ; jako oddělovačem. První řádek obsahuje názvy sloupců. Soubor ukládejte v kódování UTF-8.

Zachování struktury

Doporučujeme vycházet ze vzorového souboru a zachovat názvy záhlaví i logiku opakujících se bloků.

Doporučení: Před větší úpravou vždy pracujte s kopií původního souboru. U hromadných změn je vhodné nejdřív otestovat menší vzorek dat.

Import

CSV soubor slouží k hromadnému založení nebo aktualizaci produktů v systému Omnix. V jednom souboru je možné pracovat se základními údaji o produktu, cenami, skladem, kategoriemi, obrázky, parametry i vazbami na další produkty.

  1. Vycházejte ze vzorového importního CSV souboru.
  2. Zachovejte názvy sloupců a strukturu souboru.
  3. Vyplňte nebo upravte hodnoty v jednotlivých řádcích.
  4. Zkontrolujte sloupec code, podle kterého se produkty párují.
  5. U nových produktů doplňte alespoň code, price a name.
  6. U obrázků použijte název souboru nebo URL adresu.
  7. Soubor uložte ve formátu CSV v kódování UTF-8 a následně proveďte import.

Opakující se bloky, například kategorie, galerie obrázků nebo vazby, lze v souboru použít vícekrát. Počet vyplněných bloků záleží na konkrétním produktu.

Definice záhlaví jednotlivých {sloupců}

V této části je uveden přehled sloupců, které se ve vzorovém importním CSV používají. Sloupce jsou rozdělené do logických bloků podle typu dat.

U opakujících se bloků označuje X pořadí dané položky. Tento princip se používá hlavně u kategorií, obrázků a vazeb na další produkty.

Základ produktu

Sloupec Popis
parent_product Položka používaná při aktualizaci nebo přiřazování variant produktů.
code Kód produktu. Podle tohoto sloupce se produkt při importu páruje.
name Název produktu.
long_name Rozšířený název produktu.
short_description Krátký popis produktu.
description Podrobný popis produktu. Ve vzorovém souboru je vedený jako HTML obsah.
second_description Doplňkový popis produktu.
state Stav produktu. Podporované hodnoty jsou active, hidden a inactive.
unit Jednotka produktu (např. ks, kg, m).
ean EAN kód produktu.
weight Hmotnost produktu.
no_selling Hodnota 1 znamená, že se produkt zobrazí jako neprodejný.

Ceny a sklad

Sloupec Popis
price Základní cena produktu. Patří mezi povinná pole při založení nového produktu.
action_price Akční cena produktu.
recommended_price Doporučená cena produktu.
purchase_price Nákupní cena produktu.
vat Sazba DPH.
stock Skladové množství produktu.
price_with_vat Pole pro práci s cenou včetně DPH. Hodnota 1 značí zadání ceny produktu včetně DPH.

SEO a identifikace

Sloupec Popis
seo_title SEO titulek produktu.
seo_description SEO popis produktu.
seo_url URL adresa produktu.

Kategorie

Kategorie jsou v souboru vedené po opakujících se blocích. Pro přiřazení produktu do kategorie stačí ID kategorie. Ostatní související sloupce jsou nepovinné nebo upřesňují nastavení, například pozici produktu v kategorii.

tbody>
Sloupec Popis
category#X ID kategorie. Toto pole stačí pro samotné zařazení produktu do kategorie.
category#X#item_order Pořadí produktu v dané kategorii.

Vazby na další produkty

Sloupec Popis
alternative_product#X Kód alternativního produktu.
likewise_product#X Kód souvisejícího nebo podobného produktu.
better_product#X Kód lepšího produktu na dosah.
product_type#X Kód typu produktu (např. Novinka, Akce, Výprodej).

Hlavní obrázek a galerie

U obrázků je možné použít název souboru i URL adresu. Totéž platí pro hlavní obrázek i pro obrázky v galerii.

Sloupec Popis
image Název hlavního obrázku produktu.
image_url URL adresa hlavního obrázku produktu.
product_image#X Název souboru obrázku v galerii.
product_image#X#name Název obrázku.
product_image#X#item_order Pořadí obrázku v galerii.
product_image#X#description Popis obrázku.
product_image#X#url URL adresa obrázku v galerii.

Parametry produktu

V záhlaví se používá název nebo kód parametru za znakem #, případně číselné ID parametru.

Sloupec Popis
parameter#název_parametru Záhlaví parametru vytvořené podle názvu, kódu nebo číselného ID parametru.
parameter#color Příklad technického a čitelného zápisu parametru ve vzorovém souboru. Hodnoty mohou být např. color_white, color_red, color_blue...
parameter#sirka Příklad parametru rozměru produktu.
parameter#prostor Příklad parametru umístění produktu. Hodnoty mohou být např. place_livingroom, place_bath, place_stairs...

Další nastavení

Sloupec Popis
catalog_feed Určuje, zda se má produkt zahrnout do feedu se zbožím. Používají se hodnoty 0 a 1.
feed_productname Název produktu do feedu zboží.
google_product_category Zařazení produktu do kategorií Googlu dle taxonomie.
searching_keywords Klíčová slova pro vyhledávání.
transit#X Omezení dopravy. Umožňuje zvolit požadované způsoby dopravy, hodnoty mohou být např. trans#Zas_VM, trans#PPL_na_adresu, trans#osobni_odber...