Hepsiburada entegrasyonu: servis anahtarından hakediş kontrolüne kadar
Hepsiburada entegrasyonu, satıcı panelinde yaptığınız stok, fiyat, sipariş ve fatura işlerini bir yazılımın resmî servisler üzerinden sizin adınıza yürütmesidir. Bu bölümde Hepsiburada'nın katalog ve listing yapısını, entegratör yetkisinin nasıl verildiğini, gönderilen bir stok güncellemesinin neden her zaman ilana yansımadığını ve siparişten hakedişe kadar nelere dikkat etmeniz gerektiğini anlatıyoruz. Böylece bir Hepsiburada entegrasyon programı seçmeden önce neye bakacağınızı bilirsiniz.
Hepsiburada'da ürün yapısı: katalog ürünü ve listing farkı
Hepsiburada'da bir ürünün iki katmanı vardır. Birincisi katalog ürünü: ürünün adı, kategorisi, özellikleri ve görselleri. Aynı ürünü birden fazla satıcı satabilir ve hepsi aynı katalog sayfasında görünür. İkincisi listing: sizin o ürün için verdiğiniz teklif, yani fiyatınız, stok adediniz ve kargoya veriş süreniz. Entegrasyonun gündelik işi büyük ölçüde listing katmanında döner.
Kendi stok kodunuz ve Hepsiburada ürün kodu
Hepsiburada geliştirici belgelerinde her satırda iki kod görürsünüz: sizin stok kodunuz (merchantSku) ve Hepsiburada'nın verdiği ürün kodu (hbSku). Sağlıklı bir Hepsiburada entegrasyonu bu iki kodu doğru eşleştirerek başlar. Kendi stok kodunuz başka kanallarda farklı yazılmışsa (boşluk, büyük-küçük harf, ön ek), eşleşme kaçar ve aynı ürün panelde iki ayrı kart gibi görünür.
Yeni ürün açmak neden daha uzun sürer?
Katalogda hiç olmayan bir ürünü gönderdiğinizde Hepsiburada önce ürün bilgisini işler; gönderime bir takip numarası verilir ve sonuç ayrıca sorgulanır. Onaylanmayan ürünler "aksiyon bekleyen" durumda kalır ve envantere yansımaz. Katalogda zaten bulunan bir ürüne teklif vermek ise çoğu zaman eşleşme onayıyla biter. Bu yüzden ilk kurulumda önce mevcut ilanlarınızı eşleştirmek, yeni ürün açmayı ikinci adıma bırakmak daha az sürprizle sonuçlanır.
Hepsiburada servis anahtarı ve entegratör yetkisi nasıl verilir?
Hepsiburada'da bağlantı, mağaza şifrenizi paylaşarak değil, entegratöre yetki verip servis anahtarı oluşturarak yapılır. Adımlar Hepsiburada'nın kendi yardım belgesinde anlatılır; menü adları panel güncellemeleriyle değişebilir, ama akış şöyledir:
- Satıcı paneline girin, mağaza adınızın altındaki Bilgilerim alanını açın.
- Entegrasyon sayfasına geçin ve Entegratör Bilgileri sekmesinde yeni entegratör ekleyin.
- Entegratörün durumu bir süre "beklemede" görünür; yetki Hepsiburada tarafından aktif edilir.
- Yetki açıldıktan sonra Entegratörlerim listesinde ilgili satırdaki Servis Anahtarı düğmesine basın ve anahtarı kopyalayın.
- Mağaza (merchant) kimliğinizi ve servis anahtarını eticaretcim'deki Hepsiburada bağlantı ekranına girin; panel mevcut ilanlarınızı okumaya başlar.
Hepsiburada stok entegrasyonu ve fiyat güncellemesi
Hepsiburada stok entegrasyonu dışarıdan basit görünür: adet değişir, ilana yazılır. Arka planda ise stok ve fiyat güncellemeleri toplu yükleme olarak gönderilir; Hepsiburada her yükleme için bir kimlik döner ve işlemin başarılı mı başarısız mı olduğu bu kimlikle ayrıca sorgulanır. Yani bir güncellemenin "gönderildi" olması, ilana yansıdığı anlamına gelmez. eticaretcim'de bu yüzden senkron sağlığı ayrı bir ekranda izlenir ve reddedilen ilanın sebebi gösterilir.
Örnek: Hepsiburada ve iki kanalda tek stok kartı
Bir ürünün depoda 10 adedi var ve bu ürünü Hepsiburada, Trendyol ve kendi sitenizde satıyorsunuz. Hepsiburada'dan 3 adetlik sipariş geldiğinde stok kartı 7'ye iner ve diğer kanallara 7 olarak yazılır. Ana fiyatınız ₺500 ise ve Hepsiburada için %8 fark kuralı tanımladıysanız ilan fiyatı ₺540 olarak gönderilir. Bu kuralların nasıl tanımlandığını stok ve fiyat senkronu sayfasında anlattık.
- Fiyat farkını kanal başına yüzde ya da tutar olarak tanımlayın; Hepsiburada fiyatını elle değiştirmeyin, yoksa iki kaynak çakışır.
- Kritik stok uyarısı için bir eşik belirleyin; son adetlere inen ürünü zamanında görürsünüz ve aşırı satış riski azalır.
- Paket ürünlerde (5'li, 10'lu) stok tek birimden düşer, ayrı stok tutmanıza gerek kalmaz.
Çok kanallı satışta aşırı satışı önlemenin pratik kurallarını aşırı satış kontrol listesi rehberinde topladık.
Hepsiburada sipariş entegrasyonu: paket, kargo ve fatura
Hepsiburada'da sipariş kalemleri paketlenerek kargoya hazırlanır; aynı siparişteki kalemler tek pakette birleştirilebilir ya da bölünebilir. Hepsiburada'nın sipariş servislerinde paketleme, kargo bilgisi ve fatura linki gönderme ayrı işlemlerdir. Entegrasyonun buradaki görevi, siparişi diğer kanallarla aynı listeye almak, onaylamak (isterseniz otomatik) ve takip numarası ile fatura bilgisini doğru pakete iletmektir.
Hepsiburada gönderim seçenekleri mi, kendi kargo sözleşmeniz mi?
Hangi gönderim modellerinin mağazanıza açık olduğunu satıcı panelinizden kontrol edin; kendi kargo sözleşmenizle çalışıyorsanız takip numarası panelden Hepsiburada siparişine iletilir. Birincil kargo firması, barkod ve etiket ayarları kargo entegrasyonu bölümünde yapılır. Başlangıç paketinde kargo entegrasyonu yoktur; takip numarası elle girilir.
Hepsiburada siparişine fatura kesme ve yükleme
Siparişe otomatik e-Arşiv ya da e-Fatura kesilmesi ve PDF'in Hepsiburada'ya yüklenmesi, bağlı muhasebe programınız üzerinden yürür. Nasıl kurulduğunu e-Fatura ve e-Arşiv entegrasyonu sayfasında anlattık. Bütün kanalların siparişlerini tek listede (Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim) görmek için sipariş yönetimi ekranına bakabilirsiniz.
Hepsiburada komisyonu, kesintiler ve hakediş kontrolü
Hepsiburada'da komisyon oranı kategoriye göre değişir ve zaman zaman güncellenir; güncel oranı satıcı panelinizden ve sözleşmenizden kontrol edin. Hakediş ödemesinin düzeni de sözleşmenize bağlıdır. Burada sabit bir oran yazmıyoruz, çünkü yanlış bir rakam fiyatlandırmanızı bozar.
Kontrol etmeniz gereken şey, her siparişte Hepsiburada'nın kestiği tutarın beklediğiniz tutarla aynı olup olmadığıdır. eticaretcim'in hakediş mutabakatı özelliği sipariş bazında net kârı çıkarır ve şu durumları ayrı listeler:
- Beklenenden yüksek kesilen komisyon
- Fazla kesilen kargo bedeli
- Teslim edildiği hâlde ödenmeyen hakediş
- Komisyon ve kargo sonrası zarar eden siparişler
- Hepsiburada ile diğer kanalların kârlılık karşılaştırması
Ürün ve kanal bazında kâr ile kesinti raporları Profesyonel ve üstü paketlerde açılır.
Hepsiburada entegrasyon programı: hangi paket size uygun?
Yalnızca Hepsiburada'da satıyorsanız ya da tek kanalla başlamak istiyorsanız Başlangıç paketi yeterli olabilir. Hepsiburada'yı başka pazaryerleriyle aynı stoktan yönetecekseniz kanal sayısı ve aylık sipariş limiti belirleyici olur. Güncel karşılaştırma fiyatlar sayfasında.
| Paket | Aylık | Kanal | Ürün / aylık sipariş | Hepsiburada için not |
|---|---|---|---|---|
| Başlangıç | ₺499 | 1 | 500 / 100 | Hepsiburada seçilebilir; takip no elle girilir |
| Büyüme | ₺999 | 3 | 5.000 / 500 | 1 kargo firması, toplu işlemler, kural motoru |
| Profesyonel | ₺1.999 | 5 | 10.000 / 2.000 | 1 e-Fatura programı, kâr ve kesinti raporları |
| Kurumsal | ₺3.999 | Sınırsız | 25.000 / 5.000 | 5 kargo firması, 3 e-Fatura programı, depo yönetimi |
Yıllık ödemede %20 indirim uygulanır. 3 günlük ücretsiz denemede Hepsiburada mağazanızı bağlayıp mevcut ilanlarınızın panele nasıl okunduğunu görebilirsiniz; siz onaylamadan hiçbir ilan değişmez.
Hepsiburada entegrasyonu kurulum kontrol listesi ve sık hatalar
Hepsiburada entegrasyonunda yaşanan sorunların çoğu yazılımdan değil, kurulum öncesi atlanan küçük adımlardan çıkar. Bağlantıyı açmadan önce şu listeyi gözden geçirin:
- Stok kodları bütün kanallarda aynı yazımda mı? Farklıysa önce eşleştirmeyi düzeltin.
- Entegratör yetkisi "beklemede" mi? Anahtar yalnızca yetki aktif olduktan sonra çalışır.
- Panele okunan ilanlar arasında barkod ya da stok koduyla eşleşmeyen satır kaldı mı?
- Hepsiburada için fiyat farkı kuralını ilk senkrondan önce tanımladınız mı?
- Aksiyon bekleyen ürünleriniz var mı? Bunlar satışa açık değildir; eksik özellikleri tamamlayın.
- Fatura ve kargo ayarlarını ilk siparişten önce test ettiniz mi?
Trendyol'da da satıyorsanız iki kanalın kurulum farklarını Trendyol entegrasyonu sayfasında karşılaştırabilirsiniz. İsterseniz kurulumu birlikte yaparız; panelin işleyişini önce 15 dakikalık bir demo görüşmesinde de görebilirsiniz.
- Hepsiburada Geliştirici Portalı: Entegratöre Servis Anahtarı Ekleme/Görüntüleme
- Hepsiburada Geliştirici Portalı: Listing Fiyat Güncelleme
- Hepsiburada Geliştirici Portalı: Listing Stok Güncelleme Sorgulama
- Hepsiburada Geliştirici Portalı: Listing Bilgilerini Sorgulama
- Hepsiburada Geliştirici Portalı: Aksiyon Bekleyen Ürün Silme
- Hepsiburada Geliştirici Portalı: Talep ve sipariş entegrasyonu dokümanı
- Hepsiburada Geliştirici Portalı: İhtilaflı Talep Kabul/Red Bildirimi (hbSku/merchantSku örneği)
- Hepsiburada Satıcı Paneli başvuru
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi
