Toplu işlem, yüzlerce ürünü tek tek değil, tek pakette göndermektir. Platform paketi kabul eder, kuyruğa alır ve arka planda işler. Bu yöntem hem hızlıdır hem istek sınırına takılmayı önler. Pazaryerlerinde ürün yükleme ve stok-fiyat güncelleme genellikle böyle çalışır.
Trendyol örneği
Trendyol'un stok ve fiyat güncelleme servisi tipik bir toplu işlemdir:
| Kural | Değer |
|---|---|
| Bir istekte en fazla ürün | 1000 öğe (SKU) |
| Yanıt | İşlemin sonucu değil, batchRequestId |
| Sonuç kontrolü | Batch sonucu servisinden batchRequestId ile |
| Aynı isteğin tekrarı | Gövde değişmeden aynı istek 15 dakika boyunca tekrar gönderilemez |
Doküman, sistemlerin yalnız değişen stok ve fiyatları göndermesini önerir.
200 yanıtı "bitti" demek değildir
Toplu işlemde ilk yanıt yalnız "aldım" anlamına gelir. Ürünlerin bazıları sonradan hata alabilir. Örneğin geçersiz barkod ya da kurallara aykırı fiyat yüzünden bir öğe FAILED durumuna düşer ve hata nedenleri listelenir. Sonucu sorgulamayan bir yazılım, başarısız güncellemeyi başarılı sanır. Hepsiburada'da da durum benzerdir: toplu işlemlerin takip sonucunda hata adları ayrıca döner.
Saystok, Trendyol'a stok ya da fiyat gönderdikten kısa süre sonra batch sonucunu okur ve kesin başarısız öğe varsa hatayı barkoduyla birlikte gösterir.
İyi uygulamalar
- Büyük listeyi platformun sınırına göre parçalara bölün.
- Her parçanın takip kimliğini kaydedin.
- Sonucu bir süre sonra sorgulayın; işlem birkaç saniyeden uzun sürebilir.
- Başarısız öğeleri ayıklayın, hatayı düzeltin, yalnız onları yeniden gönderin.
- Aynı paketi kısa aralıkla tekrar göndermeyin; hem sınır hem tekrar kuralı devreye girer.
- Her öğenin barkodunu ve gönderilen değeri kaydedin; hata nedenini sonradan bulmak kolaylaşır.
Satıcı için anlamı
Panelde "stok güncellendi" yazıp pazaryerinde eski stok görünüyorsa sebep çoğunlukla toplu işlemin henüz bitmemesi ya da bazı öğelerin hata almasıdır. Gecikmenin diğer nedenleri için senkronizasyon gecikmesi maddesine bakın.