# CSV dosyalarıyla içe aktarma

Bir e-tablo dosyası kullanarak Shopify mağazanızdaki ürünleri (ve envanteri) hızlıca oluşturmak veya güncellemek için CSV Import’u kullanın.

## ✅ Başlamadan önce (gereksinimler)

#### 📌 CSV dosyanızı hazırlayın

CSV dosyanızda şunların olduğundan emin olun:

* İlk satırda **sütun başlıkları** (ör. `Handle`, `Title`, `Vendor`)
* Kayıtları eşleştirmek için kullanabileceğiniz **benzersiz bir anahtar** (önerilen: **Handle**)
* Doğru biçim (CSV dosyası)

#### 🔑 Önerilen birincil anahtar

* **Product Handle** (çoğu içe aktarma için en iyisi)
* Verinize bağlı olarak Product ID, Variant SKU gibi başka anahtarlar da görebilirsiniz

***

## 🛠️ Dosya yükleme adımları&#x20;

### Tipo uygulamasında CSV uploads’ı açın

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

1. Shopify Admin’de **Apps → Tipo Sync**’i açın
2. **CSV uploads**’a tıklayın
3. **Add csv file**’a tıklayın

İçe aktarma sihirbazına yönlendirileceksiniz (**1/3 ilerleme**).

***

### 📤 Adım 1/3 — CSV yükleme&#x20;

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

#### **Yükleme kaynağınızı seçin**

CSV dosyasını şu kaynaklardan yükleyebilirsiniz:

* **CSV Import** (bilgisayarınızdan dosya yükleyin)
* Web bağlantısından (URL) içe aktarma
* FTP sunucu yüklemesi
* SFTP sunucu yüklemesi

#### **CSV seçeneklerini seçin**

**Ayraç**

* Virgül (en yaygın)
* Noktalı virgül
* Diğer

**CSV verisi**

* **Product** (başlık, açıklama, satıcı… gibi ürün alanları için)
* **Inventory** (envanter miktarları için)

Ardından **Next Step**’e tıklayın.

<figure><span class="missing-media" role="note">Bu ekran görüntüsü orijinal dokümantasyonda mevcut değil.</span><figcaption></figcaption></figure>

***

### 🧩 Adım 2/3 — Alanları eşleştirin&#x20;

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

**A) Birincil anahtar eşleştirmesi**

Bu, uygulamaya CSV’deki satırların Shopify’daki ürünlerle nasıl eşleştirileceğini söyler.

* **Primary Key**: Shopify mağazanızın neye göre eşleştirme yapacağını seçin\
  Örnek: **Product Handle**
* **Column heading**: CSV’de kullanılacak sütunu seçin\
  Örnek: **Handle**

> Birincil anahtarınız eşleşmezse uygulama yinelenen kayıtlar oluşturabilir veya doğru ürünü güncelleyemeyebilir.

**B) CSV sütunlarınızı Shopify alanlarına eşleştirin**

Şuna benzer sekmeler göreceksiniz:

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

Her satır için:

* **Import to Shopify** = Shopify alanı (ör. Title)
* **Column heading** = CSV sütunu (ör. Title)

Daha fazla alan içe aktarmak için **➕ Add mapping**’e tıklayabilirsiniz.

Ardından **Next Step**’e tıklayın.

***

### ⚙️ Adım 3/3 — İçe aktarma ayarları&#x20;

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

#### **Adım 3.1. Eşleştirme ve içe aktarma (Shopify nasıl güncellenir)**

Birini seçin:

✅ **Create new items**

* Yalnızca yeni ürünler oluşturur (mevcut ürünleri güncellemez)

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

* Yalnızca mevcut ürünleri günceller
* Yeni ürün OLUŞTURMAZ

✅ **Create new items if not exist and update current items that have the same primary key** *(yaygın tercih)*

* Eksik ürünleri oluşturur
* Eşleşen mevcut ürünleri günceller (Handle/SKU vb. ile)

***

#### **Adım 3.2. Yükleme belirtimi (ne kadar içe aktarılacak)**

* **Import All**: Dosyadaki her şeyi içe aktarır
* **Specify import**: Yalnızca seçilen satır aralığını içe aktarır (test için kullanışlıdır)

***

#### **Adım 3.3. Verileri filtreleyin (isteğe bağlı)**

* **Only import data containing …** (dahil etme kuralı)
* **Exclude data containing …** (hariç tutma kuralı)

Yalnızca belirli satırları içe aktarmak istiyorsanız bunu kullanın (ör. yalnızca `SYNC` içeren satırlar).

***

#### **Adım 3.4. Görsel verileri (CSV’niz görsel içeriyorsa)**

Birini seçin:

* **Add new images** (eski görselleri kaldırmadan yeni görseller ekler)
* **Upon creation product only** (yalnızca yeni ürünler için görsel ekler)
* **Overwrite current images** (mevcut görselleri değiştirir)

***

#### **Adım 3.5. E-posta bildirimleri (isteğe bağlı)**

E-posta almak istediğiniz zamanları seçin:

* Yükleme başladığında
* Yükleme tamamlandığında
* Yüklemede hata oluştuğunda

***

#### **Adım 3.6. Yüklemeyi planlayın**&#x20;

* **Run now** (hemen içe aktar)\
  (Planınıza veya ayarlarınıza bağlı olarak başka zamanlama seçenekleri de görünebilir.)

Son olarak sağ üstteki **Save**’e tıklayın.

***

## 🧪 Örnek: Mevcut ürünleri güncelleyin + yenilerini oluşturun

**CSV örneği**

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

**Seçilecek ayarlar**

* **Primary Key**: Product Handle
* **Column heading**: Handle
* **Matching & Imports**: Mevcut değilse yeni öğeler oluşturun ve aynı birincil anahtara sahip mevcut öğeleri güncelleyin

**Sonuç**

* `ceramic-table-lamp` zaten varsa → güncellenir
* `wooden-floor-mirror` yoksa → oluşturulur

***

**🙋 Hâlâ desteğe ihtiyacınız var mı?**

Hâlâ yardıma ihtiyacınız varsa lütfen <hi@tipo.io> adresinden bizimle iletişime geçmekten çekinmeyin. Size memnuniyetle yardımcı olacağız.
