Hepsiburada nedir?
Hepsiburada, Türkiye’nin önde gelen pazaryerlerinden biri. Satıcı olarak Hepsiburada Mağaza üzerinden satış yapıyorsanız ürün listeleme, sipariş, stok, fiyat ve kargo süreçlerinizi Hepsiburada Merchant API üzerinden otomatize edebilirsiniz. Pazaryeri olduğu için Hepsiburada birçok operasyonel kararı — özellikle 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 yaygın kapsama alanıyla öne çıkar. Gönderi oluşturma, takip numarası alma, etiket basma ve ücret sorgulama işlemleri için açık bir API’si vardır. Pratikteki en kritik nokta şu: Yurtiçi Kargo çoğu platform için resmi, hazır bir eklenti sunmaz — bağlantı her zaman custom entegrasyon gerektirir. Ek olarak şube/şahıs gönderi ayrımı ve peşin/fatura ödeme tipleri yapılandırmada özel ilgi ister; erişim bilgileri (müşteri kodu, kullanıcı adı, şifre) anlaşmalı Yurtiçi şubesinden temin edilir.
Neden Hepsiburada ve Yurtiçi Kargo entegre edilmeli?
Önce dürüst çerçeve: Hepsiburada’da varsayılan lojistik HepsiJet’tir ve çoğu satıcı için yeterlidir; sipariş otomatik HepsiJet’e düşer, ek entegrasyon gerekmez. Yurtiçi Kargo entegrasyonu yalnızca satıcı kargo modunu kullandığınızda devreye girer. O senaryoda doğru kurulmuş bir entegrasyon şunları sağlar:
- Satıcı kargo siparişlerinde otomatik Yurtiçi gönderisi: Sipariş satıcı kargoya düştüğü anda Yurtiçi’de gönderi kaydı açılır, kargo paneline el ile girmeniz gerekmez.
- Takip numarasının Hepsiburada’ya geri yazılması: Yurtiçi’den dönen takip numarası Hepsiburada Merchant API üzerinden siparişe bildirilir; bu adım entegrasyonun en kritik halkasıdır.
- Hepsiburada kargo bildirim süresine uyum: Hepsiburada, sipariş onayından sonra belirli sürede kargo bildirimi şart koşar; otomasyon bu süreyi kaçırmanızı ve performans puanı kaybını önler.
- Custom köprünün baştan doğru kurulması: Yurtiçi’nin resmi eklentisi olmadığı için bağlantı tamamen özel geliştirmedir; şube/şahıs gönderi ve ödeme tipi ayrımı kurulumda kurallara bağlanır.
- Doğru kargo seçimi: Hangi siparişin Yurtiçi’ye (satıcı kargo), hangisinin HepsiJet’e gideceği kurala bağlanır; karışıklık olmaz.
Büyük ebatlı ürün satıyorsanız veya Yurtiçi’nin Anadolu kapsama alanından faydalanmak istiyorsanız, bu akış satıcı kargo tarafını HepsiJet’in manuel yükü olmadan yürütmenizi sağlar.
Hepsiburada Yurtiçi Kargo entegrasyonu nasıl yapılır?
Yurtiçi Kargo’nun resmi bir tek tık eklentisi olmadığı için bağlantıyı her durumda custom geliştiriyoruz: ya Hepsiburada Merchant API ile Yurtiçi API’sini birbirine bağlayan özel bir köprü ile ya da bir orchestration platformu (Sentos, Platin360 gibi) üzerinden. Hangisi olursa olsun süreç şöyle işler:
- Mevcut sipariş hacminizi ve hangi ürünlerin satıcı kargoya gideceğini birlikte belirliyoruz.
- Anlaşmalı Yurtiçi şubenizden erişim bilgilerini (müşteri kodu, kullanıcı adı, şifre) temin ediyoruz; Yurtiçi’nin altyapısı bazı firmalardan farklı çalıştığı için bu adım günler sürebilir, koordinasyonu biz yürütüyoruz.
- Hepsiburada Merchant API tarafında satıcı kargo siparişlerini ayırt eden akışı kuruyoruz.
- Yurtiçi gönderi kaydı, şube/şahıs gönderi ve peşin/fatura ödeme tipi kurallarını, etiket çıktısını (A4 veya termal) ve takip numarasının Hepsiburada Merchant API’ye geri yazılmasını içeren köprüyü tasarlıyoruz.
- Test aşamasında 5-10 satıcı kargo siparişi üzerinde uçtan uca deneme yapıyoruz; etiket çıktısını ve panel bildirimini şube doğrulamasıyla birlikte kontrol ediyoruz.
- Canlı geçişten sonra ilk günlerde yoğun izleme yapıyor, bakım anlaşmasıyla Yurtiçi API ve Hepsiburada Merchant API değişikliklerini takip ediyoruz.
Sıkça karşılaşılan sorunlar
Hepsiburada satıcı kargo + Yurtiçi kombinasyonunda sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Takip numarası Hepsiburada’ya hiç yazılmaması. Yurtiçi gönderisi açılıyor ama takip numarası Merchant API’ye bildirilmiyor; sipariş “kargolanmadı” görünüp performans puanına yol açıyor. Çözüm: takip numarasını gönderi kaydının hemen ardından panele geri yazan iki yönlü akış kurmak.
- “Kargo İşlem Görmemiş” hatası. Şube kargoyu entegrasyon sistemi yerine manuel kestiğinde hareket kaydı sisteme dönmez, sipariş “kargo bekliyor” durumunda takılır. Çözüm: kurulumda gönderilerin entegrasyon üzerinden kesilmesini sağlamak ve hareket dönmeyen gönderileri otomatik tespit edip uyarmak.
- Ödeme tipi karışıklığı. Yurtiçi’de peşin ve fatura ödemeli gönderiler farklı yapılandırma ister; yanlış tip seçilince gönderi reddedilir veya ücret hatası oluşur. Çözüm: sipariş türüne göre doğru ödeme tipini otomatik seçen kuralları entegrasyona gömmek.
- HepsiJet ve satıcı kargo siparişlerinin karışması. Tüm siparişler ayırt edilmeden Yurtiçi’ye düşürülmeye çalışılınca HepsiJet siparişleri için gereksiz Yurtiçi kaydı oluşuyor. Çözüm: Hepsiburada Merchant API’den gelen kargo tipi bilgisine göre yalnızca satıcı kargo siparişlerini Yurtiçi akışına yönlendirmek.
Dördü de kurulumda doğru tasarımla önlenebilir; canlıda fark edilince düzeltmek çok daha fazla iş yükü ve performans puanı riski yaratır.