Çiçeksepeti nedir?
Çiçeksepeti, Türkiye’nin önemli niche pazaryerlerinden biri; çiçek, hediyelik, gıda, ev tekstili ve dekorasyon kategorilerinde güçlü. Satıcı olarak Çiçeksepeti üzerinden satış yapıyorsanız sipariş, ürün, stok ve kargo süreçlerinizi Çiçeksepeti satıcı API’si üzerinden otomatize edebilirsiniz. Bir pazaryeri olduğu için Çiçeksepeti birçok operasyonel kararı — en başta lojistiği — kendi kuralları çerçevesinde belirler. Entegrasyon tasarımı bu kuralların üzerine kurulur.
Yurtiçi Kargo nedir?
Yurtiçi Kargo, Türkiye’nin en köklü ve geniş şube ağına sahip kargo firmalarından biri; özellikle Anadolu’daki kapsama alanı geniştir. Gönderi oluşturma, takip numarası alma, etiket basma ve ücret sorgulama için bir API’si vardır. Buradaki kritik nokta şudur: Yurtiçi’nin açık API’si olsa da çoğu platform için resmi bir eklentisi yoktur — yaygın altyapılarda bile (örneğin WooCommerce) genelde custom entegrasyon gerekir. Ayrıca erişim bilgileri (müşteri kodu, kullanıcı adı, şifre) sözleşmeli Yurtiçi şubenizden temin edilir ve şube koordinasyonu sürecin parçasıdır. Şube/şahıs gönderi ayrımı ve peşin/fatura ödemeli gönderi tipleri de yapılandırmaya dahildir.
Neden Çiçeksepeti ve Yurtiçi Kargo entegre edilmeli?
Önce dürüst çerçeve: Çiçeksepeti’nde varsayılan lojistik kendi hızlı teslimat ağıdır (Çiçeksepeti Express) ve çiçek, hediyelik, gıda gibi kategorilerde sipariş otomatik bu ağa düşer. Bu kategorilerde harici kargoya gerek olmaz. Yurtiçi Kargo entegrasyonu yalnızca satıcı kargo modunu kullandığınız nadir, özel durumlarda gündeme gelir — büyük ebatlı ürün, çiçek dışı kategoriler, Express’in ulaşmadığı bölge ya da avantajlı Yurtiçi anlaşması. Yani “Çiçeksepeti için Yurtiçi entegrasyonu şart” demiyoruz; bu sayfa o özel senaryoyu doğru kurmak içindir.
O senaryoda doğru kurulmuş bir köprü şunları sağlar:
- Satıcı kargo siparişlerinde otomatik Yurtiçi gönderisi: Yalnızca satıcı kargoya uygun sipariş düştüğünde Yurtiçi’de gönderi kaydı açılır; Express siparişlerine dokunulmaz.
- Takip numarasının Çiçeksepeti’ne geri yazılması: Yurtiçi’den dönen takip numarası Çiçeksepeti siparişine bildirilir; bu adım köprünün en kritik halkasıdır.
- Çiçeksepeti kargo bildirim süresine uyum: Bildirim gecikirse sipariş “kargolanmadı” görünür ve satıcı performansınız etkilenir; otomasyon bu süreyi kaçırmanızı önler.
- Express ile satıcı kargonun net ayrımı: Hangi kategori ve ebat eşiğinin Yurtiçi’ye gideceği kurala bağlanır; gereksiz gönderi karışıklığı olmaz.
- Şube ve eklenti boşluğunun yönetimi: Resmi eklenti olmadığı için köprüyü biz geliştiriyor, şube erişim bilgisi temini ve “Kargo İşlem Görmemiş” gibi durumları baştan kurguluyoruz.
Büyük ebatlı ev tekstili veya dekorasyon ürünleri satıyor ve Yurtiçi’nin Anadolu kapsamasından yararlanmak istiyorsanız, bu akış satıcı kargo tarafını manuel panel yükü olmadan yürütmenizi sağlar.
Çiçeksepeti Yurtiçi Kargo entegrasyonu nasıl yapılır?
Çiçeksepeti ile Yurtiçi arasında resmi bir tek tık eklenti olmadığı için Çiçeksepeti satıcı API’si ile Yurtiçi Kargo API’sini birbirine bağlayan custom bir köprü geliştiriyoruz. Süreç şöyle işler:
- Önce gerçekten satıcı kargoya ihtiyacınız olup olmadığını netleştiriyoruz: hangi kategoriler ve ebatlar Express dışında kalıyor, hacim köprüyü mantıklı kılıyor mu.
- Sözleşmeli Yurtiçi şubenizden erişim bilgilerini (müşteri kodu, kullanıcı adı, şifre) temin ediyor, gerekli entegrasyon tanımlarını yaptırıyoruz — bu adım günler sürebilir, koordinasyonu biz yürütüyoruz.
- Çiçeksepeti satıcı API’si tarafında yalnızca satıcı kargo modundaki siparişleri ayırt eden akışı kuruyoruz; Express siparişleri köprünün dışında kalır.
- Yurtiçi gönderi kaydı, etiket çıktısı (A4 veya termal) ve takip numarasının Çiçeksepeti siparişine geri yazılması köprüsünü tasarlıyoruz; peşin/fatura ödemeli gönderi tipini sipariş özelliğine göre doğru seçiyoruz.
- Test aşamasında birkaç satıcı kargo siparişi üzerinde uçtan uca deneme yapıyoruz; etiket çıktısını, panel bildirimini ve şube tarafındaki kaydı doğruluyoruz.
- Canlı geçişten sonra ilk günlerde yoğun izleme yapıyor, bakım anlaşmasıyla Yurtiçi API ve Çiçeksepeti satıcı API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
Çiçeksepeti satıcı kargo + Yurtiçi kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Express siparişlerine yanlışlıkla Yurtiçi kaydı açılması. Akış kategori/ebat eşiğine göre ayrılmazsa, kendi teslimat ağına gitmesi gereken çiçek/gıda siparişleri için gereksiz Yurtiçi gönderisi oluşur. Çözüm: Çiçeksepeti API’sinden gelen sipariş tipine göre yalnızca satıcı kargo siparişlerini köprüye yönlendirmek.
- Takip numarasının Çiçeksepeti’ne hiç yazılmaması. Yurtiçi gönderisi açılıyor ama takip numarası siparişe bildirilmiyor; sipariş “kargolanmadı” görünüp performansı etkiliyor. Çözüm: takip numarasını gönderi kaydının hemen ardından siparişe geri yazan iki yönlü akış kurmak.
- “Kargo İşlem Görmemiş” durumu. Şube gönderiyi entegrasyon yerine manuel kestiğinde ya da erişim bilgileri eksik kaldığında takip bilgisi sisteme yansımaz, sipariş takılı kalır. Çözüm: kurulum öncesi şubeyle koordinasyon ve gönderi oluştuğu halde hareket gelmeyen siparişler için otomatik uyarı.
- Desi/ağırlık eksikliğiyle yanlış etiket. Büyük ebatlı ürünlerde katalogda boyut bilgisi yoksa Yurtiçi etiketi hatalı desi ile basılır, kargo ücreti tutmaz. Çözüm: kurulumda ürün-desi eşlemesini tamamlamak ve çok ürünlü siparişlerde toplam desiyi otomatik hesaplatmak.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıda fark edilince düzeltmek çok daha fazla iş yükü ve satıcı performans riski yaratır.