Hepsiburada Entegrasyonu
Qukasoft paneliniz üzerinden Hepsiburada mağazanızı bağlayarak ürün senkronizasyonu, sipariş yönetimi ve dinamik fiyatlandırma süreçlerini otomatize edebilirsiniz.
Genel Ayarlar
Entegrasyonu başlatmak için Pazaryeri -> Mağazalar -> Hepsiburada Mağazalarım -> Mağaza Ekle adımlarını izleyin.
API Bilgilerini Alma
- merchant.hepsiburada.com adresine giriş yapın.
- Sağ üst köşede bulunan Hesap Bilgilerim -> Entegrasyon sekmesine gidin.
- Burada yer alan Servis Anahtarı (API Key) ve Mağaza ID bilgilerini Qukasoft panelindeki ilgili alanlara yapıştırın.
- "API'yi Test Et" butonu ile bağlantıyı doğrulayın.

Senkronizasyon ve Güncelleme Ayarları
Mağazanızın aktiflik durumunu ve verilerin hangi kapsamda güncelleneceğini bu bölümden yönetebilirsiniz.
| Güncelleme Tipi | Açıklama |
|---|---|
| Tüm Bilgiler | İzin verilen tüm alanları (Açıklama, Stok, Fiyat vb.) günceller. |
| Sadece Ürün Bilgileri | Fiyat ve stok hariç içeriksel verileri günceller. |
| Sadece Fiyat / Stok | Yalnızca seçilen veriyi (fiyat veya stok) günceller. |
| Stok ve Fiyat | Operasyonel verileri (stok + fiyat) birlikte günceller. |
Önemli: Hepsiburada katalog sisteminde yer alan ürünlerin içerik değişikliklerine her zaman izin vermeyebilir. Kampanya dönemlerinde fiyatın sabit kalması için "Sadece Stok" seçeneğini kullanabilirsiniz.
Kar Oranı ve Fiyatlandırma Kuralları
Tüm fiyat hesaplamaları Türk Lirası (₺) üzerinden yapılır. Döviz bazlı ürünler sistem tarafından otomatik olarak çevrilir ve ardından kar oranları eklenir.
Fiyat Hesaplama Mantığı
Hesaplamalar şu formüle göre yapılır:
$$Satış_Fiyatı = (Maliyet \times (1 + \frac{Kar_Oranı}{100})) + Ek_Tutar$$
Uygulama Önceliği (Hiyerarşi)
Sistem, bir ürün için tanımlanmış kurallar arasında ilk eşleşeni baz alır:
- Çapraz Kar: Kaynak + Kategori + Desi + Fiyat kombinasyonu.
- Kategori / Marka Bazlı: Spesifik kategorilere veya markalara özel oranlar.
- Kaynak Bazlı: Ürünün geldiği site veya XML kaynağına göre.
- Sabit Kar: Mağazadaki tüm ürünlere uygulanan genel oran.
Kısıtlamalar
Pazaryerine gönderilecek ürünleri belirli filtrelerle sınırlandırabilirsiniz. Kısıtlamaya giren ürünlerin pazaryerindeki stokları otomatik olarak 0 (sıfır) olarak güncellenir.
- Genel Kısıtlamalar: Belirlediğiniz minimum/maksimum stok, fiyat veya desi aralığı dışındaki ürünler aktarılmaz.
- Piyasa Fiyatı Kontrolü: Piyasa fiyatı (çizili fiyat) ile satış fiyatı arasındaki farkın belirlenen oranı aşmasını engeller.
- Özel Filtreler: Kaynak, kategori veya marka bazında spesifik kısıtlamalar tanımlanabilir.
Fiyat Yuvarlama ve Görsel Yönetimi
- Fiyat Yuvarlama: Fiyatlarınızı .99, .90 veya .x9 gibi formatlara çevirir. Yuvarlama yönünü (Yukarı, Aşağı, En Yakına) belirleyebilirsiniz.
- Görsel Boyutlandırma: Ürün resimlerini Hepsiburada standartlarına uygun hale getirir.
- Orantılı Boyutlandır: Görseli bozmadan çerçeveye sığdırır.
- Merkeze Yaklaştır: Görselin odak noktasını ortalayarak boyutlandırır.
Sipariş ve Operasyon Yönetimi
- Otomatik Onay: Gelen siparişlerin sistem tarafından anlık onaylanmasını sağlar.
- İade/İptal Durumu: İade edilen ürünlerin stoklara otomatik eklenip eklenmeyeceğini yapılandırır.
- Ürün Logları: Güncelleme sırasında alınan teknik hataları ve Hepsiburada'dan dönen mesajları buradan takip edebilirsiniz.
- Toplu Güncelleme: Ayar değişikliklerinden sonra tüm ürünleri sıraya alarak (dakikada yaklaşık 100 ürün) toplu günceller.