# Hepsiburada entegrasyonu kurulumu > Hepsiburada satıcı panelinizden servis anahtarı alın, Satıcı ID ve servis anahtarıyla bağlanın, ilanları ürünlerinizle eşleştirin, siparişleri yönetin. Canonical page: https://magazamhazir.com/yardim/hepsiburada-entegrasyonu Menu path in the store admin: Pazaryerleri > Hepsiburada Requires plugin(s): hepsiburada-marketplace, hepsiburada-import Last updated: 2026-09-01 Hepsiburada entegrasyonu, satıcı hesabınızdaki ilanları, siparişleri, iadeleri, soruları ve hak ediş kayıtlarını kendi panelinize taşır. Ürünlerinizin fiyat ve stoğunu buradan Hepsiburada'ya gönderir, gelen siparişleri kendi sipariş ekranınızda işlersiniz. Kurulumun ilk adımı bizde değil Hepsiburada'da yapılır: yetkiyi kendi satıcı panelinizden vermeniz gerekir. ## Başlamadan önce - Hepsiburada Pazaryeri eklentisinin paketinizde açık olması - Hepsiburada Satıcı Paneli'ne giriş yetkiniz — servis anahtarı orada oluşturulur - Satıcı ID'niz (API kullanıcı adı olarak da bu değer kullanılır) - Excel'den ürün aktarmak için ayrıca Hepsiburada Aktarma eklentisi ## Adımlar ### 1. Hepsiburada panelinizde servis anahtarı oluşturun {#adim-1} Pazaryerleri > Hepsiburada > Ayarlar sayfasını açın. Bağlantı kurulmadan önce en üstte "Başlamadan önce: Hepsiburada panelinizde yetki verin" kartı çıkar ve içinde Entegratör Adımız yazar. Kopyala deyin, Hepsiburada Satıcı Paneli'nde Ayarlar > Entegrasyon Bilgileri > Servis Anahtarı Ekle adımına gidin, entegratör arama kutusuna bu adı yazıp yetki verin. Oluşan servis anahtarını hemen kopyalayın — anahtar yalnızca bir kez gösterilir. ### 2. Satıcı ID ve servis anahtarıyla bağlanın {#adim-2} Aynı sayfadaki Bağlantı Durumu kartında yalnızca iki alan vardır. Satıcı ID'nizi ve az önce oluşan servis anahtarını girip Bağlan deyin — ayrıca bir kullanıcı adı istenmez, çünkü API kullanıcı adı olarak Satıcı ID kullanılır. "Kimlik bilgileri kaydedildi" mesajını ve Bağlı rozetini gördüğünüzde bağlantı hazırdır. Servis anahtarı veya ID hatalıysa "Bağlantı başarısız. Kimlik bilgilerinizi kontrol edin." uyarısı gelir. ### 3. Senkronizasyon Ayarları'ndaki iki anahtarı kararınıza göre kurun {#adim-3} Bağlantı kurulur kurulmaz sayfaya Webhook Durumu ve Senkronizasyon Ayarları kartları eklenir. "Sipariş senkronizasyonu aktif" açıkken her 5 dakikada bir arka planda yeni Hepsiburada siparişleri çekilir. "Otomatik fatura oluştur" ise kapalı gelir: kapalıyken faturayı sipariş ekranından siz oluşturursunuz, açtığınızda paketlenen her sipariş için fatura otomatik oluşturulur ve bağlantısı Hepsiburada'ya gönderilir. ### 4. İlanları mağazanızdaki ürünlerle eşleştirin {#adim-4} Ürünler sayfası iki sekmelidir: Pazaryeri kataloğu Hepsiburada'daki ilanlarınızı, Mağazamdaki ürünler kendi varyantlarınızı listeler. Önce Senkronize et ile katalogu çekin. Otomatik eşleştir stok kodu birebir tutan satırları doğrudan bağlar ve kaç ilanın bağlandığını bildirir. Akıllı eşleştir ise barkod, ad ve özellik benzerliğinden aday çıkarır; bu adaylar kendiliğinden bağlanmaz, "eşleşme onayını bekliyor" kartında Onayla ve Reddet düğmeleriyle sizi bekler. ### 5. Fiyat ve stok farklarını gönderin {#adim-5} Fiyat/stok farkları sayfası, mağazanızdaki değerle Hepsiburada'daki değerin ayrıştığı satırları tek listede gösterir: Mağaza fiyatı, Mağaza stoğu ve Fark sütunlarıyla. Fark "Sadece fiyat", "Sadece stok" veya "Fiyat ve stok" olabilir. Gönderdiğiniz satırlar Hepsiburada tarafında birkaç dakika içinde işlenir. Bu ekran mevcut ilanları günceller; buradan Hepsiburada'da yeni ilan açılmaz. ### 6. Siparişleri, iadeleri ve faturaları takip edin {#adim-6} Kontrol Paneli dört sayıyı — Ürünler, Siparişler, Sorular, İadeler — ve altında son siparişlerle son iadeleri gösterir. Sipariş durumları Açık, Paketlendi, Kargoya Verildi, Teslim Edildi gibi Türkçeleştirilmiş hâlde gelir. Hepsiburada bir paket için fatura beklediğinde "Fatura Bekleyen Paketler" kartı çıkar: Fatura Oluştur'a bastığınızda sipariş mağazanıza aktarılır, faturası hazırlanır ve bağlantısı Hepsiburada'ya gönderilir. ### 7. Kataloğunuzu Excel ile içe aktarın {#adim-7} Hepsiburada'daki ürünleriniz henüz mağazanızda yoksa İçe Aktarma > Hepsiburada sayfasından Hepsiburada'nın ürün Excel'ini yükleyebilirsiniz. Sihirbaz Dosya, Sütun eşleme, Özellikler, Önizleme ve Sonuç adımlarından geçer. Hepsiburada'nın sütun başlıkları zaten tanımlı olduğu için eşleme doğrudan yapılır, yapay zekâ çağrılmaz ve kredi harcanmaz. Onayla ve aktar demeden hiçbir kayıt oluşturulmaz. ## İpuçları ### Barkod eşleşmesini gözden geçirmeden onaylamayın Stok kodu birebir tutan satırlar güvenlidir; barkod bir tahmindir ve barkod her zaman benzersiz değildir. Yanlış bağlanan bir ürün Hepsiburada'ya yanlış fiyat ve stok gönderir. "Kesin eşleşme" bandındakileri topluca onaylayın, "Kontrol edilmeli" ve "Zayıf ihtimal" bandındakileri tek tek açın. ### Servis anahtarı tek seferliktir Hepsiburada servis anahtarını yalnızca anahtarı oluşturduğunuz ekranda bir kez gösterir. Kaybederseniz aynı anahtar geri gelmez; satıcı panelinizden yeni bir servis anahtarı oluşturup buradaki Servis Anahtarı alanına girip Yeniden Bağlan demeniz gerekir. Satıcı ID değişmez. ## Sık sorulan sorular ### Bu panelden Hepsiburada'da yeni ürün açabilir miyim? Hayır. Hepsiburada'ya ürün gönderimi kategori ve o kategorinin zorunlu özellikleriyle birlikte yapılır ve Hepsiburada onayından geçer; bu akış henüz panelde açık değil. Ürünü Hepsiburada panelinizden açın, buradan eşleştirin, fiyat ve stoğu buradan yönetin. ### Siparişler panele ne sıklıkla düşüyor? "Sipariş senkronizasyonu aktif" açıkken her 5 dakikada bir arka planda çekilir. Bunun yanında webhook kuruludur ve Webhook Durumu kartından son olayı görebilirsiniz. Tek bir siparişi hemen tazelemek isterseniz sipariş detayında "Hepsiburada'dan Yeniden Senkronize Et" düğmesi vardır. ### Fatura otomatik mi kesiliyor? Varsayılan olarak hayır. "Otomatik fatura oluştur" kapalı gelir ve faturayı siz oluşturursunuz. Açtığınızda paketlenen her sipariş için fatura otomatik oluşturulur ve bağlantısı Hepsiburada'ya gönderilir — fatura yasal bir belge olduğu için bu anahtarı bilerek açın.