Çiçeksepeti entegrasyonu:
ürün, stok ve sipariş tek panelde.

Çiçeksepeti entegrasyonu nedir, kimin işine yarar?

Çiçeksepeti entegrasyonu, mağazanızdaki ilanları elle güncellemek yerine stok ve fiyat bilgisini tek bir ürün kartından Çiçeksepeti'ne gönderen, siparişleri ise geri okuyan bağlantıdır. Çiçeksepeti Akademi'ye göre platform 30 farklı kategoride satıcı kabul ediyor; elektronik, ev ve yaşam, kozmetik, moda, takı, pet shop, süpermarket ve çiçek bunlardan bazıları. Yani Çiçeksepeti artık yalnız çiçekçilerin değil, hediye olarak alınabilecek hemen her ürünü satanların kanalı.

Çiçeksepeti'ni tek kanal olarak kullanan ve az ürünü olan bir satıcı için satıcı paneli bir süre yeterli olabilir. Bir çiçeksepeti entegrasyon programı şu durumlarda ihtiyaca dönüşür:

• Aynı stoğu Trendyol, Hepsiburada ya da kendi sitenizle paylaşıyorsunuz; bir kanalda satılan son ürünün Çiçeksepeti'nde de düşmesi gerekiyor.
• Sevgililer Günü, Anneler Günü ve yılbaşı gibi dönemlerde sipariş sayınız katlanıyor ve stoğu elle düşmek iptal riskini büyütüyor.
• Renk, beden ya da kişiselleştirme seçenekli ürünleriniz var ve her varyantı ayrı kodla yönetmeniz gerekiyor.
• Çiçeksepeti'nin komisyon, kargo ve listeleme kesintilerini sipariş bazında kontrol etmek istiyorsunuz.

Çiçeksepeti Akademi, satıcı puanını etkileyen ölçütler arasında siparişi tamamlama süresini ve ürünü tedarik edebilmeyi sayıyor. Bu yüzden çiçeksepeti stok entegrasyonu, birden fazla kanalda satan biri için yalnız bir kolaylık değil, iptali ve puan kaybını önleyen bir önlemdir. Bütün kanalları tek tabloda görmek için pazaryeri entegrasyonu sayfasına bakabilirsiniz.

Çiçeksepeti'nde satıcı olma şartları ve başvuru evrakları

Çiçeksepeti'nde satış yapmak için vergi levhası sahibi olmanız ve fatura kesebilmeniz gerekir; Çiçeksepeti Akademi'ye göre vergi muafiyet belgesiyle başvuru kabul edilmez. Şahıs şirketi, limited, anonim şirket, adi ortaklık ve tacirler başvurabilir. Şahıs şirketleri T.C. kimlik numarasıyla, limited ve anonim şirketler vergi kimlik numarasıyla kayıt olur. Her numarayla yalnız bir üyelik açılabilir ve hakediş yalnız vergi levhasındaki firmanın banka hesabına ödenir. Mağaza açmak ücretsizdir.

Başvuruda istenen belgeler

• Son bir yılı gösteren vergi levhası ve imza sirküleri
• Her sayfası kaşeli ve imzalı Bayi Bilgi Formu, Çiçeksepeti Sözleşmesi ve Platform Kullanım Kuralları
• Banka bilgisini gösteren belge ya da hesap cüzdanı
• Şahıs şirketi, tacir ve adi ortaklıklarda nüfus cüzdanının ön yüzü; adi ortaklıklarda ayrıca ortaklık sözleşmesi

Belgeler PDF olarak yüklenir; ticaret sicil gazetesi ve ticaret sicil belgesi zorunlu değildir. Başvuru ciceksepeti.com'daki Çiçeksepeti'nde Satış Yap alanından, telefon ve e-posta doğrulamasıyla yapılır. Kadın Girişimci, Öğrenci ve STK gibi ayrı başvuru tipleri vardır; onay süresi resmî sayfada gün olarak verilmemiştir.

Çiçeksepeti komisyonu, kesinti kalemleri ve hakediş ödeme günü

Çiçeksepeti herkese açık bir kategori komisyon tablosu yayımlamaz: komisyon oranı ürünü listelediğiniz kategoriye göre değişir ve size uygulanan oran Bayi Bilgi Formu'nda ve satıcı panelinde Ürün Yönetimi > Ürün Listesi ekranında görünür. Başvuruda seçtiğiniz kategori dışında ürün satarsanız o kategorinin oranı uygulanır. Kesintiler İş Ortaklığı ve İlan Sözleşmesi'ndeki Finansal Şartlar'a göre yapılır:

Hakediş tarihini kaydıran durumlar

Ödeme takvimi kargoya verdiğiniz günden değil, siparişin Teslim Edildi statüsüne geçtiği günden başlar. Teslimatı uzayan sipariş hakedişi de uzatır; süre çarşambadan sonra dolarsa ödeme bir sonraki çarşambaya kalır. Kampanyada kullanılan indirim kuponlarının tutarı hakediş detaylarında ayrıca görünür. Fiyatınızı kurarken oranınızı komisyon hesaplama aracına girip kargo ve stopajla birlikte sonucu kontrol edin.

Çiçeksepeti API bilgileri nereden alınır?

Çiçeksepeti API bilgileri satıcı panelinde Hesap Yönetimi > Entegrasyon Bilgilerim ekranındadır. Bu ekranda API anahtarı (x-api-key) ile birlikte Satıcı ID ve Entegratör Adı alanları yer alır. Mağazanız için API bilgisi daha önce tanımlanmadıysa ekran boş kalır ve bilgileri Çiçeksepeti'nden istemeniz gerekir. Çiçeksepeti'nin geliştirici dokümanındaki yolu Yox İş Ortağım kurulumuyla birleştirince süreç şöyle ilerler:

1. Satıcı paneline girin ve Çiçeksepeti Destek Ekibi > Konuşma Başlat adımlarını izleyin.
2. Konu başlığı olarak API Entegrasyon Süreçleri'ni seçip canlı mağazanız için API bilgisi isteyin.
3. Bilgiler oluşturulduktan sonra Entegrasyon Bilgilerim ekranından API anahtarınızı ve Satıcı ID'nizi kontrol edin.
4. Entegratörle çalıştığınız için Entegratör Adı alanını doldurun; Çiçeksepeti bu bilgiyi mağazaya hangi yazılımın bağlandığını görmek için kullanır.
5. Bilgileri Yox İş Ortağım panelinde Çiçeksepeti kanalına girin; mevcut ilanlarınız okunur ve barkod ya da stok koduyla ürün kartlarınızla eşleştirilir.
6. Eşleşme listesini onayladığınızda stok, fiyat ve sipariş senkronu başlar; onayınız olmadan hiçbir ilan değişmez.

Çiçeksepeti test (sandbox) ve canlı mağaza için farklı API anahtarları verir; canlı mağazayı test anahtarıyla bağlamaya çalışmak sık görülen bir bağlantı hatasıdır. Çiçeksepeti API entegrasyonu için mağaza şifreniz istenmez, yalnız anahtar ve Satıcı ID yeterlidir.

Çiçeksepeti API kuralları: hız sınırları ve işlem kuyruğu

Çiçeksepeti Marketplace API; ürün yükleme, ürün ve stok-fiyat güncelleme, sipariş ve kargo yönetimi, fatura gönderimi ve iade için servis sunar. Ürün ve stok servisleri istekleri sıraya alarak çalışır: işlem önce Pending (beklemede) görünür, sonucu batch kontrolüyle doğrulanır. Aşağıdaki kurallar Çiçeksepeti'nin geliştirici dokümanından alınmıştır ve hangi yazılımı kullanırsanız kullanın geçerlidir:

API ile değiştirilemeyen alanlar

• Barkod: ürüne tanımlı barkod API ile değiştirilemez.
• Ürün özellikleri: güncelleme için satıcı panelinden destek talebi açılır; değişen bir varyant özelliğiyse yeni varyant oluşturulabilir.
• Ürünün tamamını pasife almak: API ile yalnız varyant pasife alınır, ürünün kendisi için destek talebi gerekir.

Bu sınırlar ilk kurulumda önem kazanır. Barkodu yanlış girilmiş bir ürünü API ile düzeltemeyeceğiniz için eşleştirmeyi onaylamadan önce barkod ve stok kodlarını kontrol etmek, sonradan destek talebiyle uğraşmaktan çok daha az zaman alır.

Çiçeksepeti entegrasyonu ile ürün gönderimi: kategori, özellik ve teslimat tipi

Yox İş Ortağım'da ürün kartınız Çiçeksepeti kategorisine ve o kategorinin özelliklerine eşleştirilir; beden ve renk gibi varyantlar tek karttan yönetilir. Çiçeksepeti'nde bir ürünün kabul edilip edilmeyeceğini şu alanlar belirler.

En alt kategori ve zorunlu özellikler

Ürün, Çiçeksepeti kategori listesindeki en alt kategorinin kimliğiyle açılır. Her kategori kendi özellik listesini döndürür: varyant oluşturan özellikler (renk, beden gibi), ürün özellikleri ve kişiselleştirilebilir özellikler. Zorunlu işaretli bir özellik eksikse ürün açılmaz. Kişiselleştirilebilir özellik yalnız kişiye özel ürünlerde, örneğin bilekliğe yazılacak isim için kullanılır; Çiçeksepeti kurallarına göre kişiye özel ürünlerde iade kabul edilmez.

Teslimat tipi ve teslimat aralığı

Çiçeksepeti'ne özgü iki zorunlu alan vardır: teslimat tipi (servis aracı, kargo ya da ikisi birden) ve teslimat aralığı (Hediye Kargo Aynı Gün, 1-3 iş günü, 1-5 iş günü gibi). Alıcı bu süreyi ürün sayfasında görür; karşılayamayacağınız bir aralık seçmek geciken siparişe ve satıcı puanı kaybına yol açar.

Fiyat, görsel ve açıklama kuralları

• Üstü çizili fiyat, mevzuat gereği ürünün son 30 gündeki en düşük satış fiyatı olmalı; satış fiyatıyla arasındaki fark %1'den az, %80'den fazla olamaz.
• Görseller en az 500x500, en fazla 2000x2000 piksel ve 5 MB olmalı; satıcı logosu ya da iletişim bilgisi içermemeli.
• Açıklama düz metin olarak en az 30 karakter olmalı; firma adı, web sitesi, e-posta ve telefon yazılamaz.
• Markasız ürün satılamaz; markanızı önce Ürün Yönetimi > Marka Tescil İşlemleri ekranından tanımlatın.

Yüklenen ürünler Ürün Onay Bekliyor statüsünde Çiçeksepeti ekiplerince incelenir; onaylananlar satışa açılır, eksik olanlar düzeltme için geri gönderilir.

Çiçeksepeti kargo modelleri, sipariş statüleri ve fatura

Çiçeksepeti siparişleri API üzerinden iki farklı kargo modeliyle yönetilir ve hangisini kullanacağınızı entegrasyondan önce Çiçeksepeti'ndeki bayi sorumlunuzla netleştirmeniz gerekir. Çiçeksepeti'ne göre kendi kargo anlaşmanız ve fiyatlarınızla çıkış yapmak istiyorsanız bir entegrasyon yazılımıyla API üzerinden çalışmanız şarttır.

Kendi sözleşmenizle çalışırken etiket basıldığında takip numarası Çiçeksepeti siparişine işlenir; firma tarafını Yurtiçi Kargo entegrasyonu sayfasında anlattık. Başlangıç paketinde kargo entegrasyonu yoktur, takip numarası elle girilir. Lojistik firmasına atanan yüksek desili siparişlerde Çiçeksepeti desi ve parça sayısını ister; koli ölçüsünü desi hesaplama aracıyla önceden bulabilirsiniz.

Sipariş statüleri

Sipariş Yeni olarak düşer, hazırlığa başlayınca Hazırlanıyor'a, bitince Kargoya Verilecek'e alınır; ardından Kargoya Verildi ve Teslim Edildi gelir. Servis aracıyla teslim edilen ürünlerde Kargoya Verildi yerine Arabaya Verildi kullanılır. Ana siparişteki her ürün ayrı alt sipariş numarasıyla gelir; aynı alıcının alt siparişlerini tek pakette gönderebilirsiniz. Yox İş Ortağım'da Çiçeksepeti siparişleri diğer kanallarla aynı listeye düşer.

Fatura pakete değil sisteme

Faturayı kendi unvanınızla siz kesersiniz: bireysel alıcıya ad soyad ve tutarla, şirket adına alımda vergi dairesi, vergi numarası ve adresle. Sipariş hediye olabileceği için Çiçeksepeti faturanın pakete konmamasını ister; PDF satıcı paneline ya da API ile siparişe yüklenir, Çiçeksepeti alıcıya e-postayla iletir. GİB'e göre e-Fatura sistemine kayıtlı olmayan alıcıya e-Arşiv Fatura düzenlenir. Yox İş Ortağım'da belge bağlı muhasebe programınızdan, örneğin Paraşüt üzerinden kesilir; e-Fatura bağlantısı Profesyonel paketle başlar.

Elle yönetim ile Yox İş Ortağım arasındaki fark ve paket seçimi

Çiçeksepeti satıcı paneli ve Excel şablonu tek kanal için iş görür; fark, ikinci kanal eklendiği anda ortaya çıkar. Aşağıdaki karşılaştırma yalnız panelde tanımlı işlevleri içerir:

Çiçeksepeti hangi pakette bağlanır?

Çiçeksepeti, Başlangıç paketinde seçilebilen yedi kanaldan biridir; Büyüme paketinde üç kanal, Kurumsal ve Enterprise'da sınırsız kanal bağlanır. Yıllık ödemede %20 indirim uygulanır; bütün limitler paket karşılaştırmasında yer alır.

Paneli 3 gün ücretsiz deneyebilir, önce kısa bir ön görüşme yapabilirsiniz; isterseniz kurulumu sizinle birlikte yaparız. Başlamak için Yox İş Ortağım'a başvurun.

Çiçeksepeti entegrasyonu kurulum kontrol listesi ve sık yapılan hatalar

Çiçeksepeti entegrasyonunda sorunların çoğu ilk bağlantı günü, yanlış eşleşmeden ya da eksik ayardan çıkar. Senkronu başlatmadan önce şu listeyi tamamlayın:

• Mağaza onaylandı, API bilgileri Entegrasyon Bilgilerim ekranında görünüyor ve canlı anahtar kullanılıyor.
• Kargo modeli bayi sorumlunuzla netleşti; kendi anlaşmanızı kullanacaksanız firma adı Çiçeksepeti'ne bildirildi.
• Her ürün ve varyant için ayrı stok kodu var; barkodlar doğru, çünkü sonradan API ile değiştirilemez.
• Bayi Bilgi Formu'ndaki komisyon oranları ve azami ödeme süreleri elinizde.
• Teslimat aralıkları gerçekten gönderebileceğiniz süreye göre seçildi.
• Depodaki stok sayıldı; özel gün dönemleri için tampon stok belirlendi.

Sık yapılan hatalar

• Test anahtarıyla canlı mağazayı bağlamaya çalışmak.
• Varyantlara ortak stok kodu vermek: bir rengin satışı başka rengin stoğunu düşürür.
• Faturayı kolinin içine koymak: hediye siparişinde alıcı ürünün fiyatını görür.
• Stok-fiyat güncellemesinin Çiçeksepeti tarafında kuyruğa girdiğini unutup son adedi bütün kanallarda açık bırakmak.
• Kesintileri yalnız ay sonunda toplam olarak kontrol etmek; fazla kesilen komisyon ve kargo sipariş bazında bakılmazsa gözden kaçar.

Listeyi birlikte gözden geçirmek isterseniz iletişim sayfasından bize ulaşın; ön görüşmede mağazanızın ürün ve sipariş hacmine uygun paketi birlikte belirleriz.