TotalApp Dökümanlar
Ctrl K
Anasayfa
EN | TR
Uygulamaya Git

Hepsiburada Entegrasyonu

Hepsiburada satıcı hesabınızı bağlayın, canlı listelemelerinizi ve sipariş paketlerinizi görüntüleyin ve stok, fiyat ve kargo hakkında Yapay Zeka Asistanı'na soru sorun.

Genel Bakış

Hepsiburada Entegrasyonu ekranı (E-ticaret → Pazaryeri Yönetimi → Hepsiburada), TotalApp ile Hepsiburada satıcı hesabınız arasındaki bağlantı merkezidir. API bilgilerinizi yönetir, canlı listeleme kataloğunuzu ve sipariş paketlerinizi yükler, kullanılan Hepsiburada REST uç noktalarını listeler ve pazaryeri verilerinize doğrudan erişimi olan gömülü bir Yapay Zeka Asistanı sunar.

Yalnızca Sunucu Taraflı API Çağrıları

Hepsiburada Listeleme API'sine (listing-external.hepsiburada.com) ve Sipariş Yönetim Sistemine (oms-external.hepsiburada.com) yapılan tüm istekler, tarayıcınızdan değil, TotalApp sunucusundan HTTP Basic kimlik doğrulaması ile yapılır. Bu, API kullanıcı adı ve şifrenizi güvende tutar ve CORS kısıtlamalarını önler.

Bağlantıyı Kurma

Adım 1 — Hepsiburada Entegrasyon Bilgilerinizi Alın

TotalApp, Hepsiburada Merchant ID ve API bilgilerinizi kullanarak bağlanır. Bulmak için:

  1. Hepsiburada Satıcı Paneli'ne giriş yapın.
  2. Hesap → Entegrasyon Bilgileri bölümüne gidin.
  3. Merchant ID değerinizi kopyalayın.
  4. API Kullanıcı Adı ve API Şifresi değerlerinizi kopyalayın.

Adım 2 — Bilgileri TotalApp'e Girin

Ayarlar → Entegrasyonlar → E-Ticaret → Hepsiburada bölümünü açın ve şunları girin:

AlanNerede bulunurÖrnek
Merchant IDHepsiburada Satıcı Paneli → Hesap → Entegrasyon Bilgileria1b2c3d4-...
API Kullanıcı AdıHepsiburada Satıcı Paneli → Hesap → Entegrasyon Bilgilerimerchant_username
API ŞifresiHepsiburada Satıcı Paneli → Hesap → Entegrasyon Bilgilerixxxxxxxxxxxxxxxx

Hepsiburada Entegrasyonu ekranında Satıcı Bağlantısı panelini açın ve Bağlantıyı Test Et düğmesine tıklayın. Bilgiler geçerliyse TotalApp bir sayfa listeleme çeker ve sayıyı görüntüler.

Adım 3 — Canlı Veri Yükleyin

Hepsiburada'dan en güncel anlık görüntüyü çekmek için Listelemeleri Yükle ve Paketleri Yükle düğmelerini kullanın:

  • Listeleme Kataloğu — satıcı SKU, HB SKU, ürün adı, stok, fiyat ve listeleme durumu.
  • Sipariş Paketleri — sipariş numarası, paket numarası, müşteri, ürün adedi, tutar ve paket durumu.

İstek Üzerine Senkronizasyon

Veriler arka planda otomatik olarak senkronize edilmez, istek üzerine yüklenir. Tabloların ve Yapay Zeka Asistanı'nın en güncel Hepsiburada durumunu yansıtmasını istediğinizde yükleme düğmelerine tıklayın.

API Uç Noktaları

Ekran, TotalApp'in kullandığı Hepsiburada Listeleme ve Sipariş Yönetimi (OMS) uç noktalarını listeleyen bir API Uç Noktaları referans paneli sunar. {merchantId}, {packageNumber} ve {status} gibi yol parametreleri çağrı sırasında doldurulur.

Listeleme API — listing-external.hepsiburada.com

MetotYolAmaç
GET/listings/merchantid/{merchantId}Satıcı ürünlerini (listelemeleri) getir
POST/listings/merchantid/{merchantId}/inventory-uploadsFiyat & stok güncellemesi yükle

Sipariş Yönetimi (OMS) — oms-external.hepsiburada.com

MetotYolAmaç
GET/packages/merchantid/{merchantId}Satıcı paketlerini listele
GET/orders/merchantid/{merchantId}/paymentawaitingÖdemesi beklenen siparişleri listele
POST/packages/merchantid/{merchantId}/packagenumber/{packageNumber}/deliverTeslimat statüsü ilet (teslim edildi)
GET/claims/merchantId/{merchantId}/status/{status}Satıcı taleplerini / iadeleri getir
GET/transactions/merchantid/{merchantId}Kayıt bazlı muhasebe servisi

SIT (Test) Ortamı

Hepsiburada, -sit alan adlarında bir SIT (Sistem Entegrasyon Testi) ortamı sunar (ör. oms-external-sit.hepsiburada.com). Yukarıdaki üretim adreslerine geçmeden önce entegrasyonunuzu doğrulamak için bu ortamı kullanın.

Yapay Zeka Asistanı

Ekranın sağ tarafındaki Yapay Zeka Asistanı paneli, Hepsiburada verilerinize sohbet tabanlı bir arayüz sunar. Bilgiler yapılandırıldığında TotalApp, canlı listeleme ve paketlerinizi sunucu tarafında çeker ve bağlam olarak sağlar; böylece asistan analitik sorularınızı anında yanıtlar.

Neler Sorabilirsiniz

  • Stok soruları: “Hangi listelemelerin stoğu azaldı?”
  • Sipariş soruları: “Bu haftanın paketlerini duruma göre özetle.”
  • Kargo soruları: “Kargo bekleyen paketleri listele.”
  • Fiyat soruları: “En yüksek fiyatlı listelemeler hangileri?”

Writer Engine Desteği

Asistan, Ayarlar → Agentic → Writer Engine seçiminize uyar. Local CLI veya Hosted API modunda canlı Hepsiburada verisi sunucu tarafında çekilerek bağlama eklenir. Ollama, Local LLM veya Web LLM modunda istek tamamen istemci tarafında çalışır ve canlı pazaryeri verisi kullanılamaz — veriye dayalı raporlar için Local CLI veya Hosted API'ye geçin.

Rapor Olarak Kaydetme

Yapay zeka yanıt verdikten sonra yanıtın altında bir Rapor Olarak Kaydet düğmesi belirir. Tıkladığınızda yanıt, sorunuz ve içinde bulunulan ay ile otomatik olarak adlandırılıp E-ticaret Raporları altına kaydedilir.

Sık Sorulan Sorular

Hepsiburada bilgilerim nerede saklanır?
Merchant ID, API Kullanıcı Adı ve API Şifresi bilgileriniz Ayarlar → Entegrasyonlar üzerinden saklanır. Hepsiburada'ya yapılan tüm çağrılar TotalApp sunucusundan HTTP Basic kimlik doğrulaması ile yapılır — bilgiler asla tarayıcıya açık edilmez.
Bağlantı testi HTTP 401 ile başarısız oluyor. Ne kontrol etmeliyim?
401 hatası, API Kullanıcı Adı/Şifre çiftinin yanlış olduğunu ya da Merchant ID'nin bilgilerle eşleşmediğini gösterir. Üç değeri de Hepsiburada Satıcı Paneli → Hesap → Entegrasyon Bilgileri bölümünden yeniden kopyalayıp tekrar test edin.
Listelemeler ve paketler neden farklı base URL kullanıyor?
Hepsiburada API'lerini servislere ayırır: Listeleme API'si listing-external.hepsiburada.com üzerinde, Sipariş Yönetim Sistemi (OMS) ise oms-external.hepsiburada.com üzerinde yer alır. TotalApp her isteği otomatik olarak doğru adrese yönlendirir.

Sonraki Adımlar