CSV ile toplu veri aktarma: ürün, sipariş ve çeviri

Yeni bir mağaza kurarken ya da başka bir sistemden taşınırken ilk soru hep aynıdır: "Bu kadar ürünü tek tek mi gireceğim?" Hayır. Sepetya içinde veriyi üç yoldan taşırsınız: CSV dosyalarıyla toplu içe ve dışa aktarma, panelden seçip toplu düzenleme ve API ile otomatikleştirme.

Bu rehber üçünü de anlatır; hangi işte hangisinin doğru araç olduğunu, dosyayı nasıl hazırlayacağınızı ve bir şey ters giderse nereye bakacağınızı gösterir. API tarafına yeni başlıyorsanız önce REST API ile başlangıç yazısına göz atın.

Hangi işte hangi araç?

İş	Doğru araç
Başka bir sistemden ilk kez ürün taşımak	CSV içe aktarma
Seçtiğiniz ürünlerin fiyatını yüzde ile artırmak	Panelde toplu düzenleme
Her gece stokları ERP'den güncellemek	API
Bütün katalogu yedeklemek ya da Excel'de incelemek	CSV dışa aktarma
Çevirileri çevirmene göndermek	Çeviri dosyası (CSV)

Kural basit: tek seferlik ve büyük işler CSV, tekrarlayan ve otomatik işler API, küçük ve seçime dayalı işler panelde toplu düzenleme.

Ürün içe aktarma üç adımdır

1. Dosya: "Şablonu indir" ile örnek dosyayı alın, kendi verinizi onun sütunlarına yerleştirin. Excel kullanıyorsanız dosyayı "CSV UTF-8" olarak kaydedin; başlıklar Türkçe ya da İngilizce olabilir.
2. Önizleme: dosyayı yüklediğinizde panel satır sayısını, yaklaşık ürün sayısını ve dosya boyutunu gösterir; tanınan sütunları listeler, zorunlu bir sütun eksikse söyler ve tanımadığı sütunların yok sayılacağını belirtir. İlk satırlardan örnekler gösterilir. Bu adımda hiçbir şey kaydedilmez.
3. İçe aktarma: seçenekleri belirleyip başlatırsınız. Satırlar arka planda işlenir; sayfadan ayrılabilirsiniz.

Dosyayı hazırlarken üç şeyi bilin: her satır bir varyanttır ve aynı "Ürün Grup Kodu" olan satırlar tek ürün olur; fiyatlar hem "1.299,90" hem "1299.90" biçiminde yazılabilir; görseller için herkese açık bağlantılar verilir ve birden fazla bağlantı noktalı virgülle ayrılır.

• Mevcut ürünleri güncelle: açıksa aynı stok kodu, ürün kimliği ya da grup koduna sahip ürünler güncellenir; kapalıysa bu satırlar atlanır. İlk aktarmada kapalı, düzenli güncellemelerde açık kullanılır.
• Görselleri indir: bağlantılardaki görseller indirilip ürünlere eklenir. Bu iş arka planda sürer, büyük kataloglarda biraz zaman alır.
• Dosyanın dili: dil eki olmayan metin sütunları bu dile yazılır. Çok dilli mağazada yanlış seçim, Türkçe metinleri İngilizce alanına yazmak demektir; önce bunu kontrol edin.

Toplu işlemler sayfası: durum, rapor, durdurma

Bütün içe ve dışa aktarmalar ile toplu güncellemeler Ürünler › Toplu işlemler sayfasında listelenir. Her işlemin türü (ürün içe aktarma, ürün dışa aktarma, çeviri dışa aktarma, toplu fiyat güncelleme gibi), durumu (sırada, çalışıyor, tamamlandı, başarısız, durduruldu), ilerlemesi ve "başarılı · hatalı · toplam" sayıları görünür.

• Hata raporu: hatalı satır varsa "Hata raporunu indir" ile hangi satırda ne olduğunu satır numarasıyla birlikte alırsınız. Raporu düzeltip yalnız o satırları yeniden yükleyebilirsiniz.
• Dosya indirme: dışa aktarmalarda sonuç dosyası aynı sayfadan indirilir.
• Durdurma: uzun süren bir işlemi durdurabilirsiniz; işlenmiş satırlar geri alınmaz, kalanlar atlanır. Bu yüzden durdurduğunuz bir içe aktarmadan sonra katalogu bir kez gözden geçirin.
• Tüm ürünleri dışa aktar: aynı sayfadaki bu düğme, taşımadan önce yedek almanın en hızlı yoludur.

Uzun süren bir işlemi beklemek zorunda değilsiniz: panel, kaç satırın işlendiğini gösterir ve sayfadan ayrılsanız bile işlem arka planda sürer. Birkaç aktarmayı aynı anda başlatmak yerine sırayla yapmak, hatayı bulmayı da kolaylaştırır.

Ürün dışındaki dosyalar

CSV yalnız ürünle sınırlı değil. Panelde şu veriler de dosyayla taşınır:

Dosya	Ne işe yarar?
Müşteriler	Mevcut müşteri listesini adres ve özel alanlarıyla taşımak
Siparişler	Geçmiş siparişleri raporlar ve müşteri geçmişi için aktarmak
Fiyat listesi	Müşteri grubuna özel fiyatları toplu girmek (bkz. müşteri grupları)
Özellikler	Teknik özellik değerlerini ürünlere toplu yazmak
Stok sayımı ve stok transferi	Depo sayımını ve depolar arası hareketi dosyayla işlemek
Kategori sıralaması	Kategori içindeki ürün sırasını toplu belirlemek
Stok bildirimi talepleri	"Gelince haber ver" taleplerini taşımak
İndirim kodları	Hazır kod listesini kampanyaya yüklemek
Yönlendirmeler	Eski adresleri yeni adreslere eşlemek (bkz. 301 yönlendirme rehberi)

Stok bildirimi taleplerinde panel ayrıca bir onay ister: listedeki kişilerin bu bildirimi gerçekten sizden istemiş olması gerekir. Onay, içe aktarmayı yapan kişiyle birlikte işlem kaydına yazılır. İzin konusunda bu titizlik yalnız nezaket değil, ticari ileti izinlerinin gereğidir.

Başka bir sistemden taşınırken sıra önemlidir

Veriyi rastgele sırayla yüklemek, sonradan elle düzeltilecek bir yığın iş çıkarır. İşleyen sıra şudur:

1. Markalar ve kategoriler: ürünler bunlara bağlanacağı için önce ağacı kurun. Kategori adlarını son hâline getirip sonra ürün yükleyin.
2. Ürünler ve varyantlar: stok kodlarını eski sistemdekiyle aynı tutun; ileride eşleştirme yapmanız gerekirse tek bağlantı noktanız bu olur.
3. Stok: ürünler girdikten sonra stok sayımı dosyasıyla miktarları yazın. Depolarınız varsa önce lokasyonları tanımlayın.
4. Müşteriler: pazarlama izinlerini kaynağıyla birlikte taşıyın; izin kaynağı olmayan kayıtlara ticari ileti göndermeyin.
5. Siparişler: geçmiş siparişler müşteri geçmişini ve raporları tamamlar.
6. Yönlendirmeler: en son, eski adresleri yeni adreslere eşleyin; böylece arama motorlarından gelen trafik kaybolmaz.

Her adımdan sonra birkaç kaydı panelde açıp gözle kontrol edin. Katalog yapısını kurarken kategori ve filtre rehberi işinizi kolaylaştırır.

Çeviri dosyası

Çok dilli mağazalarda çeviriler tek bir dosyada toplanır. Online Mağaza › Lokalizasyon › Çeviriler altından dışa aktardığınız dosyada her satır bir kaydın bir alanıdır (ürün adı, kategori açıklaması, menü öğesi, blog yazısının bir bloğu gibi) ve her mağaza dili için bir sütun bulunur. Çevirmeniniz boş hücreleri doldurur, dosyayı geri yükler.

• Boş bırakılan hücre kayıttaki metni değiştirmez; yani yalnız doldurduğunuz alanlar güncellenir.
• Her satır kendi kaydının kurallarıyla kaydedilir: doğrulama, adres (slug) üretimi, otomatik yönlendirme ve işlem kaydı panelden düzenlemeyle aynıdır.
• Hücreler formül korumalıdır; elektronik tabloda formül gibi görünebilecek metinler zararsız hâle getirilir ve içe aktarırken geri çözülür.
• Bir kaydın satırlarından biri hatalıysa o kaydın hiçbir satırı uygulanmaz; hatalı satır raporda görünür.

Çeviri akışının tamamı ve dil ekleme adımları çok dilli e-ticaret SEO'su yazısında.

Panelden toplu düzenleme

Dosyaya hiç dokunmadan da toplu iş yapabilirsiniz. Ürün listesinde kayıtları seçip durum değiştirme, fiyat güncelleme (yüzde, tutar ya da sabit fiyat, yuvarlama seçenekleriyle), kategori ve etiket ekleme/çıkarma, marka ve tedarikçi atama, satış kanalı görünürlüğü ve silme işlemlerini yapabilirsiniz. Varyant tablosunda fiyat, karşılaştırma fiyatı, maliyet, stok, ağırlık ve stok kodu alanlarını toplu doldurabilirsiniz. Sipariş ve müşteri listelerinde de benzer toplu işlemler vardır.

Her toplu değişiklik, etkilediği kaydın zaman çizelgesine "Toplu işlem: fiyatlar güncellendi" gibi bir satır düşer. Böylece "bu fiyatı kim değiştirdi?" sorusunun cevabı kaybolmaz.

API ile otomatikleştirme

Tekrarlayan aktarmaları elle yapmak yerine API'ye bağlayabilirsiniz. İçe aktarma uç noktaları dosyayı alır ve bir toplu işlem oluşturur; işlemin durumunu ve hata raporunu yine API'den okursunuz. Çeviri dosyasını da dışa aktarıp kendi çeviri sisteminize bağlayabilirsiniz. Stok gibi sık değişen veriler için dosya yerine doğrudan stok uç noktalarını kullanmak daha hızlıdır.

Toplu işlemler ve CSV, paketinizde açık olması gereken bir özelliktir; API ile çalışacaksanız API erişiminin de açık olması gerekir. Otomatik işleri gece gibi sakin saatlere alın, bir işlemin bitmesini bekleyip diğerini başlatın ve hata raporunu kendi günlüğünüze kaydedin. Sipariş gibi olay anında tepki isteyen akışlar için webhook kullanın.

Veri taşıma kontrol listesi

• Taşımadan önce mevcut katalog dışa aktarılıp yedeklendi.
• Şablon dosyası indirildi; sütunlar şablona göre düzenlendi.
• Dosya "CSV UTF-8" olarak kaydedildi.
• Varyantlı ürünlerde grup kodu doğru; aynı ürünün satırları aynı kodu taşıyor.
• Stok kodları tekil ve tutarlı; eski sistemdeki kodlarla eşleşiyor.
• Önce 10–20 satırlık deneme dosyası yüklendi ve sonuç panelde kontrol edildi.
• "Mevcut ürünleri güncelle" ve "Görselleri indir" seçenekleri bilinçli seçildi.
• Çok dilli mağazada dosyanın dili doğru seçildi.
• Toplu işlemler sayfasındaki hata raporu indirilip düzeltildi.
• Tekrarlayan aktarmalar için API ya da planlı bir iş kuruldu.

Katalogunuzu taşıyıp denemek için ücretsiz başlayın; başka bir altyapıdan geliyorsanız geçiş rehberimize de bakabilirsiniz.