Çiçeksepeti Entegrasyonu Nasıl Yapılır? Adım Adım

Bu yazıda

Kısa cevap: Çiçeksepeti entegrasyonu nasıl yapılır?
Başlamadan önce hazırlayın
Adım 1: API bilgilerini alın
Adım 2: Entegratör Adı alanını doldurun
Adım 3: Kargo modelini seçin
Adım 4: Kategorileri eşleştirin, ürünleri gönderin
Sipariş ve fatura
Sık görülen sorunlar
Güvenlik: API anahtarını kim görmeli?
Webtegra'ya Çiçeksepeti mağazası bağlamak
Sık sorulanlar
Kaynaklar

Çiçeksepeti'ni ikinci ya da üçüncü mağaza olarak açtınız ve siparişleri, stoğu, faturayı diğer mağazalarınızla aynı programdan yönetmek istiyorsunuz. Çiçeksepeti'nde bağlantı Trendyol'dakinden iki noktada ayrılır: API bilgileri ilk kez panelden değil destek talebiyle verilir, siparişin kargo süreci de seçtiğiniz kargo modeline göre değişir.

Entegrasyonun genel mantığını pazaryeri entegrasyonu nedir yazısında anlattık. Bu yazıda Çiçeksepeti entegrasyonunu dört adımda topladık: API bilgilerini almak, Entegratör Adı alanını doldurmak, kargo modelini seçmek ve ürünleri göndermek. Ardından sipariş ve fatura, sık görülen sorunlar ve güvenlik geliyor. Bütün adımlar Çiçeksepeti'nin API dokümanından (ciceksepeti.dev) ve Çiçeksepeti Akademi'nin sıkça sorulan sorularından, 5 Kasım 2026'da okundu.

Kısa cevap: Çiçeksepeti entegrasyonu nasıl yapılır?

API bilgileriniz daha önce oluşturulmadıysa satıcı panelinde Çiçeksepeti Destek Ekibi > Konuşma Başlat yolundan "API Entegrasyon Süreçleri" başlığıyla talep açın. Bilgiler talep üzerinden iletilir.
Bilgiler oluşturulduysa satıcı panelinde Hesap Yönetimi > Entegrasyon Bilgilerim alanında API anahtarınızı (x-api-key) ve Satıcı ID'nizi görün.
Bir entegratörle çalışıyorsanız aynı alandaki Entegratör Adı alanını doldurun.
Canlı mağazanızın API anahtarını entegrasyon programınıza girin. Çiçeksepeti test ve canlı mağaza için ayrı anahtar verir.
Kargo modelinizi seçin: Çiçeksepeti'nin kargo entegrasyonu ya da kendi kargo entegrasyonunuz. Seçtiğiniz model hem Çiçeksepeti mağaza ayarlarında hem programda aynı tanımlanmalı.
Kategori ve özellikleri eşleştirip ürünleri gönderin; sonucu işlem statülerinden izleyin.

Başlamadan önce hazırlayın

Onaylı bir Çiçeksepeti mağazası. Çiçeksepeti'ne göre satıcı olmak için vergi levhası ve fatura kesebilme şartı aranır; vergi muafiyet belgesiyle başvuru kabul edilmez.
Kargo kararı. Çiçeksepeti'nin anlaşmalı kargo firmalarıyla mı, kendi kargo anlaşmanızla mı göndereceğinizi bilin. Bu karar entegrasyonun kurulumunu değiştirir.
Markalar. Çiçeksepeti'nde markasız ürün satılmaz. Markanızı satıcı panelinde Ürün Yönetimi > Marka Tescil İşlemleri adımlarıyla eklersiniz.
Varyant kodları. Stok ve fiyat güncellemesi ürünün tedarikçi varyant koduyla (stockCode) yapılır; her varyantın kendi kodu olmalı. Terimin ayrıntısı SKU maddesinde.
Görseller. Çiçeksepeti görsellerin 500x500 ile 2000x2000 piksel arasında ve 5 MB'a kadar olmasını istiyor.

Adım 1: API bilgilerini alın

Çiçeksepeti API'sine yapılan her istekte iki bilgi gönderilir: API anahtarı (x-api-key) ve user-agent. Çiçeksepeti'nin dokümanına göre bilgilere şöyle ulaşılır:

İlk kez alıyorsanız: Canlı mağaza için API bilgileri daha önce tanımlanmadıysa satıcı panelinde Çiçeksepeti Destek Ekibi > Konuşma Başlat düğmelerine tıklayıp "API Entegrasyon Süreçleri" konu başlığından talep oluşturursunuz. API bilgileri oluşturulup bu talep üzerinden iletilir.
Daha önce oluşturulduysa: Bilgiler satıcı panelinde Hesap Yönetimi > Entegrasyon Bilgilerim alanındadır.
Paneli kullanmıyorsanız: Çiçeksepeti'nde firmanızdan sorumlu kişiyle iletişime geçersiniz.
Test ve canlı ayrı: Test ve canlı ortam için farklı anahtarlar verilir; test anahtarı ayrıca talep edilir.

Çiçeksepeti Akademi API Key'i, entegrasyonla Çiçeksepeti paneli arasında bağlantı kurmanızı sağlayan kod diye tanımlıyor: anahtarı entegratörünüze verdiğinizde işlemleri API üzerinden yaparsınız. Bu anahtar mağazanızın ürünlerine, siparişlerine ve fiyatlarına erişim demektir; ekran görüntüsüyle ya da mesajla dolaştırmayın. Terimin ayrıntısı API anahtarı maddesinde.

Programınıza canlı mağazanın anahtarını girin. Test işlemleri ayrı bir test adresinde yapılır; test anahtarıyla kurulan bağlantı canlı mağazanızdaki siparişleri getirmez.

Adım 2: Entegratör Adı alanını doldurun

Entegrasyon Bilgilerim başlığı altında Satıcı ID ve Entegratör Adı bilgileri durur. Program, Çiçeksepeti'ne her istekte kim olduğunu bu iki bilgiyle söyler. Çiçeksepeti'nin kuralı şöyle:

Durum	Entegratör Adı alanı	Programın gönderdiği user-agent
Bir entegratör firmayla çalışıyorsunuz	Entegratörün adını yazarsınız	"Satıcı ID-Entegratör Adı"
Yazılımı kendiniz yaptınız	Boş bırakabilirsiniz	Yalnız "Satıcı ID"

Çiçeksepeti bu alanın zorunlu olmadığını, ekranda çıkan açıklamanın yalnız uyarı olduğunu yazıyor; ama hangi entegratörü kullandığınızın tespit edilebilmesi için doldurulmasını önemli buluyor. Alana ne yazılacağını çalıştığınız programdan öğrenin ve programı değiştirdiğinizde bu alanı da güncelleyin. Entegratör teriminin ayrıntısı sözlükte.

Adım 3: Kargo modelini seçin

Çiçeksepeti siparişlerinin kargo süreci API üzerinden iki şekilde yönetilir. Çiçeksepeti'ne göre kullanılacak model hem Çiçeksepeti mağaza ayarlarında hem de entegrasyon ayarlarında tanımlanmalıdır.

Konu	Çiçeksepeti kargo entegrasyonu	Kendi kargo entegrasyonunuz
Kargo firması	Yalnız Çiçeksepeti'nin anlaşmalı olduğu firmalar	İstediğiniz firma; firmaların adını Çiçeksepeti'ne bildirirsiniz
Kargo kodu	Çiçeksepeti oluşturur; program alt sipariş numarasıyla alır	Sizin ya da entegratörünüzün oluşturduğu kargo barkodu
Statü güncellemesi	Statüleri ve müşteri bilgilendirmesini Çiçeksepeti takip eder	Statü ve takip bilgisini siz güncellersiniz; Çiçeksepeti müşteriye bu güncellemelere göre e-posta ve SMS gönderir
Kimin için	Çiçeksepeti'nin anlaşmalı kargo firmalarıyla göndermek isteyen satıcı	Kendi kargo anlaşması ve fiyatlarıyla çıkmak isteyen satıcı

Çiçeksepeti'nin kargo entegrasyonunda hangi firmayla çalışacağınız, gönderi ve iade gönderi bedelini kimin ödeyeceğiyle birlikte Çiçeksepeti sistemine tanımlanır. Aynı pakete koyacağınız alt siparişler için tek kargo kodu alınabilir; alıcı adı ve adresi farklıysa farklı kodlar verilir.

Kendi kargo anlaşmanızla çıkmak istiyorsanız Çiçeksepeti Akademi'ye göre bir entegrasyon firmasıyla çalışmanız ve gönderiyi API üzerinden oluşturmanız gerekir. Bu modelde siparişin takibinden siz sorumlusunuz. İki özel durum var: kendi entegrasyonunuzla Yurtiçi Kargo kullanıyorsanız siparişi yalnız "Kargoya Verilecek" statüsüne çekersiniz ve kargo barkodunu Çiçeksepeti oluşturur; aynı gün servis aracıyla teslim edilen siparişlerde statü "Arabaya Verildi" olmalıdır.

Adım 4: Kategorileri eşleştirin, ürünleri gönderin

Çiçeksepeti'nin anlatımına göre ürünün yükleneceği kategori Çiçeksepeti'nin kategori listesinden alınır. Ürünün varyant ve özellik bilgileri de o kategoride tanımlı zorunlu ve isteğe bağlı özelliklere göre gönderilir. Ürün açma isteği sıraya alınır ve 24 saate kadar tamamlanır. Programınız her işlemin sonucunu şu statülerle görür:

Statü	Anlamı	Ne yapmalı
Pending	İşlem sırada bekliyor	Bekleyin
Processing	İşleme başlandı	Bekleyin
Success	İşlem başarılı	Ürünü panelde kontrol edin
Warning	İşlem başarılı, ama gönderilen istek kontrol edilmeli	Programdaki uyarıyı okuyun
Failed	İşlem yapılamadı; teknik bir hata var	Ürünü yeniden gönderin

Ürün kartında ve stokta Çiçeksepeti'nin dokümanındaki şu kurallar, programın neyi yapıp neyi yapamayacağını belirler:

Konu	Çiçeksepeti'nin kuralı
Ürün bilgisi güncelleme	Sıraya alınır, 24 saate kadar tamamlanır
Özellik (attribute) bilgisi	API ile güncellenmez; satıcı panelinden destek talebi açılır. Varyant özelliğinde güncelleme yerine yeni varyant açılabilir
Barkod	Yüklerken isteğe bağlı; gönderilirse 3 ile 50 karakter arası. Sonradan API ile güncellenmez
Stok ve fiyat	Varyant koduyla gönderilir, 4 saate kadar tamamlanır; aynı istek yarım saatte bir gönderilebilir
Üstü çizili fiyat	Tek başına güncellenmez, satış fiyatıyla birlikte gönderilir
Satıştan kaldırma	Varyant API ile pasife alınabilir; ürünün kendisi için panelden destek talebi açılır

Stok ve fiyat güncellemesi sıraya alındığı için programda değiştirdiğiniz rakam Çiçeksepeti'nde hemen görünmeyebilir. Kampanya ve sezon günlerinde, son adetleri satılan ürünlerde bu payı hesaba katın; birden çok mağazada satılan son ürün için sanal stok ayırmak bu riski azaltır.

Sipariş ve fatura

Ana sipariş ve alt sipariş. Bir siparişte birden çok ürün varsa her biri ayrı alt sipariş numarasıyla gelir. Kargo kodu ve fatura alt sipariş üzerinden işlenir.
Sipariş statüleri. Çiçeksepeti'nin dokümanındaki statüler Yeni, Hazırlanıyor, Kargoya Verilecek, Kargoya Verildi ve Teslim Edildi. İptal edilen sipariş pasif olarak işaretlenir.
Fatura pakete konmaz. Çiçeksepeti'ne göre faturayı kendi ünvanınızla düzenler ve satıcı panelinden yüklersiniz; ürün hediye olabileceği için fatura ürünle gönderilmez. API'de fatura, alt sipariş numarasıyla PDF dosyası ya da PDF bağlantısı olarak gönderilir; Çiçeksepeti onu sıraya alır ve müşteriye e-postayla iletir.
İade. İade siparişler API'den çekilir; ürün size ulaşınca teslim aldığınız bildirilir, sonra iade onaylanır ya da reddedilir. Anlaşmazlıkta Çiçeksepeti'nin kararı siparişte görünür: müşteri haklı bulunursa para iade edilir, siz haklı bulunursanız ürün müşteriye yeniden gönderilir.

Sık görülen sorunlar

Sorun	Çiçeksepeti'nin dokümanına göre sebep	Ne yapmalı
"Geçersiz API Key"	API anahtarı eksik ya da tanımsız	Anahtarı Entegrasyon Bilgilerim'den yeniden kopyalayın; canlı mağaza için canlı anahtarı kullandığınızı kontrol edin
Ürün gönderildi ama panelde yok	İşlem sırada (Pending) ya da başarısız (Failed)	İşlem statüsüne bakın; Failed ise ürünü yeniden gönderin
Ürün özelliği programdan değişmiyor	Özellik bilgisi API ile güncellenmez	Satıcı panelinden destek talebi açın
Barkod programdan değişmiyor	Barkod API ile güncellenmez	Değişikliği panelden Çiçeksepeti'ne sorun
Üstü çizili fiyat değişmiyor	Liste fiyatı tek başına güncellenmez	Satış fiyatıyla birlikte gönderin
Ürün programdan satıştan kalkmıyor	Ürünün kendisi API ile pasife alınamaz	Panelden destek talebi açın; varyantı programdan pasife alabilirsiniz
Kargo kodu ya da statü beklenen gibi ilerlemiyor	Kargo modeli mağaza ayarlarında ve entegrasyonda aynı tanımlı olmalı	İki yerde aynı modeli seçin

Güvenlik: API anahtarını kim görmeli?

Anahtarı programa kendiniz girin. Ekran görüntüsüyle ya da mesajla göndermeyin; anahtar mağazanızın siparişlerine ve fiyatlarına erişim demektir.
Bıraktığınız programın erişimini kapatın. Çiçeksepeti'nin API dokümanında anahtarın nasıl yenileneceği yazmıyor (5 Kasım 2026). Programı bıraktığınızda ya da anahtar yanlış kişiye gittiğinde panelden "API Entegrasyon Süreçleri" başlığıyla talep açıp Çiçeksepeti'ne sorun. Program değiştirirken izlenecek sıra entegrasyon programı değiştirme yazısında.
Entegratör Adı'nı güncel tutun. Programı değiştirdiğinizde alandaki adı da değiştirin.
Stok ve fiyatı tek programdan gönderin. İki program aynı ürüne farklı rakam gönderirse son gelen geçerli olur. Ayrıntısı stok senkronizasyonu maddesinde.

Webtegra'ya Çiçeksepeti mağazası bağlamak

Webtegra'da sıra şöyledir: kayıt olur, firma ayarlarınızı yapar, Entegrasyon API ayarları ekranına Çiçeksepeti'deki canlı mağaza bilgilerinizi girersiniz. Ardından marka ve kategori eşleştirmesini yapar, ürün kartlarınızı Çiçeksepeti'ne bağlarsınız. Ürünleriniz başka bir pazaryerinde zaten satıştaysa onları Excel, XML, bağlantı ya da pazaryeri kataloğundan topluca aktarırsınız. Her adımın videosu eğitim sayfasında. Bağlantı adımlarını destek ekibimiz uzaktan bağlanarak sizinle birlikte yapabilir; yerinde kurulum yapılmaz. Kendi kargo anlaşmanızla çıkmak istiyorsanız kurulumdan önce bunu destek ekibimize söyleyin.

Bağlantıdan sonra Çiçeksepeti siparişleri diğer pazaryerlerinizin siparişleriyle aynı listeye düşer, stok bütün mağazalarda aynı ürün kartından düşer, fatura siparişten kesilip pazaryerine gönderilir. Mikro dışındaki paketlerde paketleme ekranı her ürünün barkodu okutulmadan paketi kapatmaz (barkodlu paketleme). Anlaşmalı kargo firmaları ve Webtegra'nın kargo entegrasyonları Çiçeksepeti entegrasyonu sayfasında. Komisyon, ödeme altyapı ve listeleme bedelinden sonra bir satışın ne bıraktığını Çiçeksepeti komisyon hesaplama aracında görebilirsiniz.

Kullandıkça Öde paketinde aylık sabit ücret yok, sipariş başı 3 TL (KDV dahil) ödersiniz. Mikro, KOBİ ve Kurumsal paketlerde 3 ay koşulsuz iade imkânı var.

Sık sorulanlar

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

API bilgileriniz daha önce oluşturulduysa satıcı panelinde Hesap Yönetimi > Entegrasyon Bilgilerim alanındadır. İlk kez alıyorsanız panelde Çiçeksepeti Destek Ekibi > Konuşma Başlat yolundan "API Entegrasyon Süreçleri" başlığıyla talep açarsınız; bilgiler talep üzerinden iletilir.

Çiçeksepeti Entegratör Adı alanına ne yazılır?

Bir entegratörle çalışıyorsanız entegratörün adı yazılır; program da Çiçeksepeti'ne "Satıcı ID-Entegratör Adı" bilgisini gönderir. Yazılımı kendiniz yaptıysanız alanı boş bırakabilirsiniz. Alana yazılacak adı çalıştığınız programdan öğrenin.

Çiçeksepeti test ve canlı API anahtarı farklı mı?

Evet. Çiçeksepeti test ve canlı mağaza için ayrı anahtar verir; test anahtarı ayrıca talep edilir. Programınıza canlı mağazanızın anahtarını girersiniz.

Çiçeksepeti'ne ürün gönderdim, neden panelde görünmüyor?

Ürün açma isteği sıraya alınır ve 24 saate kadar tamamlanır. İşlem statüsü Pending ya da Processing ise bekleyin; Failed ise teknik bir hata vardır ve ürünü yeniden göndermeniz gerekir.

Çiçeksepeti'nde faturayı pakete koymalı mıyım?

Hayır. Çiçeksepeti'ne göre faturayı kendi ünvanınızla düzenleyip satıcı panelinden yüklersiniz ya da programınız API ile gönderir; ürün hediye olabileceği için fatura paketle gönderilmez.

Kendi kargo anlaşmamla Çiçeksepeti siparişi gönderebilir miyim?

Evet. Çiçeksepeti'ne göre bunun için bir entegrasyon firmasıyla çalışmanız ve gönderiyi API üzerinden oluşturmanız gerekir. Bu modelde statü ve takip bilgisini siz güncellersiniz; çalıştığınız kargo firmalarının adını Çiçeksepeti'ne bildirirsiniz.

Bu yazı bilgilendirme amaçlıdır; mali ve hukuki görüş değildir. Adımlar 5 Kasım 2026 itibarıyla Çiçeksepeti'nin API dokümanından ve Çiçeksepeti Akademi'den derlendi; panel menü adları değişebilir. Fatura, e-arşiv ve e-fatura ayarlarınız için mali müşavirinize danışın.

Çiçeksepeti Entegrasyonu Nasıl Yapılır? API Key, Entegratör Adı ve Kargo Modeli