E-Ticaret Ürün Dosyası Hazırlama Rehberi (CSV ve Excel)

E-ticaret ürün dosyası hazırlama; ürün adı, SKU, barkod, fiyat, stok, varyant, açıklama ve görsel bağlantılarını belirli bir tablo formatında (CSV veya XLSX) eksiksiz düzenleme sürecidir. Başarılı bir aktarım için zorunlu sütunlar doğru adlandırılmalı, sayısal kodlar metin olarak biçimlendirilmeli ve dosya UTF-8 kodlamasıyla kaydedilmelidir.

E-ticaret operasyonlarında yüzlerce veya binlerce ürünü tek tek yönetim paneline girmek hem zaman kaybına yol açar hem de insan hatası riskini artırır. Toplu ürün içe aktarma (bulk import) süreçleri, katalog yönetimini dakikalar seviyesine indirir. Ancak dosya yapısındaki en ufak bir biçimlendirme hatası, stokların karışmasına, fiyatların yanlış basılmasına veya tüm yüklemenin reddedilmesine neden olabilir. Bu rehberde, hatasız bir ürün dosyası kurgulamanın tüm adımlarını, teknik kurallarını ve dikkat edilmesi gereken noktaları ele alıyoruz.

Ücretsiz araçExcel / CSV → ShopifyExcel / CSV ürün dosyanı Shopify şablonuna çevirir; sütunlar eşlenir, barkod ve varyantlar korunur. Ücretsiz, kayıt yok, dosyan tarayıcından çıkmaz.Aracı aç

E-ticaret ürün dosyasında bulunması gereken temel sütunlar

Her e-ticaret yazılımının ve pazaryerinin kendine özgü bir şablonu bulunsa da bir ürün tablosunun omurgasını oluşturan standart sütunlar ortaktır. Dosyanızı oluştururken bu alanların veri türlerine dikkat etmeniz gerekir:

• Handle / Ürün Tanıtıcısı (Slug): Ürünün URL yapısını ve varyant gruplandırmasını belirleyen benzersiz kimliktir. Örneğin erkek-pamuklu-tisort şeklindeki bir tanımlama, aynı ürüne ait tüm beden ve renkleri tek bir sayfada toplar. Başlıkları URL dostu metinlere dönüştürmek için toplu slug üretici aracını kullanabilirsiniz.
• Ürün Adı (Title): Müşterinin sitede göreceği tam başlıktır. İsimlendirmede standart sağlamak, arama sonuçları ve filtreleme açısından kritiktir. Başlıklarınızı düzenlerken büyük küçük harf dönüştürücü ile başlık biçimi standardını koruyabilirsiniz.
• Açıklama (Body / Description): Ürün hakkında detaylı metin, teknik özellikler ve bakım talimatlarını içerir. E-ticaret altyapılarının çoğu bu alanda temel HTML etiketlerini (paragraf, liste, kalın yazı) destekler.
• SKU (Stock Keeping Unit): Depo yönetiminde her bir varyantı ayırt eden benzersiz stok kodudur. Harf ve rakamlardan oluşmalı, asla yinelenmemelidir.
• Barkod (Barcode / GTIN / EAN): Genellikle 13 haneli uluslararası ürün tanımlama kodudur. Excel tarafında bozulmaya en açık veridir.
• Fiyat ve İndirimli Fiyat (Price / Compare at Price): Ürünün satış fiyatı ve varsa üstü çizili liste fiyatıdır.
• Stok Miktarı (Inventory / Quantity): İlgili varyantın depodaki fiziksel adedidir.
• Varyant Seçenekleri (Option1 Name / Value): Beden, Renk, Materyal gibi özellik adları ve bunların karşılıklarıdır (örn. Beden: M, Renk: Siyah).
• Görsel Bağlantısı (Image Src): Ürün görselinin doğrudan erişilebilir HTTPS formatındaki açık web bağlantısıdır.

Adım adım toplu ürün dosyası hazırlama rehberi

Kataloğunuzu hatasız bir şekilde yüklemeye hazır hale getirmek için aşağıdaki adımları sırasıyla uygulayın:

1. Doğru şablonu belirleyin: Yükleme yapacağınız platformun (Shopify, WooCommerce, Trendyol vb.) en güncel örnek içe aktarma şablonunu indirin. Şablondaki sütun başlıklarını değiştirmeyin; sistemler büyük/küçük harfe ve boşluklara duyarlıdır.
2. Ürün tanıtıcılarını (Handle) kurgulayın: Aynı ürünün farklı varyantları varsa, bu varyantların tamamına aynı Handle değerini verin. Sistem bu sayede satırların aynı ürün sayfasına ait olduğunu anlar.
3. Sayısal alanları metin olarak biçimlendirin: Excel veya e-tablo programınızda SKU ve Barkod sütunlarını seçip hücre biçimini mutlaka “Metin” (Text) yapın. Aksi takdirde 0123456789012 gibi bir barkodun başındaki sıfır silinir veya 1.23457E+12 şeklinde bilimsel gösterime dönüşür.
4. Fiyat ve stok formatını standartlaştırın: Fiyat sütunlarında para birimi simgesi (TL, $, €) kullanmayın; yalnızca sayısal değer girin. Küresel altyapılar için ondalık ayracının nokta (.) olduğundan emin olun.
5. Görselleri barındırıcıya yükleyip açık URL alın: Görseller bilgisayarınızdaki yerel dosya yolu (C:\resimler\urun.jpg) olamaz. Görsellerin internette herkese açık bir sunucuda barındırılması ve https://site.com/gorsel.jpg biçiminde doğrudan uzantıyla biten bağlantılar halinde eklenmesi gerekir.
6. Yinelenen kayıtları temizleyin: Aynı SKU veya Barkod birden fazla farklı ürüne atanmışsa içe aktarma işlemi çakışma hatası verir. Dosyanızı yüklemeden önce yinelenen satır temizleme aracıyla mükerrer kayıtları ayıklayın.
7. Dosyayı UTF-8 CSV olarak dışa aktarın: Çalışmanızı bitirdiğinizde dosyayı doğrudan kaydetmek yerine UTF-8 kodlamalı CSV olarak dışa aktarın. Farklı formatların getirdiği avantajları öğrenmek için pazaryeri ürün dosyalarında Excel ve CSV format farkları başlıklı incelememize göz atabilirsiniz.

Ücretsiz araçExcel / CSV → ShopifyExcel / CSV ürün dosyanı Shopify şablonuna çevirir; sütunlar eşlenir, barkod ve varyantlar korunur. Ücretsiz, kayıt yok, dosyan tarayıcından çıkmaz.Aracı aç

Farklı kaynaklardan gelen ürün listelerinizi Shopify standartlarına dönüştürmek karmaşık sütun eşleme süreçleri gerektirebilir. Bu işlemi tarayıcınızda doğrudan gerçekleştirmek için Excel / CSV → Shopify dönüştürme aracımızdan yararlanabilirsiniz.

Platformlara göre ürün dosyası gereksinimleri

Her e-ticaret ekosisteminin veri kabul standartları farklılık gösterir. Aşağıdaki tabloda yaygın platformların teknik dosya gereksinimlerini karşılaştırabilirsiniz:

Platform / Sistem	Desteklenen Dosya Formatı	Karakter Kodlaması	Ondalık Ayracı	Varyant Satır Mantığı	Maksimum Dosya / Satır Limiti
Shopify	CSV	UTF-8	Nokta (.)	Her varyant ve ek görsel için yeni satır	Dosya başı maks. 20 MB (yaklaşık 10.000 satır önerilir)
WooCommerce	CSV, TXT	UTF-8	Nokta (.)	Ana ürün (parent) satırı altında varyant satırları	Sunucu PHP bellek sınırına bağlı (önerilen 2.000-5.000)
Yerel Pazaryerleri	XLSX, XLS	UTF-8 / Windows-1254	Virgül (,) veya Nokta (.)	Tek satırda çoklu sütun veya varyant satırı	Şablona göre değişir (genellikle 5.000 - 20.000 satır)
Magento (Adobe Com.)	CSV	UTF-8	Nokta (.)	Configurable ürün + Simple ürün satırları	Sunucu yapılandırmasına göre 10.000+ satır

Varyantlı ürünleri dosya yapısında kurgulama mantığı

Varyant yönetimi, ürün dosyası hazırlarken en çok hata yapılan alandır. Bir tişörtün S, M, L bedenleri ve Siyah, Beyaz renkleri olduğunu varsayalım. Bu ürün toplamda 6 farklı varyanta (kombinasyona) sahiptir.

• Shopify ve benzeri sistemlerde: Dosyada 6 ayrı satır oluşturulur. İlk satırda ürünün ana bilgileri (Handle, Başlık, Açıklama, Kategori, Etiketler) doldurulur. Option1 Name “Beden”, Option1 Value “S”; Option2 Name “Renk”, Option2 Value “Siyah” yazılır. Takip eden 5 satırda Handle aynı bırakılır; Başlık ve Açıklama alanları boş bırakılabilir ancak ilgili varyantın SKU’su, Fiyatı, Stoğu ve Seçenek Değerleri (M - Siyah, L - Siyah vb.) doldurulur.
• Tek satırda varyant toplayan sistemlerde: Bazı sistemlerde ana ürün tek bir satırdır ve varyant özellikleri sütunlar halinde (Ozellik_1: Beden, Ozellik_2: Renk) tanımlanır.

Birden fazla tedarikçiden veya şablondan gelen verileri bir araya getirirken sütun yapısını standartlaştırmak için CSV / Excel birleştirme aracını kullanarak tabloları tek bir çatı altında toplayabilirsiniz.

Karakter kodlaması ve ayırıcı sorunlarını çözme

Ürün dosyanızı hazırladıktan sonra karşılaşılan hataların büyük bir bölümü karakter kodlaması (encoding) ve alan ayırıcı (delimiter) uyumsuzluklarından kaynaklanır:

• Türkçe Karakter Bozulması: Dosyanızı kaydederken UTF-8 seçilmezse; ş, ç, ğ, ı, ö, ü harfleri yükleme sonrasında ?, , ç gibi bozuk karakterlere dönüşür. Excel üzerinden CSV alırken “CSV UTF-8 (Virgülle ayrılmış)” seçeneğini kullanmalısınız. Hali hazırda bozulmuş veya ANSI kaydedilmiş dosyaları düzeltmek için Excel to CSV dönüştürücüyü kullanabilirsiniz.
• Virgül ve Noktalı Virgül Karmaşası: Türkçe işletim sistemlerinde Excel, standart CSV dışa aktarımlarında ayırıcı olarak noktalı virgül (;) kullanır. Ancak Shopify ve WooCommerce gibi sistemler varsayılan olarak virgül (,) bekler. Ayırıcısı kaymış ve tüm verisi tek sütuna toplanmış dosyaları onarmak için CSV ayırıcı düzeltme aracından yararlanabilirsiniz.
• Bozuk CSV’leri Düzenleme: CSV dosyanızı açarken hücrelerin kaydığını fark ederseniz doğrudan Excel ile açmak yerine CSV to Excel aracıyla tablo düzenini koruyarak XLSX formatına dönüştürüp inceleyebilirsiniz.

Sık yapılan hatalar

• Hata: Barkod ve SKU sütunlarını ‘Genel’ veya ‘Sayı’ biçiminde bırakmak.
  Sonucu: Baştaki sıfırlar kaybolur (0541... -> 541...) veya 13 haneli barkodlar bilimsel nota (1,23E+12) dönüşür; ürünler eşleşmez.
  Çözümü: Sütunları düzenlemeye başlamadan önce tüm veri aralığını seçip hücre biçimlendirmesini ‘Metin’ (Text) olarak ayarlayın.
• Hata: Ürün açıklamalarında kapanmamış HTML etiketleri veya tırnak işaretleri bırakmak.
  Sonucu: CSV satır yapısı bozulur, sonraki sütunlar açıklama metninin içine kayar ve içe aktarma yarıda kesilir.
  Çözümü: Açıklama alanında çift tırnak (") kullanmaktan kaçının veya metinleri içe aktarmadan önce düz metin editöründe kontrol edin.
• Hata: Fiyat alanlarında binlik basamak ayracı ve para birimi kullanmak (örn: 1.250,50 TL).
  Sonucu: İçe aktarma motoru fiyatı tanıyamaz veya ürünü 1.25 TL gibi hatalı bir fiyatla yayına alır.
  Çözümü: Tüm para birimi sembollerini kaldırın; binlik ayracı kullanmayın ve kuruş ayrımı için yalnızca nokta (1250.50) kullanın.
• Hata: Görsel sütununa yerel bilgisayar klasör yolunu yazmak.
  Sonucu: E-ticaret sunucusu bilgisayarınıza erişemeyeceği için görseller yüklenemez ve boş ürün kartları oluşur.
  Çözümü: Görselleri bir CDN veya bulut depolama servisine yükleyip doğrudan erişilebilir HTTPS bağlantılarını dosyanıza ekleyin.
• Hata: Aynı varyant kombinasyonunu birden fazla satırda tekrarlamak.
  Sonucu: Sistem mükerrer varyant uyarısı verir ve dosyanın tamamını veya ilgili ürünü içeri almayı reddeder.
  Çözümü: Dosyayı içe aktarmadan önce SKU veya Handle + Seçenek sütunlarına göre filtreleyip mükerrer satırları ayıklayın.

Sık sorulan sorular

E-ticaret ürün yüklemelerinde CSV mi yoksa Excel formatı mı tercih edilmeli?
Çoğu e-ticaret altyapısı ve küresel platform için UTF-8 kodlamalı CSV dosyaları tercih edilmelidir. Bazı yerel pazaryerleri doğrudan .xlsx şablonları kabul etse de standart içe aktarma sistemlerinin evrensel standardı CSV formatıdır.

Barkod ve SKU sütunlarındaki baştaki sıfırlar Excel’de neden kaybolur?
Excel, başında sıfır bulunan hücreleri sayı olarak algıladığı için ‘0123’ değerini otomatik olarak ‘123’ sayısına çevirir. Bu sorunu önlemek için sütun biçimini genelden metne çevirmeli veya dosyanızı açarken metin içe aktarma sihirbazını kullanmalısınız.

Aynı ürüne ait birden fazla görsel CSV dosyasında nasıl tanımlanır?
Shopify gibi sistemlerde her ek görsel için ürünün temel tanıtıcısı (Handle) korunarak yeni bir satır açılır ve diğer varyant bilgileri boş bırakılarak yalnızca görsel URL’si eklenir. Bazı yerel pazaryerlerinde ise aynı satır içinde ‘Görsel 1’, ‘Görsel 2’ gibi ayrılmış sütunlar kullanılır.

Fiyat sütunlarında kuruş ayrımı için nokta mı yoksa virgül mü kullanılmalıdır?
Shopify, WooCommerce ve küresel e-ticaret yazılımları ondalık ayracı olarak yalnızca nokta (.) karakterini kabul eder. Türkiye ayarlarına sahip Excel tablolarından dışa aktarım yaparken virgülleri noktaya çevirmeniz ve binlik basamak ayracı kullanmamanız gerekir.

Sonuç

Kusursuz bir e-ticaret ürün dosyası hazırlamak; doğru şablon seçimi, titiz veri biçimlendirmesi ve standartlara uygun CSV dışa aktarımı gerektirir. SKU, fiyat ve varyant hiyerarşisini baştan doğru kurgulayarak hem ürün yükleme sürelerinizi saniyelere indirebilir hem de olası envanter karmaşalarının önüne geçebilirsiniz. Dosyalarınızı platform gereksinimlerine göre dönüştürmek, biçimlendirmek ve temizlemek için AREM Labs bünyesindeki tarayıcı tabanlı ücretsiz veri araçlarını güvenle kullanabilirsiniz.