Çiçeksepeti entegrasyonu, Çiçeksepeti'nde satış yapan mağazanın ürün, stok, fiyat, sipariş, kargo, fatura, iade ve soru-cevap işlemlerini Çiçeksepeti Marketplace API ile yazılımdan yönetmesidir. API REST yapısındadır ve belgeleri ciceksepeti.dev adresinde herkese açıktır.
İlgili içerikler: Pazaryeri entegrasyonu rehberi · Trendyol entegrasyonu · Pazarama entegrasyonu · Kargo entegrasyonu
API Anahtarı ve Ortamlar
- İlk kez: Satıcı panelinde Çiçeksepeti Destek Ekibi, Konuşma Başlat yolundan "API Entegrasyon Süreçleri" konusuyla talep açılır.
- Daha önce oluşturulduysa: Hesap Yönetimi, Entegrasyon Bilgilerim bölümünde görünür.
- Test ve canlı: Ayrı anahtar verilir; test anahtarı ayrıca istenir. Canlı
https://apis.ciceksepeti.com/api/v1/, testhttps://sandbox-apis.ciceksepeti.com/api/v1/. - Başlıklar: Her istekte
x-api-keyveuser-agent. Kendi yazılımınızla bağlanıyorsanız user-agent yalnızca satıcı numaranızdır; entegratör kullanıyorsanız "SatıcıId-EntegratörAdı". - Güvenlik: TLS 1.2 ve üzeri zorunlu.
Ürün Servisleri
| İşlem | Uç nokta | Not |
|---|---|---|
| Kategori listesi | GET /Categories | |
| Kategori özellikleri | GET /Categories/{categoryId}/attributes | Varyant, ürün ve kişiselleştirilebilir özellik türleri |
| Ürün yükleme | POST /Products | En çok 1.000 öğe; farklı içerikle 5 saniyede 1 istek |
| Ürün güncelleme | PUT /Products | En çok 200 öğe; saniyede 1 istek |
| Stok ve fiyat | PUT /Products/price-and-stock | En çok 200 öğe; saniyede 1 istek, aynı içerik 30 dakikada 1 |
| Ürün listeleme | GET /Products | Sayfa başına en çok 60 |
| Toplu işlem sonucu | GET /Products/batch-status/{batchId} |
Ürün yüklemede zorunlu alanlar: productName, mainProductCode, stockCode, categoryId (en alt kırılım), StockQuantity, TotalPrice, description, images, deliveryType (1 servis aracı, 2 kargo, 3 ikisi) ve deliveryMessageType. Kategoride zorunlu özellik varsa attributes da gönderilir.
- İşlemler kuyruğa alınır: ürün açma ve güncelleme en geç 24 saatte, stok-fiyat en geç 4 saatte tamamlanır. Başarısız dönen ürünleri yeniden gönderin.
- Üstü çizili fiyat ile satış fiyatı arasındaki fark yüzde 1'den az, yüzde 80'den fazla olamaz; fiyat bir seferde mevcut fiyatın yarısının altına indirilemez.
- Liste fiyatı tek başına güncellenemez, satış fiyatıyla birlikte gönderilir.
- Barkod, varyant özelliği ve ürünün kendisini pasife alma API ile yapılamaz; panelden destek talebi gerekir. Varyant pasife alınabilir.
Sipariş ve Kargo
| İşlem | Uç nokta |
|---|---|
| Sipariş listeleme | POST /Order/GetOrders (sayfa başına en çok 100, tarih aralığı en çok 2 hafta) |
| Kendi kargo entegrasyonunuzla gönderim | PUT /Order/statusupdatewithsupplierintegration |
| Çiçeksepeti kargo entegrasyonuyla gönderim | PUT /Order/readyforcargowithcsintegration |
| Kargo firmasını değiştirme | PUT /Order/CargoCompany |
| Desi ve adet bildirme | POST /Order/CargoMeasurement |
| Fatura gönderimi | POST /Branch/SendInvoiceMail (base64 belge veya PDF bağlantısı) |
| statusId | Sipariş durumu |
|---|---|
| 1 | Yeni |
| 2 | Hazırlanıyor |
| 11 | Kargoya Verilecek |
| 5 | Kargoya Verildi |
| 7 | Teslim Edildi |
| 3 | Arabaya Verildi |
| 18 | Firmaya İade Edildi |
Çiçeksepeti kargo entegrasyonunda kargo kodunu Çiçeksepeti üretir; kendi kargo entegrasyonunuzda kodu siz üretip bildirirsiniz. Kendi kargo entegrasyonunuz için kargo entegrasyonu rehberine bakın.
İade ve Soru-Cevap
- İadeler
POST /Order/getcanceledordersile listelenir; teslim alındığı bildirilir vePOST /Order/cancelevaluationile onaylanır (1) veya reddedilir (3). - İade durumları: 20 süreç başladı, 21 kargoda, 22 tedarikçide, 23 tedarikçi onayı bekliyor.
- Müşteri soruları
GET /sellerquestionsile çekilir (tarih aralığı en çok 32 gün),PUT /sellerquestions/{id}ile yanıtlanır.
Sık Sorulan Sorular
Çiçeksepeti'nde test ortamı var mı?
Evet: sandbox-apis.ciceksepeti.com. Ayrı bir test API anahtarı istemeniz gerekir.
Ürünü API ile pasife alabilir miyim?
Yalnızca varyantı pasife alabilirsiniz. Ürünün kendisi için panelden destek talebi açılır.
Stok ve fiyatı ne sıklıkla güncelleyebilirim?
Saniyede 1 istek, istek başına en çok 200 ürün; aynı içerik 30 dakikada bir gönderilebilir.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.