Yanıtın yapısı
Yanıt üç üst alan içerir: batchId, itemCount ve items. items listesindeki her satırın alanları şunlardır:
| Alan | Anlamı |
|---|---|
| itemId | Satırın kimliği |
| status | Pending, Processing, Success, Warning ya da Failed |
| data | Gönderdiğiniz ürünün verisi; stockCode burada yer alır |
| failureReasons | Hata listesi; her biri message ve code alanlı |
| lastModificationDate | Satırın son güncellenme zamanı |
Satırı kendi kaydınızla eşleştirmek için data.stockCode alanını kullanın. Başarılı ürün yükleme satırlarında data içinde siteCode alanı da gelebilir.
Durumların anlamı
- Pending ve Processing: İşlem sürüyor. Bir süre sonra tekrar sorgulayın.
- Success: Satır başarıyla işlendi. Ürün yüklemede bu, ürünün inceleme sürecine alındığını gösterir; yayına girdiğini göstermez.
- Warning: Satır işlendi ama bir uyarı var. Çalışan entegrasyonlarda Warning başarılı kabul ediliyor; uyarı metnini yine de kaydedin.
- Failed: Satır reddedildi. failureReasons nedeni söyler.
Failed her zaman kalıcı bir hata değildir. "Mevcut bir istek bulunmaktadır" (PW_1065) mesajıyla gelen bir Failed satırı, ürünün inceleme kuyruğunda zaten beklediğini anlatır. Bu tür mesajlar için ürün onay süreci sayfasına bakın.
Doğru sorgulama düzeni
- Gönderimden hemen sonra değil, birkaç saniye sonra sorgulayın. Stok-fiyat işlemlerinde 4-5 saniyelik bir bekleme çoğu zaman yeterli oluyor.
- Ürün yüklemede satırlar daha uzun Pending kalabilir. 10 saniye arayla birkaç kez sormak, sürekli sorgudan daha verimlidir.
- Bir üst deneme sayısı belirleyin. Süre dolduğunda hâlâ Pending olan satırları "beklemede" olarak bırakıp sonraki turda yeniden sorun.
- batchId'yi ürünlerle birlikte saklayın. Sorun bildirildiğinde hangi işlemle gittiğini bilirsiniz.
- Hata mesajındaki Batch Id değerini de okuyun. "Aynı içerikle zaten bir istek" mesajı önceki işlemin numarasını verir; o batch'i sorgulayarak gerçek sonucu bulursunuz.
Sessiz hata tuzağı
En yaygın entegrasyon hatası, stok-fiyat isteğine 200 yanıtı geldiği için işlemi başarılı saymaktır. 200 yalnız batch'in alındığını söyler. Satırlar daha sonra Failed olabilir ve bu durumda stok ya da fiyat Çiçeksepeti'nde değişmemiştir.
Bu yüzden stok ve fiyat gönderen her akış, batch sonucunu en az bir kez kontrol etmeli ve Failed satırları kullanıcıya göstermelidir. Aksi hâlde kendi sisteminiz stoğu güncellenmiş sanır, Çiçeksepeti eski adetle satmaya devam eder.
Sık sorulanlar
Çiçeksepeti batchId ne işe yarar?
Asenkron işlemlerin takip numarasıdır. Ürün yükleme ve stok-fiyat güncellemesinin sonucunu GET /api/v1/Products/batch-status/{batchId} isteğiyle okursunuz.
Warning durumu başarılı mı sayılır?
Çalışan entegrasyonlarda Warning, satırın işlendiği anlamında başarılı kabul ediliyor. Uyarı metnini yine de kaydedip incelemek iyi olur.
Stok güncellemesi 200 döndü, yine de kontrol etmeli miyim?
Evet. 200 yalnız batch'in alındığını gösterir. Satırlar sonradan Failed olabilir; batch-status sonucunu kontrol etmezseniz başarısız güncellemeyi fark etmezsiniz.
Bir batch'in sonucu ne kadar süre sorgulanabilir?
Bu konuda doğrulanmış bir saklama süresi bilgisine ulaşamadık. batchId'yi gönderdiğiniz ürünlerle birlikte saklayın ve sonucu işlemden kısa süre sonra okuyun; uzun süre sonra sonuç alınamazsa ürün listesinden kontrol edin.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı