Bu rehberde ele alınan temel konular
  • Katalog ürünü ile satıcı listelemesini birbirinden ayırın.
  • Tracking ID ve listeleme güncelleme ID’si üzerinden gerçek sonucu sorgulayın.
  • Kategori özellikleri, barkod, merchantSku, görsel, fiyat ve stok formatlarını kontrol edin.
  • 0 fiyat–0 stok oluşan listelemeleri yalnızca panelden değil entegrasyon kaydından düzeltin.

Hepsiburada ürün reddedildi hatası neden oluşur?

Ürün reddi; katalog içeriğinin kategori kurallarına uymaması, zorunlu özelliğin eksik olması, barkod veya merchantSku çakışması, uygun olmayan görsel, fiyat-stok formatı veya listeleme güncellemesinin başarısız olması nedeniyle oluşabilir. Sorunu çözmek için önce reddin katalog aşamasında mı, listeleme aşamasında mı gerçekleştiğini belirlemek gerekir.

Hepsiburada geliştirici portalı, katalog ürün entegrasyonu ile ürün içeriğinin; listeleme entegrasyonu ile stok, fiyat ve kargoya veriliş süresinin yönetildiğini açıklar. Dolayısıyla “ürün onaylandı ama satışta yok” sorunu çoğu zaman listeleme tarafındadır.

Katalog ürünü ile listeleme arasındaki fark

Katalog ürünüÜrün adı, marka, kategori, barkod, özellikler, açıklama ve görseller
Satıcı listelemesiMerchantSku, fiyat, stok, kargoya veriliş süresi ve satış durumu

Katalog kabul edilmiş olsa bile listeleme 0 stok veya 0 fiyatla oluşabilir. Tersi durumda listeleme verisi hazır olsa bile katalog içeriği inceleme veya red durumundaysa ürün satışa çıkmaz.

“Değer uygun formatta değildir” uyarısı ne demektir?

Hepsiburada’nın resmî katalog ürün entegrasyonu rehberinde, fiyat veya stok formatı hatalıysa listeleme kaydının 0 fiyat ve 0 stokla oluşturulabileceği belirtilir. Bu durumda ürün içeriği başarılı görünse bile satışa açılmaz.

Kategori ve zorunlu özellikleri kontrol edin

Kategori seçimi ürünün hangi alanları beklediğini belirler. Yanlış kategori, zorunlu özelliklerin eksik görünmesine veya gönderilen değerlerin reddedilmesine neden olur. Kategori özellik şeması güncellenebildiği için yerel eşleme tabloları düzenli yenilenmelidir.

  • Doğru ve en uygun kategori seçildi mi?
  • Zorunlu özelliklerin tamamı gönderiliyor mu?
  • Değerler beklenen tipte mi: metin, sayı, seçim veya birim?
  • Varyant özellikleri aynı ürün ailesinde tutarlı mı?
  • Marka kaydı katalogdaki marka ile eşleşiyor mu?
  • Eski kategori eşlemesi güncel şemayla karşılaştırıldı mı?

Barkod ve merchantSku çakışmalarını bulun

Barkod katalog ürününün kimliğini, merchantSku ise satıcının listeleme kimliğini yönetir. Aynı merchantSku’nun başka ürüne bağlı olması veya barkodun farklı ürün için kullanılması yanlış güncelleme ve red oluşturabilir.

Merkez sistemde ürün kodu değiştirildiğinde eski listeleme kaydı unutulmamalıdır. Yeni SKU ile ikinci kayıt açmak yerine mevcut katalog/listing ilişkisi doğrulanmalıdır.

Görsel ve içerik reddi nasıl incelenir?

Ürün görselleri erişilebilir, yeterli çözünürlükte ve ürünü doğru göstermelidir. Bozuk URL, erişim engeli, aşırı filigran, farklı ürün görseli veya yinelenen düşük kaliteli görseller inceleme sorununa yol açabilir. Başlık, açıklama ve marka bilgisi de görselle çelişmemelidir.

Görsel URL’sini yalnızca tarayıcıda açmak yeterli değildir. Hepsiburada sunucularının erişebilmesi için oturum, referer veya IP kısıtı olmamalıdır.

Fiyat, stok ve kargoya veriliş süresi formatı

Fiyat ve stok alanlarında metin biçimi, ondalık ayırıcı veya negatif değer gibi hatalar listelemeyi kapatabilir. Fiyatın sıfırdan büyük, stok bilgisinin geçerli tam sayı ve kargoya veriliş süresinin desteklenen değer aralığında olması gerekir.

AlanYanlış örnekDoğru yaklaşım
Fiyat"1.299,90 TL"API’nin beklediği sayısal formatı gönderin
Stok"10 adet"Yalnızca geçerli sayısal miktar gönderin
MerchantSkuBaşka üründe kullanılan kodHer listeleme için benzersiz ve kalıcı kod kullanın
Kargoya verilişDesteklenmeyen metinDokümandaki alan tipi ve aralığa uyun

Tracking ID ve güncelleme sonucunu sorgulayın

Toplu ürün veya listeleme isteğinde dönen kimlik, işlemin son durumunu takip etmek için saklanmalıdır. Hepsiburada sık sorulan sorular bölümünde fiyat-stok güncellemesi yansımadığında, dönen ID üzerinden listeleme güncelleme sorgulama servislerinden durum ve uyarıların kontrol edilmesini önerir.

  1. İstek gövdesi ve gönderim zamanını kaydedin.
  2. Dönen tracking veya işlem ID’sini ürünle ilişkilendirin.
  3. İşlem tamamlandıktan sonra sonucu sorgulayın.
  4. Ürün bazlı hata ve uyarıları ayrı kuyruğa yazın.
  5. Düzeltme sonrası yalnızca başarısız ürünleri yeniden gönderin.
  6. Listeleme sorgusuyla fiyat, stok ve satış durumunu tekrar okuyun.

Hepsiburada ürün reddi neden–çözüm tablosu

BelirtiMuhtemel nedenÇözüm
Katalog reddedildiEksik kategori özelliği veya içerik uyumsuzluğuKategori şemasını yenileyip zorunlu alanları tamamlayın
Ürün onaylı, satışta değilListeleme 0 fiyat veya 0 stokFiyat-stok formatını düzeltip listing güncellemesi gönderin
Güncelleme yansımadıİşlem sonucu sorgulanmadıDönen ID ile uyarı ve ürün bazlı sonucu kontrol edin
Yanlış ürün güncelleniyorMerchantSku eşleşmesi bozukMerkez SKU ile listeleme kodunu yeniden eşleyin
Görsel alınamıyorURL dış erişime kapalıKalıcı HTTPS URL ve herkese açık erişim sağlayın
Varyantlar birleşmiyorÜrün ailesi ve varyant özellikleri tutarsızAynı ailede ortak alanları ve varyant ayrımını düzeltin

Ürünü düzeltip yeniden gönderirken dikkat edin

Bütün kataloğu tekrar göndermek yerine hata alan ürünleri hedefleyin. Aksi hâlde onaylı ürünlerde gereksiz güncelleme kuyruğu ve yeni çakışmalar oluşabilir. Düzeltme öncesi eski merchantSku, barkod ve katalog ilişkisini koruyun.

Hangi durumda teknik destek gerekir?

  • Tracking sonuçları sistemde tutulmuyor veya kullanıcıya gösterilmiyorsa
  • Kategori şeması ve özellik eşlemeleri toplu olarak bozulduysa
  • Ürün onaylı olduğu hâlde listing sürekli 0 fiyat–0 stok oluyorsa
  • MerchantSku başka ürünlerle çakışıyorsa
  • Görsel sunucusu dış erişim veya sertifika hatası veriyorsa
  • Binlerce başarısız ürünün güvenli biçimde yeniden gönderilmesi gerekiyorsa

Sık sorulan sorular

Katalog başarılıysa ürün kesin satışa açılır mı?

Hayır. Listelemenin geçerli fiyat, stok ve diğer satış alanlarına sahip olması gerekir.

0 stokla oluşan listeleme ürün reddi midir?

İçerik başarılı olabilir; fakat listeleme satışa kapalı kalır. İşlem uyarısı ve listing alanları kontrol edilmelidir.

Panelden fiyat yazmak kalıcı çözüm müdür?

Entegrasyon eski veya hatalı veriyi yeniden gönderiyorsa paneldeki manuel değer tekrar değişebilir.

Hepsiburada red ve listeleme hatalarını çözün

Katalog, tracking sonucu, merchantSku ve listeleme alanlarını birlikte inceleyerek satışa açılmayan ürünleri güvenli biçimde yeniden işleyelim.

E-Ticaret ve Entegrasyon Paketlerini İnceleyin