Qando
Dokümantasyon·Ürün ve Stok

CSV/Excel ile Toplu Ürün İçe Aktarma

Örnek şablon indirme, sütun eşleştirme, önizleme ve toplu ürün/stok aktarımının adım adım anlatımı.

CSV/Excel ile Toplu Ürün İçe Aktarma

Çok sayıda ürünü tek tek girmek yerine bir CSV veya Excel dosyasıyla topluca yükleyebilirsiniz. İçe aktarma sihirbazı üç adımdan oluşur: Dosya Yükle, Önizleme ve Tamamlandı.

Sihirbaza ulaşmak için Katalog > Ürünler sayfasından İçeri Aktar butonuna gidin.

Adım 0: Örnek Şablonu İndirin

İlk defa yüklüyorsanız hazır şablonu kullanmanızı öneririz. Dosya yükleme ekranındaki bilgi kartından Excel İndir veya CSV İndir butonuna tıklayın.

Şablon şunları içerir:

  • Tüm alanların Türkçe başlıkları
  • 4 gerçekçi örnek satır (tekil ürün, çok varyantlı ürün, sadece stok güncelleme)
  • Excel dosyasında ikinci bir sayfada alan açıklamaları

Zorunlu sütunlar: SKU ve Ürün Adı.

Şablon Alanları

  • SKU (zorunlu): Sistem genelinde tekil stok kodu. Mevcut bir SKU varsa o kayıt güncellenir.
  • Ürün adı (zorunlu): Görüntülenecek ad. Aynı "Ana ürün kodu" altındaki satırlarda aynı olmalı.
  • Açıklama: Uzun açıklama metni (HTML kullanılabilir).
  • Fiyat: Satış fiyatı (örn. 199.90 veya 199,90).
  • Maliyet (KDV Hariç, birim, ₺): Birim alış maliyeti, KDV hariç. Kâr raporunda kullanılır. Boş bırakılabilir; güncellemede boş maliyet mevcut değeri silmez.
  • Para birimi: TRY, USD, EUR. Boşsa TRY varsayılır.
  • Birim: adet (varsayılan), metre, cm, kg, gram, litre, ml. Türkçe kısaltmalar da kabul edilir (ad, gr, lt, m).
  • Kategori yolu: Çubukla ayrılmış hiyerarşi: "Giyim > Erkek > Üst". Eksik kategoriler otomatik oluşturulur.
  • Marka: Marka adı. Yoksa otomatik oluşturulur.
  • Barkod: EAN/UPC. Tekil olmalı.
  • Stok miktarı: Varsayılan depoya yazılır. Mevcut SKU'da hedef miktar olarak güncellenir (fark değil).
  • Varyant adı: Çok varyantlı ürünlerde zorunlu. Aynı ana ürün kodu altındaki satırlarda farklı olmalı.
  • Ana ürün kodu: Aynı değere sahip satırlar tek ürünün varyantları olarak işlenir. Tek varyantlıysa boş bırakın.
  • Görsel URL: Tam HTTPS URL. Birden fazlaysa | ile ayırın: "url1|url2".

Adım 1: Dosyayı Yükleyin ve Sütunları Eşleştirin

1. CSV veya Excel dosyanızı sürükleyip bırakın ya da tıklayarak seçin (.csv, .xlsx, .xls). Tek seferde en fazla 5.000 satır yüklenebilir.

2. Dosya okunduğunda sistem, sütun başlıklarını otomatik olarak doğru alanlara eşleştirmeye çalışır. Otomatik eşleşenler "Otomatik eşleştirildi" etiketiyle işaretlenir.

3. Sütun Eşleştirme listesinde her sütunun hangi alana karşılık geldiğini kontrol edin. Yanlışsa açılır menüden düzeltin. Kullanmak istemediğiniz sütunlar için "— Yoksay —" seçin.

4. Önizlemeye Geç butonuna tıklayın.

Adım 2: Önizleme ve Doğrulama

Sistem satırları analiz eder ve özet kartlarında şunları gösterir:

  • Toplam Satır, Geçerli, Hatalı
  • Yeni Ürün, Yeni Varyant, Güncellenecek sayıları

Alt taraftaki tabloda her satırın İşlem etiketini görürsünüz: Yeni Ürün, Yeni Varyant, Güncelle veya Atla. Hatalı satırlar kırmızı, uyarılar sarı renkte gösterilir. Hatalı satırlar atlanır, geçerli satırlar aktarılır.

Doğrulama tamamsa "... Satırı Aktar" butonuna tıklayın.

Adım 3: Sonuç

Aktarım bitince özet ekranı açılır:

  • Kaç yeni ürün, yeni varyant, güncellenen kayıt, stok hareketi ve kategori oluşturulduğu
  • Başarısız satırlar varsa nedenleriyle birlikte listelenir

Buradan Ürünleri Görüntüle ile listeye dönebilir veya Yeni Aktarım ile baştan başlayabilirsiniz.

İpuçları

  • Mevcut ürünlerin sadece stoğunu güncellemek için: SKU + Stok miktarı sütunlarını doldurup diğerlerini boş bırakan bir dosya hazırlamanız yeterlidir.
  • Aynı ürünün birden çok varyantını yüklerken tüm satırlarda aynı "Ana ürün kodu" ve farklı "Varyant adı" kullanın.

Bu doküman yardımcı olmadı mı?

Destek Ekibine Yaz