Hepsiburada Entegrasyonu Rehberi 2026: REST API, HepsiJet ve Tek Panelden Satıcı Yönetimi

1. Hepsiburada API Mimarisi 2026

Hepsiburada'nın satıcı tarafı, iki birbiriyle örtüşen katmanla çalışır: yönetim arayüzü olan HMS satıcı paneli ve programatik erişim için REST API. Düşük SKU adedi olan satıcılar HMS'i doğrudan kullanır; orta-yüksek hacimli profesyonel satıcılar tüm operasyonu API ile otomatikleştirir. İki katman aynı veri tabanına yazar — yani panelden yaptığınız bir değişiklik API'den okuduğunuz veriye anında yansır.

REST API Taban URL ve Kimlik Doğrulama

Hepsiburada REST API, üç ana servis alanı (domain) üzerinden hizmet verir; tümü HTTPS üzerinden ve Basic Auth ile çağrılır:

• mpop.hepsiburada.com — Ürün, kategori ve listing servisleri
• oms-external.hepsiburada.com — Sipariş yönetimi (Order Management Service)
• listing-external.hepsiburada.com — Stok ve fiyat güncellemeleri (real-time)

API kimlik doğrulamasında Username + Password + Merchant ID üçlüsü kullanılır. Kimlik bilgileri HMS panelinizdeki "Entegrasyon → API Yönetimi" bölümünden talep edilir; Hepsiburada operasyon ekibi 1-3 iş günü içinde aktive eder. Her istekte HTTP header'ında Authorization: Basic <base64(username:password)> ve URL path'inde Merchant ID gönderilir.

HMS — Hepsiburada Marketplace Service

HMS, Hepsiburada'nın 3P satıcılarına sunduğu merkezi yönetim panelidir. Ürün listeleme, kategori ağacı taraması, varyasyon (renk/beden) tanımı, stok-fiyat güncelleme, sipariş işleme, iade yönetimi, kargo etiketi basma, performans raporları ve mağaza ayarları HMS üzerinden yapılır. HMS, REST API'nin kullanıcı arayüzlü karşılığıdır; API ile yapılan her işlem aynı arayüzde de görülür.

API Hız Limitleri ve Webhook Modeli

Hepsiburada API'si tipik olarak endpoint başına dakikada 100-300 istek limiti uygular; aşımda 429 Too Many Requests döner. Yüksek hacimli stok-fiyat güncellemelerinde batch (toplu) endpoint'leri kullanmak gerekir — örneğin tek istekte 100 SKU'ya kadar stok push edilebilir. Sipariş bildirimi için Webhook aboneliği ile polling (sorgulama) hibrit kullanılır: webhook'lar yeni sipariş ve durum değişikliklerini push eder, polling ise kaçırılan eventlere karşı güvence sağlar (Zunapro'da varsayılan polling aralığı 5 dakikadır).

2. REST API ile Bağlanma — Adım Adım

HMS Satıcı Hesabı Açılışı

Hepsiburada satıcı hesabı açmak için satici.hepsiburada.com üzerinden başvuru yapılır. Gerekli belgeler:

• Vergi levhası (faaliyet kodu e-ticarete uygun olmalı)
• İmza sirküleri ve faaliyet belgesi (limited / anonim şirketler için)
• ETBİS kaydı (Elektronik Ticaret Bilgi Sistemi, T.C. Ticaret Bakanlığı)
• GİB e-Fatura veya e-Arşiv mükellefiyeti
• Türk bankası TRY hesap bilgisi (ödeme alımı için)
• KEP adresi (Kayıtlı Elektronik Posta, tebligat için)

Başvuru sonrası Hepsiburada operasyon ekibi belgeleri tipik 3-5 iş gününde denetler. Onay sonrası HMS paneline ilk girişte mağaza adı, logo, vergi-iade politikaları ve iletişim bilgileri tanımlanır.

API Erişimi Talebi

API erişimi, HMS panelinde aktif satıcı hesabı oluştuktan sonra "Entegrasyon → API Yönetimi" menüsünden talep edilir. Hepsiburada operasyon ekibi, satış hacmi ve teknik ekip beyanına göre 1-3 iş günü içinde aşağıdaki üç bilgiyi e-posta veya panel mesajı ile iletir:

• Merchant ID (10 haneli benzersiz tanımlayıcı, örn. 1234567890)
• API Username (örn. satici_username_api)
• API Password (16+ karakter, sadece bir kez gösterilir, kasada saklayın)

Bu üçlü, REST API çağrılarında Authorization: Basic <base64(username:password)> header'ında ve URL path'inde /<merchantId>/ olarak kullanılır.

İlk Ürün Listeleme — Örnek Akış

Yeni bir ürünü Hepsiburada'da listelemek için tipik akış şudur:

1. Kategori ağacı sorgusu: GET /product/api/categories/get-all-categories ile tüm kategori hiyerarşisi çekilir, ürününüze uygun yaprak kategori bulunur (örn. "Cep Telefonu → Akıllı Telefon").
2. Kategori attribute set: GET /product/api/categories/{categoryId}/attributes ile o kategorinin zorunlu ve opsiyonel özellikleri çekilir (marka, model, renk, garanti, vs.).
3. Ürün gönderimi: POST /product/api/products/import ile ürün JSON payload'ı gönderilir (başlık, açıklama, fiyat, görseller, varyasyon listesi).
4. Onay bekleme: Hepsiburada moderasyonu ürünü 2-24 saatte denetler; başarısız ise hata kodu ile geri döner (eksik attribute, yasak içerik, görsel boyutu vs.).
5. Listing aktivasyonu: Onaylanan ürün otomatik olarak hepsiburada.com üzerinde yayına alınır; stok > 0 ve fiyat geçerliyse "Sepete Ekle" butonu aktif olur.

3. Ürün Senkronizasyonu — Kategori, Attribute ve Varyasyon

Kategori Ağacı Hiyerarşisi

Hepsiburada kategori ağacı, klasik bir hiyerarşik yapıdır: ana kategori → alt kategori → yaprak kategori. Yalnızca yaprak (leaf) kategorilere ürün listelenebilir; ara seviyelere listeleme yapılamaz. 2026 itibarıyla katalog 7.000'den fazla yaprak kategori içerir. Doğru kategori seçimi, hem komisyon oranını hem arama görünürlüğünü doğrudan etkiler — yanlış kategoride listelenen bir ürün, doğru aramalarda hiç görünmez.

Attribute Set ve Zorunlu Alanlar

Her yaprak kategorinin kendine özgü bir attribute set'i vardır: marka, model, renk, beden, malzeme, garanti süresi, vs. Attribute'lar üç tipte gelir:

• Zorunlu (Mandatory): Bu alanlar dolu olmadan ürün onaylanmaz. Eksiklik 400 Bad Request + hata kodu döndürür.
• Filtrelenebilir (Filterable): Hepsiburada arama filtrelerinde görünür — örn. "Renk: Siyah", "Marka: Samsung". Dolu olması conversion'ı doğrudan artırır.
• Opsiyonel (Optional): Ürün sayfasında detay olarak listelenir; arama filtresinde kullanılmaz.

Marka attribute'u en kritik olanıdır: her marka Hepsiburada onaylı marka listesinde olmalıdır. Yeni marka eklenmesi için ayrı bir marka başvuru süreci ve marka tescil belgesi (TPMK) istenir.

Varyasyon Yönetimi — Renk, Beden, Boyut

Hepsiburada'da varyasyonlar, "ana ürün + varyant SKU listesi" şeklinde modellenir. Örnek: tek bir tişört ürünü, 4 renk × 5 beden = 20 varyant SKU içerebilir. Her varyant ayrı bir HBSku alır ve ayrı stok-fiyat değeri tutar. Üst seviyede tek bir "merchantSku" ile gruplandığında müşteri ürün sayfasında renk ve beden seçicisini görür.

Pratik kural: Aynı ürünün her varyantını ayrı listing olarak yüklemek, hem moderasyon hem Buy Box yarışı açısından doğrudur — Hepsiburada algoritması varyant gruplamasını ana SKU üzerinden tutar.

Toplu (Bulk) İçeri Aktarma

1.000+ SKU'lu kataloglar için tek tek ürün gönderimi pratik değildir. Hepsiburada API'si POST /product/api/products/import endpoint'inde tek istekte 100 ürüne kadar batch payload kabul eder. İstek async çalışır: hemen bir trackingId döner, ardından GET /product/api/products/status/{trackingId} ile sonuç sorgulanır. Zunapro bu polling'i arka planda yürütür, başarısız olan ürünleri otomatik tekrar dener ve hata raporunu satıcıya sunar.

4. Sipariş Yönetimi — Webhook, Durum Akışı, Kargo

Sipariş Olay Akışı

Hepsiburada sipariş yaşam döngüsü tipik olarak şu durumları (status) içerir:

1. Open — Yeni sipariş, satıcı henüz onaylamadı (tipik SLA: 24 saat)
2. Picking — Sipariş satıcı tarafından kabul edildi, hazırlanıyor
3. Packaged — Paketlendi, kargoya verilmek üzere bekliyor
4. InTransit — Kargoya verildi, takip kodu üretildi
5. Delivered — Müşteriye teslim edildi
6. Cancelled / Returned — İptal veya iade

Her durum geçişi REST API üzerinden POST /orders/{orderId}/status ile veya HMS panelinden yapılır. Webhook abonesi olan entegrasyonlar her geçişte gerçek zamanlı bildirim alır.

Webhook Abonelik Modeli

Webhook'lar satıcının vereceği HTTPS endpoint'ine HTTP POST ile JSON payload gönderir. Tipik event tipleri: order.created, order.status.changed, order.cancelled, return.created. Hepsiburada idempotency için her event'e unique eventId ekler — entegrasyonun aynı eventId'yi iki kez işlememesi gerekir. Zunapro'da webhook receiver, eventId'leri Redis'te 7 gün tutar ve duplicate'ları sessizce drop eder.

Kargo Etiketi ve HepsiJet Otomasyonu

Sipariş Packaged durumuna geçtiğinde Hepsiburada otomatik bir kargo barkodu üretir. HepsiJet seçildiyse etiket Hepsiburada altyapısında basılır ve PDF olarak indirilir; Yurtiçi Kargo / Aras Kargo seçildiyse ilgili kuryenin entegre etiketi üretilir. Zunapro, PDF etiketi otomatik olarak siparişe ekler ve depo yazıcısına gönderir.

İade Portalı ve İptal Yönetimi

Tüketici mevzuatı gereği Türkiye'de B2C alıcılar 14 gün içinde cayma hakkını kullanabilir. Hepsiburada bu süreci iade portalı üzerinden işler: müşteri portaldan iade başvurusu açar, satıcıya bildirim gider, ürün HepsiJet ile geri toplanır, satıcı muayene sonrası iadeyi onaylar veya reddeder. Onaylanan iadelerde Hepsiburada müşteriye otomatik geri ödeme yapar ve satıcı hesabından düşer. Otomatik iade kodu (RMA) API'den çekilebilir.

5. Stok ve Fiyat — Real-Time Senkronizasyon ve Buy Box

Real-Time Stok Push

Hepsiburada API'si stok güncellemeleri için POST /listing/merchantid/{merchantId}/sku/{hbSku} endpoint'ini kullanır. Tek istekte tek SKU veya batch endpoint ile 100 SKU'ya kadar push edilebilir. Tipik latency 1-3 saniye; stok değişikliği müşteri tarafında 5 saniye içinde görünür. Stok 0'a düştüğünde listing otomatik olarak "satışa kapalı" işaretine geçer — listing silinmez, stok geri yüklendiğinde tekrar açılır.

Mükerrer Listeleme MIN-Stok Dedup

Aynı ürünü farklı pazaryerlerinde paralel listelediğinizde — örneğin Hepsiburada + Trendyol + ÇiçekSepeti — kritik risk overselling'tir: tek bir fiziksel stok birden fazla pazaryerinde aynı anda satılabilir. Zunapro bu riski MIN-stok dedup politikasıyla çözer: master katalogdaki gerçek stok değerinden, her pazaryerinde rezerve edilen stok düşülerek o pazaryerine push edilir. Bu sayede tek bir gerçek stok birim, sistem genelinde tek bir satışa karşılık gelir.

Hepsiburada Buy Box ve Fiyat Rekabeti

Hepsiburada Buy Box, ürün detay sayfasında "Sepete Ekle" butonunu kazanan satıcının teklifidir. Aynı ürünü satan birden fazla satıcı varsa, Hepsiburada algoritması en uygun teklifi öne çıkarır. Buy Box yarışında değerlendirilen ana sinyaller:

• Fiyat rekabetçiliği — Rakip satıcılara göre fiyat konumu (%5 farkın altı genelde güvenli bölge)
• Satıcı puanı — Müşteri yorumları ortalaması (4.7+ kritik eşik)
• Teslim hızı taahhüdü — HepsiJet aynı gün / ertesi gün avantajı
• HepsiLojistik kullanımı — FBA modelinde Buy Box ağırlığı belirgin yükselir
• İptal ve iade oranı — Düşük oranlar pozitif sinyal
• Stok süreklilik puanı — Sık stok-dışı kalan satıcılar cezalandırılır

Repricer Entegrasyonu

Buy Box rekabetini sürekli kazanmak için manuel fiyat takibi pratik değildir. Zunapro repricer modülü Hepsiburada API'sinden rakip satıcı fiyatlarını dakikalık çeker, satıcının tanımladığı taban (floor) ve tavan (ceiling) fiyat aralığında otomatik düzeltme yapar, ve Buy Box durumunu kaybettiği anda agresif düzeltme kuralı tetikler. Çıktı: ortalama %12-22 net cirosal artış raporlanır.

6. HepsiJet — Hepsiburada'nın Kendi Kurye Ağı

Neden HepsiJet?

HepsiJet, Hepsiburada'nın iştirak şirketi olarak kurulmuş, pazaryerinin kendi 1. parti kurye operasyonudur. 2020'li yıllarda büyük yatırımla genişleyen HepsiJet, 2026 itibarıyla Türkiye genelinde 1.500'den fazla teslim noktası ve mahalle bazlı dağıtım kapasitesiyle aynı gün ve ertesi gün teslimat standardını yakalamış durumda. Hepsiburada satıcı puanlamasında HepsiJet kullanımı doğrudan ödüllendirilir.

Avantajlar

• Hızlı teslim rozeti — Ürün sayfasında "HepsiJet Hızlı Teslimat" etiketi gösterilir; conversion'ı doğrudan artırır
• Kargo komisyonunda indirim — Hepsiburada, HepsiJet seçen satıcılara kargo bedeli üzerinden indirim sunar
• Buy Box ağırlığı — Aynı fiyatta iki satıcı varsa HepsiJet seçen kazanır
• Entegre takip — Müşteri kargo durumunu Hepsiburada uygulamasından gerçek zamanlı izler
• Otomatik iade toplama — İade portalından açılan başvurularda HepsiJet kuryeyi otomatik müşteri kapısına yollar

HepsiJet Etiket API'si

Sipariş Packaged durumuna geçtiğinde Hepsiburada API'sinden HepsiJet barkod ve PDF etiket çekilir: GET /shipping/api/labels/{packageNumber}. Bu PDF doğrudan etiket yazıcısına gönderilebilir veya manuel basılır. Zunapro, etiket çıktısını sipariş detayında saklar ve müşteri hizmetlerinde gerektiğinde tek tıkla erişim sağlar.

Alternatif Kuryeler

HepsiJet zorunlu değildir; Hepsiburada altyapısı şu kuryelerle entegre çalışır:

• Yurtiçi Kargo — En geniş şube ağı, kırsal bölgelerde HepsiJet'in alternatifi
• Aras Kargo — Güçlü B2B ve büyük paket performansı
• MNG Kargo — Ekonomik alternatif, küçük paketler için uygun
• Sürat Kargo — Belirli illerde rekabetçi fiyat avantajı
• PTT Kargo — En düşük maliyet, ama daha uzun teslim süresi

Zunapro lojistik modülü, her siparişi ağırlık, alıcı il/ilçe ve seçilen teslim metoduna göre en uygun kuryeye yönlendirir; HepsiJet hizmet alanı dışındaki bölgelere otomatik fallback uygular.

7. HepsiLojistik — FBA Modeli

HepsiLojistik Nedir?

HepsiLojistik, Hepsiburada'nın Amazon FBA eşdeğeri fulfillment hizmetidir: stokunuzu Hepsiburada deposuna teslim edersiniz, sipariş geldiğinde toplama (picking), paketleme (packing), kargolama (shipping) ve iade işleme (returns) Hepsiburada tarafından yürütülür. Satıcı sadece stok temin eder; lojistiğin geri kalan tüm operasyonel yükü pazaryerinde kalır.

HepsiLojistik Depoları

• Gebze (Kocaeli) — Ana fulfillment merkezi, en büyük kapasite, İstanbul-Marmara hizmet alanı
• Şekerpınar (Kocaeli) — İkincil İstanbul depo, hızlı teslim ürünleri için
• Kemalpaşa (İzmir) — Ege bölgesi fulfillment, batı Anadolu ve EgeEge hizmet alanı için optimize

Depolara stok girişi randevulu yapılır. Zunapro deposu giriş randevusunu API üzerinden açar ve barkod-paket boyutu doğrulamasını arka planda yürütür.

HepsiLojistik Fulfillment Ücretleri

Maliyet kalemleri tipik olarak şudur:

• Aylık depolama bedeli — m³ veya raf birimi başına; tipik 80-140 TL/m³/ay bandı
• Giriş kabul ücreti — Bir kerelik, parsiyel başına 50-150 TL aralığında
• Sipariş başı toplama-paketleme — 12-22 TL/sipariş bandı, paket boyutuna göre
• Kargolama — HepsiJet anlaşmalı fiyatı (genelde piyasanın altında)
• İade işleme — İade başına 8-15 TL muayene ücreti

Toplam: orta-segment SKU için sipariş başı tipik 18-28 TL bandında yer alır. Yüksek depo dönüş hızı (stoğun ayda 1-2 kez tamamen satılması) şarttır; dönüş hızı düşük SKU'larda depolama bedeli kârı eritir.

HepsiLojistik Başvuru Kriterleri

• Aylık en az 200 sipariş ortalaması (alt eşik tipik olarak)
• Satıcı puanı 4.5/5 üstü
• İade oranı kategori ortalamasının altında
• SKU'ların ortalama paket ağırlığı 15 kg altında (büyük beyaz eşya hariç)
• Mevsimsellik düşük; stok dönüş hızı yüksek SKU'lar tercih edilir

8. e-Fatura Entegrasyonu — GİB ve ERP'ler

GİB e-Fatura Zorunluluğu

Türkiye'de yıllık brüt satış hasılatı GİB eşiğini aşan tüm e-ticaret mükellefleri için e-Fatura ya da e-Arşiv Fatura zorunludur. 2026 itibarıyla pratik eşik 3 milyon TL'dir; e-ticaret faaliyeti gösteren mükelleflerin tamamı için fiilen zorunlu kabul edilir. Hepsiburada her sipariş için 7 gün içinde faturanın kesilmesini ve sipariş detayına yüklenmesini ister; gecikme satıcı puanını ve Buy Box durumunu olumsuz etkiler.

e-Fatura vs e-Arşiv Fark

• e-Fatura — Alıcı da e-Fatura mükellefi ise; GİB sistemleri arasında doğrudan iletilir
• e-Arşiv Fatura — Alıcı (genelde son tüketici) e-Fatura mükellefi değilse; satıcı GİB'e bildirir, alıcıya PDF iletir

Hepsiburada B2C siparişlerinin büyük çoğunluğu e-Arşiv kapsamındadır; B2B (kurumsal) alıcılarda e-Fatura kullanılır. Sistem alıcının vergi kimlik numarasını doğrulayarak otomatik tipi seçer.

ERP Entegrasyonları

Zunapro aşağıdaki Türk ERP ve e-Fatura sağlayıcılarıyla doğrudan entegredir:

• Logo (Tiger, Go, Netsis) — KOBİ-orta ölçek standardı, geniş kullanım
• Mikro Yazılım — Esnaf ve KOBİ segmentinde yaygın
• Nebim V3 — Perakende ve moda sektörü ağırlıklı
• Uyumsoft — Büyük ölçek ERP + entegratör
• QNB e-Finans, Foriba, İzibiz, Nilvera — Sadece e-Fatura entegratörleri

Hepsiburada sipariş yaratıldığı anda Zunapro tetiklenir; sipariş bilgisi seçili ERP veya entegratöre push edilir, fatura numarası ve PDF üretilir, ardından Hepsiburada sipariş detayına otomatik yüklenir. Müşteri faturayı pazaryerinden indirebilir; süreç tamamen otomatiktir.

KDV ve Tevkifat

Hepsiburada üzerinden satılan ürünlerde KDV oranı kategoriye göre değişir: standart oran %20, gıda-kitap-medikal kategorilerinde %10 veya %1. Komisyon faturasında Hepsiburada satıcıya KDV'li fatura keser; satıcı bu KDV'yi indirim olarak düşürebilir. Tevkifatlı satışlar (özel kategoriler) için Hepsiburada otomatik tevkifat uygular ve net tutarı satıcı hesabına geçer.

9. Yaygın Hatalar ve Çözümler

Hata Kodu / Mesaj	Sebep	Çözüm
401 Unauthorized	API username/password yanlış veya süresi dolmuş	HMS panelden API kimlik bilgisini sıfırla, Basic Auth header'ı yeniden üret
403 Forbidden · Merchant inactive	Satıcı hesabı askıya alınmış veya belgeler eksik	HMS bildirimlerini kontrol et, eksik belgeyi yükle, operasyon ekibiyle iletişime geç
400 · Mandatory attribute missing	Zorunlu kategori attribute'u (marka, model vs.) eksik	Kategori attribute endpoint'inden zorunlu listeyi çek, eksikleri payload'a ekle
429 Too Many Requests	Endpoint dakikalık istek limiti aşıldı	Batch endpoint kullan, exponential backoff uygula, Zunapro queue ile rate-limit hibrit
Ürün moderasyondan reddedildi	Yasak içerik, görsel boyutu, marka onayı eksik	Hata mesajını oku, ürünü düzelt, re-submit ile tekrar gönder
Stok 0 ama satış görünüyor (overselling)	Birden fazla pazaryerinde paralel listing, stok eşgüdümü yok	Zunapro MIN-stok dedup'ı aktif et; master stoğa yazılan değer push edilir
Sipariş onaylandı ama kargo etiketi gelmedi	Status timing, kargo entegrasyonu beklemede	2-3 dakika bekle, ardından GET /shipping/labels ile manuel çekin
İade onayı verildi ama bakiye düşmedi	Mali süreç 3-5 iş günü içinde tamamlanır	HMS muhasebe sekmesinden kontrol et; gecikme uzarsa destek talebi açın

10. Hepsiburada Komisyon 2026 — Kategori Bazlı Yapı

Hepsiburada komisyonu kategori bazlı olarak %8 ile %22 arasında değişir. Komisyon, satış tutarının KDV hariç bedelinden hesaplanır. Üç bant yapısı şudur:

Komisyon Üstüne Eklenen Maliyetler

• HepsiAd reklam bütçesi — Opsiyonel, CPC tabanlı (TL 0.40 – 4+ /tık)
• HepsiLojistik fulfillment ücreti — Opsiyonel, FBA modelinde sipariş başı 18-28 TL
• Kargo bedeli — HepsiJet veya alternatif kurye tarifeleri (ücretsiz teslimat tercih edilirse satıcıdan düşer)
• Hizmet bedeli — Kategoriye göre %1-2 ek (mali işlemler ve raporlama)
• BSMV ve KDV — Komisyon faturasında otomatik uygulanır

Yasal Çerçeve 2026 — KDV, e-Fatura, KVKK, ETBİS

KDV ve Vergi

Türkiye'de standart KDV oranı %20'dir; gıda, kitap ve medikal ürünlerde %10 veya %1 indirimli oranlar uygulanır. Hepsiburada satıcı kazançları KDV'li gösterilir; satıcı KDV beyannamesinde komisyon KDV'sini indirir. Stopaj ve gelir vergisi mevzuatı standart Türk ticaret hukuku çerçevesinde işler.

e-Fatura ve e-Arşiv (GİB)

2026 itibarıyla pratikte tüm e-ticaret mükellefleri için e-Fatura veya e-Arşiv zorunludur. Yıllık brüt satış hasılatı 3 milyon TL'yi aşan tüm mükellefler GİB sistemine kayıtlı olmak zorundadır. Hepsiburada her sipariş için 7 gün içinde fatura yüklenmesini bekler; gecikmeler satıcı performans puanını düşürür.

KVKK — Kişisel Verilerin Korunması

6698 sayılı KVKK (Kişisel Verilerin Korunması Kanunu) kapsamında satıcılar, müşteri bilgilerini (ad, adres, telefon, e-posta) ancak siparişin gerektirdiği ölçüde işleyebilir. Pazaryerinden gelen veri Hepsiburada'nın veri sorumluluğundadır; satıcı veri işleyen sıfatıyla aynı sorumlulukları taşır. VERBİS (Veri Sorumluları Sicili) kaydı, yıllık 50 çalışan veya 25 milyon TL ciro üstü işletmeler için zorunludur.

ETBİS — Elektronik Ticaret Bilgi Sistemi

T.C. Ticaret Bakanlığı tarafından yürütülen ETBİS kaydı, Türkiye'de elektronik ticaret yapan tüm tüzel kişiler için zorunludur. Kayıt etbis.ticaret.gov.tr üzerinden ücretsizdir; vergi kimlik no, MERSİS no ve faaliyet alanı bildirilir. ETBİS kaydı olmayan satıcılar Hepsiburada'da hesap açamaz.

Tüketici Hakları ve 14 Gün Cayma

• 14 gün cayma hakkı — 6502 sayılı Tüketicinin Korunması Hakkında Kanun; B2C uzaktan satışlarda alıcı 14 gün içinde gerekçesiz iade hakkına sahip
• 2 yıl yasal garanti — Türk Borçlar Kanunu çerçevesinde dayanıklı tüketim mallarında 2 yıl ayıba karşı tekeffül
• İade kargo ücreti — Cayma hakkı kullanımında kargo ücreti, ürün tipi ve marketplace politikasına göre satıcıdan veya alıcıdan tahsil edilebilir

Lojistik ve Kargo — HepsiJet Öncelikli Yapı

Türkiye Kargo Pazarının Genel Yapısı

Türkiye'nin e-ticaret lojistik altyapısı, yoğun şehir nüfusu ve görece kısa coğrafi mesafeler sayesinde son derece olgun bir kurye ekosistemine sahiptir. Pazaryeri-özel kurye operasyonları (HepsiJet, Trendyol Express) son beş yılda hızla büyüdü; her büyük pazaryeri kendi 1. parti kuryesini varsayılan teslim seçeneği yapıyor.

Pratik 2026 Kargo Yığını

Hepsiburada satıcısı için pratik 2026 kargo dağılımı şudur:

• HepsiJet — Marmara, Ege, İç Anadolu büyük şehirleri için varsayılan
• Yurtiçi Kargo — Anadolu içleri ve kırsal bölge fallback
• Aras Kargo — 25 kg üstü büyük paketler ve B2B teslimat
• MNG Kargo — Ekonomik küçük paket alternatifi
• PTT Kargo — Uzak köy/kasaba teslimatları, en düşük maliyet
• Sürat Kargo — Belirli illerde bölgesel rekabet avantajı

Zunapro lojistik modülü her siparişi ağırlık, alıcı il/ilçe, alıcının seçtiği teslim metodu ve kargo tarife matrisine göre en ekonomik kuryeye yönlendirir; HepsiJet servis alanı dışına otomatik fallback uygular.

Çoklu Pazaryeri Stratejisi — Hepsiburada + Trendyol + ÇiçekSepeti

Tek Stok, Çoklu Pazaryeri

Türkiye 3P pazaryeri ekosisteminde 2026 için kazandıran strateji tek master kataloğun 3-5 pazaryerine paralel yansıtılmasıdır. Tipik konfigürasyon: Trendyol (en geniş reach), Hepsiburada (orta-yüksek segment alıcı), ÇiçekSepeti (özel günler ve hediye), PTT AVM (kamu ve kurumsal satınalma) ve isteğe bağlı olarak Amazon TR (markalı tüketici elektroniği için). Zunapro tek bir master katalog üzerinden tüm bu kanallara stok-fiyat push'u eşgüdümlü yapar.

Pazaryeri Karşılaştırma — Hepsiburada vs Trendyol

Boyut	Hepsiburada	Trendyol
Kuruluş yılı	2000 (Hanzade Doğan Boyner)	2010 (Demet Mutlu)
Halka açıklık	NASDAQ:HEPS (2021)	Alibaba çoğunluk hissedar (özel)
Aktif müşteri	13M+	40M+
Aktif satıcı	60K+	250K+
API modeli	Basic Auth + Merchant ID, mpop.hepsiburada.com	OAuth + Supplier ID, api.trendyol.com
Kendi kargo	HepsiJet (1.500+ nokta)	Trendyol Express
FBA modeli	HepsiLojistik	Trendyol Mağaza Plus / Anlaşmalı depo
Komisyon bandı	%8 – %22	%5 – %20
Güçlü kategori	Elektronik, beyaz eşya, premium	Moda, kozmetik, ev, gıda

Tabloyu okuma kılavuzu: Trendyol toplam reach'te öndedir; Hepsiburada özellikle elektronik ve premium segment alıcı profilinde güçlüdür. Komisyon bandları örtüşür ama kategori bazlı farklar 2-4 puana ulaşabilir. Pratik strateji: yüksek hacimli SKU'ları iki pazaryerine paralel yansıtmak, kategoriye özgü tek pazaryeri optimizasyonu Zunapro'da kural tabanlı yapmak.

Hepsiburada'da Satışa Nasıl Başlanır — 5 Adımda

1. Hepsiburada Satıcı Hesabı Açın

Vergi levhası, ETBİS kaydı, GİB e-Fatura mükellefiyeti, KEP adresi ve Türk bankası TRY hesabı ile satici.hepsiburada.com üzerinden başvuru yapın. Onay tipik 3-5 iş günü sürer. Yabancı satıcılar için Türkiye'de bir limited şirket kurmak ön şarttır — doğrudan yurt dışı şirket ile satış kabul edilmez.

2. HMS Panel ve API Kimliği

HMS paneline ilk girişte mağaza profilini tamamlayın (mağaza adı, logo, iade politikası, iletişim). Ardından "Entegrasyon → API Yönetimi" menüsünden API erişimi talep edin. 1-3 iş gününde Merchant ID + Username + Password üçlüsü iletilir.

3. e-Fatura ve ERP Entegrasyonu

Hepsiburada satışına başlamadan önce e-Fatura veya e-Arşiv altyapınızı kurun. Logo, Mikro, Nebim, Netsis, Uyumsoft veya bağımsız entegratör (Foriba, İzibiz, Nilvera) seçeneklerinden biri yeterlidir. Zunapro tüm bunlara doğrudan entegredir.

4. HepsiJet veya Alternatif Kurye Seçin

Yüksek hacimli satıcıların büyük çoğunluğu HepsiJet'i varsayılan kargo olarak seçer (kargo bedeli indirimi + Buy Box ağırlığı + hızlı teslim rozeti). HepsiJet hizmet alanı dışındaki bölgeler için Yurtiçi veya Aras Kargo fallback olarak tanımlanır.

5. Zunapro ile Bağlanın (10 Dakika Entegrasyon)

1. Zunapro hesabınıza giriş yapın ve Türkiye modülünden "Hepsiburada" tile'ını seçin
2. Merchant ID + Username + Password'ü ilgili alanlara yapıştırın; bağlantı testi otomatik çalışır
3. Master kataloğunuzu eşleyin — Zunapro ML kategori önerisini onaylayın
4. e-Fatura ve HepsiJet entegrasyonunu tek tıkla aktive edin
5. Canlıya alın — 1.000 SKU katalog için ilk senkron tipik 10 dakikada tamamlanır

Hepsiburada Entegrasyonu — Sık Sorulan Sorular 2026