Çiçeksepeti nedir?
Çiçeksepeti, Türkiye’nin önemli niche pazaryerlerinden biri; çiçek, hediyelik, gıda ve ev tekstili gibi kategorilerde güçlü. Satıcı olarak Çiçeksepeti üzerinden satış yapıyorsanız ürün, stok, sipariş ve kargo süreçlerinizi Çiçeksepeti satıcı API’si üzerinden otomatize edebilirsiniz. Pazaryeri olduğu için Çiçeksepeti birçok operasyonel kararı — özellikle teslimatı — kendi kuralları çerçevesinde belirler; entegrasyon tasarımı bu kuralların üzerine kurulur.
Aras Kargo nedir?
Aras Kargo, Türkiye’nin en yaygın kargo ağlarından biri. Aras’ın gönderi oluşturma, takip numarası alma, etiket basma ve ücret sorgulama işlemleri için hem SOAP web servisi hem de REST API’si var. Pratikte en kritik nokta şube bağımlılığı: API erişim bilgileri (müşteri kodu, kullanıcı adı, şifre) anlaşmalı Aras şubesinden temin edilir ve entegrasyon kodunuzun şube tarafından sisteme tanımlanması gerekir — tanımlanmazsa “entegrasyon numarası sistemde tanımlı değil” hatası alırsınız. Bu, kanaldan bağımsız olarak Aras entegrasyonlarının en sık takıldığı yerdir.
Neden Çiçeksepeti ve Aras Kargo entegre edilmeli?
Önce dürüst çerçeve: Çiçeksepeti’nde varsayılan lojistik, Çiçeksepeti’nin kendi hızlı teslimat ağıdır. Çiçek, hediyelik ve gıda kategorilerinde sipariş bu ağa otomatik düşer ve çoğu satıcı için bu yeterlidir. Aras Kargo entegrasyonu, satıcıların büyük çoğunluğu için gerekli değildir; yalnızca satıcı kargo modundaki istisnai siparişlerde anlamlıdır. Bu istisnalar genellikle şunlardır:
- Çiçek dışı, büyük ebatlı ürünler: Ev tekstili, büyük hediyelik, saksı/aksesuar gibi standart kargoyla taşınması gereken ürünler.
- Hızlı ağın kapsamadığı bölgeler: Çiçeksepeti’nin kendi teslimatının ulaşmadığı yerlere şehirler arası gönderim.
- Avantajlı Aras anlaşması: Kendi Aras anlaşma fiyatınızın bu ürün grubunda mantıklı olduğu durumlar.
Bu istisnai siparişler için doğru kurulmuş bir entegrasyon şunları sağlar:
- Otomatik Aras gönderisi: Sipariş satıcı kargoya düştüğü anda Aras’ta gönderi kaydı açılır, kargo paneline el ile girmeniz gerekmez.
- Takip numarasının Çiçeksepeti’ne geri yazılması: Aras’tan dönen takip numarası Çiçeksepeti sipariş/kargo bildirim API’si üzerinden siparişe işlenir; akışın en kritik halkası budur.
- Bildirim süresine uyum: Çiçeksepeti’nin kargo bildirim süresi kaçırılmaz, satıcı performansınız zarar görmez.
Önemli: Taze çiçek ve aynı gün teslim ürünlerinde Çiçeksepeti’nin kendi ağı zaten en iyi çözümdür; Aras entegrasyonunu onlara zorlamak yanlış olur. Aras’ı yalnızca yukarıdaki dayanıklı, ebatlı ürün senaryolarına yönlendiriyoruz.
Çiçeksepeti Aras Kargo entegrasyonu nasıl yapılır?
Çiçeksepeti ile Aras arasında resmi bir tek tık eklenti olmadığı için iki yoldan biriyle ilerliyoruz: bir orchestration platformu üzerinden ya da Çiçeksepeti satıcı API’si ile Aras web servisini birbirine bağlayan custom köprü ile. Hangisi olursa olsun süreç şöyle işler:
- Önce gerçekten Aras’a ihtiyacınız olup olmadığını birlikte değerlendiriyoruz; istisnai sipariş hacminiz düşükse ağır bir kurulum yerine daha hafif bir akış öneriyoruz.
- Hangi ürünlerin satıcı kargoya (Aras), hangilerinin Çiçeksepeti hızlı ağında kalacağını ürün bazında kurala bağlıyoruz.
- Anlaşmalı Aras şubenizden API bilgilerini (müşteri kodu, kullanıcı adı, şifre) temin ediyor, entegrasyon kodunuzu şube sistemine tanımlatıyoruz — bu adım günler sürebilir, koordinasyonu biz yürütüyoruz.
- Çiçeksepeti satıcı API’si tarafında satıcı kargo siparişlerini ayırt eden filtreyi kuruyoruz.
- Aras gönderi kaydı, etiket çıktısı (A4 veya termal/ZPL) ve takip numarasının Çiçeksepeti’ne geri yazılması köprüsünü tasarlıyoruz.
- Test aşamasında birkaç gerçek satıcı kargo siparişi üzerinde uçtan uca deneme yapıyoruz; etiket çıktısını, panel bildirimini ve “entegrasyon numarası tanımlı” doğrulamasını şubeyle birlikte kontrol ediyoruz.
- Canlı geçişten sonra izleme yapıyor, bakım anlaşmasıyla Aras servis ve Çiçeksepeti API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
Çiçeksepeti satıcı kargo + Aras kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Her siparişin Aras’a düşürülmeye çalışılması. Filtre kurulmadığında, aslında Çiçeksepeti hızlı teslimatına gidecek siparişler için de gereksiz Aras kaydı oluşur ve operasyon karışır. Çözüm: yalnızca satıcı kargo modundaki, çiçek dışı/ebatlı ürünleri Aras akışına yönlendiren bir filtre tanımlamak.
- “Entegrasyon numarası sistemde tanımlı değil” hatası. Aras şubesi barkod/entegrasyon kodunu sisteme girmediğinde gönderi oluşturma çağrısı baştan reddedilir. Çözüm: kurulum öncesi şubeyle koordinasyon ve test aşamasında kodun tanımlı olduğunu gerçek bir gönderiyle doğrulamak.
- Takip numarası Çiçeksepeti’ne hiç yazılmaması. Aras gönderisi açılıyor ama takip numarası panele bildirilmiyor; sipariş “kargolanmadı” görünüp satıcı performansını düşürüyor. Çözüm: takip numarasını gönderi kaydının hemen ardından Çiçeksepeti bildirim API’sine yazan iki yönlü akış kurmak.
- Taze çiçeğin yanlışlıkla standart kargoya yönlendirilmesi. Ürün ayrımı yapılmazsa hassas, aynı gün teslim gerektiren ürünler Aras’a düşürülür ve teslimat kalitesi bozulur. Çözüm: kurulumda ürün-akış eşlemesini netleştirmek; çiçek ve hızlı teslim ürünlerini Çiçeksepeti’nin kendi ağında tutmak.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıda fark edilince düzeltmek çok daha fazla iş yükü ve performans riski yaratır.