Çiçeksepeti nedir?
Çiçeksepeti, Türkiye’nin önde gelen niche pazaryerlerinden biridir; çiçek, hediyelik, gıda ve ev tekstili kategorilerinde güçlüdür. Satıcı olarak Çiçeksepeti Mağaza üzerinden satış yaparsınız; ürün listeleme, sipariş, aynı gün teslimat (Çiçeksepeti Express) ve tahsilat akışı büyük ölçüde Çiçeksepeti’nin kontrolündedir. Kendi e-ticaret sitenizin aksine alıcıyla doğrudan ilişki kurmazsınız; aradaki muhatap Çiçeksepeti’dir. Bu, faturalama tarafında belirgin farklar yaratır: sipariş verisine ancak Çiçeksepeti satıcı API’si üzerinden ulaşırsınız ve alıcı bilgilerinin bir kısmını Çiçeksepeti sizinle hiç paylaşmaz. Üstelik çiçek-hediye siparişlerinde “gönderen” ile “teslim alan” çoğu zaman ayrı kişilerdir, kart-mesaj ve randevulu teslim gibi alanlar da işin içine girer.
Logo nedir?
Logo, Türkiye’nin köklü ve yaygın muhasebe/iş yazılımıdır. Logo Tiger ve Logo Go ile muhasebe, stok, cari hesap takibi, e-fatura ve e-arşiv işlemlerini tek çatı altında toplar. Bir GİB özel entegratörü değil, kendi e-fatura/e-arşiv altyapısı olan bir muhasebe yazılımıdır; fatura GİB’e Logo’nun e-fatura altyapısı üzerinden iletilir. Önemli teknik fark şudur: Logo on-premise çalışır — yazılım kendi sunucunuzda veya yerel ağınızdaki bir makinede kuruludur, bulutta değildir. Bu, veri sahipliği ve kontrol açısından avantajlıdır; ama Çiçeksepeti gibi bulut tabanlı bir pazaryeriyle doğrudan konuşamaması nedeniyle araya bir köprü katmanı gerektirir.
Neden Çiçeksepeti ve Logo entegre edilmeli?
Çiçeksepeti’nde her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Yoğun günlerde (Sevgililer Günü, Anneler Günü) gelen yüzlerce siparişi panelden CSV indirip Logo’ya elle girmek sürdürülebilir değildir. Doğru kurulmuş bir köprü şunları sağlar:
- Otomatik fatura kesimi: Çiçeksepeti’ne düşen sipariş API üzerinden çekilir, Logo’da otomatik e-arşiv veya e-fatura olarak kesilir.
- Manuel panel/CSV derdinin bitmesi: Çiçeksepeti panelinden tek tek indirip Logo’ya kopyalama işi tamamen ortadan kalkar.
- 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.
- Temiz cari kayıt: Aynı alıcı için Logo’da mükerrer cari açılmaz, raporlama tutarlı kalır.
- Stok ve raporun Logo’da kalması: Satış sonrası Logo stok ve cari kayıtları güncel kalır, mali raporlama mevcut Logo altyapınızdan yürür.
Manuel akışta bir kişinin tam zamanlı işi olan Çiçeksepeti fatura takibi, otomatik akışta kendiliğinden yürür.
Çiçeksepeti Logo entegrasyonu nasıl yapılır?
Önce dürüst olalım: Çiçeksepeti ile Logo arasında tek tıkla kurulan resmi bir entegrasyon yok. Logo on-premise, Çiçeksepeti bulutta; ikisini birbirine bağlamak için araya bir köprü katmanı şart. Zeisoft olarak bu katmanı kuruyoruz ve sürecimiz şöyle işler:
- Mevcut süreci inceliyoruz: Aylık Çiçeksepeti sipariş hacmi, hangi Logo ürününü (Tiger/Go) ve sürümünü kullandığınız, Logo Connect modülünüz olup olmadığı ve fatura kurallarınız belirleniyor.
- Köprü yöntemini seçiyoruz: Logo Connect modülünüz varsa onun üzerinden, yoksa Logo Object/REST katmanı kullanılarak custom köprü kuruyoruz. Sunucu erişimi, sabit IP veya VPN gereksinimleri bu aşamada netleşir.
- API erişimini açıyoruz: Çiçeksepeti satıcı panelinden API anahtarı/kimlik bilgileri 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ı, KDV haritalaması, kart-mesajlı/randevulu siparişler ve eksik müşteri bilgisi senaryoları Logo tarafında kurgulanır.
- Test ediyoruz: Gerçek 5-10 Çiçeksepeti siparişi üzerinde — bireysel, kurumsal, iade, gönderen/teslim alan farklı — fatura kesimini doğruluyoruz.
- Bakım veriyoruz: Çiçeksepeti API kural değişikliklerini ve Logo sürüm güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (Çiçeksepeti, Logo, varsa Logo Connect modülü) sizin tarafınızda; biz köprü kurulumu, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
Çiçeksepeti-Logo akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Eksik alıcı bilgisi ve gönderen/teslim alan ayrımı. Çiçeksepeti bireysel siparişlerde KVKK gereği TC kimlik bilgisini çoğunlukla vermez; üstelik çiçek-hediye siparişinde faturalanacak kişi (gönderen) ile teslim alan farklıdır. Çözüm: varsayılanı gönderen adına e-arşiv fatura olarak kurmak, sadece alıcı kurumsal fatura ve VKN girdiyse e-fatura kesmek.
- On-premise köprü kopması. Logo kendi sunucunuzda olduğu için sunucu kapanması, IP değişimi veya VPN sorunu köprüyü düşürebilir ve siparişler Logo’ya akmaz. Çözüm: bağlantıyı izleyen ve kesinti olduğunda uyarı veren bir kontrol katmanı kurmak, erişim gereksinimlerini baştan sabitlemek.
- Gecikmeli fatura. Çiçeksepeti webhook yerine sorgulama (polling) ile çalıştığından sorgu aralığı geniş tutulursa fatura geç kesilir; aynı gün teslimatlı çiçek/gıda siparişinde bu sorun yaratır. Çözüm: sipariş çekme aralığını yoğunluğa göre 5-15 dakikaya ayarlamak ve doğru statüde tetiklemek.
- İade sonrası fatura aktif kalması. Bozulabilir ürün nedeniyle reddedilen veya iade edilen siparişte Logo’da fatura iptal/iade edilmezse KDV beyanı yanlış görünür. Çözüm: iptal/iade statü değişimini API’den yakalayıp Logo’da iade faturası kesim kuralını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.