Hepsiburada entegrasyonu üç adımda kurulur: önce Hepsiburada satıcı panelinde Pixa'yı entegratör olarak
ekleyip mağaza bilgilerinizi alırsınız, sonra bu bilgileri Pixa'daki kurulum ayarlarına yazarsınız, en sonunda
bağlantıyı test edersiniz. Pixa, Hepsiburada'nın yetkili entegratörüdür; bu yüzden Hepsiburada tarafında
ayrı bir başvuru ya da onay süreci gerekmez, Pixa'yı listeden seçmeniz yeterlidir.
Her Hepsiburada mağazası Pixa'da ayrı bir entegrasyon kartıdır. Birden fazla mağazanız varsa bu adımları her
mağaza için ayrı ayrı yaparsınız; ayrıntı için sayfanın sonundaki "Birden fazla Hepsiburada mağazam var"
bölümüne bakın.
Başlamadan önce hazır olması gerekenler
Gereken | Nereden bulunur |
Aktif bir Hepsiburada satıcı hesabı | Hepsiburada Satıcı Paneli'ne giriş yapabiliyor olmalısınız. |
Mağaza ID | Satıcı panelinde entegratör ekleme ekranında görünür. Pixa'da Tedarikçi alanına yazılır. |
Servis Anahtarı | Aynı ekranda Pixa için üretilir. Pixa'da Servis Anahtarı alanına yazılır. |
Pixa'da ana kullanıcı hesabı | Kurulum ayarları ve Aktif/Pasif işlemleri yalnızca ana kullanıcıya açıktır; alt kullanıcılar bu alanları görmez. |
Siparişleri bir ERP'ye ya da kargo firmasına otomatik aktaracaksanız, ilgili ERP ve kargo entegrasyonlarının
Pixa'da önceden kurulu olması gerekir. Hepsiburada kurulumunda yalnızca bunların adını seçersiniz.
1. Adım: Hepsiburada'da Pixa'yı entegratör olarak ekleyin
Hepsiburada Satıcı Paneli'ne giriş yapın.
Hesabım → Ayarlarım menüsüne girin.
Entegratör ekle düğmesine tıklayın ve listeden Pixa'yı seçin.
Açılan ekranda Mağaza ID ve Servis Anahtarı bilgilerini kopyalayın. Servis Anahtarı yalnızca Pixa
için üretilir; başka bir entegratörün anahtarı Pixa'da çalışmaz.
Bilgileri kopyalarken başına ya da sonuna boşluk gelmemesine dikkat edin. Pixa boşlukları temizler, ancak
yanlış ya da eksik kopyalanmış bir anahtar bağlantı hatasına yol açar.
Servis Anahtarı'nı Hepsiburada panelinde yenilerseniz eski anahtar geçersiz olur ve Pixa'daki bağlantı kesilir.
Yeni anahtarı Pixa'daki kurulum ayarlarına da yazmanız gerekir.
2. Adım: Pixa'da kurulum ayarlarını kaydedin
Sol menüden Market'e girin.
Arama kutusuna "Hepsiburada" yazın ve Hepsiburada kartında Kur'a tıklayın. Kurulum sayfası açılır.
Kurulum sayfası dört adımdan oluşur. Her adımda ayarlar açık/kapalı anahtarlar ya da metin alanları olarak
listelenir; zorunlu alanlar yıldız ile işaretlidir.
Adım | Ne ayarlanır |
Mağaza Bilgileri | Tedarikçi (Mağaza ID, zorunlu), Servis Anahtarı (zorunlu), isteğe bağlı Özel İsimlendirme ve Satıcı Stok Kodu |
Sipariş Ayarları | Siparişleri Getir, Kargoya Veriliş Süresi (zorunlu, varsayılan 3 gün), Erp Adı ve Erp'ye Anlık İlet, Kargoya Anlık İlet, paketleme ve kargo etiketi tercihleri, Ödeme Bekleyen Siparişleri Aktar, İadeler Erp'ye İletilsin |
Ürün & Stok Ayarları | Stokları Gönder, Stok Alt Limiti, Buffer Stok, Fiyatları Güncelle |
Diğer Ayarlar | Entegrasyon Aktif, Sadece Satış Fiyatını Kullan, Stok Kodu Yerine Barkod Gönder, Otomatik Eşleştir, Kataloğa Özel Barkod Tanımı |
Zorunlu alan boş bırakılırsa Devam et çalışmaz ve "Lütfen zorunlu alanların hepsini doldurunuz" uyarısı
görünür.Son adımda Kaydet ve Bitir'e tıklayın. "Kaydedildi" mesajından sonra Market sayfasına yönlendirilirsiniz.
Sayfanın üst çubuğunda Entegrasyon anahtarı vardır. Bağlantı testine geçmeden önce bu anahtarın Aktif
olduğundan emin olun. Üst çubuktaki arama kutusu (Ayarlarda ara) ile herhangi bir ayarı adına göre bulabilirsiniz;
sağdaki Ayar Özeti hangi ayarların dolu olduğunu adım adım gösterir.
İlk kurulumda hangi anahtarların açılacağı hakkında karar veremiyorsanız yalnızca zorunlu alanları doldurup
kaydedin. Sipariş, stok ve fiyat ayarlarını daha sonra Market → Hepsiburada → Yapılandır → Kurulum
Ayarları yolundan istediğiniz zaman değiştirebilirsiniz. Her ayarın ne yaptığı ilgili makalede anlatılır:
sipariş aktarımı,
stok gönderimi,
fiyat gönderimi.
Kargoya Veriliş Süresi Hepsiburada'da "termin" olarak bilinen, siparişi kaç gün içinde kargoya vereceğinizi
belirten değerdir. Buraya yazdığınız süre ürünlerinize varsayılan olarak uygulanır; ürün bazında farklı süre
tanımlamayı stok gönderimi makalesi anlatır.
3. Adım: Bağlantıyı test edin
Market → Hepsiburada → Yapılandır → sağdaki Kurulum Ayarları'na girin.
Üst çubuktaki Bağlantıyı Test Et düğmesine tıklayın. Düğme "Test ediliyor…" olur, sonuç "Bağlantı
başarılı" ya da "Bağlantı hatası" olarak görünür; başlığın yanındaki rozet de "Bağlı" ya da "Bağlantı hatası"
olur.
Test, Mağaza ID ve Servis Anahtarı ile Hepsiburada'dan sipariş listenizin okunabildiğini doğrular. Başarılı
test, Hepsiburada'nın Pixa'yı mağazanız için tanıdığı anlamına gelir. Test ürün eşleştirme ya da başka bir işlem
başlatmaz.
"Bağlantı hatası" alıyorsanız sırayla kontrol edin:
Tedarikçi ve Servis Anahtarı doğru mu? En sık neden, anahtarın eksik kopyalanması ya da başka bir
mağazanın anahtarının yazılmasıdır. Hepsiburada panelinden yeniden kopyalayıp kaydedin.Hepsiburada panelinde Pixa entegratör listesinde hâlâ ekli mi? Entegratör kaldırılmış ya da anahtar
yenilenmişse Pixa erişim alamaz. 1. Adım'ı tekrarlayın ve yeni anahtarı Pixa'ya yazın.Entegrasyon Aktif mi? Pasif entegrasyonda hiçbir işlem çalışmaz.
Hepsiburada satıcı hesabınız askıda mı? Bu durumda önce Hepsiburada tarafını düzeltin.
Ne yapar, ne yapmaz
Kabiliyet | Durum |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ | |
✅ Stok turuyla birlikte | |
Kargo maliyetinin çekilmesi | ✅ Her gece |
Soru-cevap takibi | ✅ Saatte bir |
Çalışma sıklıkları
İşlem | Sıklık |
Sipariş çekme | Birkaç dakikada bir — webhook açıksa anında |
Paketlenemeyen siparişlerin yeniden denenmesi | 10 dakikada bir |
Ödemesi bekleyen siparişlerin kontrolü | Sekiz saatte bir |
Kargoya verilenlerin güncellenmesi | Günde beş kez |
Teslim edilenlerin güncellenmesi | Günde üç kez |
İptallerin çekilmesi | Saatte bir |
İade taleplerinin çekilmesi | Günde üç kez |
Stok gönderimi | Dört saatte bir, tam senkron her gece — ayrıca sipariş düştüğü anda |
Fiyat gönderimi | 🔴 Periyodik tarama yok — fiyat değiştiğinde gönderilir |
Ürün eşleştirme | Günde üç kez |
Fatura bağlantısının gönderilmesi | Günde iki kez |
Soru-cevap | Saatte bir |
Kargo maliyeti | Her gece |
İkinci ve sonraki Hepsiburada mağazalarınız aynı işleri kaydırmalı saatlerde yapar; bu yüzden bir
mağazada güncellenen bilgi diğerinde birkaç dakika sonra görünebilir.
Kurulumdan sonra
Kurulu entegrasyonlar Market sayfasında Kurulu entegrasyonlar başlığı altında listelenir. Kartın
Yapılandır penceresinde sağ tarafta Kurulum Ayarları, Pasif Et / Aktif Et ve entegrasyonun
açık görevlerinin listesi bulunur.Pasif Et, onay için "onaylıyorum" yazmanızı ister. Pasif entegrasyonda sipariş çekme, stok ve fiyat
gönderimi dahil tüm otomatik işlemler durur; ayarlarınız silinmez, Aktif Et ile kaldığı yerden devam eder.Siparişlerin gelmesi için Siparişleri Getir açık olmalıdır. Bu anahtar kapalıyken siparişler gelmediği
gibi fatura bağlantıları da Hepsiburada'ya iletilmez. Stok ve fiyatın gitmesi için Stokları Gönder ve
Fiyatları Güncelle açık olmalıdır.Kurulumdan sonra neyi ne zaman beklemelisiniz:
İşlem | Sıklık |
Yeni siparişlerin kontrolü | Yaklaşık 5 dakikada bir |
Stok gönderimi | Değişen ürünler 4 saatte bir, tüm ürünler her gece; ayrıca her sipariş sonrasında |
Fiyat gönderimi | Fiyat değiştiğinde ve panelden "Fiyatları Güncelle" dendiğinde |
Ürün eşleştirme | Otomatik Eşleştir açıksa günde üç kez |
Ürünlerinizi Pixa'dan göndermeyi planlıyorsanız Hepsiburada'da ürünler ilk gönderimde onay sürecinden geçer;
onaylanana kadar stok ve fiyat platformda görünmeyebilir. Ayrıntı için
ürün gönderimi.
Sık karşılaşılan durumlar
"Entegrasyon ayarı bulunamadı" uyarısı alıyorum. Bu uyarı Hepsiburada kurulumunun hiç kaydedilmediği ya da
entegrasyonun pasif olduğu durumda görünür. Market'te Hepsiburada kartı Kur gösteriyorsa kurulum
yapılmamıştır; Yapılandır gösteriyorsa Aktif Et'e bakın.
Ayarlar doğru ama bağlantı hatası alıyorum. Servis Anahtarı yalnızca üretildiği mağaza ve Pixa için
geçerlidir. Başka bir entegratör için üretilmiş anahtar ya da başka bir mağazanın Mağaza ID'si ile eşleşmeyen
anahtar hata verir. Hepsiburada panelinde Pixa satırındaki bilgileri yeniden kopyalayın.
Servis Anahtarı'nı yeniledim, siparişler gelmiyor. Yenilenen anahtar eskisini geçersiz kılar. Yeni anahtarı
Kurulum Ayarları'nda Servis Anahtarı alanına yazıp kaydedin ve bağlantıyı yeniden test edin.
Birden fazla Hepsiburada mağazam var. Her mağaza Pixa'da ayrı bir kart olarak tanımlanır (Hepsiburada,
Hepsiburada2, …) ve her biri için Hepsiburada panelinde ayrı entegratör kaydı, ayrı Mağaza ID ve Servis
Anahtarı gerekir. Kartları ayırt etmek için Özel İsimlendirme alanına mağaza adınızı yazın. Sipariş, stok ve
fiyat ayarları da mağaza başına ayrı tutulur; örneğin kargoya veriliş süresini her mağazanın kendi kurulum
ayarlarında değiştirmeniz gerekir. Ek mağaza kartı için Market sayfasındaki Yeni entegrasyon talep et
düğmesini kullanın ya da destek ekibine yazın.
Hepsiburada e-Faturam kullanıyorum. Hepsiburada e-Faturam, faturalarınızı Hepsiburada üzerinden kesmenizi
sağlayan ayrı bir entegrasyondur ve Market'te ayrı bir kart olarak kurulur. Bu makaledeki kurulum onu kapsamaz;
ayrıntı için fatura gönderimi.