# Importeren met CSV-bestanden

Gebruik CSV Import om snel producten (en voorraad) in uw Shopify-winkel aan te maken of bij te werken met een spreadsheetbestand.

## ✅ Voordat u begint (vereisten)

#### 📌 Uw CSV-bestand voorbereiden

Zorg dat uw CSV-bestand het volgende bevat:

* **Kolomkoppen** in de eerste rij (bijv. `Handle`, `Title`, `Vendor`)
* Een **unieke sleutel** waarmee u records kunt koppelen (aanbevolen: **Handle**)
* De juiste indeling (CSV-bestand)

#### 🔑 Aanbevolen primaire sleutel

* **Product Handle** (het beste voor de meeste imports)
* Afhankelijk van uw gegevens ziet u mogelijk ook andere sleutels (bijv. Product ID, Variant SKU)

***

## 🛠️ Stappen om het bestand te uploaden&#x20;

### CSV Uploads openen in de Tipo-app

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

1. Open in het Shopify-beheer **Apps → Tipo Sync**
2. Klik op **CSV uploads**
3. Klik op **Add csv file**

U wordt doorgestuurd naar de importwizard (**voortgang 1/3**).

***

### 📤 Stap 1/3 — CSV uploaden&#x20;

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

#### **Kies uw uploadbron**

U kunt een CSV-bestand uploaden vanuit:

* **CSV Import** (bestand uploaden vanaf uw computer)
* Import via weblink (URL)
* Upload naar FTP-server
* Upload naar SFTP-server

#### **Kies CSV-opties**

**Scheidingsteken**

* Komma (meest gebruikelijk)
* Puntkomma
* Overig

**CSV-gegevens**

* **Product** (voor productvelden zoals titel, beschrijving, leverancier…)
* **Inventory** (voor voorraadaantallen)

Klik vervolgens op **Next Step**.

<figure><span class="missing-media" role="note">Deze schermafbeelding is niet beschikbaar in de oorspronkelijke documentatie.</span><figcaption></figcaption></figure>

***

### 🧩 Stap 2/3 — Velden koppelen&#x20;

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

**A) Koppeling van de primaire sleutel**

Hiermee geeft u de app aan hoe rijen in uw CSV-bestand worden gekoppeld aan producten in Shopify.

* **Primary Key**: kies waarop uw Shopify-winkel moet matchen\
  Voorbeeld: **Product Handle**
* **Column heading**: kies de kolom in uw CSV-bestand\
  Voorbeeld: **Handle**

> Als uw primaire sleutel niet overeenkomt, kan de app dubbele producten aanmaken of het verkeerde product bijwerken.

**B) Koppel uw CSV-kolommen aan Shopify-velden**

U ziet tabbladen zoals:

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

Voor elke rij:

* **Import to Shopify** = Shopify-veld (bijv. Title)
* **Column heading** = CSV-kolom (bijv. Title)

U kunt op **➕ Add mapping** klikken om meer velden te importeren.

Klik vervolgens op **Next Step**.

***

### ⚙️ Stap 3/3 — Importinstellingen&#x20;

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

#### **Stap 3.1. Matching en importeren (hoe Shopify wordt bijgewerkt)**

Kies één optie:

✅ **Create new items**

* Maakt alleen nieuwe producten aan (bestaande producten worden niet bijgewerkt)

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

* Werkt alleen bestaande producten bij
* Maakt GEEN nieuwe producten aan

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

* Maakt ontbrekende producten aan
* Werkt bestaande producten bij die overeenkomen (op Handle/SKU/enz.)

***

#### **Stap 3.2. Uploadspecificatie (hoeveel er wordt geïmporteerd)**

* **Import All**: alles in het bestand importeren
* **Specify import**: alleen een geselecteerd bereik rijen importeren (handig om te testen)

***

#### **Stap 3.3. Gegevens filteren (optioneel)**

* **Only import data containing …** (insluitregel)
* **Exclude data containing …** (uitsluitregel)

Gebruik dit als u alleen bepaalde rijen wilt importeren (bijv. alleen rijen met `SYNC`).

***

#### **Stap 3.4. Afbeeldingsgegevens (als uw CSV-bestand afbeeldingen bevat)**

Kies één optie:

* **Add new images** (voegt afbeeldingen toe zonder oude te verwijderen)
* **Upon creation product only** (alleen afbeeldingen toevoegen voor nieuwe producten)
* **Overwrite current images** (vervangt bestaande afbeeldingen)

***

#### **Stap 3.5. E-mailmeldingen (optioneel)**

Kies wanneer u e-mails wilt ontvangen:

* Bij start van de upload
* Bij voltooiing van de upload
* Bij een fout bij de upload

***

#### **Stap 3.6. Upload plannen**&#x20;

* **Run now** (direct importeren)\
  (Andere planningsopties kunnen verschijnen, afhankelijk van uw abonnement of instellingen.)

Klik ten slotte op **Save** (rechtsboven).

***

## 🧪 Voorbeeld: bestaande producten bijwerken + nieuwe aanmaken

**CSV-voorbeeld**

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

**Instellingen om te kiezen**

* **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

**Resultaat**

* Als `ceramic-table-lamp` al bestaat → wordt het bijgewerkt
* Als `wooden-floor-mirror` niet bestaat → wordt het aangemaakt

***

**🙋 Heb je nog steeds ondersteuning nodig?**

Als je nog steeds hulp nodig hebt, neem dan gerust contact met ons op via <hi@tipo.io>. We helpen je graag verder.
