Trendyol Stok Güncellemesini Yeniden Denerken Eski Miktarı Önleme

Depodaki kutuların bulunduğu rafların yanında çalışan iki kişi — Temsili stok fotoğrafı: Centre for Ageing Better / Pexels. Görseldeki kişiler Entegrino müşterisi olarak tanıtılmamaktadır.

Başarısız veya sonucu belirsiz Trendyol stok aktarımını yeniden denerken eski istekteki miktarı doğrudan kullanmayın. Önce önceki işlemin sonucunu araştırın, ardından arada gelen siparişleri içeren güncel satılabilir miktarı belirleyin. Yeniden deneme, geçmişteki stok görüntüsünü bugüne geri taşımamalıdır.

Gönderilen miktarın anlamı

Trendyol stok ve fiyat güncelleme belgesi, quantity alanını satılabilir stok olarak tanımlar; bu bilginin sipariş alındığında veya yeniden stok gönderildiğinde güncellendiğini belirtir. Bu nedenle eski miktarı tekrar göndermek, yalnızca teknik bir bağlantı denemesi olarak görülmemelidir.

Resmî entegrasyon SSS sayfası ayrıca batchId dönmesinin işlemin başarıyla sonuçlandığı anlamına gelmediğini açıklar. İstek alınması, ürün bazında sonucun doğrulanması ve yeni miktarın hesaplanması ayrı kontrollerdir.

Varsayımsal örnek: H-950 boya seti

Bir hobi mağazasında H-950 kodlu boya setinden satılabilir 10 adet bulunduğunu düşünelim. Bağlantı 10 bilgisini göndermeye çalışır, ancak işlem sonucu uygulamada belirsiz kalır. Daha sonra iki adetlik sipariş gelir. İç sistem bu siparişi işlediğinde güncel satılabilir miktar 8 olur.

Eski güncelleme işi tekrar çalışıp 10 gönderirse, yeni siparişin etkisi gözden kaçabilir. Bu örnek her bağlantının aynı hatayı yaptığı iddiası değildir. Kontrol edilmesi gereken, yeniden denenen işin miktarı ilk oluşturulduğu andan mı yoksa güncel kayıttan mı aldığıdır. Sayılar tamamen varsayımsaldır.

Yeniden denemeden önce dört soru

Önceki isteğin sonucu biliniyor mu? Bağlantı zaman aşımı, karşı sistemin hiçbir işlem yapmadığını kanıtlamaz. Mevcut işlem referansıyla sonuç araştırılmalıdır.
Bu ürün için daha yeni hareket var mı? Sipariş, iptal, depo düzeltmesi veya başka kanal satışı miktarı değiştirmiş olabilir.
İç sistem güncel mi? Henüz içeri alınmamış siparişler varsa sadece yerel sayıyı okumak yeterli olmaz.
Aynı ürüne başka güncelleme gidiyor mu? Birden fazla işin farklı miktarları peş peşe göndermesi işlem sırası sorununa yol açabilir.

İş kaydında ne tutulmalı?

Mağaza kimliği, ürün barkodu, hesaplanan miktar, hesaplama zamanı ve işlem referansı birlikte kaydedilmelidir. Bunun yanında miktarın hangi sipariş ve stok hareketlerine kadar güncel olduğu izlenebilmelidir. Yalnızca “gönderildi” yazan bir kayıt, sonradan yapılan incelemede yeterli açıklama sağlamaz.

Önerilen uygulama tasarımında eski iş, daha yeni bir miktar hesabı varsa körlemesine yeniden gönderilmez. Ekip, eski işi geçersiz sayma veya güncel veriyle yeni iş oluşturma kuralını açıkça belirler. Bu yaklaşım Trendyol API’sinde belirli bir sürüm alanı bulunduğu iddiası değildir; bağlantı tarafındaki iş yönetimi önerisidir.

Hobi ürünlerinde varyantı da koruyun

Aynı boya setinin farklı renk paketi veya kutu boyutu ayrı stok kaydı olabilir. H-950 örneğindeki miktar başka varyantın barkoduyla gönderilirse zaman sırası doğru olsa bile sonuç yanlış olur. Yeniden deneme kaydı ürün adından yeniden eşleştirme yapmamalı; doğrulanmış barkod ilişkisini korumalıdır.

Satışa açık miktar ile raf sayımını da aynı kabul etmeyin. Hazırlanmakta olan siparişlere ayrılan ürünler, işletmenin stok hesabında doğru ele alınmalıdır. Bu yazı Entegrino için hazır stok rezervasyonu veya otomatik yeniden deneme özelliği vaat etmez.

Testte yalnızca hata mesajına bakmayın

Test ortamında önce bir güncelleme işi oluşturun, ardından örnek sipariş hareketiyle miktarı değiştirin. Eski işi yeniden ele aldığınızda hangi değerin gönderildiğini ve hangi kaydın son durum olarak saklandığını inceleyin. Aynı ürüne iki güncellemenin ters sırayla sonuçlanması senaryosunu da bağlantı ekibiyle değerlendirin.

Toplu işlem sonuçlarının ayrı ürünler için incelenmesi konusunda Trendyol ürün bazında güncelleme kontrol rehberi tamamlayıcıdır. Buradaki odak, tekrar denenen stok değerinin güncelliğidir.