Toplu stok güncellemesini gönderiyorsunuz, ekranda yeşil bir "gönderildi" bildirimi çıkıyor, arayüz hiçbir hata göstermiyor. Birkaç saat sonra pazaryeri panelini kontrol ettiğinizde bazı ürünlerin stoğunun hâlâ eski rakamda durduğunu görüyorsunuz. Ne sizin sisteminiz ne de pazaryeri bir hata mesajı vermiş — ama sonuç açıkça yanlış. Bu senaryo, pazaryeri entegrasyonlarında görünenden daha sık yaşanan, kökeninde teknik bir ayrıntı yatan bir sorundur.

"Gönderildi" ile "Uygulandı" Aynı Şey Değil

Trendyol ve Hepsiburada gibi pazaryerlerinin toplu stok/fiyat güncelleme uç noktaları asenkron çalışır: siz isteği gönderdiğinizde dönen "200 OK" yanıtı sadece "isteğiniz kuyruğa alındı, kabul edildi" anlamına gelir — her kalemin gerçekten uygulandığı anlamına gelmez. Asıl işlem arka planda, isteğinizden ayrı bir zamanda gerçekleşir ve bazı kalemler bu aşamada tek tek reddedilebilir: örneğin satışa kapatılmış bir ürünün stoğu güncellenemez, ya da pazaryeri tarafında o barkod/SKU eşleşmesi bulunamaz (İngilizce hata metinlerinde sık görülen "ListingNotFound" gibi). Bu red işlemi, ilk "kabul edildi" yanıtında hiçbir şekilde görünmez — sistem doğru çalışıyor gibi görünürken aslında bazı ürünler sessizce atlanmış olur.

Neden Fark Edilmesi Bu Kadar Zor

Bu tür bir hatayı fark etmek zor, çünkü ortada klasik anlamda bir "hata" yok — HTTP isteği başarılı, entegrasyon "bağlı", log dosyasında kırmızı bir satır yok. Sorun yalnızca gönderdiğiniz kalem sayısı ile pazaryeride gerçekten güncellenen kalem sayısının eşleşmemesinde ortaya çıkar, ve bunu görmek için isteğin sonucunu ayrıca sorgulamak gerekir. Entegrasyon geliştirirken bu ikinci adımı atlamak kolaydır, çünkü ilk yanıt zaten "başarılı" görünür — test sırasında da genelde sorun çıkmaz, çünkü gönderilen ürünlerin büyük çoğunluğu gerçekten güncellenir. Asıl fark, yüzlerce ürünlük bir toplu gönderimde o az sayıdaki reddedilen kalemi kimin fark edeceğidir.

Doğru Yaklaşım: Kabulü Değil Sonucu Doğrulamak

Güvenilir bir entegrasyon, isteği gönderdikten kısa bir süre sonra pazaryerinin kendi "gerçek sonuç" uç noktasını ayrıca sorgulamalıdır — Trendyol'da batch durumu, Hepsiburada'da yükleme (upload) durumu sorgusu gibi. Bu ikinci sorgu, hangi kalemlerin gerçekten uygulandığını, hangilerinin reddedildiğini ve ret nedenini (varsa) döner. Reddedilen kalem varsa bu, "gönderim başarısız" değil ama "kısmi uyarı" olarak ayrı bir şekilde gösterilmelidir — çünkü gönderimin büyük kısmı gerçekten başarılı olmuştur, sadece belirli kalemler ek bir müdahale gerektirir.

Kendi Entegrasyonunuzda Ne Kontrol Etmelisiniz?

  • Toplu gönderim sonrası gönderilen sayı ile pazaryeride gerçekten değişen sayıyı karşılaştırın — sadece "hata yok" mesajına güvenmeyin.
  • Manuel toplu gönderim ekranlarını ayrıca kontrol edin — bazı sistemlerde otomatik (arka plan) push'lar doğrulanırken, kullanıcının elle tetiklediği "toplu gönder" butonları farklı, daha eski bir koddan geçip bu doğrulamayı atlayabilir.
  • Reddedilen kalemlerin nedenini görün — "satışa kapalı ürün" ile "eşleşme bulunamadı" çok farklı aksiyonlar gerektirir, ikisini de aynı "başarısız" etiketi altında kaybetmeyin.

Pazaryeri entegrasyonlarında en pahalı hatalar, gürültülü hatalar değil sessiz olanlardır. "Gönderildi" yazan bir ekranla gerçekten güncellenmiş bir stok arasındaki farkı düzenli olarak kontrol etmek, bir müşterinin stokta olmayan bir ürünü sipariş etmesinden çok daha ucuza gelir.