Kod ve veri
Shopify ürün CSV hataları: yeniden içe aktarmadan dosyayı kontrol et
Shopify CSV dosyasındaki başlık, tırnak, varyant ve görsel bağlantısı sorunlarını ayır; değişiklikleri inceleyip küçük bir içe aktarımı dene.
Başlangıç kopyasını sakla ve hata türünü belirle
Düzenlemeden önce hata veren dosyanın aynısını ve güncel ürün dışa aktarımını kaydet. Hata mesajını, gösterilen satırı veya ürünü not et. Tamamlanmayan işlem, tamamlandığı hâlde yanlış değer veren işlem ve görünmeyen görsel farklı sorunlardır. Her şeyi aynı anda değiştirmek nedeni bulmayı zorlaştırır.
Shopify, eşleşen ürün tanımlayıcıları ve üzerine yazma seçeneklerine göre mevcut ürünleri güncelleyebilir. İçe aktarmayı zararsız dosya önizlemesi değil, mağaza değişikliği olarak düşün. Yeni ürün mü oluşturduğunu, seçili alanları mı güncellediğini belirle ve onay ekranını buna göre oku. Kataloğunun tek kopyasını çalışma dosyası yapma.
Teşhisi üçe ayır: CSV istenen sütunlara ayrışıyor mu; ürün ve varyant değerleri seçilen Shopify biçimine uyuyor mu; barındırılan görseller gibi dış bağımlılıklar çalışıyor mu? Yerel kontrol aracı ilk iki bölümde yardımcı olabilir. Mağazanın güncel durumunu veya uzak kaynakların erişilebilirliğini tek başına kanıtlayamaz.
Başlık değiştirmeden şablon sürümüne bak
Shopify’ın güncel ürün CSV belgesinde URL handle, Description, SKU ve Price gibi başlıklar bulunuyor. Eski dışa aktarımlarda Handle, Body (HTML), Variant SKU ve Variant Price görülebilir. Shopify eski başlıklara geriye dönük uyumluluk olduğunu belirtiyor. Başlıkları eski bir yazıdan kopyalamak yerine güncel belgeyle veya yeni dışa aktarımla karşılaştır.
Baştaki boşluklara, tekrar eden başlıklara, eksik ayıraca ve verinin ortasına yapıştırılmış başlık satırına bak. Ne işe yaradığını henüz anlamadığın sütunu koru. Özel metafield veya pazara özel fiyat sütunu yabancı görünse bile gerçek veri taşıyabilir. Basit kontrol aracı dosyayı düzenli göstermek uğruna bu alanları sessizce atmamalıdır.
KitForma Shopify CSV Düzeltici’de desteklenen kontrolleri oku; önerilen düzeltmeyi kabul etmeden bildirilen satırları incele. Sonucu kullandığın şablonla karşılaştır. Temiz rapor yalnız uygulanan kontrolleri kapsar; bütün Shopify özellikleri, metafield alanları veya envanter süreçlerinin doğrulandığı anlamına gelmez.
Güncel belge → yaygın eski başlık
URL handle → Handle
Description → Body (HTML)
SKU → Variant SKU
Price → Variant Price
Başlığı değiştirmeden seçilen şemayı kontrol et.Tırnak ve kodlama sorununu ürün verisinden ayır
Shopify, sütunları virgülle ayrılmış UTF-8 CSV bekler. Tabloda doğru görünen dosya başka ayraç veya kodlamayla dışa aktarılmış olabilir. Kaydedilen dosyayı metin düzenleyici veya ayrıştırıcıyla yeniden açıp gerçek çıktıya bak. Türkçe karakterlerin bozulması, ürün adlarını değiştirmeden önce kodlamayı araştırmak için iyi işarettir.
Bir alanın içindeki virgül CSV tırnaklaması gerektirir; tırnaklı alanın içindeki gerçek çift tırnak iki kez yazılır. Aşağıdaki örnek tam Shopify şablonu değil, ayrıştırma alıştırmasıdır. Hatalı satırdaki bütün virgülleri değiştirerek düzeltmeye çalışma; etiketleri, açıklamaları ve fiyatları bozabilirsin. Akıllı kıvrık tırnaklar da CSV’nin düz tırnak ayıracından farklıdır.
Tırnaklı açıklamalar satır sonu içerebilir. Bu nedenle metin düzenleyicideki satır numarası ayrıştırılmış kayıt numarasıyla aynı olmayabilir. Bildirilen kaydı ve komşularını incele. Genel CSV’den JSON’a aracı desteklediği düz CSV yapısını görmekte yardımcı olabilir; dosyayı iki biçim arasında çevirip durmak Shopify şemasını ve kimlikleri korumanın yerine geçmez.
Title,Tags
"Mug, blue","ceramic,gift"
"Print titled ""Morning""",wall-art
İç noktalama işaretlerine rağmen her örnek satır iki alandır.IETF RFC 4180: CSV quoting and records ↗Shopify: opening, editing and encoding CSV files ↗Shopify: common product import errors ↗
Varyant grubunu bütünüyle incele
Tekrarlanan ürün tanımlayıcısı her zaman yinelenen ürün değildir; varyant ve görsel satırları aynı ürüne ait olabilir. Tekrarlanan her tanımlayıcıyı silmek yerine seçenek birleşimlerini karşılaştır. Aynı tişörtün iki satırı farklı bedenler için aynı tanımlayıcıyı kullanabilir. Aynı beden ve rengin iki kez geçmesi ise incelenmelidir.
Shopify, belirli varyant güncellemelerinde seçenek sütunlarının gerekli olduğunu; bu durumda Option1 name ve Option1 value çıkarılırsa mevcut varyantların varsayılan varyantla değişebileceğini belirtiyor. Birbirine bağlı sütunları birlikte tut. Tekrar gibi göründüğü veya genel tablo temizliği öyle önerdiği için seçenek bilgisini kaldırma.
Örnek tişörtte Small / Blue ile Medium / Blue farklı birleşimlerdir. Small / Blue iki kere geçiyorsa hangisinin doğru olduğuna özgün katalogdan karar ver. Hata kaybolsun diye yeni seçenek değeri uydurma. SKU ve barkodlardaki baştaki sıfırları korumak için bu alanları tabloda metin olarak tut.
Aynı ürün tanımlayıcısı: cotton-shirt
Small / Blue → SHIRT-001
Medium / Blue → SHIRT-002
Small / Blue → tekrarlanan birleşimi inceleShopify: current product CSV columns and dependencies ↗Shopify: common product import errors ↗
Görselleri ve değerleri kaynağında kontrol et
Görsel bağlantısı Shopify’ın erişebileceği gerçek görüntüye gitmelidir. Bilgisayarındaki dosya yolu, oturum isteyen paylaşım sayfası veya bozuk bağlantı çalışan ürün görseli kaynağı değildir. Şüpheli adresi ayrı aç; web sayfası yerine amaçlanan resmi döndürdüğünü kontrol et. Biçimsel olarak geçerli URL, erişilebilirlik kanıtı sayılmaz.
Fiyat veya stok hatasında tüm sütunu körlemesine dönüştürme; ilgili hücreyi incele. Sayısal alana para birimi simgesi, açıklama veya yerel ondalık ayracı kopyalanmış olabilir. Amaçlanan değeri güncel sütun tanımıyla karşılaştır. Dosya kabul edilsin diye eksik satış fiyatını, teslim hizmetini veya stok sayısını tahmin etme.
Katalogdan önce küçük değişikliği dene
Düzeltilen dosyayı yeni adla kaydet. Başlıkları, ürün gruplarını, kayıt sayısını ve değişen değerleri başlangıç kopyasıyla karşılaştır. Metin Farkı değişiklikleri gösterebilir; çok satırlı CSV alanlarının satır tabanlı karşılaştırmayı zorlaştırdığını unutma. Yapısal onarım yaptıysan ayrıştırılmış kayıtları da kontrol et.
İlk kontrollü içe aktarım için küçük ama eksiksiz ürün grubu hazırla; üzerine yazma davranışını doğrula. Sonrasında Shopify’da ürün ayrıntılarını, varyantları, görselleri ve durumu incele. Sonuç niyetinle aynıysa kapsamı büyüt. KitForma’nın desteklediği yerel kontroller tarayıcıda çalışır; araç mağazaya giriş yapmaz, ürün yüklemez veya bütün satırların kabulünü garanti etmez.
- Hatalı dosyayı ve başlangıç dışa aktarımını sakla.
- Teşhis edilen tek sorunu düzeltip ayrı kopya oluştur.
- Değişen hücreleri ve tam ürün gruplarını incele.
- Mağaza ayarlarını bilerek küçük içe aktarım dene.
- Büyük dosyaya geçmeden sonucu kontrol et.
KITFORMA
Hemen uygula
Hesap gerektirmez. Rehberi oku, ardından ilgili araçla dene.
İleri okuma
Kaynaklar son kontrol edildi:
Bu rehberi nasıl kullanmalı?
KitForma tarafından yayımlanır; projenin sorumlusu Fatih Erkan’dır. Kaynak bağlantıları ilgili biçim ve tanımları açıklar. Örnek girdiler, kendi dosyaların için hız, kalite veya uyumluluk garantisi vermez. Aracın belirtilen sınırlarını oku ve indirdiğin sonucu kontrol et.
Sorular ve deneyimler
İşe yarayan bir yöntemi paylaş, soru sor veya düzeltme öner. Şifre, özel dosya ya da kişisel belge bilgilerini yazma.
Yorumlar yükleniyor…