Trendyol, Hepsiburada ve N11: stok ve fiyat güncelleme karşılaştırması

Üç pazaryerinde de stok ve fiyat güncellemesi asenkron çalışıyor ama kalem sınırları 1.000 ile 4.000 arasında değişiyor ve her birinin kendine özgü, isteği sessizce reddeden bir kuralı var.

Çok pazaryerli bir entegrasyonda en sık çalışan iş stok ve fiyat senkronizasyonu. Üçünün de deseni aynı: istek kabul edilir, işlem sonra yapılır, sonucu ayrıca sorgularsınız.

Benzerlik burada bitiyor. Tek bir “paket boyutu” ve tek bir gönderim mantığıyla üçüne birden gitmek, en az birinde verimsizliğe ya da sessiz hataya yol açıyor.

Tek bakışta

	Trendyol	Hepsiburada	N11
Tek istekte kalem	1.000	4.000	1.000
Takip kimliği	batchRequestId	Inventory Upload Id	taskId
Sonuç sorgulama	Toplu İşlem Kontrolü	Listing Güncelleme İşlem Kontrolü	Task Detail
Eşzamanlılık sınırı	—	En fazla 5 bekleyen işlem	—
Ürün kimliği	barcode	MerchantSku / HepsiburadaSku	stockCode

Her birinin kendi tuzağı

Trendyol: aynı isteği 15 dakika içinde tekrarlamayın

Trendyol, birebir aynı isteğin 15 dakika içinde yeniden gönderilmesini kabul etmiyor ve hata üretiyor.

Bunun mimari sonucu şu: her çalışmada tüm katalogu toptan göndermek işe yaramaz. Ürünlerin çoğunda hiçbir değer değişmediği için bu kontrole takılır ve kotanızı boşa harcarsınız. Bir önceki gönderimdeki değerleri yerelde tutup yalnızca değişenleri göndermeniz gerekir.

Ayrıca stok alanında üst sınır var: en çok 20.000 adet. Ayrıntısı Trendyol yazısında.

Hepsiburada: eşik dışı fiyat ürünü kilitler

Hepsiburada kategori bazlı fiyat eşikleri uyguluyor. Eşiğin dışında bir fiyat gönderirseniz SKU kilitlenir ve satıştan düşer — MaxLock ya da MinLock.

Yanıt kabul edilen minPrice / maxPrice bandını veriyor; kilidi Toplu Kilit Kaldırma API’si ile ya da panelden kaldırırsınız.

Bir de eşzamanlılık kuralı var: aynı anda en fazla 5 bekleyen işlem. Hepsiburada’nın kendi önerisi, bu limite takılmamak için tek seferdeki SKU adedini artırmak. Ayrıntısı Hepsiburada yazısında.

N11: ondalık biçimi ve fiyat çifti

N11’de üç kural isteği doğrudan FAIL’e düşürüyor:

• Fiyat güncellerken listPrice ve salePrice birlikte gönderilmeli.
• Ondalık ayracı nokta olmalı — Türkçe yerel ayarla çalışan bir sunucu virgül üretirse istek reddedilir.
• Küsurat tam iki hane olmalı.

listPrice, salePrice‘tan düşük olamaz. Ayrıntısı N11 yazısında.

Ortak nokta: HTTP 200 yeterli değil

Üçünde de başarılı yanıt, güncellemenin yapıldığı anlamına gelmiyor. İstek kuyruğa alınır; gerçek sonuç kalem bazında ayrı bir servisten okunur.

Üst seviyedeki duruma bakıp geçen bir entegrasyon, binlerce üründen bir kısmının güncellenmediğini hiç fark etmez. Doğru akış:

• Değişen kalemleri belirle — değişmeyeni gönderme.
• Pazaryerinin kalem sınırına göre paketle.
• Dönen takip kimliğini sakla.
• Birkaç dakika sonra sonucu sorgula.
• Kalem bazındaki durumları ve hata sebeplerini kontrol et.
• Başarısız kalemleri işaretle, yalnızca onları tekrar dene.

Hepsiburada’da ek bir imkân var: yanıt başlığındaki x-correlation-id ile isteğin durumunu son 7 güne kadar sorgulayabiliyorsunuz. Bu değeri loglamak, sonradan “o gönderime ne olmuştu” sorusunu cevaplamanın tek yolu.

Çok pazaryerli yazarken

• Paket boyutunu pazaryeri başına yapılandırın. Tek bir sabit, Hepsiburada’da kapasitenin dörtte birini kullanmanıza ve 5 işlem limitine takılmanıza yol açar.
• Sayı biçimlendirmesini merkezileştirin. N11 nokta ve iki hane istiyor; yerele duyarlı bir biçimlendirici sessizce virgül üretir.
• Ürün kimliği eşlemesini kendi tarafınızda tutun. Üçü üç farklı alan bekliyor — barkod ve stok kodu eşleştirme yazısı bu katmanı ele alıyor.
• Fiyat değişimlerine kendi sınırlarınızı koyun. Hepsiburada’da eşik dışı fiyat kilit üretiyor; otomatik fiyatlandırma varsa bu kaçınılmaz hâle gelir.
• Sonuç sorgulamayı baştan yazın. Sonradan eklenen kontrol kodu genelde hiç yazılmıyor.

Kimlik doğrulama tarafındaki farkları ayrı bir karşılaştırmada topladık; orada da her pazaryerinin kendine özgü bir kuralı var.

Kaynak

Trendyol bilgileri Stok ve Fiyat Güncelleme; Hepsiburada bilgileri geliştirici portalındaki Listeleme Entegrasyonu dokümanı; N11 bilgileri Ürün Fiyat-Stok Güncelleme sayfasından alınmıştır.

Son kontrol: 2 Kasım 2026. Üç pazaryeri de sınırlarını bağımsız olarak değiştirebilir.