# Tuonti CSV-tiedostoilla

Käytä CSV-tuontia luodaksesi tai päivittääksesi nopeasti tuotteita (ja varastoa) Shopify-kaupassasi laskentataulukkotiedoston avulla.

## ✅ Ennen aloittamista (vaatimukset)

#### 📌 Valmistele CSV-tiedostosi

Varmista, että CSV-tiedostossasi on:

* **Sarakeotsikot** ensimmäisellä rivillä (esim. `Handle`, `Title`, `Vendor`)
* **Yksilöllinen avain**, jolla voit yhdistää tietueet (suositus: **Handle**)
* Oikea muoto (CSV-tiedosto)

#### 🔑 Suositeltu pääavain

* **Product Handle** (paras useimpiin tuontiin)
* Voit myös nähdä muita avaimia tiedoistasi riippuen (esim. Product ID, Variant SKU)

***

## 🛠️ Vaiheet tiedoston lataamiseen&#x20;

### Avaa CSV Uploads Tipo-sovelluksessa

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

1. Avaa Shopify-hallinnassa **Apps → Tipo Sync**
2. Klikkaa **CSV uploads**
3. Klikkaa **Add csv file**

Sinut ohjataan tuontiavustajaan (**1/3 progress**).

***

### 📤 Vaihe 1/3 — Lataa CSV&#x20;

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

#### **Valitse lähde**

Voit ladata CSV-tiedoston seuraavista lähteistä:

* **CSV Import** (lataa tiedosto tietokoneeltasi)
* Import from Web Link (URL)
* FTP Server Upload
* SFTP Server Upload

#### **Valitse CSV-asetukset**

**Separator**

* Pilkku (yleisin)
* Puolipiste
* Muu

**CSV Data**

* **Product** (tuotekentille, kuten otsikko, kuvaus, valmistaja…)
* **Inventory** (varastomäärille)

Klikkaa sitten **Next Step**.

<figure><span class="missing-media" role="note">Tämä kuvakaappaus ei ole saatavilla alkuperäisessä dokumentaatiossa.</span><figcaption></figcaption></figure>

***

### 🧩 Vaihe 2/3 — Kenttien yhdistäminen&#x20;

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

**A) Pääavaimen yhdistäminen**

Tämä kertoo sovellukselle, miten CSV-tiedostosi rivit yhdistetään Shopifyn tuotteisiin.

* **Primary Key**: valitse, mihin Shopify-kauppasi yhdistää\
  Esimerkki: **Product Handle**
* **Column heading**: valitse CSV-tiedostosi sarake\
  Esimerkki: **Handle**

> Jos pääavaimesi ei täsmää, sovellus voi luoda kaksoiskappaleita tai epäonnistua oikean tuotteen päivittämisessä.

**B) Yhdistä CSV-sarakkeet Shopify-kenttiin**

Näet välilehdet, kuten:

* **Product**
* **Variant**
* **Image**
* **Metafield**
* **Inventory**

Jokaiselle riville:

* **Import to Shopify** = Shopify-kenttä (esim. Title)
* **Column heading** = CSV-sarake (esim. Title)

Voit klikata **➕ Add mapping** tuodaksesi lisää kenttiä.

Klikkaa sitten **Next Step**.

***

### ⚙️ Vaihe 3/3 — Tuonnin asetukset&#x20;

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

#### **Vaihe 3.1. Yhdistäminen ja tuonti (miten Shopify päivitetään)**

Valitse yksi:

✅ **Create new items**

* Luo vain uusia tuotteita (ei päivitä olemassa olevia)

✅ **Only update current items that have the same primary key**

* Päivittää vain olemassa olevia tuotteita
* EI luo uusia

✅ **Create new items if not exist and update current items that have the same primary key** *(yleinen valinta)*

* Luo puuttuvat tuotteet
* Päivittää olemassa olevat vastaavat tuotteet (Handle/SKU jne. perusteella)

***

#### **Vaihe 3.2. Tuontimäärä (kuinka paljon tuodaan)**

* **Import All**: tuo kaikki tiedostosta
* **Specify import**: tuo vain valittu rivialue (hyödyllinen testaukseen)

***

#### **Vaihe 3.3. Suodata data (valinnainen)**

* **Only import data containing …** (sisällytyssääntö)
* **Exclude data containing …** (poissulkusääntö)

Käytä tätä, jos haluat tuoda vain tietyt rivit (esim. vain rivit, joilla on `SYNC`).

***

#### **Vaihe 3.4. Kuvadata (jos CSV sisältää kuvia)**

Valitse yksi:

* **Add new images** (lisää kuvia poistamatta vanhoja)
* **Upon creation product only** (lisää kuvat vain uusille tuotteille)
* **Overwrite current images** (korvaa olemassa olevat kuvat)

***

#### **Vaihe 3.5. Sähköposti-ilmoitukset (valinnainen)**

Valitse, milloin haluat saada sähköpostia:

* Latauksen alkaessa
* Latauksen valmistuessa
* Latausvirheen sattuessa

***

#### **Vaihe 3.6. Ajasta lataus**&#x20;

* **Run now** (tuo heti)\
  (Muut aikatauluvaihtoehdot voivat näkyä tilauksesi tai asetustesi mukaan.)

Lopuksi klikkaa **Save** (oikeassa yläkulmassa).

***

## 🧪 Esimerkki: Päivitä olemassa olevat tuotteet + luo uusia

**CSV-esimerkki**

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

**Valittavat asetukset**

* **Primary Key**: Product Handle
* **Column heading**: Handle
* **Matching & Imports**: Create new items if not exist and update current items that have the same primary key

**Tulos**

* Jos `ceramic-table-lamp` on jo olemassa → se päivitetään
* Jos `wooden-floor-mirror` ei ole olemassa → se luodaan

***

**🙋 Tarvitsetko yhä tukea?**

Jos tarvitset edelleen apua, ota meihin rohkeasti yhteyttä osoitteeseen <hi@tipo.io>. Autamme mielellämme lisää.
