Qando

Ürün Eşleşmeme Sorunu

Pazaryeri ürünü ile Qando varyantı eşleşmediğinde manuel eşleştirme, barkod sorunları.

Belirti

Pazaryeri ürün sync'i çekiyor ama Qando'da:

  • Ürün ayrı bir kayıt olarak oluşturulmuş (sizin manuel oluşturmadığınız)
  • Stok rakamı eşleşmiyor
  • PRODUCT_MATCHED bildirimi gelmemiş

Eşleşme mantığı

Qando, sync'lediği her pazaryeri ürününü mevcut varyantlarla eşleştirmeye çalışır:

  1. Barkod eşleşmesi (en yüksek öncelik)
  2. SKU eşleşmesi
  3. Ürün başlığı + marka (fuzzy match)

Eşleşme bulunursa:

  • Mevcut varyant güncellenir (stok, fiyat sync)
  • PRODUCT_MATCHED bildirimi tetiklenir

Eşleşme bulunmazsa:

  • Yeni bir ürün oluşturulur (Qando otomatik)
  • Sizin manuel oluşturduğunuz ürünle ilişki kurulmaz

Yaygın sebepler

1. Barkod farklı

  • Qando varyantınızda: 8690123456789
  • Pazaryeri ürününde: 869-0123456-789 (tire ile)

Çözüm: Barkodları aynı formata getir.

2. Barkod yok

  • Qando varyantınızda barkod boş
  • Pazaryeri ürünü zaten unique tanım yapamıyor

Çözüm: Varyantınıza barkod ekle.

3. SKU farklı

  • Manuel oluşturduğunuz: TSHIRT-WHT-M
  • Pazaryeri ürününde: tshirt_white_m veya pazaryeri kendi kodu

Çözüm: SKU'yu aynı yap (genelde sizinki referans alınır).

4. Başlık çok farklı

  • Sizin: "Bambu Tişört Beyaz Medium"
  • Pazaryeri: "Beyaz Bambu T-shirt M Beden"

Fuzzy match çalışsa bile uzaktan başlıklar eşleşmiyor.

Çözüm: Barkod veya SKU eşle.

Manuel eşleştirme

İki ayrı oluşmuş varyantı birleştirme:

  1. Sol menü Ürünler > Manuel Eşleştirme.
  2. Sol panel: pazaryerinden gelen, eşleşmemiş ürünler.
  3. Sağ panel: Qando'daki mevcut varyantlar.
  4. Sürükle-bırak ile eşleştir.
  5. Birleştir butonuna bas.

Birleştirme sonrası:

  • Pazaryeri verisi mevcut varyanta bağlanır
  • Otomatik oluşturulmuş "duplicate" ürün soft-delete edilir
  • Sonraki sync'lerde otomatik eşleşir

Otomatik birleştirme

Çok sayıda eşleşmemiş varyant varsa toplu eşleştirme aracı:

  1. Ürünler > Manuel Eşleştirme > Otomatik Eşleştir.
  2. Sistem fuzzy match ile çiftler önerir (güven skoru ile).
  3. %90+ skorları otomatik kabul et seçeneği var.
  4. Diğerlerini tek tek incele.

Eşleşme kontrolü

Eşleşme başarılı mı kontrol etmek için:

  1. Varyant detay sayfasında Pazaryeri Bağlantıları bölümü
  2. Hangi pazaryerinde hangi ürün ID ile eşleştiği listelenir
  3. Eşleşmedi ise burası boş gözükür

HB veri kalitesi uyarısı

Hepsiburada bazı endpoint'lerden eksik veri verir:

  • Avantajlı Ürün sayfasında stok=0
  • Kendi Kampanyan sayfasında fiyat=0
  • Variant alanı ? olarak gelir

Bu HB tarafı problemidir; Qando bunu PRODUCT_MATCHED bildirimi ile size haber verir. Manuel düzeltme gerekir.

Yaygın sorunlar

  • Eşleştirdim ama sync hala iki ayrı kayıt oluşturuyor → Manuel eşleştirme sonrası soft-delete edilmemiş ürün hâlâ duruyor; destek
  • PRODUCT_MATCHED bildirimi gelmedi → Eşleşme yapılmadı; manuel eşleştirme yap
  • Otomatik eşleştirme çok yanlış öneri veriyor → Başlıklarınız çok genel; daha spesifik isim ver

Sonraki adım