Hepsiburada'ya Nasıl Bağlanırım? Servis Anahtarı Alma ve Kurulum

Hepsiburada'ya bağlanmak aslında iki parça bilgi demek: Mağaza ID (MerchantId) ve Servis Anahtarı (Service Key). Bu ikisini Hepsiburada satıcı panelinden alıp Ventegre'ye giriyorsunuz, bağlantı kuruluyor. Geri kalan her şey — ürün aktarımı, stok senkronizasyonu, sipariş akışı — bu bağlantının üstüne çalışıyor.

Bu yazıda Hepsiburada'dan bu iki bilgiyi nasıl alacağınızı, Ventegre'ye nasıl bağlayacağınızı ve en sık karşılaşılan hataları nasıl çözeceğinizi anlatıyorum.

Trendyol yazısından farkı: Trendyol'da üç bilgi gerekmişti (Satıcı ID + API Key + API Secret). Hepsiburada'da iki bilgi yeterli. Ayrıca Hepsiburada, Ventegre'yi worklabsoft_dev entegratör adıyla eklemenizi onaylamak için 2 saate kadar sürebilir.

Bağlantı İçin Ne Lazım?

Başlamadan önce iki şey hazır olsun:

• Aktif Hepsiburada satıcı hesabı. Mağaza açma sürecini tamamlamış olmanız gerekiyor.
• Ventegre hesabı. Ücretsiz hesap buradan açılır.

İkisi de hazırsa başlayalım.

1. Hepsiburada Satıcı Paneline Giriş Yapın

Tarayıcıdan Hepsiburada satıcı paneline (satis.hepsiburada.com veya panel adresiniz) girin ve satıcı bilgilerinizle giriş yapın.

2. Entegratör Bilgileri Sayfasını Açın

Giriş yaptıktan sonra şu yolu izleyin:

Hesabım → Bilgilerim → Entegrasyon → Entegratör Bilgileri

Bu sayfa, dış yazılımların (Ventegre gibi) Hepsiburada ile konuşabilmesi için gereken bilgilerin üretildiği yer.

3. Ventegre'yi Entegratör Olarak Ekleyin

Sayfada "Entegratör Ekle" butonuna tıklayın. Açılan formda şu alanları doldurun:

• Entegratör Kullanıcı Adı: Tam olarak worklabsoft_dev yazın (büyük/küçük harf önemli). Bu, Hepsiburada'nın Ventegre'yi tanıdığı entegratör adıdır.
• Başlangıç Tarihi: Bugünün tarihini seçin. Bitiş tarihi zorunlu değil, boş bırakabilirsiniz.

Kaydet'e tıklayın. Eklediğiniz entegratör, listede worklabsoft_dev olarak görünür.

Önemli: Bu alana Ventegre, ventegre veya başka bir şey yazmayın. Hepsiburada, Ventegre'yi worklabsoft_dev adıyla tanıyor; başka yazarsanız bağlantı çalışmaz.

4. Hepsiburada Onayını Bekleyin

Trendyol entegratör seçimini anında onaylıyordu. Hepsiburada ise bu onay bazen 2 saate kadar sürebilir. Ekledikten sonra worklabsoft_dev satırında "Servis Anahtarı" butonu çıkmadıysa, onay bekleniyor demektir.

İpucu: Onay genelde dakikalar içinde biter ama resmi olarak 2 saat verilir. Bu süre içinde Ventegre tarafında bağlantı kurmayı denerseniz "henüz onaylanmadı" hatası alırsınız — bu normal, biraz bekleyin.

5. Servis Anahtarını Kopyalayın

Onay geldikten sonra worklabsoft_dev satırında "Servis Anahtarı" butonuna tıklayın. Açılan pencerede uzun bir anahtar çıkar.

Bu anahtarı kopyalayın. Dikkat: Hepsiburada servis anahtarını yalnızca bir kez gösterir. Kaybetmeyin, kimseyle paylaşmayın.

Ayrıca aynı sayfada Mağaza ID (MerchantId) bilginiz de yazar. Bu, UUID formatında uzun bir koddur (örn. 158a06bd-b18d-48c4-a3ac-f0f5a84ae64b). Bunu da kopyalayın.

6. Ventegre Panelinde Hepsiburada'yı Bağlayın

İki bilgiyi de aldıktan sonra Ventegre tarafına geçiyoruz.

1. Ventegre paneline giriş yapın.
2. Üst menüden "Pazaryeri API" sekmesine tıklayın.
3. "Pazaryeri Entegrasyonları" bölümünde Hepsiburada kartını bulun. Kartın üzerinde "Sisteme Bağla" yazan butona basın.
4. Açılan pencerede iki alan doldurun:
   • Mağaza ID (MerchantId) → Hepsiburada'dan aldığınız UUID formatındaki kimlik
   • Servis Anahtarı (Service Key) → Hepsiburada'dan kopyaladığınız anahtar
5. "Bağlantıyı Test Et" butonuna tıklayın.

Bu noktada Ventegre, girdiğiniz bilgilerle Hepsiburada'ya gerçek bir istek atıp bilgilerin doğru olduğunu teyit eder.

Nasıl çalışıyor: Ventegre bağlantıyı test ederken önce üretim (gerçek) ortamını, sonra gerekirse test ortamını dener. Hangisi başarırsa o kaydedilir. Yani yanlış bir Servis Anahtarı girdiyseniz test başarısız olur; bağlantı kurulmaz.

Test başarılı olursa pencere yeşil onay verir ve Hepsiburada kartı "Bağlı" durumuna geçer. Hata alırsanız aşağıdaki Sık Karşılaşılan Sorunlar bölümüne bakın.

7. Bağlantı Kurulduktan Sonra Ne Oluyor?

Bağlantı kurulur kurulmaz Ventegre arka planda şu işleri başlatır:

• Ürünleri otomatik çeker. Hepsiburada'daki tüm ürünleriniz sayfa sayfa çekilmeye başlanır. Bu işlem arka planda çalışır; bir butona basmanıza gerek yok. İlerlemeyi aynı ekranda görebilirsiniz ("Ürünleriniz çekiliyor…").
• Siparişleri otomatik alır. Hepsiburada'da yeni bir sipariş oluştuğunda Ventegre bunu her dakika yapılan otomatik kontrolle yakalar ve listeye ekler. Stok, sipariş oluştuğu an düşülür.
• Stok senkronizasyonu açılır. Hepsiburada'da bir ürün satıldığında stok Ventegre'de düşer ve aynı ürünü Trendyol/N11 gibi diğer kanallarınızda varsa orada da düşer. Bu, aynı ürünün iki kez satılması riskini ortadan kaldırır.

Çekilen ürünler Hepsiburada'daki gerçek durumlarıyla gelir: satıştaysa Yayında, satışta değilse Yayında değil olarak görünür.

Sıkça Sorulan Sorular

---

Hepsiburada'ya bağlantı kurmak bu kadar. Bağlantı kurulur kurulmaz ürün ve sipariş akışı büyük ölçüde otomatik çalışmaya başlar. Ürün yönetimi, sipariş operasyonu ve diğer kanallara genişletme hakkında rehberleri blogda topluyoruz; takipte kalın.

Bağlantıda takıldığınız bir yer olursa Ventegre destek ekibiyle iletişime geçin; bağlantı sürecini birlikte tamamlayalım.