Ne işe yarar?
Şablona uygun JSON ile çoklu ürün yükleme.
Neden önemli?
Katalog göçlerinde hız kazandırır.
Detaylı açıklama
FastEntegre’de ürün yaşam döngüsü iki aşamalıdır: içe aktarma (GET) ürünü panele alır; publish kayıtlı ürünü platform API’sine gönderir. İkisi farklı limit ve hata profiline sahiptir.
Toplu JSON, şablondaki alan adlarıyla (SKU, barkod, fiyat, kategori, görsel URL…) çoklu ürün oluşturur veya günceller. Sözdizimi hatası tüm dosyayı düşürür; alan hatası satır numarasıyla döner. Önce 2–3 SKU’luk dosya ile şemayı doğrulayın. Büyük dosyalar kuyruğa alınabilir — bitmeden ikinci yükleme yapmayın.
Ön koşullar
- PIM’de en az bir kategori ve (gerekiyorsa) marka tanımı.
- Hedef pazaryeri için mağaza bağlantısı.
Adımlar (Menü > Ürünler > Toplu JSON)
- Örnek şablonu indirin.
- SKU, barkod, fiyat ve kategori alanlarını doldurun.
- Dosyayı yükleyin; hata satır numarasını düzeltip tekrar gönderin.
- Örnek şablonu indirin; alan adlarını Türkçe başlıkla değiştirmeyin.
- SKU ve barkodun benzersiz olduğundan emin olun.
- Dosyayı yükleyin; hata satır numarasını düzeltip yalnızca hatalı partiyi tekrar gönderin.
- İçe aktarma sonrası rastgele 5 kartı açıp kategori ve görseli kontrol edin.
İçe aktarma kanalları
Form, JSON toplu yükleme, XML feed, link ile çekme ve pazaryerinden içe aktarma farklı senaryolara uygundur. Büyük kataloglarda önce küçük bir SKU seti ile şema doğrulaması yapın.
Güncelleme vs oluşturma
Aynı SKU tekrar gelirse kart güncellenir (kanal ayarına bağlı). Yanlışlıkla tüm katalog fiyatını sıfırlamamak için önce dar filtreli dosya kullanın. Stok kolonunu boş bırakmak sıfır yazmak anlamına gelebilir — şablon açıklamasını okuyun.
Kontrol listesi
- Kategori eşlemesi tamam.
- Zorunlu özellikler dolu.
- Görseller platform kurallarına uygun.
- Barkod ve stok doğru varyantta.
Sık karşılaşılan hatalar
- Tüm satırlar hata — JSON sözdizimi ve zorunlu alan adlarını şablonla karşılaştırın.
- Tüm satırlar hata — JSON sözdizimi (virgül, tırnak) ve zorunlu alan adlarını şablonla karşılaştırın. UTF-8 kaydedin.
- Kısmi başarı — Logdaki satır numaralarını Excel’de işaretleyip küçük partiyle tekrar yükleyin.
Sık sorulan sorular
Excel’i JSON’a nasıl çeviririm?
Şablonu koruyarak dönüştürün. Ham .xlsx yükleme bu ekranın işi değildir.
Görseller URL mi dosya mı?
JSON’da genelde URL. Dosya yükleme görsel ekranındandır; erişilebilir HTTPS kullanın.
İlgili rehberler
- Publish öncesi kontrol listesi
- Publish hata mesajları
- Kategori ve marka eşleme
- XML feed entegrasyonu
- Ürün içe aktarma ile publish farkı
Hâlâ çözülmedi?
- Destek talebi açın — kısa başlık, ana mağaza ID, mağaza adı, ekran görüntüsü ve tam hata metnini ekleyin.
- WhatsApp: 0850 242 32 78 (mesai saatleri içinde yanıt verilir).
- Sipariş veya fatura tamamen durduysa Acil: sipariş veya fatura kesilemiyor makalesindeki kontrol listesini uygulayın.