İstek gövdesi
| Alan | Anlamı | Kural |
|---|---|---|
| items[].code | Ürün kodu | getProducts yanıtındaki code |
| items[].stockCount | Yeni stok adedi | Tam sayı, 0 ya da üstü |
Örnek gövde: items: [ { code: URUN_KODU, stockCount: 12 }, { code: URUN_KODU_2, stockCount: 0 } ]. Stoğu 0 göndermek ürünü satışa kapatmanın yoludur; ürünü silmez. Gönderilen değer artış ya da azalış değil, ürünün yeni toplam stoğudur.
Yanıt ve eşzamansız işleme
Yanıt, sarmalın data alanında bir parti numarası (batchRequestId ya da batchId) taşıyabilir. Partinin sonucunu sorgulayan servis bu rehberde doğrulanamadı; değişikliği doğrulamanın güvenilir yolu bir süre sonra getProducts ile stockCount değerini okumaktır.
| Yanıt | Anlamı | Yapılacak |
|---|---|---|
| 200, success true | İstek kabul edildi, sıraya alındı | Birkaç dakika sonra kontrol edin |
| 200, success false | İstek reddedildi | message alanını okuyun |
| 404 (v2 yolunda) | Yol bulunamadı | Eski /product/updateStock yolunu deneyin |
| 429 | İstek sınırı aşıldı | Retry-After kadar bekleyin |
v2 ve eski yol
Canlı entegrasyon önce updateStock-v2'yi dener; bu yol 404 dönerse aynı gövdeyle /product/updateStock'a geçer ve o oturumda eski yolu kullanmaya devam eder. Hangi yolun güncel olduğunu Pazarama dokümanından kontrol edin. Yeni bir entegrasyonda v2'yi tercih edin, eski yolu yedek olarak tutun.
Pazaryerlerinde stok servislerinin sürümlenmesi yaygındır; eski sürüm bir süre çalışmaya devam eder, sonra kapatılır. Yedek yola düştüğünüzde bunu kaydetmek, kapanış duyurusunu kaçırmamanızı sağlar.
Eski yolla yeni yolun gövdesi canlı entegrasyonda aynıdır: items dizisi, her kalemde code ve stockCount. Yanıt biçimi de aynı sarmalı kullanır. Bu yüzden yedek yola geçiş kodda tek bir adres değişikliğiyle yapılabilir.
Toplu gönderim düzeni
- Değişen stokları biriktirin ve tek istekte gönderin; her satışta tek kalem göndermeyin.
- 3.000 kalemden büyük listeyi parçalara bölün.
- İstekler arasında en az 10 saniye bırakın.
- Stoğu tam sayıya çevirin; negatif değer göndermeyin.
- Aynı kodu aynı istekte iki kez göndermeyin; son değer belirsiz kalır.
Stok farklarının neden oluştuğu ve nasıl önlendiği stok farkı neden oluşur yazısında anlatılıyor.
Sık hatalar ve çözümleri
| Hata | Sonuç | Doğrusu |
|---|---|---|
| 200'ü kesin başarı saymak | Reddedilen istek fark edilmez | success alanına ve sonra stockCount'a bakmak |
| Stok kodu ya da barkodla göndermek | Kalem eşleşmeyebilir | code kullanmak |
| Saniyede birçok istek | 429 | 10 saniye aralıkla toplu göndermek |
| Ondalık ya da negatif stok | Ret | Tam sayı, en az 0 |
Sık sorulanlar
Pazarama stok güncelleme hangi servisle yapılır?
POST /product/updateStock-v2 ile. Gövdedeki items dizisinin her kalemi code ve stockCount taşır.
Bir istekte kaç ürünün stoğu gönderilir?
Canlı entegrasyon istek başına en fazla 3.000 kalem gönderir ve istekler arasında yaklaşık 10 saniye bekler.
Stok güncellemem neden hemen görünmüyor?
Servis eşzamansızdır. 200 yanıtı yalnız isteğin kabul edildiğini gösterir; değişiklik sırayla işlenir ve birkaç dakika sürebilir.
Barkodla stok gönderebilir miyim?
Canlıda doğrulanan alan ürün kodudur (code). Barkodla gönderimin çalıştığı doğrulanamadı.
Kaynaklar
İlgili Pazarama API konuları
Son güncelleme: 27.10.2026 · Pazarama API rehberinin tamamı