N11 Zorunlu Kategori Özellikleri Nasıl Eşleştirilir?

Kısa cevap

N11'de zorunlu özellikler kategoriye göre değişir. Bu nedenle sabit bir özellik listesiyle tüm ürünleri göndermek yerine seçilen kategoriye ait güncel özellikler çekilmeli ve required alanlar ürün verisiyle eşleştirilmelidir.

N11 Zorunlu Kategori Özellikleri Nasıl Eşleştirilir? neden önemli?

Ayakkabı kategorisinde beden zorunluyken farklı kategoride başka teknik alanlar zorunlu olabilir. Kategori değiştiğinde eski özellik eşleştirmesi geçersiz hale gelebilir.

Hata çözümünde ilk adım aynı isteği tekrar göndermek değil, hatayı sınıflandırmaktır. Veri hatası, iş kuralı, geçici ağ sorunu ve asenkron bekleme durumu farklı müdahale gerektirir.

2026 itibarıyla pazaryerleri katalog ve sipariş servislerini düzenli olarak güncelliyor. Bu nedenle entegrasyon kararını yalnız bir kez yapılan kurulum gibi değil, izlenen ve güncellenen bir operasyon sistemi gibi ele almak daha sağlıklıdır.

Doğru çalışma mantığı nasıl kurulmalı?

Teşhis sırası yerel validasyon → gönderilen payload → HTTP/API yanıtı → batch/task sonucu → canlı kanal kontrolü şeklinde olmalıdır. Bu sıra, kullanıcının gördüğü belirti ile gerçek kök nedeni birbirinden ayırır.

Karşılaştırma yaparken özellik var/yok tablosu tek başına yeterli değildir. Aynı özelliğin limit, güncelleme sıklığı, kanal kapsamı ve destek biçimi farklı olabilir. Bu ayrıntıları yazılı hale getirmek yanlış paket seçim riskini düşürür.

Adım adım uygulama planı

Ürünün doğru N11 kategorisini kesinleştirin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Kategori özelliklerini ve zorunlu alan bilgisini API/entegrasyon üzerinden güncel çekin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Kaynak ürün alanlarını N11 özellik değerleriyle eşleştirin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Serbest metin yerine sözlük değeri gerekiyorsa geçerli seçenek kimliğini kullanın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Toplu gönderim öncesi required alanları yerel validasyondan geçirin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Eksik ürünleri gönderim kuyruğuna almadan kullanıcıya gösterin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Kategori değişikliklerinde özellik eşleştirmesini yeniden doğrulayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.

Kontrol ve ölçüm noktaları

Aynı hata kodunun tekrar sayısı, hata alan SKU sayısı, ilk hata ile çözüm arasındaki süre ve yeniden deneme başarısı izlenmelidir. Tekrarlayan hatalar için otomatik ön kontrol eklemek destek yükünü azaltır.

İşlem hangi mağaza ve kanal için çalıştı?
Yerel SKU/barkod ile uzak ürün kimliği eşleşiyor mu?
Son durum ilk API yanıtından mı, nihai sonuç servisinden mi geliyor?
Başarısız işlem için kullanıcıya anlaşılır hata nedeni gösteriliyor mu?
Tekrar deneme mükerrer ürün veya sipariş oluşturmadan çalışıyor mu?
Canlı kanalda örnek ürün/sipariş ile sonuç doğrulandı mı?

Sık yapılan hatalar ve düzeltme yaklaşımı

Bir kategoride çalışan özellik setini tüm kategorilere uygulamak.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

Zorunlu alanı arayüzde gizlemek.

Kategori değeri değiştiği halde eski özellik ID'lerini göndermek.

API hatasını kullanıcıya hangi alanın eksik olduğunu söylemeden göstermek.

2026 için güncellik notları

Pazaryeri API dokümanları, endpoint sürümleri, zorunlu alanlar ve işlem limitleri zaman içinde değişebilir. Bu yazıdaki operasyon mantığını uygularken ilgili kanalın güncel geliştirici veya satıcı destek dokümanını esas alın. Özellikle ürün oluşturma, toplu güncelleme ve sipariş durum servislerinde sürüm notlarını takip etmek gerekir.

Canlı sistemlerde değişiklik yapmadan önce küçük ürün grubu, düşük riskli stok-fiyat değeri ve test edilebilir sipariş senaryosu kullanmak; geniş kataloğa geçmeden önce hata davranışını görmeyi sağlar.

3E Entegrasyon tarafında hangi akışlar değerlendirilebilir?

3E Yazılım’ın pazaryeri entegrasyonu sayfasında XML, Excel, manuel ürün ekleme, desteklenen bağlantılardan ürün alma, tekil/toplu ürün gönderimi, kategori-özellik eşleştirme, stok-fiyat senkronizasyonu ve sipariş takibi gibi operasyon başlıkları yer alıyor. İhtiyacınız bu akışlardan biriyse önce gerçek ürün verinizle demo senaryosu oluşturmak en sağlıklı karşılaştırma yöntemidir.

Pazaryeri entegrasyonu özelliklerini inceleyin veya demo talebi oluşturun.

Sık sorulan sorular

Zorunlu özellikler neden değişir?

Ürünün kategorisine ve N11 katalog kurallarına göre farklı alanlar zorunlu olabilir.

Özellikler bir kez eşleştirilince kalıcı mı?

Kategori şemaları değişebileceği için periyodik güncelleme ve doğrulama gerekir.

Toplu gönderimden önce kontrol yapılabilir mi?

Evet. Required alanlar yerel validasyonla kontrol edilerek hatalı satırlar gönderimden önce ayrılabilir.

Resmî ve güvenilir kaynaklar

N11 Mağaza Destek SSS