Hepsiburada Entegrasyonu Kurulumu

Hepsiburada mağazanızı Pazarus'a bağlayarak ürünlerinizi içe aktarabilir, stok ve fiyatı tek yerden yönetebilir, siparişleri otomatik çekebilir ve müşteri sorularını panelden takip edebilirsiniz. Hepsiburada'da bağlantı, satıcı panelinizde Pazarus'u entegratör olarak tanımlamanızla başlar; bu rehber o adımdan itibaren tüm süreci anlatır.

Ön koşullar

• Aktif bir Hepsiburada satıcı hesabınız olmalı.
• Pazarus'ta Entegrasyonlar → Pazaryeri Ayarları sayfasında bağlantı limitinizin dolu olmaması gerekir.
• Ürünlerinizin barkodlu olması önerilir; eşleştirme ve sipariş akışı barkod üzerinden ilerler.

Adım adım

1. Entegrasyonlar → Pazaryeri Ayarları sayfasını açın ve Hepsiburada kartındaki Entegrasyonu Kur butonuna tıklayın.
2. Sayfanın üstündeki Entegratör Kurulumu bölümünde listelenen adımları Hepsiburada satıcı panelinizde uygulayın:
   • Hepsiburada satıcı panelinize giriş yapın ve Entegratör Bilgileri sayfasına gidin.
   • Entegratör ekle + butonuna tıklayın; açılan pencerede Entegratör kullanıcı adı alanından hubsan_dev seçin.
   • Başlangıç tarihini bugün olarak bırakın ve kaydedin.
   • Entegratörler listesinde hubsan_dev satırındaki Servis Anahtarı bağlantısına tıklayıp anahtarı kopyalayın. Aynı sayfadaki Mağaza ID değerini de kopyalayın.
3. Pazarus'a dönüp Hepsiburada entegratör panelimde hubsan_dev'i seçtim ve servis anahtarını aldım kutusunu işaretleyin. Bağlantı alanları bu onaydan sonra görünür.
4. Hepsiburada Bağlantı Ayarları bölümünde Mağaza ID alanına kopyaladığınız mağaza kimliğini, Servis Anahtarı alanına servis anahtarını yapıştırın. Pazarus, entegratör adını (hubsan_dev) sizin yerinize ekler; ayrıca girmeniz gerekmez.
5. Ortam alanında Canlı (Production) seçili kalsın. Test (Stage) yalnızca Hepsiburada'dan test satıcı hesabı aldıysanız kullanılır.
6. Aktif anahtarını açık bırakın. Senkronizasyon Modu ilk kurulumda Senkronize Etme olarak kalsın; ürün eşleştirmesi tamamlandıktan sonra Fiyat + Stok, Sadece Fiyat veya Sadece Stok seçin.
7. Kaydet butonuna basın, ardından Bağlantıyı Test Et butonuna tıklayın. "Bağlantı Başarılı!" bildirimi gelmelidir.
8. Sağ üstteki Ürünleri Önizle butonuyla kaç ürün geleceğini görün, sonra Ürünleri İçe Aktar butonuna tıklayın. Açılan pencerede:
   • Sadece aktif ürünleri aktar: yalnızca satışta olan ürünler gelir.
   • Sadece stoktakileri aktar: stoğu sıfırdan büyük ürünler gelir.
   • Varyantları oluştur: model kodu veya grup kodu aynı ürünler tek ürün altında varyant olarak birleştirilir. İstemiyorsanız kapatın; ürünler ayrı ayrı eklenir.
   • Stok davranışı: Pazarus'ta zaten ürünleriniz varsa "Sadece yeni ürünlerde stok al (mevcut ürünlere dokunma)" seçeneğini koruyun.
   Başlat ile aktarım arka planda çalışır; bittiğinde bildirim alırsınız.
9. Sipariş Senkronizasyonu bölümünde Siparişleri Otomatik Çek anahtarını açın; siparişler her 5 dakikada bir çekilir.
10. Anlık sipariş bildirimi istiyorsanız Bildirim Bilgilerini Oluştur butonuna tıklayın. Pazarus bir adres, kullanıcı adı ve şifre üretir ve bunları Hepsiburada Destek Kaydına İletilecek Bilgiler kutusunda gösterir. Hepsiburada satıcı panelinde Destek Kaydı Aç ile bir kayıt açıp bu bilgileri ve işlem türlerini (Yeni Sipariş, Paket Oluşturma, İptal, Kargoya Verildi, Teslim Edildi, Teslim Edilemedi, Paket Açma, Adres Değişikliği) ekleyin. Hepsiburada ekibi önce test ortamında doğrular, sonra canlıya alır; bu sırada 5 dakikalık çekim yedek olarak çalışmaya devam eder.
11. Son olarak Kaydet ile ayarları saklayın.

İsteğe bağlı ayar bölümleri

• Müşteri Hizmetleri: Ürün Sorularını Otomatik Çek açıkken cevaplanmamış ürün soruları periyodik olarak sisteme çekilir. Ayrıntı için "Trendyol ve Hepsiburada Otomatik Soru Cevaplama" rehberine bakın.
• Maliyet Varsayılanları: Sipariş İşlem Bedeli (₺) ve Varsayılan İade Maliyeti (₺) kâr hesaplarında kullanılır; ürün bazında değiştirilebilir.
• Ürün Senkronizasyonu: Ürün değişikliklerini pazaryerine push et açıkken Pazarus'taki ürün değişiklikleri Hepsiburada'ya otomatik gönderilir.
• Kategorileri Senkronize Et butonu Hepsiburada kategori ağacını arka planda çeker; ürün göndermeden önce bir kez çalıştırın.

Sık karşılaşılan sorunlar

• Belirti: Bağlantı testi "HTTP 401" veya "HTTP 403" veriyor. Çözüm: Mağaza ID ve Servis Anahtarı değerlerini Entegratör Bilgileri sayfasından yeniden kopyalayın; anahtarın hubsan_dev entegratörüne ait olduğundan ve entegratör kaydının aktif olduğundan emin olun. Başka bir entegratörün anahtarı çalışmaz.
• Belirti: Bağlantı alanları görünmüyor. Çözüm: Entegratör Kurulumu bölümündeki onay kutusunu işaretleyin; alanlar onaydan sonra açılır.
• Belirti: İçe aktarılan ürünlerin fotoğrafı yok. Çözüm: Hepsiburada ürün aktarımında fotoğraf bilgisi her zaman dönmez. İlk aktarımı Trendyol gibi fotoğraf dönen bir platformdan yapmanız önerilir; daha sonra Ürünler & Stok → Ürünler sayfasındaki Fotoğrafları Getir butonuyla görselleri çekebilirsiniz.
• Belirti: Aynı ürün için birden fazla Hepsiburada bağlantısı oluştu. Çözüm: Ürün kartının Hepsiburada sekmesinde iki ayrı alan vardır: Satıcı SKU (merchantSku) sizin kendi stok kodunuz, Hepsiburada SKU (HBCV/HBV) ise Hepsiburada'nın ürettiği kod. HBCV/HBV kodunu Satıcı SKU alanına yazmayın; aksi halde sonraki içe aktarma eşleşmeyi bulamaz ve yeni bağlantı açar.
• Belirti: Kargo firması Pazarus'ta bastığınız etiketi kabul etmiyor. Çözüm: HepsiJet ve Aras kargolu Hepsiburada siparişlerinde yalnızca Hepsiburada'nın ortak barkodlu etiketi geçerlidir. Pazarus bu siparişlerde ortak barkodlu etiketi otomatik alır; etiket alınamadıysa paketin Hepsiburada tarafında oluşmasını bekleyip yazdırmayı tekrarlayın.

İpuçları

• Yalnızca Hepsiburada eşleştirmelerini kaldırmak için Diğer → Hepsiburada Bağlantılarını Sil kullanın; ürünleriniz korunur. Entegrasyonu Tamamen Kaldır ayarları da siler.
• Anlık bildirimleri kapatmak için Anlık Bildirimleri Kapat butonunu kullanın ve Hepsiburada tarafında da iptal talebi açın.