WooCommerce CSV ürün yükleme, yüzlerce ürünü tek tek düzenlemek yerine ürün verisini tablo halinde içe aktarmayı sağlar. Ancak yanlış kimlik, SKU, ürün türü veya sütun eşlemesi mevcut ürünlerin fiyatını, stoğunu ve varyasyon ilişkisini bozabilir. Bu rehber, önce küçük bir test partisiyle doğrulanan ve gerektiğinde geri alınabilen güvenli bir içe aktarma süreci kurar.
İçe aktarmadan önce hedefi netleştirin
CSV dosyasının amacı şu üç işlemden yalnız biri olmalıdır:
- Yeni ürün oluşturma: mağazada bulunmayan ürünleri eklemek.
- Mevcut ürünleri güncelleme: fiyat, stok, açıklama veya başka alanları kimlik/SKU üzerinden değiştirmek.
- Veri taşıma: başka WooCommerce mağazasından alınan ürünleri yeni mağazaya aktarmak.
Aynı dosyada hem yeni ürün hem mevcut ürün güncellemek mümkündür; fakat hata etkisini büyütür. İlk çalışmada işlemleri ayrı dosyalara bölmek, hangi satırın ne yaptığını izlemeyi kolaylaştırır. Mevcut katalog yapısını da WooCommerce ürün sayfası SEO ayarları ile kontrol ederek başlık, açıklama ve görsel alanlarının gerçek kullanıcı bilgisini koruduğundan emin olun.
Yedek ve örnek dışa aktarma alın
Toplu değişiklikten önce veritabanı ve medya dosyalarını kapsayan geri yüklenebilir bir yedek alın. Ardından Ürünler → Tüm Ürünler → Dışa aktar aracını kullanarak birkaç doğru ürünü dışa aktarın. WooCommerce’in ürettiği bu dosya, mevcut sürümünüzün beklediği sütun adları ve değer biçimleri için en güvenilir şablondur.
WooCommerce’in resmî ürün CSV içe/dışa aktarma belgesi desteklenen sütunları açıklar. Örneğin sayısal Stock değeri stok yönetimini ve miktarı, In stock? alanı stok durumunu, Parent alanı ise varyasyonun bağlı olduğu ana ürünü etkileyebilir.
CSV dosyasını veri kaybı oluşturmadan hazırlayın
UTF-8 ve ayraç biçimi
Türkçe karakterlerin bozulmaması için dosyayı UTF-8 olarak kaydedin. Elektronik tablo uygulamanızın virgül, noktalı virgül ve ondalık ayırıcı davranışını kontrol edin. İçe aktarma önizlemesinde sütunlar tek alanda birleşiyorsa yanlış ayraç seçilmiş olabilir.
SKU ve baştaki sıfırlar
SKU hücrelerini metin olarak biçimlendirin. Elektronik tablo, 00125 değerini sayıya çevirip 125 yapabilir veya uzun kodları bilimsel gösterime dönüştürebilir. Bu değişiklik ürün eşleşmesini bozar. İçe aktarmadan önce SKU sütununu düz metin dosyasında da kontrol edin.
Formül ve dış bağlantı güvenliği
Kaynağını bilmediğiniz CSV dosyasını doğrudan elektronik tabloda açmayın. =, +, - veya @ ile başlayan hücreler bazı uygulamalarda formül olarak çalıştırılabilir. Tedarikçiden gelen dosyayı düz metin olarak inceleyin; gereksiz formülleri, makroları ve dış bağlantıları temizleyin.
Temel WooCommerce ürün sütunlarını eşleyin
| Alan | Görevi | Kontrol |
|---|---|---|
| ID | Mevcut ürünü kesin kimlikle eşler | Başka mağazadan taşırken aynı ID’yi varsaymayın |
| SKU | Ürün veya varyasyonu iş koduyla eşler | Benzersiz ve metin biçiminde olmalı |
| Name | Ürün başlığı | Boş ya da tedarikçi kodu olmamalı |
| Type | simple, variable, variation vb. | Ürün yapısıyla eşleşmeli |
| Published | Yayın durumunu belirler | Test ürünlerini doğrudan yayımlamayın |
| Regular price | Normal fiyat | Ondalık ayırıcı ve vergi dahil/hariç biçimi |
| Categories | Kategori ilişkisi | Hiyerarşi ve ayraç doğru olmalı |
| Images | Görsel adresleri | Herkese açık, geçerli ve kullanım hakkı olan URL |
| Stock | Stok yönetimi ve miktarı | Sayısal değer, SKU ile doğru ürüne bağlı |
Yalnız değiştirmek istediğiniz alanları dosyaya almak riski azaltabilir; ancak güncelleme seçeneğinin boş hücreleri nasıl yorumladığını önizlemede doğrulayın. Boş değer “dokunma” ile “alanı temizle” anlamına aynı anda gelmez. Önce iki kopya ürün üzerinde deneyin.
Basit ürünleri küçük bir partiyle içe aktarın
- Ürünler → Tüm Ürünler → İçe aktar ekranını açın.
- Yeni ürün dosyasını seçin. Mevcut ürünleri güncelliyorsanız ilgili güncelleme seçeneğini bilinçli olarak işaretleyin.
- Ayraç ve gelişmiş seçenekleri dosyanızla eşleştirin.
- Sütun eşleme ekranında otomatik eşleşmeleri tek tek gözden geçirin.
- Önce iki ila beş test ürününü taslak olarak içe aktarın.
- Ürün düzenleyicisi, kategori, görsel, fiyat, vergi, stok ve ön yüzdeki sonucu doğrulayın.
Stok sütununu kullanıyorsanız sonucu WooCommerce stok yönetimi rehberindeki ürün, varyasyon ve sipariş kontrolleriyle karşılaştırın. CSV doğru görünse bile dış ERP veya pazar yeri bağlantısı kısa süre sonra değeri tekrar değiştirebilir.
Varyasyonlu ürünleri doğru sırayla oluşturun
Varyasyonlu ürün aktarımında ana ürün satırı ve varyasyon satırları ayrı görev taşır. Ana ürünün türü variable, alt satırların türü variation olmalıdır. Varyasyonların Parent alanı ana ürünün kimliğini veya desteklenen eşleştirme biçimini göstermeli; kullanılan nitelikler ana üründe tanımlanmalıdır.
- Önce ana ürünü ve kullanılacak nitelikleri doğrulayın.
- Her varyasyona gerekiyorsa ayrı SKU, fiyat, görsel ve stok girin.
- Nitelik adları ile değerlerinin yazımını bütün satırlarda aynı tutun.
- Renk ve beden kombinasyonlarından eksik veya yinelenen satır olmadığını kontrol edin.
- İçe aktarmadan sonra her varyasyonu seçip fiyat, stok ve görsel değişimini ön yüzde test edin.
Varyasyonların ürün düzenleyicisindeki yapısını WooCommerce varyasyonlu ürün kurulumuyla karşılaştırın. Ana ürün SKU’su ile varyasyon SKU’larını aynı kullanmayın.
Fiyat, KDV ve para birimi biçimini doğrulayın
CSV fiyat sütunundaki değerin WooCommerce ayarınızdaki vergi dahil/hariç fiyat giriş biçimiyle aynı olması gerekir. Elektronik tablo ondalık ayırıcıyı değiştirebilir; para birimi simgesi, binlik ayırıcı veya metin eklemeyin. Fiyat sonucunu WooCommerce KDV ayarları rehberindeki katalog, sepet ve test siparişi zincirinde doğrulayın.
Ürün görsellerini güvenli biçimde aktarın
Görsel sütunundaki adresler sunucunun erişebileceği herkese açık HTTP/HTTPS URL’leri olmalıdır. Geçici oturum, yerel bilgisayar yolu veya erişim izni isteyen bulut bağlantısı çalışmaz. Görsellerin kullanım hakkını ve dosya boyutunu kontrol edin. Aynı dosyanın farklı URL’lerle tekrar içe aktarılması medya kütüphanesinde kopyalar oluşturabilir.
İçe aktarma sonrasında öne çıkan görsel, galeri sırası, alt metin ve dosyanın gerçekten yerel medya kütüphanesine alındığını kontrol edin. CSV’ye anahtar kelime doldurulmuş alt metinler eklemek yerine her görselin görünen içeriğini doğal biçimde açıklayın.
Yaygın CSV içe aktarma hataları
SKU zaten kullanılıyor
Dosyadaki yinelenen SKU’ları ve mağazadaki mevcut eşleşmeyi bulun. Yeni ürün oluşturuyorsanız benzersiz SKU kullanın. Güncelleme yapıyorsanız satırın gerçekten hedeflediğiniz ürüne ait olduğunu doğrulayın.
Sütunlar yanlış alanlara eşlendi
Önizleme ekranına geri dönüp özellikle fiyat, stok, kategori, nitelik ve ebeveyn alanlarını kontrol edin. Türkçe özel sütun adlarının otomatik eşleşmesini varsaymayın; gerekirse manuel eşleyin.
Varyasyon ana ürüne bağlanmadı
Ana ürün türünü, Parent değerini ve nitelik adlarını kontrol edin. Başka mağazadan gelen sayısal ID’ler yeni mağazada farklı ürüne ait olabilir; taşıma sırasında SKU tabanlı plan veya iki aşamalı aktarım kullanın.
İşlem zaman aşımına uğradı
Dosyayı daha küçük partilere bölün; ağır görselleri ve gereksiz sütunları ayırın. Sunucu logunda bellek, çalışma süresi veya güvenlik duvarı hatası olup olmadığını inceleyin. Zaman aşımından sonra içe aktarılan satırları kontrol etmeden aynı dosyayı yeniden çalıştırmayın.
İçe aktarma sonrası doğrulama ve geri alma
- İçe aktarma raporundaki başarılı, atlanan ve hatalı satırları kaydedin.
- Rastgele örnek yerine basit, varyasyonlu, stoklu ve farklı vergi sınıflı ürünlerden test kümesi seçin.
- Ürün URL’si, yayın durumu, kategori, fiyat, stok, görsel ve nitelikleri doğrulayın.
- Arama, filtreleme, sepete ekleme ve ödeme akışını mobilde test edin.
- Hatalı toplu güncellemeyi elle tersine çevirmek yerine işlem öncesi dışa aktarım veya doğrulanmış yedekle geri dönüş planını uygulayın.
Canlı katalogda büyük bir güncelleme yaptıktan sonra ürün sitemap’inin erişilebilir olduğunu ve yanlışlıkla taslak/gizli duruma geçen ürün bulunmadığını kontrol edin. Kalıcı URL’leri değiştirdiyseniz eski adreslerin yönlendirme planını ayrıca hazırlayın.
Sık sorulan sorular
WooCommerce CSV ile mevcut ürünler güncellenebilir mi?
Evet. Güncelleme seçeneği etkinleştirildiğinde ürünler ID veya SKU gibi eşleştirme alanlarıyla bulunabilir. Önce küçük bir kopya ürün grubunda hangi boş ve dolu hücrelerin değiştiğini test edin.
CSV dosyasında ürün görseli nasıl eklenir?
Görsel sütununa sunucunun erişebileceği herkese açık dosya URL’leri yazılır. Geçici veya giriş gerektiren bağlantılar çalışmayabilir; kullanım hakkı ve dosya boyutu da kontrol edilmelidir.
Varyasyonlar neden ana ürüne bağlanmıyor?
Genellikle ürün türü, Parent alanı veya nitelik adları uyuşmaz. Ana ürünü önce doğrulayın; başka mağazadan gelen sayısal ID’lerin yeni mağazada aynı olmadığını unutmayın.
Türkçe karakterler CSV’de neden bozuluyor?
Dosya UTF-8 dışında kaydedilmiş veya yanlış ayraçla açılmış olabilir. Dosyayı UTF-8 CSV olarak dışa aktarın ve içe aktarma önizlemesinde ürün adlarını kontrol edin.
Hatalı CSV içe aktarma nasıl geri alınır?
WooCommerce içe aktarıcısında her değişikliği tek tıkla geri alan genel bir işlem varsaymayın. İşlem öncesi ürün dışa aktarımı ve tam yedek alın; staging testiyle geri yükleme planını doğrulayın.
Sonuç
Güvenli WooCommerce CSV ürün yükleme; doğru şablon, benzersiz SKU, kontrollü sütun eşleme ve küçük test partisiyle başlar. Basit ürün, varyasyon, görsel, stok ve vergi alanlarını ayrı ayrı doğrulayın. Canlı mağazada toplu işlem yapmadan önce dışa aktarım ve geri yüklenebilir yedek hazırlamak, düzeltme maliyetini önemli ölçüde azaltır.
