Trendyol'da Stok ve Fiyat Güncelleme Hataları Nasıl Önlenir? Entegrasyon Kontrol Listesi
Trendyol'da stok ya da fiyat güncellemesi gönderip "200 döndü, tamam" demek, entegrasyonlarda en pahalıya patlayan alışkanlıktır. Sebep basit: Trendyol bu güncellemeleri anında uygulamaz, kuyruğa alır. Başarılı görünen bir istek yalnızca "talebini aldım" demektir; satırların tek tek işlenip işlenmediğini ayrıca sorgulamadığınızda, panelde 0 görünen ürüne sipariş düşmesi ya da eski fiyattan satış yapılması bir gün mutlaka gelir.
Bu yazıda önce Trendyol'un geliştirici dokümantasyonunun stok ve fiyat güncellemesi hakkında gerçekte ne söylediğini, sonra hataların hangi noktalarda oluştuğunu ve bunları önleyen kontrol listesini anlatıyoruz. Listeyi hem kendi yazılım ekibiniz hem de entegratör firmanızla yapacağınız görüşmede soru listesi olarak kullanabilirsiniz.
Güncelleme neden "gönderildi" ile "işlendi" arasında kayıp verir?
Trendyol'un geliştirici sayfasına göre ürün oluşturma, ürün güncelleme ve stok-fiyat güncelleme metotları Trendyol sisteminde kuyrukla işlenir. Her başarılı istek sonucunda bir batchRequestId döner. Bu kimlik, işlemin sonucu değil, sonucu sorgulamak için kullanacağınız makbuzdur.
Stok ve fiyat tarafında bir ayrıntı daha var ve çoğu entegrasyon bunu atlıyor. Dokümantasyon, stok ve fiyat güncellemelerinde batch düzeyinde bir durum (status) alanının size dönmeyeceğini, bunun yerine sorguladığınız batchId için satır bazındaki durum alanlarına bakmanız gerektiğini söylüyor. Yani "batch COMPLETED" yazısını beklerseniz hiç görmezsiniz; her ürünün kendi durumunu okumak gerekir. Hatalı satırların nedeni ise failureReasons alanında yazar, toplam ve hatalı satır sayısı da yanıtta gelir.
Sonuç sorgusunun bir de süresi var: dokümantasyon, ürün oluşturma, güncelleme ve stok-fiyat güncellemelerinin batch kaydının 4 saat sonrasına kadar görüntülenebildiğini belirtiyor. Bu nedenle sonucu "akşam toplu bakarız" mantığıyla değil, gönderimden kısa süre sonra okumak ve kaydetmek gerekir. Süresi dolan bir batch'in neden hata verdiğini artık Trendyol'dan öğrenemezsiniz.
Hız limitleri: eski "limitsiz" varsayımı artık geçerli mi?
Servis limitleri sayfası, ürün servisleri için 14 Eylül 2026 itibarıyla yeni bir düzenin geçerli olduğunu yazıyor. Daha önce stok ve fiyat güncelleme servisinin limiti "limitsiz" olarak listeleniyordu. Yeni düzende limitler tek tek uç noktalara değil servis gruplarına ortak uygulanıyor ve stok-fiyat güncellemesi kendi grubunda (Inventory & Price Write) yer alıyor. Grup içindeki limit, satıcının listeleme limitine göre belirleniyor:
| Satıcı katmanı (listeleme limiti) | Stok ve fiyat yazma grubu |
|---|---|
| 100.000 | 350 istek/dk |
| 350.000 | 500 istek/dk |
| 500.000 | 1000 istek/dk |
| Limitsiz | 1500 istek/dk |
Bundan bağımsız ikinci bir sınır daha var ve pratikte en çok bu takılıyor: aynı barkod için fiyat güncelleme isteği dakikada en fazla 30 olabilir. Aynı barkod için bundan fazla istek gönderirseniz, o barkodun satırı batch sonuç servisinde hata ile döner. Hata ürün bazında olduğu için genel bir kesinti gibi görünmez; tek tek ürünlerin eski fiyatta kalması şeklinde sessizce ortaya çıkar. Dokümantasyon sayfası 429 gibi genel bir kısıtlama yanıtından söz etmiyor, dolayısıyla "hata gelmedi" demek "limite takılmadım" demek değildir.
Bu yüzden entegratörünüze ya da yazılım ekibinize sormanız gereken ilk soru şudur: "Bizim satıcı katmanımızda dakikada kaç stok-fiyat isteği gönderiyorsunuz ve aynı barkoda dakikada kaç kez fiyat yazıyorsunuz?" Cevap net değilse, yoğun kampanya saatinde sorun çıkma ihtimali yüksektir.
Gönderimden önce: veri kuralları
Hataların büyük kısmı Trendyol'a hiç ulaşmadan önlenebilir. Dokümantasyondaki kurallar kısa ve nettir:
- Tek istekte en fazla 1000 ürün. Bu sınır ürün oluşturma sayfasında açıkça yazıyor. Stok-fiyat güncellemesinde de aynı parça boyutunu kullanmak güvenli taraftır; daha büyük kataloglar birden fazla isteğe bölünmelidir.
- Liste fiyatı satış fiyatından düşük olamaz. listPrice (üstü çizili fiyat) salePrice'tan küçükse değer geçersizdir. Kendi sisteminizde bir indirim hesabı yaparken bu iki alanı karıştırmak, kampanya günü yüzlerce satırın hata vermesine yol açar.
- Stok yalnızca stok güncelleme servisinden değişir. Ürün ilk oluşturulurken adet verilebilir, hatta stoksuz da açılabilir; ama sonrasında stoğu ürün güncelleme servisiyle değiştirmeye çalışmak işe yaramaz.
- Onay bekleyen ürün yayına girmez. Onayda bekleyen ya da reddedilen ürünün stoğunu doğru yazmanız yetmez; ürün canlı değildir. Durumu ürün filtresi servisinden izlemek gerekir.
Entegrasyon kontrol listesi
Aşağıdaki maddeleri tek tek "var / yok" diye işaretleyin. "Bilmiyorum" cevabı da "yok" sayılır.
Gönderim tarafı
- Yalnızca değişeni gönderiyor mu? Her döngüde tüm kataloğu yazan bir sistem hem limiti zorlar hem de hata ayıklamayı zorlaştırır. Önceki gönderilen değerle kıyaslayıp farklı olan satırları göndermek, istek sayısını belirgin biçimde azaltır.
- Aynı barkod için fiyat yazımları birleştiriliyor mu? Bir dakika içinde aynı barkoda birden fazla fiyat değişikliği geliyorsa, yalnızca sonuncusunu göndermek 30 isteklik barkod sınırına çarpmanızı önler.
- Parçalama 1000 satır ve altında mı? Büyük bir katalogda tek seferlik dev istek yerine kontrollü parçalar gönderilmeli; her parçanın batchRequestId'si ayrı kaydedilmeli.
- Katman limitinin altında kalan bir hız sınırlayıcı var mı? Limit aşımını Trendyol'a bırakmayın; istek hızını kendi tarafınızda sınırlayın.
Sonuç okuma tarafı
- batchRequestId her gönderimde saklanıyor mu? Hangi ürün hangi batch'te gitti, geriye dönük izlenebilmeli.
- Satır bazlı durum okunuyor mu? Sistem yalnızca HTTP 200'e bakıyorsa başarısız satırları hiç fark etmez.
- failureReasons kaydediliyor mu? Hata mesajı bir log dosyasında kaybolmamalı; hangi ürünün hangi nedenle reddedildiği bir ekranda görülebilmeli.
- Yalnızca başarısız satırlar mı yeniden deneniyor? Tüm batch'i yeniden göndermek, başarılı satırları da tekrar yazar ve limit tüketir.
- Sonuç, gönderimden sonraki 4 saat içinde okunuyor mu? Bu pencerenin dışında kalan hatalar görünmez olur.
Doğruluk tarafı
- Periyodik mutabakat var mı? Belirli aralıklarla Trendyol'daki mevcut stok ve fiyatı ürün filtresi servisiyle çekip kendi sisteminizdeki değerle karşılaştırın. Fark çıkan satırlar, gönderim akışının görmediği hataların tek yakalama yoludur.
- Fiyat için koruma kuralı var mı? Stok yazılımında yanlış bir kur ya da maliyet güncellemesi fiyatı bir anda çok düşürebilir. Önceki fiyata göre belirlediğiniz bir sapma eşiğini aşan değişikliklerin otomatik gönderilmeyip onaya düşmesi, bu tür kazaları durdurur. Eşiği kendi marj yapınıza göre siz belirlersiniz.
- Güvenlik stoğu uygulanıyor mu? Kuyruk gecikmesi nedeniyle, son birkaç adet için başka kanaldan da satış yapıyorsanız fazla satış riski vardır. Sınırlı adetlerde pazaryerine gerçek stoktan bir miktar düşük değer yazmak makul bir tampondur.
Kaynak sistem tek olmalı
Birden fazla kanalda satış yapan işletmelerde en sık görülen hata, stok bilgisinin iki yerde ayrı ayrı yönetilmesidir. Trendyol panelinde elle düzeltilen bir stok, birkaç dakika sonra çalışan entegrasyon tarafından eski değerle ezilir; bunun tersi de olur. Kural şu: stoğun tek doğru kaynağı sizin depo ya da ERP sisteminizdir, pazaryeri paneli yalnızca bir görünümdür. Panelden elle müdahale gerekiyorsa, önce kaynak sistemde değişiklik yapılır, sonra gönderim yapılır. Kendi sitenizle pazaryeri arasındaki eşitleme düzenini ayrıntılı anlattığımız stok senkronizasyonu yazımız bu kısmı tamamlıyor.
Varyantlı ürünlerde (renk, beden) hata ihtimali daha da yüksektir, çünkü her varyant ayrı barkoddur. Barkod eşleşmesi bir kez bozulduğunda yanlış bedenin stoğu güncellenir. Bu konuda varyant kurulumu rehberimize bakabilirsiniz.
Hata çıktığında ilk bakılacak yerler
Elinizde şu belirti varsa şu noktadan başlayın:
- Panelde stok 0, kendi sisteminizde stok var: son gönderimin batchRequestId'sini bulun ve satır durumunu okuyun. Satır başarısızsa failureReasons nedeni gösterir; satır hiç gönderilmemişse değişiklik tespit mantığı ürünü atlıyor demektir.
- Fiyat eski kalıyor: aynı barkoda dakikada kaç fiyat isteği gittiğine bakın. 30 sınırı aşılmışsa fazla istekler hata ile dönmüştür.
- Bir grup ürün yayında görünmüyor: stok ve fiyat doğru olsa da ürünler onay bekliyor ya da reddedilmiş olabilir; ürün filtresi sonucunu kontrol edin.
- Kampanya gününde yaygın hata: katman limitinin yoğun saatte aşılması söz konusu olabilir. Bu durumda bir hız sınırlayıcı ve öncelik kuyruğu gerekir; kampanya ürünleri önce, diğerleri sonra gönderilmelidir.
Kampanya zamanı hataları, siparişte stok bulunamadığı için iptal olan siparişleri de beraberinde getirir. Gecikme kaynaklı ceza riskini gecikme cezası rehberimizde ele almıştık; stok doğruluğu bu riskin ilk halkasıdır.
Kampanya gününe hazırlık
Limitlerin ve kuyruğun asıl sınandığı gün kampanya günüdür. Yüzlerce ürünün fiyatı aynı anda değişir, stok hızla düşer ve her iki akış da aynı grup limitini paylaşır. Önceden hazırlık yapmak için şu sırayı izleyin: kampanya fiyatlarını bir gün önce hazırlayıp parçalara bölün, fiyat değişikliklerini kampanya başlamadan kısa süre önce kontrollü bir hızda gönderin ve gönderilen her parçanın satır sonucunu okuyun. Hatalı satırları kampanya başlamadan düzeltmek, başladıktan sonra düzeltmekten çok daha ucuzdur.
Kampanya sırasında stok güncellemelerine öncelik verin. Fiyat hatası genellikle marjı eritir, stok hatası ise müşteriye verilemeyen sipariş ve iptal demektir; ikincisi hem satıcı puanını hem de müşteri deneyimini etkiler. Kampanya bittikten sonra da fiyatları eski değerlerine döndürürken aynı kontrolü tekrarlamayı unutmayın; indirimli fiyatın kampanya sonrası aktif kalması en sık görülen ve en geç fark edilen hatadır.
Entegratörle yapılacak görüşme için sorular
Hazır bir entegratör kullanıyorsanız, yukarıdaki listeyi toplantıda şu sorulara indirgeyebilirsiniz: Satır bazlı sonuçları okuyor musunuz ve başarısız satırları bana nasıl gösteriyorsunuz? Aynı barkoda dakikada kaç fiyat isteği gönderebilirsiniz? Stok değişikliği yaptığımda Trendyol'a ne kadar süre içinde gönderilir? Mutabakat raporu sunuyor musunuz? Bu soruların net ve yazılı cevapları, sözleşme yenileme ya da entegratör değiştirme kararında en değerli veridir.
Son olarak bu kontrolleri bir kez yapıp bırakmayın. Trendyol servis limitlerini ve kurallarını zaman zaman güncelliyor; nitekim limit düzeni 14 Eylül 2026 itibarıyla değişti. Entegrasyonunuzu üç ayda bir geliştirici sayfasındaki güncel limit ve alan kurallarıyla karşılaştırmak, bir sonraki değişiklikte sürprizle karşılaşmanızı engeller. Değişikliklerin tarihini ve entegrasyonda yaptığınız ayarı kısa bir not defterinde tutmak, ileride hata araştırırken size saatler kazandırır.
Sıkça Sorulan Sorular
Trendyol'a gönderdiğim stok kaç dakikada panele yansır?
Dokümantasyon bir işlem süresi taahhüdü vermiyor; yalnızca isteklerin kuyrukla işlendiğini söylüyor. Bu yüzden "anında" varsaymayın. Önemli olan süre değil, satır sonucunu okuyup işlendiğini doğrulamaktır.
Entegratör kullanıyorsam bu kontrolleri yapmam gerekir mi?
Kontrolü siz yapmayabilirsiniz, ama entegratörden bu davranışları yazılı olarak istemelisiniz: satır bazlı sonuç okuma, başarısız satırların yeniden denenmesi ve hata raporunun size görünür olması. Hata raporuna erişiminiz yoksa sorun oluştuğunda sebebini bilemezsiniz.
Aynı fiyatı tekrar tekrar göndermek zararlı mı?
Dokümantasyonda aynı değerin tekrarının nasıl işlendiğine dair bir bilgi yok. Ancak her gereksiz istek, hem grup limitinden hem barkod başına fiyat sınırından pay alır. Bu yüzden yalnızca değişen değerleri göndermek en sağlam yaklaşımdır.
Stok bittiğinde ürünü silmeli miyim?
Genellikle gerek yok; stoğu sıfırlamak ürünü satışa kapatır ve ürün kaydı yerinde kalır. Silme işleminin ayrı bir servisi ve ayrı, daha düşük bir istek limiti vardır; rutin akışta kullanılacak bir işlem değildir.
Sonuç
Stok ve fiyat hatalarının çoğu aslında Trendyol'daki bir arızadan değil, "gönderdim, oldu" varsayımından doğar. Kuyruk mantığını kabul eden, her batchRequestId'yi kaydeden, satır sonuçlarını okuyan ve periyodik mutabakat yapan bir akış, bu hataların hem sayısını hem maliyetini düşürür. Başlangıç noktası basit: bugün entegrasyonunuzun satır bazlı sonucu okuyup okumadığını öğrenin.
Entegrasyonunuzu bu liste üzerinden birlikte gözden geçirmek isterseniz Trendyol pazaryeri danışmanlığı hizmetimiz bu denetimi yapıyor. Hem kendi sitenizde hem pazaryerinde satıyorsanız, iki tarafın ürün verisini, reklamını ve ölçümünü tek ekiple yürüten e-ticaret ajansı çalışmamıza bakabilirsiniz. Tüm yazılarımız için blog sayfamıza göz atabilirsiniz.