Çiçeksepeti nedir?
Çiçeksepeti, çiçek, hediyelik, gıda ve ev tekstili gibi kategorilerde güçlü, Türkiye’nin önemli niş pazaryerlerinden biridir. 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. Bu, faturalama tarafında önemli farklar yaratır: sipariş verisine ancak Çiçeksepeti satıcı API’si üzerinden ulaşır, alıcı bilgilerinin bir kısmını ise Çiçeksepeti sizinle hiç paylaşmaz. Üstelik hediye ve kart-mesaj odaklı yapısı yüzünden, faturanın muhatabı çoğu zaman teslimat adresindeki kişi değildir.
Bir-Fatura nedir?
Bir-Fatura, GİB’in özel entegratörü olarak çalışan, uygun maliyetli bir e-fatura ve e-arşiv kesim platformudur. Onu tam bir muhasebe yazılımından ayıran nokta şudur: Bir-Fatura bir fatura kesim katmanıdır — cari hesap, gelir-gider takibi veya kapsamlı raporlama için tasarlanmamıştır; işi hızlı ve düşük maliyetle yasal fatura kesmektir. e-fatura ve e-arşiv mükellefiyetiniz için GİB ile bağlantıyı doğrudan sağlar, yani Çiçeksepeti siparişinizin faturası Bir-Fatura üzerinden GİB’e iletilir. Sade yapısı küçük ve orta ölçekli pazaryeri satıcıları için onu cazip kılar.
Neden Çiçeksepeti ve Bir-Fatura entegre edilmeli?
Çiçeksepeti’nde her sipariş için e-fatura/e-arşiv kesimi yasal zorunluluktur. Anneler Günü, Sevgililer Günü gibi pik günlerde günde yüzlerce siparişi Çiçeksepeti panelinden CSV indirip Bir-Fatura paneline tek tek girmek 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, Bir-Fatura’da 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.
- Doğru muhatap: Fatura, teslimat adresindeki kişiye değil sipariş sahibine kesilir; hediye akışında karışıklık olmaz.
- Manuel panel derdinin sonu: CSV indirip Bir-Fatura’ya tek tek girme adımı tamamen ortadan kalkar.
- GİB uyumu: Fatura kesimi Bir-Fatura üzerinden GİB’e otomatik gönderilir, manuel beyan derdi kalmaz.
Manuel akışta pik dönemde bir kişinin tam zamanlı işine dönüşen Çiçeksepeti fatura takibi, otomatik akışta kendiliğinden yürür.
Çiçeksepeti Bir-Fatura entegrasyonu nasıl yapılır?
Önce dürüst olalım: Çiçeksepeti ile Bir-Fatura arasında tek tıkla kurulan resmi bir entegrasyon yok. Bir-Fatura bir kesim katmanı olduğundan, Çiçeksepeti satıcı API’sinden siparişi çekecek bir aracı 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, gıda, hediyelik), başka pazaryeri 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; ö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ı, KDV haritalaması, eksik müşteri bilgisi ve sipariş-sahibi/teslimat ayrımı senaryoları Bir-Fatura tarafında kurgulanır.
- Kapasiteyi düşünerek tasarlıyoruz: Bir-Fatura’nın istek kapasitesi pik günlerde darboğaz yapabildiği için kuyruk ve yeniden deneme mantığıyla kuruyoruz.
- 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 Bir-Fatura güncellemelerini takip etmek bakım anlaşmasıyla bizde kalır.
Lisanslar (Çiçeksepeti satıcı hesabı, Bir-Fatura, varsa orchestration platformu) sizin tarafınızda; biz kurulum, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
Çiçeksepeti-Bir-Fatura akışında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Eksik alıcı bilgisi. Çiçeksepeti bireysel siparişlerde KVKK gereği TC kimlik bilgisini çoğunlukla vermez. Çözüm: Bir-Fatura’da varsayılanı e-arşiv fatura olarak kurmak, sadece alıcı kurumsal fatura ve VKN girdiyse e-fatura kesmek.
- Faturanın yanlış kişiye kesilmesi. Hediye siparişlerinde teslimat adresindeki kişi sipariş sahibi değildir; fatura muhatabı teslimat adresine bağlanırsa yanlış kişiye fatura çıkar. Çözüm: fatura muhatabını her zaman sipariş sahibi üzerinden eşleştirmek.
- Pik günde fatura tıkanması. Anneler Günü gibi yoğun günlerde Bir-Fatura’nın istek kapasitesi zorlanır, fatura kesimi takılabilir. Çözüm: siparişleri kuyruğa alıp kontrollü hızda göndermek, geçici hatalarda otomatik yeniden deneme kurmak.
- İade sonrası fatura aktif kalması. Çiçeksepeti’nde iade onaylandığında Bir-Fatura’da fatura iptal/iade edilmezse KDV beyanı yanlış görünür. Çözüm: iptal/iade statü değişimini API’den yakalayıp iade akışını tanımlamak.
Dördü de kurulumda doğru tasarımla önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.