Çiçeksepeti nedir?
Çiçeksepeti, Türkiye’nin önemli niche pazaryerlerinden biridir; çiçek, hediyelik, gıda ve ev tekstili kategorilerinde güçlüdür. Satıcı olarak Çiçeksepeti mağazanız üzerinden satış yaparsınız; ürün listeleme, sipariş, teslimat ve tahsilat akışı Çiçeksepeti’nin kontrolündedir. Kendi e-ticaret sitenizin aksine müşteriyle doğrudan ilişki kurmaz, alıcıyla aranızda Çiçeksepeti durur. Üstelik birçok sipariş hediye amaçlıdır: siparişi veren kişi ile ürünün gönderildiği kişi çoğu zaman farklıdır. Bu durum faturalama tarafında ek bir özen gerektirir; sipariş verisine ise ancak Çiçeksepeti satıcı API’si üzerinden ulaşırsınız.
Paraşüt nedir?
Paraşüt, Türkiye’deki KOBİ’lerin tercih ettiği bulut tabanlı ön muhasebe ve e-fatura yazılımıdır. e-fatura ve e-arşiv mükellefiyetiniz için GİB ile bağlantıyı sağlar; cari hesap, gelir-gider takibi, banka entegrasyonları ve raporlama tek panelde toplanır. Paraşüt GİB özel entegratörü olarak fatura kesim yetkisine sahiptir, yani Çiçeksepeti siparişinizin faturası Paraşüt üzerinden doğrudan GİB’e iletilir.
Neden Çiçeksepeti ve Paraşüt entegre edilmeli?
Çiçeksepeti’nde her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Sevgililer Günü, Anneler Günü gibi tepe dönemlerde gelen yüzlerce siparişi panelden tek tek faturalamak sürdürülebilir değil. Doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik fatura kesimi: Çiçeksepeti’ne düşen sipariş API üzerinden çekilir, Paraşüt’te otomatik e-arşiv veya e-fatura olarak kesilir.
- Doğru fatura türü: Bireysel alıcıya e-arşiv, VKN giren kurumsal alıcıya e-fatura — sistem ayrımı kendisi yapar.
- Hediye siparişinde doğru muhatap: Fatura ödemeyi yapan alıcıya kesilir, teslimat adresi ve kart-mesaj bilgisiyle karışmaz.
- Temiz cari kayıt: Aynı alıcı için mükerrer cari açılmaz, raporlama tutarlı kalır.
- GİB uyumu: Fatura kesimi Paraşüt üzerinden GİB’e otomatik gönderilir, manuel beyan derdi kalmaz.
Manuel akışta tepe dönemlerinde bir kişinin tam zamanlı işine dönen Çiçeksepeti fatura takibi, otomatik akışta kendiliğinden yürür.
Çiçeksepeti Paraşüt entegrasyonu nasıl yapılır?
Önce dürüst olalım: Çiçeksepeti ile Paraşüt arasında tek tıkla kurulan resmi bir entegrasyon yok. Paraşüt’ün kendi pazaryeri bağlayıcıları Çiçeksepeti özelinde çoğu zaman kapsam dışı kalıyor, araya bir katman gerekiyor. Zeisoft olarak bu katmanı iki yoldan biriyle kuruyoruz — sipariş hacminize ve mevcut altyapınıza göre doğru olanı seçiyoruz:
- Mevcut süreci inceliyoruz: Aylık Çiçeksepeti sipariş hacmi, hangi kategorilerde sattığınız (çiçek, hediyelik, gıda), başka pazaryeri/site kullanıp kullanmadığınız ve fatura kurallarınız belirleniyor.
- Yöntemi seçiyoruz: Tek pazaryeri ve orta hacim için bir orchestration platformu yeterli olabilir; hediye siparişi gibi özel iş kuralları veya çoklu kanal varsa Çiçeksepeti satıcı API’si üzerine custom köprü kuruyoruz.
- API erişimini açıyoruz: Çiçeksepeti satıcı panelinden API anahtarları alınır; sipariş çekme aralığı ve fatura tetikleme statüsü yapılandırılır.
- Fatura kurallarını tanımlıyoruz: e-arşiv/e-fatura ayrımı, alıcı-teslimat ayrımı, KDV haritalaması ve eksik müşteri bilgisi senaryoları Paraşüt tarafında kurgulanır.
- Test ediyoruz: Gerçek 5-10 Çiçeksepeti siparişi üzerinde — bireysel, kurumsal, hediye, iade — fatura kesimini doğruluyoruz.
- Bakım veriyoruz: Çiçeksepeti API kural değişikliklerini ve Paraşüt güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (Çiçeksepeti, Paraşüt, varsa orchestration platformu) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
Çiçeksepeti-Paraşüt akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Faturanın yanlış kişiye kesilmesi. Hediye siparişlerinde siparişi veren ile ürünün gittiği kişi farklı olduğundan, kural doğru kurulmazsa fatura teslimat alıcısına kesiliyor. Çözüm: faturayı ödemeyi yapan alıcıya kesecek, teslimat ve kart-mesaj bilgisini faturadan ayrı tutacak şekilde eşleştirme kurmak.
- Eksik alıcı bilgisi. Çiçeksepeti bireysel siparişlerde TC kimlik bilgisini çoğunlukla vermez. Çözüm: varsayılanı e-arşiv fatura olarak kurmak, sadece alıcı kurumsal fatura ve VKN girdiyse e-fatura kesmek.
- Gecikmeli fatura. Çiçeksepeti API’si webhook yerine sorgulama (polling) ile çalıştığından, sorgu aralığı geniş tutulursa aynı gün teslimatlı çiçek siparişinde fatura geç kesiliyor. Çözüm: sipariş çekme aralığını kategoriye ve yoğunluğa göre 5-15 dakikaya ayarlamak.
- İade/iptal sonrası fatura aktif kalması. Çiçek gibi bozulabilir üründe çoğu zaman fiziksel iade yerine ücret iadesi yapılır; iptal API’den yakalanmazsa Paraşüt’te fatura açık kalıp KDV beyanı yanlış görünür. Çözüm: iptal/iade statü değişimini API’den okuyup iade akışını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.