Qando

CSV/Excel ile Toplu Ürün Yükleme

Şablon indirme, alanları doldurma, preview ile hata kontrolü, apply ile uygulama.

Ne zaman kullanılır?

  • Yeni Qando hesabında 100+ ürünü hızla yüklemek
  • Mevcut sistemden migrate ederken
  • Toplu fiyat veya açıklama güncellemesi yapmak

İki aşamalı süreç: Preview → Apply

Qando import'u iki aşamalıdır:

  1. Preview (önizleme): Dosyayı yükle, sistem her satırı kontrol eder; geçerli ve hatalı satırları gösterir. Hiç DB değişikliği olmaz.
  2. Apply (uygula): Önizlemede onayladıktan sonra DB'ye yazılır.

Bu sayede yanlış dosya yüklediğinizde geri dönüş kolay.

Şablon indirme

  1. Sol menü Ürünler > Toplu İçe Aktarma sekmesi.
  2. Şablonu İndir butonuna basın (CSV veya XLSX).
  3. Şablonu açın, hücreleri doldurun.

Şablon kolonları

KolonAçıklamaZorunlu
titleÜrün başlığı✓
brandMarka adı (yoksa otomatik oluşturulur)
categorySlugKategori slug (örn. tisort)
skuStok kodu✓
barcodeEAN/UPC barkodönerilir
priceMinorFiyat (kuruş — 19990 = 199.90 TL)✓
currencyPara birimi (varsayılan TRY)
stockQtyBaşlangıç stok miktarı
warehouseSlugHangi depoya yazılacak (varsayılan: ana depo)
descriptionÜrün açıklaması
imageUrlsGörsel URL'leri (virgülle ayrılmış)
attributesJSON formatında: {"renk":"Beyaz","beden":"M"}

Aynı ürünün birden fazla varyantı

Aynı title ile birden fazla satır yazın; sistem otomatik olarak aynı ürünün varyantları olarak ekler. Her satır farklı bir varyant olur.

title,sku,barcode,attributes,priceMinor
"Bambu Tişört","BAMBU-WHT-M","8690...001","{""renk"":""Beyaz"",""beden"":""M""}",19990
"Bambu Tişört","BAMBU-WHT-L","8690...002","{""renk"":""Beyaz"",""beden"":""L""}",19990
"Bambu Tişört","BAMBU-BLK-M","8690...003","{""renk"":""Siyah"",""beden"":""M""}",19990

Preview adımı

  1. Doldurulmuş dosyayı Dosya Seç ile yükleyin.
  2. Sistem maksimum birkaç dakikada (10.000 satır için ~30s) işler.
  3. Sonuç ekranında:
    • Toplam satır sayısı
    • Geçerli (yeşil) ve Hatalı (kırmızı) satır sayısı
    • Hatalı satırların listesi + hata mesajı (örn. "Barkod tekil değil, satır 47")
  4. Hataları düzelt veya Sadece geçerli satırları uygula seçeneğini işaretle.

Apply adımı

  1. Uygula butonuna basın.
  2. Onay diyaloğu açılır — kaç satır eklenecek, kaç güncellenecek özetlenir.
  3. Evet, uygula → DB'ye yazılır.
  4. İşlem bittiğinde rapor: oluşturulan, güncellenen, başarısız sayısı.

Update mantığı

Eğer SKU veya barkod mevcut bir varyanta eşleşiyorsa güncelleme yapılır (yeni kayıt eklenmez). Eşleşmeyen satırlar yeni varyant olarak eklenir.

Bu sayede aynı şablonu fiyat güncellemesi için tekrar kullanabilirsiniz.

Yaygın hatalar

  • "priceMinor sayı değil" → 199.90 yazmışsınız; kuruş cinsinden integer olmalı (19990)
  • "Barkod tekil değil" → Aynı barkod başka varyantta var; barkodu kontrol edin veya boş bırakın
  • "Kategori bulunamadı" → categorySlug yanlış; Kategoriler sayfasında slug'ları kontrol edin
  • "Image download failed" → imageUrls'de erişilemez URL var; URL'yi düzeltin veya boş bırakın

Limitler

  • Tek dosyada max 10.000 satır
  • Dosya boyutu max 20 MB
  • Görsel URL'leri toplam max 1 GB çekilir (her görsel max 5 MB)

Daha büyük datasetler için dosyayı bölün veya destekle iletişime geçin.

Sonraki adım