İçeriğe Geç

Trendyol V2 Toplu İşlemlerinde batchRequestId ve Hata Takibi

Trendyol ürün aktarımında isteğin kabul edilmesiyle ürünün işlenmesi arasındaki farkı; batchRequestId, kalem sonuçları ve tekrar denemelerini inceleyin.

Yazar: Sorun ve ÇözümPlatforma ÖzelPazaryerleriAltyapı ve Entegrasyon
AdPix tarafından hazırlanan açıklayıcı şema.

İsteğin Kabulü ve İşlenmesi

Trendyol ürün işlemlerinin bir bölümü kuyruğa alınır ve başarılı istek yanıtında batchRequestId döner. Bu kimlik işlemin sonucunu daha sonra araştırmak içindir. Kimliğin alınması bütün ürünlerin hatasız işlendiği anlamına gelmez.

Örneğin yüz ürün içeren aktarım için uygulama hemen tamamlandı mesajı gösterir. Ancak bazı kalemler zorunlu özellik veya ürün bilgisi nedeniyle reddedilmiş olabilir. Destek ekibi yalnızca ilk yanıtı saklıyorsa hangi ürünün eksik kaldığını anlayamaz. Bu nedenle aktarım kaydı, istek kabulü ve ürün bazındaki nihai sonuçları ayrı biçimde izlemelidir.

Kalem Sonucunun Önemi

Trendyol V2 toplu işlem yanıtlarında kalemlerin status ve failureReasons bilgileri incelenir. Özellikle stok ve fiyat güncellemelerinde üst düzey batch durumunun dönmediği yapı bulunduğundan yalnızca genel status alanına güvenen kontrol eksik kalabilir.

AdPix’in önerisi her gönderilen barkod için sonuç üretmektir. Başarılı, hatalı ve henüz sonucu belirlenmemiş kalemler ayrı sayılır. Bir ürünün hatası bütün grubun başarılı görünmesine veya bütün grubun yeniden gönderilmesine neden olmamalıdır. Hata açıklaması ilgili barkodla birlikte saklanır. Böylece katalog ekibi sorunu düzeltirken hangi ürüne hangi işlem uygulandığını görebilir.

Sonuç Kaydını Zamanında Saklama

Toplu işlem sonuçlarının sağlayıcıda sınırsız süre tutulduğu varsayılmamalıdır. Trendyol belgesi ilgili işlemlerin batch sonucuna erişim için sınırlı bir süre tanımlar. İşletmenin kendi takip kaydı, daha sonra araştırma yapılabilecek şekilde hazırlanmalıdır.

Örneğin gece yapılan aktarımın hatası birkaç gün sonra fark edilir. Uygulama yalnızca batch kimliğini tutmuşsa ayrıntılı neden artık alınamayabilir. Önerilen düzende işlem sonucu zamanında okunur; ürün kimliği, sonuç ve hata özeti yerel kayda yazılır. Gizli API bilgileri bu kayda dahil edilmez. Bu disiplin destek ekibinin hatayı yeniden üretmek zorunda kalmasını azaltır.

Tekrar Denemelerin Sınırlandırılması

Hatalı sonuç alınca aynı veriyi sürekli göndermek çoğu veri hatasını çözmez. Zorunlu özelliği eksik olan ürün, içerik düzeltilmeden tekrarlandığında aynı sonucu verebilir. Ayrıca Trendyol servis limitleri işlem türüne göre değerlendirilmelidir.

Bu yaklaşımda veri hatası ile geçici bağlantı veya servis sorunu ayrılır. Veri hatası katalog sorumlusuna yönlendirilir; geçici sorun için kontrollü yeniden deneme planlanır. Aynı barkoda kısa sürede yinelenen güncellemeler gereksiz yük oluşturmasın diye son istenen değer takip edilir. Başarılı kalemlerin yeniden gönderilmesi yerine gerçekten işlem gerektiren kayıtların ele alınması tercih edilir.

İşletmeye Sunulan Sonuç

Aktarım ekranı yalnızca teknik kimlik gösterirse operasyon ekibi sorunun kapsamını anlayamayabilir. Hangi ürünlerin tamamlandığı, hangilerinin hata aldığı ve hangi düzeltmenin beklendiği açıkça görünmelidir. İlgili sipariş veya katalog sorumlusu bu bilgiden hareketle işlem yapabilmelidir.

Kontrolde birkaç farklı hata içeren örnek grup kullanılır. Sistem bir başarılı ve bir başarısız kaydı doğru ayırabiliyor mu, sonucu henüz gelmeyen kaydı yanlışlıkla tamamlıyor mu soruları yanıtlanır. Nihai kabul, ürünlerin hedefteki durumuyla da karşılaştırılır. Böylece API isteği sayısı yerine gerçekten işlenmiş ve doğru veriyi taşıyan ürünler üzerinden ilerleme izlenir.

Bu Yazıdaki Terimler 1 Kavram

Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.

Ürün Kimliği (Item ID)
Ürün kimliği (Item ID), bir ürünün product feed içinde diğerlerinden ayırt edilmesini sağlayan ve genellikle sabit kalan benzersiz tanımlayıcıdır.

Bu Konuda Nasıl Destek Oluyoruz?

AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.

İlgili Platformlarda Keşfedin

Trendyol