İstek yapısı
Gövde tek bir alan içerir: items. Her satırda kullanılan alanlar şunlardır:
| Alan | Zorunlu | Açıklama |
|---|---|---|
| stockCode | Evet | Ürünü seçen satıcı stok kodu |
| stockQuantity | Stok için | Yeni stok adedi |
| salesPrice | Fiyat için | Satış fiyatı |
| listPrice | Fiyat için | Liste (üstü çizili) fiyatı |
Örnek satır: stockCode: STOK_KODU, stockQuantity: 12. Yalnız stok değişecekse fiyat alanlarını göndermeyin. Aynı servis fiyat güncellemesinde de kullanılır; ayrıntı Çiçeksepeti fiyat güncelleme sayfasındadır.
Sonucu doğrulamak
Yanıttaki batchId, işlemin takip numarasıdır. 200 yanıtı yalnız isteğin alındığını gösterir. Birkaç saniye sonra GET /api/v1/Products/batch-status/{batchId} isteğiyle satırların durumunu okuyun:
- Success ya da Warning: Stok güncellendi.
- Pending ya da Processing: İşlem sürüyor; biraz sonra tekrar sorun.
- Failed: Stok değişmedi; failureReasons nedeni söyler.
En sık Failed nedeni, gönderilen stok kodunun Çiçeksepeti'ndeki ürünle eşleşmemesidir. Kodları yükleme sırasında değiştirdiyseniz (örneğin Türkçe harfleri çevirdiyseniz) stok güncellemesinde de aynı, değiştirilmiş kodu kullanmalısınız.
Sınırlar ve gönderim düzeni
Çiçeksepeti'nin genel istek sınırları bu servis için de geçerlidir. Arka arkaya istekler limit mesajı alabilir.
- Stok değişikliklerini tek tek değil, birden fazla ürünü aynı items listesinde toplayarak gönderin.
- Aynı içerikli isteği kısa sürede tekrarlamayın; aynı istek sınırına takılır.
- Limit mesajı gelirse "Kalan Süre" kadar bekleyip yeniden gönderin.
- Bir ürünün stoğunu kısa sürede birden çok kez değiştirmeniz gerekiyorsa son değeri bekletip tek seferde gönderin.
Çok kanallı satışta her zaman güncel toplam adedi gönderin. Servis artırma ya da azaltma değil, yeni adet alır.
Sık hatalar
- 200'ü başarı saymak: Batch sonucunu okumayan entegrasyon, başarısız güncellemeyi hiç fark etmez.
- productCode göndermek: Stok güncellemesi stockCode ile yapılır; Çiçeksepeti'nin ürün kodu bu alanda işe yaramaz.
- Onay bekleyen ürüne stok göndermek: İncelemedeki ürün henüz listede yoktur; stok onaydan sonra gönderilmelidir.
- Negatif adet: Stok sıfırın altına inmemelidir; sıfırda bırakın.
- Kendi kaydını önce güncellemek: Çiçeksepeti'nden onay gelmeden kendi sisteminizdeki adedi değiştirirseniz iki taraf ayrışır. Önce sonucu doğrulayın.
Satıcı gözüyle konunun özeti: N11 ve Çiçeksepeti stok güncelleme.
Sık sorulanlar
Çiçeksepeti'nde stok API ile nasıl güncellenir?
PUT /api/v1/Products/price-and-stock isteğinde items listesine her ürün için stockCode ve stockQuantity yazılır. Yanıttaki batchId ile sonuç batch-status servisinden kontrol edilir.
Yalnız stok gönderirsem fiyat değişir mi?
Çalışan bir entegrasyonda yalnız stockCode ve stockQuantity gönderilen istekler fiyatı değiştirmeden stoğu güncelliyor. Fiyat alanlarını yalnız fiyat değiştirecekseniz ekleyin.
Stok güncellemesi neden Failed olur?
En sık neden stok kodunun Çiçeksepeti'ndeki ürünle eşleşmemesidir. failureReasons alanındaki mesajı okuyun ve gönderdiğiniz kodu ürün listesindeki stockCode ile karşılaştırın.
Çiçeksepeti stok güncellemesi anında yansır mı?
İşlem asenkrondur; batch birkaç saniye içinde işlenir. Sonucu batch-status ile doğruladıktan sonra stoğun güncellendiğini kabul edin.
Stoğu sıfırlamak ürünü satıştan kaldırır mı?
Stok sıfır olduğunda ürün satılamaz hâle gelir. Ürünü silmeden geçici olarak kapatmanın en pratik yolu budur; stok geldiğinde yeni adedi aynı servisle gönderirsiniz.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı