Ürünler

Toplu ürün içe aktarma

CSV dosyası ile yüzlerce ürünü tek seferde mağazana yükleme.

Güncellendi: 30 Ekim 2026

Onlarca veya yüzlerce ürünü tek tek eklemek zaman alır. Toplu içe aktar ile hazırladığın bir CSV dosyasını yükleyip tüm ürünleri tek seferde ekleyebilirsin. İçe aktarma iki aşamalıdır: önce dosya yüklenip doğrulanır, sonra sen onaylayınca ürünler gerçekten aktarılır. Bu sayede yanlış bir dosyayı kazara yüklemezsin — önce ne olacağını görürsün.

Not: İçe aktarma yalnızca CSV dosyası kabul eder; Excel dosyası veya sütun eşleştirme adımı yoktur. Yükleme alanının altındaki Örnek CSV şablonunu indir bağlantısıyla beklenen kolonları, varyant satır düzenini ve mağazanın özel alan kolonlarını gösteren bir şablon indirebilir, kendi dosyanı onun üzerine hazırlayabilirsin.

İçe aktarma ekranına ulaşma

  1. Sol menüden Ürünler’e tıkla.
  2. Sağ üstteki Daha fazla menüsünü aç ve Toplu içe aktar’ı seç.
  3. Toplu Ürün İçe Aktar ekranı açılır.

1. Adım — Yükle ve doğrula

  1. CSV dosyası alanına dosyanı sürükleyip bırak ya da alana tıklayıp bilgisayarından seç. Yalnızca .csv dosyası kabul edilir; farklı türde bir dosya seçersen “Lütfen geçerli bir .csv dosyası seçin” uyarısı görürsün.
  2. İstersen İçe aktarma bitince e-posta gönder kutusunu işaretle. İşlem uzun sürerse ekranı beklemek zorunda kalmadan sonucu e-posta ile öğrenirsin.
  3. Yükle ve Doğrula butonuna bas.

Bu adımda ürünler henüz aktarılmaz. Sistem dosyanı okur, satırları kontrol eder ve karşına bir doğrulama özeti çıkarır. Görseller CSV içinde bir URL adresi olarak belirtilir; sistem içe aktarma sırasında bu adreslerden görselleri indirir.

Fiyatlarda vergi: taxInclusive kolonu

CSV’deki fiyatlar varsayılan olarak vergi dahil kabul edilir. Fiyatlarını vergi hariç hazırladıysan taxInclusive kolonunu kullan (şablonda taxRate kolonunun hemen yanındadır):

taxInclusive hücresiAnlamı
BoşFiyat vergi dahil (varsayılan).
false, 0, no, hayır veya hayirFiyat vergi hariç; vergi, ödenecek tutarda fiyatın üzerine eklenir.
true, 1, yes veya evetFiyat vergi dahil.
  • Kolon her varyant satırı için ayrı okunur. Vergi hariç bir ürünün her varyant satırına false yaz; boş bırakılan satır ürünün ilk satırından değer almaz, vergi dahil sayılır.
  • Vergi hariç fiyatlarda taxRate (vergi oranı, ör. 20) kolonunu da doldur; oranı olmayan varyanta eklenecek vergi yoktur.
  • Bu kolonda tanınmayan bir değer (ör. hariç) satırı Hatalı yapar; sistem onu sessizce vergi dahil saymaz.

İçe aktardıktan sonra oranı veya vergi dahil/hariç bilgisini ürünlerde toplu değiştirmek istersen, toplu düzenleme ekranındaki Vergi oranı (%) ve Vergi dahil/hariç sütunlarını kullanabilirsin (sütunlar Görünen alanlar menüsünden açılır).

Stok ve maliyet kolonları

  • stock kolonu adedi varsayılan lokasyona yazar.
  • Birden çok lokasyonun varsa şablonda stock’un yanında her diğer aktif lokasyon için stock:<KOD> kolonu gelir (ör. stock:MGZ). Bu kolon adedi o lokasyona yazar. Bilinmeyen ya da pasif lokasyon kodu satırı Hatalı yapar. Bkz. Stok lokasyonları.
  • unitCost kolonu Vergi hariç birim maliyeti yazar (ör. 125.50). Kolon yalnız Maliyet izni olan personelin şablonunda bulunur ve yalnız onların içe aktarmasında yazılır.

Boş hücre o değeri değiştirmez.

Doğrulama özetini okuma

Doğrulama bitince ekranda kart kart bir özet görürsün:

KartAnlamı
ÜrünDosyadaki toplam ürün satırı.
GeçerliSorunsuz aktarılacak ürünler.
UyarıAktarılır ama dikkat edilmesi gereken bir not var.
HatalıBu haliyle aktarılamayacak satırlar.
Yeni kategoriDosyada geçen, mağazanda henüz olmayan ve oluşturulacak kategoriler.
Yeni markaDosyada geçen, henüz olmayan ve oluşturulacak markalar.
Dosyada mükerrer SKUAynı stok kodunun dosya içinde birden fazla kez geçmesi.
Mevcut SKUMağazanda zaten var olan bir ürünle aynı stok koduna sahip satırlar.
Görselİçe aktarılacak toplam görsel sayısı.

Altında Alan bazlı bulgular bölümü, hangi alanda (ör. fiyat, marka, görsel) kaç satırın sorunlu olduğunu ve örnek satır numaralarını listeler. En alttaki tabloda ise her satırı tek tek görebilir; üstteki filtreyle Hatalı, Uyarı veya Atlandı gibi durumlara göre süzebilirsin.

2. Adım — İçe aktarmayı başlat

Özetin altında, aktarımı onaylamadan önce birkaç seçenek çıkar:

  • Hatalı satırları atla ve devam et — Dosyada hatalı satır varsa, devam edebilmek için bu kutuyu işaretlemen gerekir. Hatalı satırlar atlanır, geri kalanı aktarılır.
  • Mevcut SKU çakışmasında: — Mağazanda zaten var olan bir stok koduyla karşılaşıldığında ne yapılacağını seçersin:
    • Hata ver — Çakışan satır başarısız sayılır.
    • Atla — Çakışan ürün, tekrar aktarılmadan geçilir (görselleri de yeniden indirilmez).

Seçimlerini yaptıktan sonra İçe aktarmayı başlat butonuna bas. Aktarım artık başlar.

İçe aktarma sürerken

İlerlemeyi sayfanın kendisinde canlı izlersin: kaç ürünün işlendiği (ör. 120/500), geçen süre, tahmini kalan süre ve dakikada işlenen ürün sayısı görünür.

İşlem arka planda çalışır. Sayfadan çıkabilir, başka işlerle uğraşabilirsin. İçe aktarma ekranına geri döndüğünde sistem “Devam eden içe aktarma işi kontrol ediliyor…” diyerek yarıda kalan işi otomatik geri yükler ve kaldığı yerden gösterir. Bağlantın kopsa bile aktarım durmaz.

Görseller URL adreslerinden tek tek indirildiği için, çok ürünlü ve çok görselli dosyalarda bu adım biraz uzun sürebilir.

Aktarımı durdurma

Aktarım sürerken durdurmak istersen sağ üstteki İptal et butonuna bas. Sistem “İçe aktarma durdurulsun mu?” diye sorar; Evet, durdur ile onaylar, Vazgeç ile geri dönersin.

İçe aktarma bittiğinde

İşlem tamamlanınca ekranın üstünde bir sonuç mesajı görürsün:

İçe aktarma tamamlandı — X başarılı, Y hatalı, Z atlandı

Alttaki tabloda her satırın son durumunu (Aktarıldı, Başarısız, Atlandı) ve varsa bulgusunu görebilirsin. Yeni bir dosya yüklemek istersen sağ üstteki Yeni içe aktarma butonuna bas.

Sık yapılan hatalar

  • Excel dosyası yüklemeye çalışmak — Ekran yalnızca .csv kabul eder. Dosyanı CSV olarak kaydet.
  • Fiyatları virgülle yazmak — Ondalık ayracı olarak nokta kullan (129.90).
  • Vergi hariç fiyatları işaretlememek — taxInclusive kolonu boşsa fiyat vergi dahil sayılır; vergi hariç fiyatlarda her varyant satırına false yaz.
  • Marka veya kategori adını dikkatsiz yazmak — Dosyadaki ad mağazandakiyle eşleşmezse, sistem bunu yeni marka veya yeni kategori olarak oluşturur. Yeni marka/kategori sayısını doğrulama özetinden kontrol et.
  • Aynı stok kodunu dosyada tekrar kullanmak — Dosyada mükerrer SKU kartı sıfırdan büyükse, aynı stok kodu birden fazla satırda geçiyor demektir; düzeltmen gerekir.
  • Görsel için dosya yüklemeye çalışmak — Görseller CSV içinde URL adresi olarak verilir; içe aktarma bu adreslerden indirir.

Sık sorulan sorular

Bir şablon indirmem gerekiyor mu? Zorunlu değil, ama işini kolaylaştırır. Yükleme ekranındaki Örnek CSV şablonunu indir bağlantısı beklenen kolonları, örnek satırları ve mağazanın özel alan kolonlarını içeren bir dosya indirir. Sütun eşleştirme adımı yoktur; kolon adlarını şablondaki gibi kullanman yeterlidir.

Mevcut ürünleri güncellemek için içe aktarmayı kullanabilir miyim? Stok kodu (SKU) mağazandaki bir ürünle eşleşirse bu satır Mevcut SKU olarak işaretlenir. Mevcut SKU çakışmasında seçeneğini Atla yaparsan bu ürünler değiştirilmeden geçilir; Hata ver yaparsan çakışan satırlar başarısız olur.

İçe aktarma sırasında bağlantım koptu, ne olur? İçe aktarma arka planda çalışır; bağlantın kopsa bile durmaz. İçe aktarma ekranına geri döndüğünde sistem devam eden işi otomatik bulur ve kaldığı yerden gösterir. İlerlemeyi sayfanın üzerinde canlı görürsün; istersen yükleme sırasında İçe aktarma bitince e-posta gönder kutusunu işaretleyerek sonucu e-posta ile de alabilirsin.

Aynı anda görsel dosyası yükleyebilir miyim? Hayır. Görseller CSV içinde URL adresi olarak verilir ve sistem bunları o adreslerden indirir. Görselleri elle toplu yüklemek istersen Dosyalar bölümünü kullanabilirsin. Detay için Dosya yönetimi.

Sonraki adımlar