Hepsiburada entegrasyonu nasıl yapılır? Adım adım kurulum

Hepsiburada entegrasyonu neyi otomatikleştirir?

Entegrasyon, Hepsiburada mağazanızı bir yazılıma bağlayarak tekrar eden işleri ona devreder. En önemlileri stok, fiyat ve sipariştir. Hepsiburada'da satılan bir ürün, Trendyol'da ya da sitenizde de stoktan düşmelidir. Aksi hâlde aynı son ürünü iki kez satarsınız. Bu sorunun genel hâlini çok kanallı çift satış rehberinde anlattık. Siparişler de aynı mantıkla tek listede toplanır; her kanalın paneline ayrı ayrı girmeniz gerekmez.

Hepsiburada'da ürünler iki kodla izlenir: Hepsiburada'nın kendi ürün kodu (HB SKU) ve sizin verdiğiniz satıcı stok kodu. Entegrasyon yazılımları ürünleri bu kodlar ve barkod üzerinden tanır. Kurulumdan önce stok kodlarınızın düzenli olması sonraki her adımı kolaylaştırır.

Önce plan yapın: API erişimi onaya bağlıdır

Trendyol'da entegrasyon bilgileri satıcı panelinde hazır bekler. Hepsiburada'da ise geliştirici portalında bir entegrasyon tanımlanır ve onay beklenir. Portal adımlarını Hepsiburada API bağlantısı kurulumu rehberimizde sırasıyla gösterdik; burada tekrarlamıyoruz.

Pratik sonuç şudur: Hepsiburada'yı kurulum takviminin başına koyun. Onay beklerken diğer işleri ilerletebilirsiniz:

• Ürünlerin barkod ve stok kodlarını diğer kanallarla karşılaştırın.
• Stok kaynağını seçin; karar için stok kaynağı seçimi rehberine bakın.
• Çok satan ürünlerde fiziksel sayım yapın.
• Hepsiburada'daki fiyatlarınızı komisyon ve kargoya göre gözden geçirin.
• Hangi ürünleri Hepsiburada'da satacağınıza karar verin; her ürünün her kanalda olması gerekmez.

Merchant ID, API Key ve User-Agent ne işe yarar?

Üç bilginin her biri farklı bir iş görür. Hangisinin neden gerektiğini bilmek, hata aldığınızda sorunu hızlı bulmanızı sağlar.

User-Agent internetin genel bir kuralıdır. MDN'nin açıklamasına göre bu başlık, sunucunun isteği gönderen uygulamayı tanımasını sağlar. Hepsiburada bu başlığı, portalda tanımladığınız uygulama adıyla eşleştirir.

Hepsiburada isteklerinde kimlik bilgileri "basic" yöntemiyle gönderilir. MDN kimlik doğrulama sayfası, bu yöntemde bilgilerin şifrelenmeden kodlandığını ve bu yüzden yalnızca HTTPS ile kullanılması gerektiğini belirtir. Satıcı için anlamı açıktır: API Key'i yalnızca güvenli bağlantıyla çalışan bir yazılıma girin ve kimseyle paylaşmayın.

Entegratör seçerken Hepsiburada'ya özel sorular

Her entegratör Hepsiburada'yı aynı derinlikte desteklemez. Genel soruların yanında şunları sorun:

• Hepsiburada'ya stok ve fiyat güncellemesi hangi sıklıkla gönderiliyor?
• Hepsiburada siparişleri diğer kanallarla aynı listede görünüyor mu?
• Panelden Hepsiburada'ya yeni ürün açılabiliyor mu? Kategori özellikleri nasıl dolduruluyor?
• Hepsiburada'ya özel fiyat verilebiliyor mu?
• Gönderilen bir ürün reddedilirse sebebi gösteriliyor mu?

Saystok bu soruların çoğunu Hepsiburada için de karşılar: stok senkronu, tek sipariş listesi, pazaryerine ürün yükleme ve platforma özel fiyat Hepsiburada'da çalışır. Müşteri soruları ve iade modülleri ise Hepsiburada'yı kapsamaz; bu işler Hepsiburada panelinde kalır.

İlk eşleştirme: barkod ve stok kodu

Bağlantı onaylandıktan sonra ilk iş, ürünleri diğer kanallardaki karşılıklarıyla eşleştirmektir. Barkod her kanalda aynıysa eşleştirme otomatik yapılır. Farklıysa öneriler elle onaylanır.

• Varyantlı ürünlerde her beden ve renk ayrı bir ürün gibi eşleşir.
• Aynı barkodu iki farklı ürüne vermeyin; eşleştirme yanlış ürüne gider.
• Barkodu olmayan ürünler için önce barkod tanımlayın.
• İlk gün en çok satan 20-30 ürünü eşleştirip stokları karşılaştırın, sonra kataloğun geri kalanına geçin.

Ayrıntılı adımlar ürün eşleştirme rehberinde. Trendyol da bağlıysa aynı kontrolleri Trendyol entegrasyonu yazısındaki sırayla yapabilirsiniz.

Hepsiburada'da yeni ürün açarken

Ürünlerinizin bir kısmı Hepsiburada'da hiç yoksa iki yol vardır: ürünü Hepsiburada panelinde tek tek açmak ya da entegrasyon panelinden toplu göndermek. Hangisini seçerseniz seçin, Hepsiburada yeni ürünleri kendi katalog onayından geçirir. Ürün, onay çıkana kadar satışa açılmaz.

Toplu gönderimde şu sırayı izleyin:

• Kategoriyi eşleştirin: kendi kategorinizi Hepsiburada'daki karşılığıyla bir kez eşleştirin. Yanlış kategori, reddedilme ve yanlış komisyon demektir.
• Zorunlu özellikleri doldurun: her kategori farklı özellik ister. Zorunlu alan eksikse ürün onaydan geçmez.
• Görselleri kontrol edin: ürünü net gösteren görseller kullanın.
• Sonucu izleyin: gönderildi demek yayında demek değildir. Reddedilen ürünü sebebine göre düzeltip yeniden gönderin.

Ayrıntılı adımlar platforma yeni ürün açma ve kategori eşleştirme rehberlerinde. Bu işi panelden yapan araçlarda onaylanan ürün otomatik eşleşir ve stok senkronuna katılır.

Bağlantıyı test etmek: dört kontrol

Kurulumu tüm kataloğa açmadan önce dört basit kontrol yapın. Her biri farklı bir parçayı sınar.

• Bağlantı testi: entegrasyon ekranındaki test düğmesi başarılı sonuç vermeli. Başarısızsa üç bilgiyi yeniden kopyalayın.
• Stok testi: bir üründe stoku bir adet azaltın ve Hepsiburada'da değiştiğini görün.
• Fiyat testi: az satan bir üründe fiyatı küçük bir tutar değiştirin, yansıdığını görüp geri alın.
• Sipariş testi: gelen ilk Hepsiburada siparişinin panelde göründüğünü ve diğer kanallarda stoku düşürdüğünü kontrol edin.

Pazaryerleri toplu güncellemeleri sıraya alarak işleyebilir. Değişiklik hemen görünmüyorsa aynı güncellemeyi art arda göndermek yerine birkaç dakika bekleyip yeniden kontrol edin.

Sık görülen hatalar

• Yetkisiz (401) hatası: HTTP'de 401, isteğin geçerli kimlik bilgisi taşımadığını gösterir. Merchant ID ile API Key'in aynı mağazaya ait olduğunu ve User-Agent'ın portaldaki adla birebir aynı olduğunu kontrol edin.
• Onay beklerken bağlantı denemek: onay tamamlanmadan API Key üretilmez. Onay sonucunu bekleyin.
• Ürün metninde özel karakterler: başka kanaldan aktarılan başlık ve açıklamalardaki emoji ve süs sembolleri ürün gönderiminde sorun çıkarabilir. Metinleri göndermeden önce temizleyin.
• İki stok kaynağı: iki kanal birbirinin stokunu ezerse rakamlar dalgalanır. Tek kaynak seçin.
• Komisyonu hesaba katmamak: Hepsiburada'daki fiyat, komisyon ve kargo düştükten sonra kâr bırakmalıdır.

Fiyat ve kâr kontrolü

Bağlantı çalıştıktan sonra fiyatlarınızı kontrol edin. Komisyon oranları kategoriye göre değişir; güncel oranı satıcı panelinizdeki tablodan alın. Hesap mantığı şöyledir (örnek: %18 komisyon varsayalım):

• Satış fiyatı 500 TL ise komisyon 500 × 0,18 = 90 TL olur.
• Kargoyu 60 TL, ürün maliyetini 250 TL varsayarsak geriye 500 - 90 - 60 - 250 = 100 TL kalır.
• KDV ve diğer kesintiler eklendiğinde net kâr bunun altına iner.

Kategori bazında oranlara Hepsiburada komisyon oranları sayfasından bakabilir, kendi hesabınızı pazaryeri komisyon hesaplama aracında yapabilirsiniz.

Fiyat kararlarını ciroya göre değil, kanal bazındaki net kâra göre verin. Hangi kanalın gerçekten kazandırdığını görmek için pazaryeri kâr/zarar hesabı rehberindeki yöntemi uygulayın.