# Import pomocí souborů CSV

Pomocí importu CSV rychle vytvoříte nebo aktualizujete produkty (a zásoby) ve svém obchodě Shopify pomocí souboru tabulky.

## ✅ Než začnete (požadavky)

#### 📌 Připravte soubor CSV

Ujistěte se, že váš CSV obsahuje:

* **Záhlaví sloupců** v prvním řádku (např.: `Handle`, `Title`, `Vendor`)
* **Jedinečný klíč**, podle kterého lze přiřazovat záznamy (doporučeno: **Handle**)
* Správný formát (soubor CSV)

#### 🔑 Doporučený primární klíč

* **Handle produktu** (nejlepší pro většinu importů)
* Podle vašich dat se mohou zobrazit i jiné klíče (např.: ID produktu, SKU varianty)

***

## 🛠️ Postup nahrání souboru

### Otevření nahrávání CSV v aplikaci Tipo

<figure><img src="/media/2a19292f386ccfa6c516.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

1. V Shopify Admin otevřete **Aplikace → Tipo Sync**
2. Klikněte na **Nahrávání CSV (CSV uploads)**
3. Klikněte na **Přidat soubor CSV (Add csv file)**

Přejdete do průvodce importem (**průběh 1/3**).

***

### 📤 Krok 1/3 — Nahrání CSV

<figure><img src="/media/e3560f7f8a801b3726ec.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Vyberte zdroj nahrání**

CSV můžete nahrát z:

* **Import CSV (CSV Import)** (nahrání souboru z vašeho počítače)
* Import z webového odkazu (URL)
* Nahrání ze serveru FTP
* Nahrání ze serveru SFTP

#### **Vyberte možnosti CSV**

**Oddělovač (Separator)**

* Čárka (nejběžnější)
* Středník
* Jiný

**Data CSV (CSV Data)**

* **Produkt (Product)** (pro pole produktu, jako je název, popis, dodavatel…)
* **Zásoby (Inventory)** (pro množství zásob)

Poté klikněte na **Další krok (Next Step)**.

<figure><span class="missing-media" role="note">Tento snímek obrazovky není v původní dokumentaci k dispozici.</span><figcaption></figcaption></figure>

***

### 🧩 Krok 2/3 — Mapování polí

<figure><img src="/media/5beb2e9d9f197c6c8f0e.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**A) Mapování primárního klíče**

Tím aplikaci sdělíte, jak přiřadit řádky v CSV k produktům ve Shopify.

* **Primární klíč (Primary Key)**: vyberte, podle čeho váš obchod Shopify přiřazuje\
  Příklad: **Handle produktu**
* **Záhlaví sloupce (Column heading)**: vyberte sloupec ve vašem CSV\
  Příklad: **Handle**

> Pokud váš primární klíč nesedí, aplikace může vytvořit duplicity nebo neaktualizovat správný produkt.

**B) Namapujte sloupce CSV na pole Shopify**

Uvidíte karty jako:

* **Produkt**
* **Varianta**
* **Obrázek**
* **Metapole**
* **Zásoby**

U každého řádku:

* **Importovat do Shopify (Import to Shopify)** = pole Shopify (např.: Title)
* **Záhlaví sloupce** = sloupec CSV (např.: Title)

Kliknutím na **➕ Přidat mapování (Add mapping)** můžete importovat další pole.

Poté klikněte na **Další krok (Next Step)**.

***

### ⚙️ Krok 3/3 — Nastavení importu

<figure><img src="/media/0982d902faf55aaf2e59.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Krok 3.1. Párování a importy (jak aktualizovat Shopify)**

Vyberte jednu možnost:

✅ **Vytvořit nové položky (Create new items)**

* Pouze vytváří nové produkty (existující neaktualizuje)

✅ **Aktualizovat pouze stávající položky se stejným primárním klíčem (Only update current items that have the same primary key)**

* Aktualizuje pouze existující produkty
* Nevytváří nové

✅ **Vytvořit nové položky, pokud neexistují, a aktualizovat stávající položky se stejným primárním klíčem (Create new items if not exist and update current items that have the same primary key)** *(běžná volba)*

* Vytvoří chybějící produkty
* Aktualizuje existující produkty, které sedí (podle Handle/SKU atd.)

***

#### **Krok 3.2. Rozsah nahrání (kolik importovat)**

* **Importovat vše (Import All)**: importuje vše v souboru
* **Určit import (Specify import)**: importuje pouze vybraný rozsah řádků (užitečné pro testování)

***

#### **Krok 3.3. Filtrování dat (volitelné)**

* **Importovat pouze data obsahující … (Only import data containing …)** (pravidlo zahrnutí)
* **Vyloučit data obsahující … (Exclude data containing …)** (pravidlo vyloučení)

Použijte, pokud chcete importovat pouze určité řádky (např. jen řádky obsahující `SYNC`).

***

#### **Krok 3.4. Data obrázků (pokud váš CSV obsahuje obrázky)**

Vyberte jednu možnost:

* **Přidat nové obrázky (Add new images)** (přidá obrázky bez odstranění starých)
* **Pouze při vytvoření produktu (Upon creation product only)** (přidá obrázky jen u nových produktů)
* **Přepsat stávající obrázky (Overwrite current images)** (nahradí existující obrázky)

***

#### **Krok 3.5. E-mailová oznámení (volitelné)**

Vyberte, kdy chcete dostávat e-maily:

* Při zahájení nahrávání
* Po dokončení nahrávání
* Při chybě nahrávání

***

#### **Krok 3.6. Naplánování nahrání**

* **Spustit nyní (Run now)** (import proběhne okamžitě)\
  (Podle vašeho tarifu či nastavení se mohou zobrazit další možnosti plánování.)

Nakonec klikněte na **Uložit (Save)** (vpravo nahoře).

***

## 🧪 Příklad: Aktualizace stávajících produktů + vytvoření nových

**Ukázka CSV**

| Handle              | Title               | Vendor     |
| ------------------- | ------------------- | ---------- |
| ceramic-table-lamp  | Ceramic Table Lamp  | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |

**Nastavení, která zvolit**

* **Primární klíč**: Handle produktu
* **Záhlaví sloupce**: Handle
* **Párování a importy**: Vytvořit nové položky, pokud neexistují, a aktualizovat stávající položky se stejným primárním klíčem

**Výsledek**

* Pokud `ceramic-table-lamp` již existuje → bude aktualizován
* Pokud `wooden-floor-mirror` neexistuje → bude vytvořen

***

**🙋 Potřebujete další pomoc?**

Pokud stále potřebujete pomoc, napište nám na <hi@tipo.io>. Rádi vám dále pomůžeme.
