Bu rehberde ele alınan temel konular
  • Tek bir ana stok kaynağı belirleyin ve kanalları bu kaynaktan besleyin.
  • Her pazaryeri listelemesini yerel SKU, barkod ve varyantla kalıcı eşleştirin.
  • Açık sipariş rezervi ve güvenlik stoğunu satılabilir miktardan düşün.
  • API kabul cevabını başarı sanmayın; batch sonucu ve periyodik stok mutabakatı yapın.

Trendyol, Hepsiburada ve N11 stokları tek panelden nasıl yönetilir?

Tek panel stok yönetimi, bir ürünün merkezde hesaplanan satılabilir miktarını her pazaryerindeki doğru listelemeye gönderen ve sonuçlarını izleyen yapıdır. Panelde görünen “stok 12” değerinin hangi depolardan, rezervlerden ve güvenlik payından oluştuğu bilinmelidir.

Kanallar arasında doğrudan kopyalama yapılırsa hata zinciri oluşur. Trendyol’daki 8 adet stoğu Hepsiburada’ya, oradan N11’e taşımak yerine ERP, depo sistemi veya e-ticaret paneli ana kaynak seçilmeli; tüm kanallar aynı hesaplanan değerden beslenmelidir.

Önce merkezi stok kaynağını belirleyin

Fiziksel mağaza, depo, ERP ve e-ticaret sitesi aynı ürünü etkileyebilir. Bu sistemlerden hangisinin ana stok kaynağı olduğu belirlenmeden çok kanallı stok yönetimi kurulamaz.

SenaryoÖnerilen ana kaynakNot
Tek depo, yalnızca online satışE-ticaret/pazaryeri paneliBasit rezerv ve sipariş akışı yeterli olabilir
Mağaza ve depo birlikteERP veya merkezi stok sistemiMağaza satışları da anlık düşmelidir
Çok depo ve şubeERP/WMSLokasyon bazlı satılabilirlik gerekir
Tedarikçi XML stoğuKurallı entegrasyon motoruTedarikçi stoğu doğrudan kanal stoğu olmamalı

Ana kaynak dışında yapılan manuel stok değişiklikleri ya engellenmeli ya da belirli süre sonra merkezden ezileceği kullanıcıya açıkça gösterilmelidir.

SKU, barkod ve varyant eşleştirmesi

Aynı ürün farklı pazaryerlerinde farklı ürün ve listeleme kimliklerine sahip olabilir. Güncelleme yalnızca ürün adına göre yapılırsa benzer isimli ürünler veya renk-beden varyantları karışabilir.

Yerel kimlikÜrün ve varyantın paneldeki değişmez kimliği.
SKUİşletmenin stok kodu; mümkünse kanallarda tutarlı kullanılmalı.
Barkod/GTINVaryantı ayıran ürün tanımlayıcı.
Kanal kimliğiTrendyol barkodu, Hepsiburada merchant SKU veya N11 ürün kimliği.
Mağaza hesabıAynı kanalda birden fazla mağaza varsa zorunlu ayrım.
Son senkronizasyonGönderilen ve kanalda görülen son miktar.

Eşleşmeyen ürün otomatik olarak yakın isimli başka ürüne bağlanmamalıdır. “Eşleşme bekliyor” kuyruğuna alınmalı ve stok güncellemesi durdurulmalıdır.

Satılabilir stok nasıl hesaplanır?

Fiziksel miktar ile pazaryerine gönderilecek miktar aynı olmayabilir. Genel hesap şu bileşenlerden oluşur:

Örnek hesapFiziksel stok 20 − açık sipariş rezervi 5 − güvenlik stoğu 2 − hasarlı/bloke 1 = pazaryerlerinde dağıtılabilir 12 adet.

Birden fazla kanal aynı 12 adedi satıyorsa toplamda 36 adet varmış gibi düşünülmemelidir. Her kanal aynı merkez stoğu paylaşır ve herhangi bir kanalda sipariş oluştuğunda merkez rezervi hemen düşürülür.

Tedarikçi stoğuna pay bırakın

XML veya tedarikçi API’sinden gelen 10 adet stok doğrudan 10 olarak yayınlanmamalıdır. Tedarik gecikmesi, başka bayilerin satışı ve veri yenileme aralığı için güvenlik payı kullanılabilir.

Kanal bazlı stok kuralları

Her pazaryerine aynı miktarı göndermek zorunlu değildir. İşletme belirli kanala maksimum stok, minimum yayın eşiği veya satış payı tanımlayabilir.

  • Stok 3’ün altındaysa tüm kanallarda 0 göster.
  • Yeni mağazada riski azaltmak için en fazla 5 adet yayınla.
  • Belirli marka veya kategoriyi bir kanalda kapat.
  • Ön sipariş ürünlerinde gerçek stok yerine teslim süresi kuralı kullan.
  • Fiyat veya listeleme hatası olan ürüne stok gönderme.

Bu kurallar ürün, kategori, marka, depo veya kanal seviyesinde tanımlanabilir; hangi kuralın son miktarı değiştirdiği kayıt ekranında görünmelidir.

API ve kuyruk mimarisi nasıl olmalıdır?

Stok değişikliği olduğunda her kanala doğrudan aynı web isteği içinde bağlanmak paneli yavaşlatır ve tek kanal arızasında tüm işlemi durdurur. Bunun yerine kanal bazlı kuyruk kayıtları oluşturulmalıdır.

  1. Merkez stok değişikliği kaydedilir.
  2. Satılabilir miktar kurallarla hesaplanır.
  3. Her kanal için güncelleme işi oluşturulur.
  4. İşler API limitlerine uygun gruplar hâlinde gönderilir.
  5. Kanalın işlem/batch kimliği kaydedilir.
  6. Asenkron sonuç sorgulanır.
  7. Başarılı miktar ve hata nedeni ürün kartına yazılır.

Trendyol’un güncel stok ve fiyat servisi toplu kayıt göndermeyi destekler ve başarılı istekte batch süreci izlenir. Trendyol stok ve fiyat güncelleme belgesi istek sınırlarını; batch sonucu belgesi ise kayıt bazlı hata sonuçlarını açıklar.

Hepsiburada geliştirici portalı listeleme entegrasyonunun stok, fiyat ve kargoya veriliş süresini güncellemek için kullanıldığını belirtir. N11 tarafında ise resmî servis tanımları API servisleri üzerinden sunulur. Üretimde kullanılacak güncel endpoint ve yetkiler mağaza hesabı dokümantasyonundan doğrulanmalıdır.

Sipariş rezervi ve yarış koşulları

Aynı ürün son bir adetken iki farklı kanalda saniyeler içinde sipariş alabilir. Sipariş yalnızca periyodik çekiliyorsa her iki kanal da ürünü satabilir. Riski azaltmak için sipariş geldiği anda merkez stokta atomik rezerv oluşturulmalıdır.

  • Sipariş/paket kimliğini tekil kaydedin.
  • Aynı sipariş tekrar geldiğinde ikinci kez stok düşmeyin.
  • İptalde rezervi kontrollü biçimde geri bırakın.
  • Ödeme bekleyen sipariş için kanalın rezerv davranışını bilin.
  • Son adetlerde tüm kanalları hızlıca sıfırlayan öncelikli kuyruk kullanın.

Periyodik stok mutabakatı neden gerekir?

API’ye “stok 12” gönderilmiş olması kanalda mutlaka 12 göründüğü anlamına gelmez. Listeleme kapalı olabilir, işlem reddedilmiş olabilir veya sonraki manuel değişiklik değeri bozabilir. Bu nedenle belirli aralıklarla kanaldaki gerçek stok geri okunmalı ve merkezle karşılaştırılmalıdır.

Mutabakat sonucuİşlem
Merkez ve kanal eşitKayıt başarılı olarak işaretlenir
Kanal daha yüksekAcil güncelleme gönderilir, manuel değişiklik araştırılır
Kanal daha düşükListeleme veya kanal rezervi kontrol edilir
Kanal ürünü bulunamadıEşleşme/listelenme durumu hata kuyruğuna alınır
API geçici kapalıSon başarılı değer korunur, artan aralıkla tekrar denenir

Panelde hangi hata bilgileri görünmelidir?

“Senkronizasyon başarısız” tek başına yeterli değildir. Kullanıcı ürün, kanal, gönderilen miktar, kanal cevabı, işlem kimliği, deneme sayısı ve son başarılı zamanı görebilmelidir.

GönderilecekYeni merkez miktarı kuyrukta.
Kanala gönderildiİşlem/batch kimliği alındı.
BaşarılıKanal sonucu kabul edildi ve mutabakat yapıldı.
Müdahale gerekiyorEşleşme, listeleme veya yetki hatası otomatik çözülemiyor.

Yaygın sorunlar ve çözüm yönü

BelirtiMuhtemel nedenKontrol
Bir kanalda stok güncel, diğerinde eskiKanal kuyruğu durmuş veya API isteği reddedilmişSon işlem kimliği ve hata cevabı
Stok sürekli eski değere dönüyorİki farklı sistem aynı alanı ana kaynak sanıyorERP, panel ve manuel güncelleme yetkisi
Varyantların stoğu karışıyorÜrün seviyesinde eşleşme yapılmışSKU/barkod ve varyant kanal kimliği
Son ürün iki kanalda satıldıSipariş rezervi gecikmeli veya atomik değilSipariş çekme sıklığı ve rezerv işlemi
API başarılı ama kanal stoğu değişmediAsenkron batch sonucu kontrol edilmediBatch kayıt bazlı sonuç ve mutabakat

Ne zaman teknik destek gerekir?

Birden fazla mağaza hesabı, depo, ERP, XML tedarikçisi veya şube kullanılıyorsa; son adetlerde çift satış yaşanıyorsa; yüzlerce ürün hata kuyruğunda kalıyorsa veya kanal stokları sürekli geri dönüyorsa veri kaynağı ve kuyruk mimarisi birlikte incelenmelidir. Sorun yalnızca API çağrısı değil, ürün kimliği ve stok sahipliği tasarımı olabilir.

Sık sorulan sorular

Stok güncellemesi kaç dakikada bir yapılmalıdır?

Satış hacmi ve kanal limitlerine göre değişir. Sipariş rezervi mümkün olduğunca hızlı, tam stok mutabakatı ise daha seyrek çalıştırılabilir.

Her pazaryerine farklı stok gönderebilir miyim?

Evet. Kanal limiti, güvenlik stoğu ve kategori kuralı uygulanabilir; ancak tüm miktarlar aynı merkezi gerçek stoktan türetilmelidir.

Manuel stok değişikliği yapılabilir mi?

Yapılabilir fakat merkez sistemin bu değeri ne zaman yeniden yazacağı açık olmalıdır. Kalıcı manuel düzeltme merkez kaynaktan yapılmalıdır.

Pazaryeri stoklarını tek merkezde birleştirin

Trendyol, Hepsiburada ve N11 için ürün eşleştirme, rezerv, güvenlik stoğu, kuyruk ve mutabakat ekranlarını işletmenize göre kuralım.

Pazaryeri Stok Entegrasyonu Teklifi Alın