Qando

Hepsiburada Entegrasyonu

Hepsiburada merchant hesabınızı Qando'ya bağlama, finance modülü ve buybox sync.

Hangi bilgilere ihtiyacınız var?

Hepsiburada entegrasyonu için Merchant API hesabı gerekir:

  • Username (merchant kullanıcı adı)
  • Password (merchant API parolası)
  • Merchant ID — Hepsiburada satıcı panelinizdeki ID

Önemli: Bunlar normal panel giriş bilgileriniz değildir — Hepsiburada API için ayrı kullanıcı adı/şifre oluşturulur.

Hepsiburada Pro panelinden API kullanıcısı oluşturma

  1. merchant.hepsiburada.com panelinize girin.
  2. Sağ üstte profil > API Yönetimi menüsünü açın.
  3. Yeni API Kullanıcısı butonuna basın.
  4. Kullanıcı adı + güçlü parola belirleyin. Roller listesinde API rolünü seçin.
  5. Bilgileri kopyalayıp güvenli yere kaydedin (parola bir daha gösterilmez).

Qando'da bağlantı oluşturma

  1. Sol menü Entegrasyonlar > Yeni Bağlantı > Hepsiburada.
  2. Formu doldurun:
    • Bağlantı Adı
    • Merchant ID
    • Username (API kullanıcı adı)
    • Password (API parolası)
  3. Kaydet + Test Et.

Test başarılı ise bağlantı ACTIVE olur.

Finance modülü (saatlik sync)

Hepsiburada, satıcı paneli üzerinden finans (commission, ödemeler) verisini açtığı için Qando saatlik finance sync çalıştırır. Bu sayede:

  • Komisyon kesintilerini gerçek zamanlı görürsünüz
  • Ödeme dönemlerini takip edersiniz
  • Mutabakat raporları kesin rakamlarla üretilir

Finance verisi Dashboard > Komisyon & Hakediş widget'ında ve Komisyon ve Net Hakediş sayfasında görünür.

Buybox endpoint

Hepsiburada, Trendyol'un aksine buybox kazananını API üzerinden açar. Rakip Analizi premium modülü bu endpoint'i kullanır:

  • Hangi ürünlerde buybox sizde
  • Buybox'ı kaybettiyseniz hangi satıcıya geçti
  • Rakibin fiyatı ne kadar

Bu modül workspace'inize aktifse otomatik çalışır.

Sync akışları

  • Ürün Sync: 21:00'da otomatik
  • Sipariş Sync: 5 dakikada bir
  • İade Sync: 10 dakikada bir
  • Finance Sync: Saatlik
  • Buybox Sync: Saatlik (Rakip Analizi aktifse)

Manuel tetikleme bağlantı kartında Senkronize Et butonu altında.

Veri kalitesi uyarısı

Hepsiburada'nın bazı API endpoint'lerinde (özellikle Avantajlı Ürün ve Kendi Kampanyan) stok/fiyat/varyant verisi eksik gelebilir. Bu Hepsiburada tarafında bilinen bir durumdur; Qando bunları gördüğünde stok=0, fiyat=0 kaydeder ve PRODUCT_MATCHED bildirimi gönderir. Manuel düzeltme gerekir.

Yaygın sorunlar

  • Test başarısız: 401 → Username/Password yanlış girilmiş veya API rolünüz yok
  • Sipariş gelmiyor ama panel giriş çalışıyor → API kullanıcısının yetkisi yetersiz; sipariş okuma rolü ekleyin
  • Commission verisi gelmiyor → Finance sync workspace'inize aktif olmayabilir

Sonraki adım