Aşamalar
| Aşama | Nerede görünür | Ne yapmalı |
|---|---|---|
| 1. Gönderim | POST /api/v1/Products yanıtında batchId | batchId'yi ürünlerle birlikte saklayın |
| 2. Batch işleme | batch-status: Pending ya da Processing | Birkaç saniye arayla tekrar sorun |
| 3. Batch sonucu | batch-status: Success, Warning ya da Failed | Failed satırların nedenini okuyun |
| 4. İnceleme | Ürün listesinde henüz yok | Yeniden göndermeyin, bekleyin |
| 5. Yayın | GET /api/v1/Products listesinde ürün görünür | Ürünü kendi sisteminizle eşleştirin |
Success ya da Warning, batch'in o ürünü kabul ettiğini söyler; ürünün yayında olduğunu söylemez. Başarılı satırlarda siteCode alanı da gelebilir.
Beklemede olduğunu gösteren yanıtlar
- PW_1065, "mevcut bir istek bulunmaktadır": Ürün için inceleme kuyruğunda açık bir istek var. Bu bir hata değil, bekleme durumudur.
- "Aynı içerikle zaten bir istek": Aynı gün aynı içerikli bir istek gönderilmiş. Mesajdaki Batch Id ile önceki sonucu sorgulayın; aynı içerikle yeniden denemeyin.
- Ürün listede yok: Kod notlarına göre ürün listeleme servisi onay bekleyen ürünleri döndürmüyor. "Listede yok" demek "yüklenmedi" demek değildir.
Bu üç durumu hata sayan bir entegrasyon, aynı ürünleri tekrar tekrar gönderir ve kullanıcıya yüzlerce "başarısız" ürün gösterir. Doğrusu, gönderilen ürünü bekleyen olarak işaretleyip belli bir süre "eksik ürün" listesinden çıkarmaktır.
Onayı doğru izlemek
Onayı izlemenin güvenilir yolu iki kaynağı birlikte kullanmaktır: batch-status sonucu ve ürün listesi. Önerilen düzen şöyledir:
- Gönderdiğiniz her stok kodunu bir bekleme tablosuna yazın; gönderim zamanını ve batchId'yi saklayın.
- batch-status Failed dönerse kaydı ret olarak kapatın, nedeni kullanıcıya gösterin.
- Ürün listesini düzenli aralıklarla çekin; stok kodu listede görünen kaydı onaylandı olarak kapatın.
- Belirlediğiniz süre (örneğin 48 saat) dolduğu hâlde ürün görünmüyorsa kaydı "sonuçsuz" olarak işaretleyin ve panelden kontrol edin.
Reddi önlemek için
Çiçeksepeti aynı gün aynı içerikli ikinci isteği kabul etmediği için ilk denemenin temiz olması zaman kazandırır. Gönderimden önce görsel sayısını, kod karakterlerini, yasaklı kelimeleri ve açıklamayı kontrol edin. Kurallar Çiçeksepeti ürün yükleme sayfasında, sık mesajlar hata mesajları sayfasında.
Sık sorulanlar
Çiçeksepeti ürün onayı ne kadar sürer?
İnceleme süresi için 24 saate kadar ifadesi kullanılıyor. Canlı kullanımda bir günü aşan istekler de görüldü; bu yüzden 48 saatlik bir takip süresi planlamak daha güvenlidir.
Onay bekleyen ürün API'de görünür mü?
Kod notlarına göre ürün listeleme servisi onay bekleyen ürünleri döndürmüyor. Ürün ancak onaylandıktan sonra listede görünür.
Aynı ürünü tekrar göndermek onayı hızlandırır mı?
Hayır. Açık istek varken gönderilen ürün PW_1065 yanıtı alır; aynı gün aynı içerikle gönderilen istek de kabul edilmez. Beklemek gerekir.
Batch Success döndü, ürün yayında mı?
Henüz değil. Success ya da Warning, batch'in ürünü kabul ettiğini söyler. Ürün inceleme sonrası onaylanınca ürün listesinde görünür; yayında olduğunu oradan doğrulayın.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı