Çiçeksepeti Mağaza API Entegrasyon Rehberi

Çiçeksepeti mağazanızı NİTRU'ya bağlamak için API Key ve Supplier ID bilgilerine ihtiyacınız var. Çiçeksepeti REST tabanlı bir API sistemi kullanır.

1. Çiçeksepeti Satıcı Paneline Giriş

satis.ciceksepeti.com adresine satıcı hesabınızla giriş yapın.

2. Entegrasyon Sayfasına Erişim

API bilgilerinize ulaşmak için:

1. Sol menüden "Entegrasyon" sekmesine tıklayın.
2. Açılan sayfada "API Bilgileri" veya "Entegrasyon Ayarları" bölümüne gidin.

Alternatif yol: Hesabım → Mağaza Ayarları → API Entegrasyonu

3. API Key Oluşturma

API Bilgileri sayfasında:

1. Eğer daha önce API Key oluşturmadıysanız "API Anahtarı Oluştur" butonuna tıklayın.
2. Oluşan API Key'i kopyalayın ve güvenli bir yere kaydedin.
3. API Key genellikle uzun bir alfanumerik karakter dizisidir.

Önemli: Çiçeksepeti API Key'iniz hassas bir bilgidir. Kimseyle paylaşmayın ve güvenli bir yerde saklayın.

4. Supplier ID (Tedarikçi Numarası)

Supplier ID, Çiçeksepeti tarafından mağazanıza atanan benzersiz numaradır:

• Entegrasyon sayfasında "Tedarikçi No" veya "Supplier ID" olarak gösterilir.
• Alternatif olarak satıcı panelinin üst kısmında mağaza bilgileriniz arasında bulabilirsiniz.
• Bu numara genellikle 4-6 haneli bir sayıdır.

5. API Erişim Kapsamı

Çiçeksepeti API'si aşağıdaki işlemlere izin verir:

• Ürün İşlemleri: Listeleme, fiyat/stok güncelleme
• Sipariş İşlemleri: Listeleme, durum güncelleme, kargo bilgisi
• Soru-Cevap: Müşteri sorularını okuma ve yanıtlama
• Kategori: Kategori ağacını görüntüleme

Çiçeksepeti'nde API Key oluşturulduğunda tüm servislere otomatik erişim sağlanır.

6. Entegratör Kaydı

Bazı durumlarda Çiçeksepeti entegratör kaydı isteyebilir:

• Satıcı panelinde "Entegrasyon Bilgileri" sayfasında entegratör seçimi yapabilirsiniz.
• Entegratör listesinde NİTRU'yu seçin veya "Kendi Entegrasyonum" seçeneğini kullanın.
• Eğer entegratör kaydı zorunlu değilse, doğrudan API Key ile devam edebilirsiniz.

Çiçeksepeti için Supplier ID ve API Key bilgileri gereklidir. API Secret opsiyoneldir.

7. NİTRU'da Mağaza Ekleme

API bilgilerinizi aldıktan sonra NİTRU panelinde:

1. Mağaza Yönetimi sayfasına gidin.
2. "Yeni Mağaza" butonuna tıklayın.
3. Platform olarak Çiçeksepeti'ni seçin.
4. API Key ve Supplier ID bilgilerinizi girin.
5. "Doğrula" butonu ile bağlantıyı test edin.
6. Bağlantı başarılıysa "Ekle" butonuna tıklayarak mağazanızı kaydedin.

İpucu: Çiçeksepeti entegrasyonu genellikle anında çalışır. Bağlantı kurulduktan sonra siparişleriniz ve ürünleriniz hızlıca senkronize olur.

Özel Gün Dönemleri ve API

Çiçeksepeti, özel gün dönemlerinde (Sevgililer Günü, Anneler Günü vb.) yoğun trafik yaşar:

• Bu dönemlerde API yanıt süreleri uzayabilir.
• NİTRU, bu durumu otomatik olarak yönetir ve yeniden deneme mekanizması kullanır.
• Kampanya dönemlerinde stok ve fiyat güncellemelerinizi önceden yapmanız önerilir.

Sık Karşılaşılan Sorunlar

• "Geçersiz API Key" hatası: API Key'in tamamını kopyaladığınızdan emin olun. Bazı tarayıcılar uzun metinleri keserek kopyalayabilir.
• "Supplier bulunamadı" hatası: Supplier ID'nin doğru olduğunu kontrol edin. Sayısal bir değer olmalıdır.
• Ürünler eksik geliyor: Çiçeksepeti'nde "pasif" durumdaki ürünler API'de görünmeyebilir. Ürünlerinizin aktif olduğundan emin olun.

NİTRU Mağaza Yönetimi sayfasında tüm bağlı mağazalarınızı, API bağlantı durumlarını ve ürün sayılarını görebilirsiniz.