N11 Marka Bulunamadı ve Marka Eşleştirme Hatası

Kısa cevap

Kaynak sistemde marka adının bulunması, N11 tarafında geçerli marka eşleşmesi olduğu anlamına gelmez. Marka metni normalize edilmeli ve N11'in kabul ettiği marka kaydı/kimliğiyle eşleştirilmelidir.

N11 Marka Bulunamadı ve Marka Eşleştirme Hatası neden önemli?

Tekil ekranda kullanıcı markayı manuel seçtiği için ürün giderken toplu gönderimde 'Tilta markası yok' benzeri hata görülebilir. Bu durumda otomatik marka eşleştirme katmanı eksiktir.

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ı

Kaynak marka alanındaki boşluk, büyük-küçük harf ve özel karakterleri normalize edin. 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.
N11 marka listesini güncel olarak ç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.
Kesin eşleşme bulunan markayı yerel eşleştirme tablosuna kaydedin. 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.
Birden fazla aday varsa otomatik seçim yerine kullanıcı onayı isteyin. 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.
Tekil gönderimde seçilen marka ID'sinin toplu akışta da kullanıldığını 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.
Eşleşmeyen markaları ayrı raporlayı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.
Düzeltme sonrası yalnız ilgili ürünleri yeniden gönderin. 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ı

Marka adını doğrudan API alanına yazıp geçerli kimlik beklememek.

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.

Benzer isimli iki markayı otomatik birleştirmek.

Eski marka listesini aylarca yenilememek.

Tekil ekranın manuel seçimini toplu işlemin de bildiğini varsaymak.

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

Marka adı doğruysa neden hata olur?

Pazaryeri geçerli marka kaydı veya ID bekleyebilir; metin birebir aynı görünse bile eşleştirme gereklidir.

Toplu gönderimde marka otomatik seçilebilir mi?

Önceden doğrulanmış marka eşleştirme tablosu varsa güvenli biçimde otomatikleştirilebilir.

Marka N11'de hiç yoksa ne yapılır?

N11'in güncel marka oluşturma/onay süreci izlenmeli; sahte veya yakın marka eşleştirmesi yapılmamalıdır.

Resmî ve güvenilir kaynaklar

N11 Mağaza Destek SSS