Trendyol entegrasyonunda bağlantı testi, ürün durum sorgusu ve stok/fiyat güncellemesi aynı doğrulama gibi ele alınırsa ekip yanlış sonuca gidebilir. Bir endpoint 200 dönerken seller yetkili ürün okuma 401 verebilir; bir batch kabul edilirken canlı katalog henüz hedef stok veya fiyatı göstermeyebilir.
Durum, stok ve fiyat aynı sinyal değildir
Ürün durum sorgusu ürünün onaylı, arşivde veya yayında olup olmadığını anlamaya yarar. Stok ve fiyat ise satış operasyonunun canlı değerleridir; bu değerlerin güncellenmesi farklı payload, limit ve takip davranışıyla ilerleyebilir.
Bu ayrım yapılmadığında ekip ürün yayında görünüyor diye stok ve fiyatın da doğru olduğunu varsayabilir. Tersi de mümkündür: fiyat/stok güncellemesi kabul edilmiş olabilir, fakat ürün hâlâ onay beklediği için satışa açılmamıştır.
Doğru okuma sırası nasıl kurulmalı?
Önce kimlik doğrulama ve User-Agent bilgisi doğru kurulmalıdır. Trendyol Basic Auth ve User-Agent bilgisini zorunlu tutar; hatalı authorization 401, eksik User-Agent ise 403 gibi farklı hata yüzeyleri üretebilir.
Ardından ürünün pazaryerindeki durum sinyali okunur. Barkod bazlı ürün durum sorgusu ürünün onay ve yayın bilgisini verir; stok ve fiyat gibi operasyonel değerler için canlı katalog veya güncelleme sonucunu ayrıca takip etmek gerekir.
- Bağlantı testi ile seller ürün okuma yetkisini aynı kabul etmemek
- Barkod, SKU ve productMainId eşleşmelerini ürün bazında saklamak
- Fiyat/stok gönderiminde yalnız değişen satırları göndermek
- Batch kabul cevabını canlı sonuç kanıtıyla kapatmak
Stok ve fiyat güncellemesinde batch sonucu ne anlatır?
Trendyol fiyat ve stok güncellemesi tek endpoint üzerinden toplu çalışır ve batchRequestId döndürür. Bu cevap isteğin kabul edildiğini gösterir; operasyonun ürün bazında başarıya kapandığını anlamak için batch sonucunun ve gerekiyorsa canlı katalog değerinin ayrıca izlenmesi gerekir.
Aynı stok/fiyat isteğini değişiklik yapmadan tekrar göndermek de doğru bir retry stratejisi değildir. Değişmeyen satırları elemek hem rate-limit baskısını azaltır hem de gerçek hataları daha görünür yapar.
Ticevo'da pratik karşılığı
Ticevo'da Trendyol ürünleri için durum etiketi, canlı stok/fiyat okuma ve pazaryerine fiyat/stok gönderme ayrı iş akışları olarak görünür. Kullanıcı ürünün yayında olup olmadığını, son okunan stok/fiyatı ve kuyruktaki güncelleme işini aynı panelden izleyebilir.
Bu model özellikle kampanya ve yoğun sipariş dönemlerinde önemlidir. Ekip sadece gönderildi cevabına bakmak yerine, ürünün mağazada gerçekten satışa açık olup olmadığını ve hedef stok/fiyat değerine ulaşıp ulaşmadığını kontrol eder.