Hepsiburada mağazanızı TicariHub'a bağlayın: paketler otomatik gelsin, e-faturanız kesilip Hepsiburada'ya iletilsin, stok senkron kalsın. 5 dakikada kurulum, 14 gün ücretsiz.
Hepsiburada'da satış yapan bir mağazanın günlük rutini bellidir: paketleri kontrol et, faturaları kes, faturaları yükle, stok güncelle. TicariHub'ın Hepsiburada entegrasyonu bu rutini sizin yerinize yürütür.
HB Marketplace API bilgilerinizle bağlantı kurulur; paketlenmemiş, kargodaki ve teslim edilmiş tüm siparişleriniz kalem kalem panele gelir. e-Faturanız kendi entegratör hesabınızdan kesilir ve Hepsiburada paketine otomatik iletilir.
Hepsiburada'nın sipariş servisleri duruma göre ayrışır: paketlenmemiş siparişler bir uçtan; paketlenmiş, kargoya verilmiş ve teslim edilmiş olanlar ayrı uçlardan gelir. Bu yüzden yalnızca tek bir listeye bakan entegrasyonlar siparişlerin bir kısmını göremez. TicariHub bu uçların tamamını gezer, sipariş durumunu ileri yönlü (geriye dönmeyecek şekilde) günceller ve kargo barkodunu yalnızca paket kaydında bulunduğu için oradan alıp siparişe işler. Tutar tarafında satır bazlı değerler esas alınır, böylece fatura toplamı siparişle birebir örtüşür.
Neler yapar?
Siparişler otomatik düşer
Yeni siparişler dakikalar içinde TicariHub paneline gelir; her pazaryerine ayrı girmeye son.
Tek tıkla e-fatura / e-arşiv
Kendi entegratör hesabınızla (Uyumsoft, Logo, İzibiz…) siparişten faturayı tek tıkla kesin; fatura pazaryerine otomatik yüklenir.
Fatura pakete otomatik iletilir
Kesilen fatura Hepsiburada paket numarasıyla eşleştirilip otomatik gönderilir.
Stok tüm kanallarda senkron
Bir kanalda satış olunca stok tüm kanallarda düşer; oversell (fazla satış) riski biter.
Kargo takibi
Kargo firması ve takip numarası siparişle birlikte gelir; teslimat durumunu panelden izleyin.
İade yönetimi
İadeler tespit edilir, fatura iptali/iade faturası ve cari düzeltmesi kolayca yapılır.
Hepsiburada entegrasyonu adım adım nasıl kurulur?
1
Hepsiburada satıcı panelinden API bilgilerini alın
Satıcı panelinde entegrasyon/API bölümünden merchant ID ve API kullanıcı bilgilerinizi edinin. Hepsiburada bu bilgileri talep üzerine tanımlar; henüz yoksa satıcı destek üzerinden açtırmanız gerekir.
2
Bağlantıyı TicariHub'a tanımlayın
Entegrasyonlar → Yeni Ekle → Hepsiburada adımlarını izleyip bilgileri yapıştırın ve "Bağlantıyı Test Et" deyin. Test, yalnızca kimlik doğrulamayı değil sipariş uçlarına erişimi de kontrol eder.
3
Sipariş geçmişini getirin
İlk senkronizasyonda geçmiş aralığını seçersiniz. Hepsiburada'nın paket listeleri yakın tarihli bir pencereyi gösterdiği için çok eski siparişlerde bazı alanlar (özellikle kargo barkodu) kanalda da bulunmayabilir; bu bir entegrasyon eksiği değil, kanalın sınırıdır.
4
Ürünleri eşleştirin ve stok havuzunu açın
Barkod eşleşmesi otomatik, isim eşleşmesi onaylıdır. Eşleştirme tamamlandıktan sonra stok havuzunu açarsanız bir kanaldaki satış tüm kanallarda stok düşürür.
5
E-fatura ayarlarını yapın ve ilk faturayı elle kesin
Entegratör bilgilerinizi girdikten sonra ilk faturayı elle kesip PDF'i kontrol edin: unvan, VKN/TCKN, adres, KDV oranı ve toplam doğru mu? Doğruysa otomasyonu açabilirsiniz.
Hepsiburada entegrasyonunda en çok gözden kaçan konu: sipariş uçlarının ayrışması
Hepsiburada, siparişleri tek bir listede sunmaz. Paketlenmemiş siparişler bir servisten; paketlenmiş, kargoya verilmiş ve teslim edilmiş siparişler ayrı servislerden döner. Üstelik bu servislerin döndürdüğü alanlar birebir aynı değildir — bazıları sadeleştirilmiş kayıt verir, tam veri için sipariş detayına ayrıca gitmek gerekir.
Bunun pratikteki sonucu şudur: yalnızca "yeni siparişler" listesine bakan bir entegrasyon, sipariş kargoya verildiği anda onu görmeyi bırakır. Satıcı, panelinde siparişin son durumunu göremez; kargo barkodu boş kalır, teslim edildi bilgisi hiç gelmez. Hata mesajı üretmediği için bu eksiklik aylarca fark edilmeyebilir.
TicariHub bu uçların tamamını dolaşır ve sipariş durumunu ileri yönlü günceller. "İleri yönlü" olmasının nedeni, farklı servislerden gelen kayıtların farklı tazelikte olabilmesidir: teslim edilmiş bir sipariş, geç işlenen eski bir kayıt yüzünden tekrar "yeni" durumuna düşmemelidir. Aksi halde aynı siparişe ikinci kez fatura kesme riski doğar.
Kargo barkodu ve fatura yükleme nasıl çalışır?
Hepsiburada'da kargo takip barkodu sipariş kaydında değil paket kaydında bulunur. Bu yüzden takip numarası, paket kaydı okunmadan doldurulamaz. TicariHub barkodu paket kaydından alır, siparişle ilişkilendirir ve kargo etiketi modülünde kullanılabilir hale getirir.
Fatura tarafında ise kesilen belgenin PDF'i ilgili paket numarasıyla eşleştirilerek Hepsiburada'ya iletilir. Yükleme başarısız olursa sipariş "faturası yüklenmedi" durumunda kalır ve hata listesine düşer; sessizce başarılı sayılmaz. Bu ayrım önemlidir, çünkü fatura yükleme uyarıları tekrarlandığında mağaza performans göstergeleri etkilenir.
Tutar doğruluğu: neden satır toplamı esas alınır?
Pazaryerlerinde siparişin "genel toplam" alanı her zaman faturaya yazılacak tutar değildir. Kupon, kanal katkısı, satıcı indirimi ve kargo payı bu alanı şişirebilir ya da eksiltebilir. Hepsiburada tarafında yapılan ölçümlerde genel toplam alanının satır toplamının üzerine çıkabildiği görülmüştür.
TicariHub bu nedenle satır bazlı değerleri otorite kabul eder ve fatura toplamını satırlardan üretir. Böylece kestiğiniz fatura ile siparişin gerçek tutarı arasında kuruş farkı oluşmaz — bu fark hem müşteri şikâyeti hem de mali müşavir düzeltmesi anlamına geldiği için sonradan telafisi pahalıdır.
Hepsiburada satıcısı için günlük akış nasıl değişir?
Sabah: gece gelen paketler panele düşmüş olur; ayrı ayrı kanala girmeye gerek kalmaz.
Fatura: kesilmemiş siparişler tek listede süzülür, toplu ya da tek tek faturalanır, PDF pakete otomatik gider.
Kargo: takip barkodları siparişle birlikte gelir; 10×15 kargo etiketlerini toplu yazdırabilirsiniz.
Stok: satılan ürünler tüm kanallardan düşer; kritik stok seviyesi için uyarı kurabilirsiniz.
İade: iade edilen kalemler işaretlenir, fatura ve cari birlikte düzeltilir.
Akşam: gün içindeki entegrasyon hataları günlük özet e-postasıyla bildirilir; sessiz hata kalmaz.
Hepsiburada sipariş durumları ve TicariHub'ın davranışı
Kanal durumu
Panelde karşılığı
Yapılabilecek işlem
Paketlenmemiş / yeni
Yeni sipariş
Fatura kesilebilir, stok düşülür, kalemler kontrol edilir
Paketlendi
Hazırlanıyor
Kargo etiketi yazdırılır, paket numarası eşleşir
Kargoya verildi
Kargoda
Takip barkodu siparişe işlenir, müşteri bilgilendirilir
Teslim edildi
Teslim edildi
Tahsilat/mutabakat takibi yapılır, durum geri düşmez
İptal
İptal
Faturası varsa iptal/iade faturası akışı açılır
İade
İade
Stok geri girer, cari ters yönde eşitlenir
Hepsiburada mağazanızı 5 dakikada bağlayın
14 gün ücretsiz deneyin; kredi kartı gerekmez. Kurulum sihirbazı her adımı Türkçe anlatır.
Hepsiburada satıcı panelinden merchant ID ve API anahtarınızı alın; TicariHub → Entegrasyonlar → Hepsiburada ekranına girip "Bağlantıyı Test Et" deyin. Kurulum sihirbazı her adımı Türkçe anlatır.
Eski Hepsiburada siparişlerim de gelir mi?
Evet. TicariHub geçmiş sipariş çekme özelliğiyle son 60 güne kadar olan siparişlerinizi getirir; faturası kesilmemiş eski siparişlerinizi toplu görebilirsiniz.
Hepsiburada siparişine e-fatura nasıl kesilir?
Sipariş panele düşünce tek tıkla kesersiniz. Fatura kendi entegratör hesabınızdan (Uyumsoft, Logo, İzibiz…) kesilir ve HB paketine otomatik iletilir.
Çok kalemli ve çok adetli siparişler doğru gelir mi?
Evet. Siparişler kalem ve adet bazında birebir çekilir; kargo ve komisyon bilgileri de siparişle birlikte gelir.
Hepsiburada entegrasyonu ücretli mi?
14 gün ücretsiz deneme ile tüm özellikleri test edebilirsiniz; kredi kartı gerekmez.
Hepsiburada'da kargo takip numarası neden bazen boş görünür?
Takip barkodu Hepsiburada'da sipariş detayında değil paket kaydında döner ve paket servisleri yalnızca yakın tarihli bir pencereyi gösterir. Bu yüzden çok eski siparişlerde barkod kanalda da erişilemez olabilir; yeni siparişlerde otomatik dolar.
Hepsiburada faturasında hangi tutar esas alınır?
Sipariş satırlarındaki tutarlar esas alınır. Kanalın döndürdüğü genel toplam alanı bazı durumlarda satır toplamının üzerine çıkabildiği için otorite satır toplamıdır; böylece kesilen fatura ile siparişin gerçek tutarı arasında fark oluşmaz.
Hepsiburada'da paket ile sipariş arasındaki fark nedir?
Hepsiburada'da müşterinin verdiği sipariş, kargolanabilir birimlere (paket) bölünebilir. Bir sipariş birden fazla pakete ayrılabilir ya da bir paket birden fazla kalem taşıyabilir. Fatura ve kargo barkodu paket üzerinden yürüdüğü için entegrasyonun bu ayrımı doğru kurması şarttır; TicariHub paket numarasını siparişle ilişkilendirerek saklar.
Hepsiburada iadelerini panelden takip edebilir miyim?
Evet. İade edilen kalemler siparişle eşleştirilir; fatura iptali ya da iade faturası kesme seçeneklerinden birini kullanabilirsiniz. Seçtiğiniz yönteme göre cari bakiye ve stok otomatik düzeltilir.
Hepsiburada mağazamda kaç ürün varsa hepsi eşleşir mi?
Barkodu TicariHub kataloğuyla birebir eşleşen ürünler otomatik bağlanır. Eşleşmeyenler öneri listesine düşer ve onayınızı bekler; benzer isimli ama farklı varyantlı ürünlerin (örneğin 10 lt ile 20 lt) yanlış bağlanmaması için varyant koruması devrededir.
