Bu rehberde ele alınan temel konular
  • Merkez stok ile satılabilir stok arasındaki farkı ayırın.
  • SKU, barkod, varyant ve depo eşleşmelerini tek tek doğrulayın.
  • Stok gönderiminin kabul edilmesiyle mağazada uygulanmasını aynı şey sanmayın.
  • Sipariş, iptal, iade ve manuel panel hareketlerini tek kayıt akışında izleyin.

Pazaryeri stokları neden eşitlenmez?

Bir üründe web sitesi, Trendyol, Hepsiburada ve diğer kanallarda farklı stok görünmesinin en yaygın nedeni; sistemlerin aynı “satılabilir stok” tanımını kullanmamasıdır. Merkez yazılım fiziksel stoğu tutarken pazaryeri yalnızca satışa açılabilecek miktarı bekleyebilir. Bekleyen siparişler, ayrılmış ürünler, güvenlik stoğu, iadeye gelen fakat henüz rafa alınmamış ürünler ve başarısız güncelleme kayıtları bu iki değeri birbirinden ayırır.

Trendyol’un resmî stok ve fiyat dokümantasyonunda quantity alanının satılabilir stok olduğu belirtilir. Hepsiburada tarafında ise fiyat veya stok güncellemesi sonrasında dönen işlem kimliği üzerinden güncellemenin durumu ve varsa uyarıları ayrıca sorgulanmalıdır. Bu nedenle yalnızca “istek 200 döndü” veya “batch ID oluştu” bilgisi, bütün ürünlerin mağazaya başarıyla uygulandığını kanıtlamaz.

Önce tek stok kaynağını belirleyin

Sağlıklı entegrasyonda hangi sistemin ana stok kaynağı olduğu açık olmalıdır. ERP, muhasebe programı, e-ticaret paneli ve pazaryeri panellerinin hepsi aynı anda ana kaynak gibi davranırsa son yazan sistem diğerinin değerini ezer.

Merkez stokFiziksel depo ve mağazalardaki toplam miktar
Rezerve stokÖdeme veya sipariş süreci tamamlanmayı bekleyen miktar
Güvenlik stoğuAşırı satış riskini azaltmak için kanala gönderilmeyen miktar
Satılabilir stokMerkez stoktan rezervasyon ve güvenlik stoğu çıkarıldıktan sonra kanala gönderilen değer

Örnek bir kural şu şekilde olabilir: satılabilir stok = fiziksel stok − rezerve stok − güvenlik stoğu. Ancak iade kontrolü, hasarlı ürün ve mağaza vitrin stoğu gibi işletmeye özel hareketler varsa formül buna göre genişletilmelidir.

Stok çakışmasının nedenleri ve çözümleri

BelirtiMuhtemel nedenKontrolÇözüm
Tek bir varyant yanlışSKU veya barkod eşleşmesi farklıMerkez SKU ile kanal merchantSku/barcode değerini karşılaştırınVaryant eşlemesini düzeltip yeniden gönderin
Bütün ürünler eski stoktaKuyruk çalışmıyor veya API yetkisi kesilmişSon başarılı görev zamanı, HTTP kodu ve kimlik doğrulama kaydını inceleyinKuyruğu ve bağlantı bilgilerini düzeltin
Güncelleme kabul edildi fakat yansımadıÜrün bazlı batch sonucu başarısızİşlem kimliğiyle item status ve hata mesajlarını sorgulayınBaşarısız SKU’ları düzelterek yeniden gönderin
Satıştan sonra stok fazla görünüyorSipariş rezervasyonu merkeze işlenmediSipariş satırı, paket ve stok hareketi kayıtlarını eşleştirinSipariş kabulünde atomik stok düşümü uygulayın
Panelde elle değişince geri dönüyorMerkez sistem periyodik olarak kendi değerini tekrar yazıyorSon güncellemenin kaynağını ve zamanını kontrol edinTek ana kaynak belirleyin, manuel değişikliği sınırlandırın
İptal/iade sonrası stok artmıyorİade durumu yanlış aşamada stoğa ekleniyorİptal, teslim, iade kabul ve kalite kontrol statülerini inceleyinStoğa dönüş kuralını gerçek operasyon aşamasına bağlayın

SKU, barkod ve varyant eşleşmesini kontrol edin

Stok senkronizasyonunda ürün adı değil, teknik kimlik kullanılır. Renk ve beden varyantlarında aynı ürünün her seçeneğinin ayrı SKU veya barkoda sahip olması gerekir. “Siyah / M” varyantı merkezde TS-100-M-SIYAH, pazaryerinde farklı bir merchant SKU ile kayıtlıysa güncelleme başka satıra gidebilir veya tamamen reddedilebilir.

  • Her varyantın benzersiz SKU ve barkodu var mı?
  • Başında veya sonunda görünmeyen boşluk bulunuyor mu?
  • Büyük-küçük harf veya Türkçe karakter dönüşümü yapılıyor mu?
  • Aynı barkod iki farklı ürün kartında kullanılmış mı?
  • Paket ürün ile tekil ürün aynı stoktan mı düşüyor?
  • Arşivlenmiş eski listeleme hâlâ güncelleme kuyruğunda mı?

Sipariş rezervasyonu ile fiziksel stok aynı değildir

Müşteri sipariş verdiğinde ürün fiziksel olarak hâlâ rafta olabilir; ancak başka müşteriye satılmaması için rezerve edilmesi gerekir. Ödeme bekleyen siparişler, kapıda ödeme, pazaryeri paketleri ve iptal bekleyen işlemler farklı rezervasyon sürelerine sahip olabilir.

Entegrasyon yalnızca faturası kesilen siparişte stok düşürürse aynı ürün kısa sürede birden fazla kanalda satılabilir. Tersi durumda, başarısız ödemeler serbest bırakılmadığında stok gereksiz yere düşük görünür. Rezervasyonun ne zaman başlayıp ne zaman kaldırıldığı kayıt altına alınmalıdır.

Batch sonucu, kuyruk ve API kayıtlarını birlikte inceleyin

Toplu stok güncellemeleri genellikle asenkron çalışır. İlk istek yalnızca işlemin sıraya alındığını bildirir. Trendyol’da stok-fiyat güncellemesi sonrasında dönen batch kimliğiyle ürün bazlı durum kontrol edilmelidir. Hepsiburada da güncelleme sonucu için dönen ID üzerinden uyarı ve hata kayıtlarının sorgulanmasını önerir.

  1. Gönderilen SKU, miktar ve zaman bilgisini kaydedin.
  2. Dönen işlem veya batch kimliğini ürün kaydıyla ilişkilendirin.
  3. İşlem tamamlandıktan sonra item bazlı sonucu sorgulayın.
  4. Başarısız ürünleri ayrı hata kuyruğuna alın.
  5. Başarılı görünen ürünü kanal listeleme servisinden tekrar okuyun.
  6. Merkez stok ile kanal stok farkını periyodik mutabakat raporunda gösterin.

Pazaryeri panelinden yapılan manuel değişiklikleri sınırlayın

Entegrasyon aktifken pazaryeri panelinden elle stok değiştirmek kısa süreli çözüm gibi görünür. Fakat merkez sistem birkaç dakika sonra kendi değerini yeniden gönderdiğinde manuel değer kaybolur. Kullanıcıya “stok neden geri döndü?” hissi veren bu durum aslında çift kaynak problemidir.

Acil müdahale gerekiyorsa değişikliğin hangi sistemde yapıldığı, kim tarafından yapıldığı ve merkez stoğa da işlenip işlenmediği kayıt altına alınmalıdır.

İptal ve iade stok hareketlerini ayrı yönetin

İptal edilen sipariş her zaman doğrudan satılabilir stoğa dönmez. Ürün kargoya verilmişse fiziksel olarak depoda değildir. İade teslim alınmış olsa bile hasar kontrolü tamamlanmadan satışa açılması risklidir. Bu nedenle “sipariş iptal”, “kargodan döndü”, “iade depoya ulaştı” ve “yeniden satılabilir” durumları birbirinden ayrılmalıdır.

Çoklu depo ve güvenlik stoğu nasıl yönetilir?

Birden fazla mağaza veya depo varsa pazaryerine toplam stok göndermek her zaman doğru olmayabilir. Kargoyu yalnızca merkez depo hazırlıyorsa şubelerdeki ürünleri satılabilir stoğa katmak sipariş gecikmesine neden olur. Depo bazlı uygunluk, transfer süresi ve kanal önceliği tanımlanmalıdır.

Hızlı satan veya fiziksel mağazada da satılan ürünlerde 1–3 adet güvenlik stoğu bırakmak aşırı satış riskini azaltabilir. Bu değer ürün veya kategori bazında yönetilmelidir; bütün ürünlere aynı tamponu uygulamak gereksiz stok kaybı yaratabilir.

Adım adım stok eşitleme teşhis akışı

1. Sorun tek SKU’da mı, belirli kanalda mı, bütün ürünlerde mi?

2. Merkez stok hareketi doğru mu ve sipariş rezervasyonu işlenmiş mi?

3. Gönderilen payload içindeki SKU ve miktar doğru mu?

4. API yanıtı yalnızca kabul mü, yoksa ürün bazlı başarı mı?

5. Kanal listeleme servisi güncel değeri ne olarak döndürüyor?

6. Panelden manuel değişiklik veya başka entegratör müdahalesi var mı?

7. İptal, iade ve depo transferi kayıtları eksik mi?

Hangi durumda teknik destek gerekir?

Aşağıdaki durumlarda yalnızca panelden stok düzeltmek kalıcı çözüm sağlamaz:

  • Batch kayıtları sürekli başarısız oluyor veya hiç tamamlanmıyorsa
  • Aynı SKU farklı kanallarda farklı ürüne bağlıysa
  • Sipariş düşmesine rağmen stok hareketi oluşmuyorsa
  • Kuyruk servisi, cron veya worker düzenli olarak duruyorsa
  • Birden fazla entegratör aynı mağazaya stok yazıyorsa
  • İade ve iptal kuralları fiziksel operasyonla uyuşmuyorsa
Geçici değer düzeltmek yerine kayıt zincirini bulun.3E Yazılım; merkez stok, API gönderimi, batch sonucu, kanal listelemesi ve sipariş hareketini aynı zaman çizelgesinde inceleyerek çakışmanın başladığı noktayı belirler.

Sık sorulan sorular

Stok güncellemesi anında mı yansır?

Servise ve yoğunluğa göre kısa gecikmeler olabilir. Asıl kontrol, dönen işlem kimliği ve kanalın listeleme sorgusudur.

Stok sıfır gönderildiği hâlde ürün neden satışta kalır?

Yanlış SKU’ya güncelleme gitmiş, batch başarısız olmuş, başka sistem yeniden stok yazmış veya mağaza ekranında önbellek gecikmesi yaşanmış olabilir.

Güvenlik stoğu kaç olmalı?

Ürünün satış hızı, fiziksel mağaza satışı ve sipariş hazırlama süresine göre belirlenir. Tek bir sabit sayı bütün katalog için doğru değildir.

Stok çakışmasını kalıcı olarak düzeltin

Pazaryeri ve e-ticaret stoklarının hangi noktada ayrıldığını birlikte inceleyelim; SKU, sipariş, kuyruk ve API kayıtlarını tek akışta kontrol edelim.

Acil Yazılım Desteğini İnceleyin