Hepsiburada Entegrasyonu: API, XML, HepsiLojistik ve Tek Panelden Mağaza Yönetimi

Hepsiburada Hakkında: Kuruluş, Yatırımcılar ve Pazar Konumu

Kuruluş ve Tarihçe (2000 – Bugün)

Hepsiburada, Hanzade Doğan Boyner tarafından 2000'de İstanbul'da, Doğan Holding bünyesinde Türkiye'nin ilk büyük online alışveriş platformu olarak kuruldu. 2000'lerin başında kitap, müzik ve elektronikle başlayan platform, 2010 sonrası tüm kategorilere yayıldı. 2015–2020 arasında pazaryeri (3P) modeline geçerek satıcı sayısını 10K'dan 50K'ya çıkardı. HepsiJet kendi kargo şirketi 2017'de, HepsiLojistik fulfillment programı 2018'de devreye girdi.

Hepsiburada, 1 Temmuz 2021'de NASDAQ borsasında HEPS sembolü ile halka açıldı; IPO sırasında değerlemesi yaklaşık 3.9 milyar dolardı — bu, ABD borsalarında halka arz olan ilk Türk teknoloji şirketi unvanını kazandırdı. 2024'te Kaspi.kz (Kazakistan'ın en büyük fintech-pazaryeri grubu) stratejik yatırımcı olarak hisse aldı. Bugün Hepsiburada; pazaryeri (3P), kendi satışları (1P), HepsiJet kargo, HepsiLojistik fulfillment, HepsiPay ödeme, HepsiAd reklam ve HepsiGlobal sınır ötesi dikeylerine yayılmış halka açık bir teknoloji ekosistemidir.

Hepsiburada Sahiplik Yapısı (2025)

• Doğan Holding (Hanzade Doğan Boyner ailesi) — Ana hissedar (≈%24, kurucu aile)
• NASDAQ HEPS — Halka açık hisse (2021 IPO sonrası serbest dolaşım)
• BIST HEPSI — Borsa İstanbul'da ikincil işlem
• Kaspi.kz — Stratejik yatırımcı (2024 itibarıyla)
• Hanzade Doğan Boyner — Kurucu ve Yönetim Kurulu Başkanı

Türkiye E-Ticaretindeki Konumu

Hepsiburada, 2024 itibarıyla Türkiye e-ticaret pazarının yaklaşık %18-22'sini elinde tutarak Trendyol'un ardından açık ara ikinci sıradadır. Özellikle elektronik, beyaz eşya, telefon, bilgisayar ve teknoloji kategorilerinde lider konumdadır. Türkiye'nin online alışveriş yapan her 10 kişisinden 7'si Hepsiburada hesabına sahiptir. Halka açık tek Türk e-ticaret şirketi olması, finansal şeffaflık açısından satıcılar için ciddi bir güven kaynağıdır.

Hepsiburada Satış Hacmi ve Büyüklük (2024–2025 Verileri)

Hepsiburada, son 5 yılda Türkiye e-ticaretinin köklü ikinci oyuncusu olarak istikrarlı büyüme gösterdi. Gross Merchandise Value (GMV) ve sipariş hacmi her yıl %30–50 büyüme kaydetti; özellikle elektronik ve teknoloji kategorilerinde pazar liderliği güçlendi.

Yıl	GMV (TL)	Aktif Müşteri	Aktif Satıcı	Önemli Olay
2020	~₺18 milyar	10M	32K	Pandemi ile sipariş 2x büyüme
2022	~₺55 milyar	12M	45K	NASDAQ HEPS halka açık (2021)
2024	~₺105 milyar	13M+	60K+	Kaspi.kz stratejik yatırım
2025 (öngörü)	~₺140 milyar	15M	75K	Bölgesel sınır ötesi büyüme

Bu büyüme; HepsiJet'in Türkiye genelinde aynı/ertesi gün teslimat altyapısı, HepsiLojistik fulfillment programı ve Hepsiburada Yıldız Satıcı programı sayesinde gerçekleşti. Hepsiburada pazaryerine satıcı olarak girmek, özellikle elektronik, teknoloji ve premium ürün kategorilerinde Türkiye'nin en kârlı online büyüme rotasıdır.

Hepsiburada'da Mağaza Açma Süreci (2026 Güncel Kurallar)

1. Yasal ve Mali Gereksinimler

Hepsiburada'da satıcı olmak için Türkiye'de aktif vergi mükellefiyetiniz olmalıdır. Şahıs şirketi, limited veya anonim şirket farketmez; ancak e-Fatura mükellefi olmak ve e-Arşiv fatura kesebilmek zorunludur.

• Vergi levhası (güncel yıl)
• Vergi numarası ve TC kimlik no (şahıs şirketi için)
• Ticaret sicil gazetesi (ltd/A.Ş. için)
• İmza sirküleri
• Banka hesap (IBAN) — ödemeler bu hesaba aktarılır
• e-Fatura/e-Arşiv özel entegratörü veya GİB portalı
• Marka tescil belgesi (kozmetik, gıda, oyuncak gibi koruyuculu kategorilerde)

2. Hepsiburada Satıcı Paneline Başvuru

partner.hepsiburada.com üzerinden başvurunuzu yaparsınız. Onay süresi genellikle 3–7 iş günüdür. Onay sonrası size mağaza ID (MerchantId), OAuth2 client_id ve client_secret bilgileri verilir — bunlar MPOP API entegrasyonu için kritiktir.

📥 Resmi Hepsiburada Mağaza Başvuru Sayfası partner.hepsiburada.com — ücretsiz başvuru, 3–7 iş günü onay süresi →

3. Ürün Yükleme ve İçerik Kuralları

Hepsiburada, ürün listelemelerinde sıkı içerik kuralları uygular:

• Başlık: 50–150 karakter, marka + ürün adı + temel özellik
• Görsel: Beyaz arkaplan, minimum 1000×1000px, maks. 8 fotoğraf, watermark/yazı yasak
• Açıklama: HTML destekli, minimum 200 karakter
• Kategori eşleştirme: Hepsiburada kategori ID + nitelikler (renk, beden, malzeme)
• Barkod (GTIN/EAN): Elektronik ve teknolojide zorunlu, eşleme hızını ciddi artırır
• İçerik skoru: 80+ olmalı; aksi halde ürün vitrine düşmez

Hepsiburada Komisyon Oranları (2026)

Hepsiburada 2026 komisyon oranları kategoriye göre %5 ile %22 arasında değişir. Komisyona %20 KDV ile hizmet bedeli ve kargo maliyeti eklenir. Brüt-net hesabı yapmadan fiyatlama yapmak en sık görülen satıcı hatasıdır. Aşağıda kolay anlaşılır 3 ana komisyon bandını özetledik:

Net kazanç hesabı: Satış fiyatı − Komisyon − KDV − Hizmet bedeli − Kargo bedeli − Ürün maliyeti = Net kâr. Zunapro fiyatlama modülü bu hesabı her ürün ve kategori için otomatik yapar; minimum kâr eşiğinizin altında satış yapmamanızı sağlar.

Hepsiburada API Entegrasyonu — Teknik Detaylar

Hepsiburada MPOP API (Marketplace Open Platform), satıcıların ürün, stok, sipariş, fiyat, kargo ve iade verilerini Hepsiburada sistemiyle programatik olarak senkronize etmesine olanak veren RESTful bir arayüzdür. API base URL: https://mpop.hepsiburada.com/

API Yetkilendirme

Hepsiburada API, OAuth2 Bearer Token kullanır. client_id ve client_secret ile token endpoint'inden access_token alınır ve Authorization: Bearer {token} başlığında gönderilir. Token 24 saat geçerlidir; otomatik refresh edilir. Detaylı dokümantasyon: developers.hepsiburada.com

Ana Endpoint Kategorileri

• Listings API — Ürün listeleme, güncelleme, kategori eşleme, içerik skoru sorgulama
• Inventory API — Stok ve fiyat senkronizasyonu (bulk endpoint maks. 100 ürün/istek)
• Orders API — Sipariş listeleme, durum güncelleme, paket oluşturma
• Shipment API — HepsiJet kargo etiketi oluşturma, takip numarası senkron
• Cancellations API — İptal ve iade taleplerini sorgulama, kabul/red
• Settlements API — Hakediş, fatura ve mutabakat raporları
• Webhooks — Sipariş ve stok değişikliklerinde anlık callback

Rate Limit ve Hata Yönetimi

Hepsiburada API hız limiti satıcı başına dakikada 100 istektir. Aşıldığında 429 Too Many Requests döner. Yaygın hata kodları: 400 (geçersiz ürün verisi), 401 (token süresi dolmuş — refresh), 404 (kategori/barkod bulunamadı), 500 (Hepsiburada sistem hatası — yeniden dene). Zunapro entegratörü token refresh, exponential backoff retry ve dead-letter queue ile bu hataları otomatik yönetir.

Hepsiburada XML Entegrasyonu — Toplu Ürün Aktarımı

Hepsiburada XML entegrasyonu, tedarikçi veya kendi e-ticaret sitenizdeki ürün kataloğunu XML formatında otomatik okuyup Hepsiburada satıcı paneline aktaran sistemdir. Manuel ürün eklemenin alternatifi olarak binlerce ürünü dakikalar içinde yüklemenizi sağlar.

XML Şema Yapısı (Hepsiburada Uyumlu)

Hepsiburada'ya yüklenecek XML'in temel alanları:

• HepsiburadaSku — Ana ürün kodu (varyantları gruplar)
• productId, brand, productName, merchantSku, barcode
• categoryId (Hepsiburada kategorisi), attributes (renk, beden, malzeme)
• availableStock (stok), price, listPrice, vatRate
• dispatchTime, shippingAddressId
• images (1–8 URL), description (HTML)

Tedarikçi XML'inden Hepsiburada'ya Aktarım

Türkiye'deki çoğu toptancı/tedarikçi (özellikle elektronik, beyaz eşya, telefon distribütörleri Karaköy/Sirkeci, teknoloji toptancıları İstoç) ürün kataloglarını XML olarak paylaşır. Zunapro XML modülü:

1. Tedarikçi XML URL'ini okur (saatlik/günlük cron)
2. Kategori eşleştirmesini öğrenir (ilk eşleme manuel, sonra otomatik)
3. Marka, materyal, beden gibi attribute'ları normalize eder
4. Fiyata kâr marjı + komisyon ekler
5. Stok takibi yapar — tedarikçide kalmayan ürünleri otomatik pasifleştirir
6. Hepsiburada'ya MPOP API ile yükler

HepsiLojistik (Hepsiburada Fulfillment) — Lojistik Çözümü

HepsiLojistik, satıcıların ürünlerini Hepsiburada depolarına teslim ettikten sonra depolama, paketleme, kargolama ve iade yönetiminin tamamen Hepsiburada tarafından yapıldığı hizmettir. Amazon FBA'in Hepsiburada versiyonu olarak düşünülebilir; HepsiJet kargo önceliği ile birleşik çalışır.

HepsiLojistik Avantajları

• Aynı gün / ertesi gün kargo — HepsiJet önceliği
• Yüksek Buy Box şansı — HepsiLojistik rozetli ürünler vitrine daha çok düşer
• Müşteri hizmetlerini Hepsiburada yönetir — iade, değişim, şikayet
• "Hızlı Teslimat" rozeti — dönüşüm oranını %15–25 artırır
• Operasyon yükü sıfır — paketleme/kargolama yapmazsınız

HepsiLojistik Maliyetleri (2025 yaklaşık)

• Depolama: m³/ay başına 70–130 ₺
• Sipariş işleme: ürün başına 5–10 ₺
• İade işleme: 7–12 ₺/iade
• Komisyon: Normal Hepsiburada komisyonu + %1–2 HepsiLojistik ücreti

HepsiLojistik, aylık 500+ siparişi olan satıcılar için maliyet-verimli olur. Düşük hacimli satıcılar kendi deposundan kargolamayı tercih etmelidir.

Hepsiburada Mağaza Performans Skoru ve İptal Oranları

Hepsiburada her satıcıya 1–10 arası mağaza puanı verir; bu puan vitrinde görünürlüğü doğrudan etkiler. Hepsiburada Yıldız Satıcı programına dahil olmak için 8.5+ puan gerekir. Puanı düşüren ana faktörler:

• İptal oranı — Stoksuz iptaller en büyük cezalandırıcı; %2 üstü uyarı, %5 üstü mağaza kapatma riski
• Geç kargo — Hazırlama süresi (dispatchTime) içinde kargolanmayan siparişler
• İade oranı — Beklenenin üstündeki iadeler (elektronikte %5–10 doğal, moda %25+)
• Müşteri yorumu — 4.0 yıldız altı kalmamalı
• Yanıt süresi — Mesajlara 24 saat içinde dönülmeli

Zunapro otomatik stok senkronizasyonu ile iptal riskinizi %90 azaltırsınız; sitenizde, depoda veya başka pazaryerinde satılan ürünler Hepsiburada'da anında pasifleşir; Yıldız Satıcı statüsü korunur.

Hepsiburada Reklam, Promosyon ve Akıllı Fiyatlandırma

Hepsiburada Reklam Platformu (HepsiAd)

• Sponsored Products — Arama sonuçlarında üst sıralar (CPC bazlı, TL/tıklama)
• HepsiAd Akıllı Reklamlar — Algoritmik bütçe optimizasyonu
• Banner / Display reklamlar — Anasayfa ve kategori banner alanları
• HepsiLojistik promosyon — Hızlı Teslimat rozetli ürünler için indirim kampanyası

Akıllı Fiyat (Repricer)

Hepsiburada'da Buy Box savaşı özellikle elektronik kategorisinde çok yoğundur. Aynı ürünü 10+ satıcı satıyorsa, en düşük fiyatlı (veya en yüksek mağaza puanlı) Buy Box alır. Zunapro Akıllı Fiyat (repricer) modülü fiyatları rakiplerinize göre saniyeler içinde otomatik ayarlar — minimum kâr eşiğinizin altına düşmez.

Hepsiburada E-Fatura ve E-Arşiv Entegrasyonu (GİB Uyumu)

Hepsiburada'dan satış yapan tüm satıcılar, B2C müşterilerine e-Arşiv fatura, B2B müşterilerine e-Fatura kesmek zorundadır (GİB regülasyonu). Manuel fatura kesmek; günde 100+ siparişte mümkün değildir.

Zunapro e-Fatura modülü:

• Hepsiburada sipariş datası geldiği anda otomatik e-Arşiv/e-Fatura kesme
• GİB onaylı özel entegratörler ile (Logo, Mikro, Uyumsoft, Foriba, Veriban vb.)
• İade durumunda otomatik iade faturası
• Aylık KDV1, KDV2 raporlama
• Müşteriye PDF e-Arşiv otomatik e-posta + SMS

Hepsiburada Kargo Entegrasyonu — HepsiJet + Diğerleri

Hepsiburada siparişleri varsayılan olarak HepsiJet ile gönderilir (Hepsiburada'nın kendi kargosu, Türkiye genelinde 81 il aynı/ertesi gün teslimat). Ek olarak: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, PTT Kargo entegre edilebilir.

Zunapro multi-kargo modülü, sipariş ağırlığı, hedef şehir ve müşteri tercihine göre en uygun kargo şirketini otomatik seçer; etiket basar, takip numarasını Hepsiburada'ya otomatik gönderir. HepsiJet özelinde özel API endpoint'i kullanılır.

Hepsiburada İade ve Müşteri Hizmetleri Yönetimi

Türkiye e-ticaretinde iade oranı moda kategorisinde %25–35, elektronikte %5–10, ev-yaşamda %10–15'tir. İade süreci doğru yönetilmezse mağaza puanı düşer ve Yıldız Satıcı statüsü kaybedilir.

Hepsiburada Standart İade Süreci:

1. Müşteri Hepsiburada panelinden iade talebi açar (teslim sonrası 14 gün içinde)
2. HepsiJet ürünü ücretsiz alır (1–3 iş günü)
3. Hepsiburada deposu inceler, satıcıya yönlendirir veya iade onayı verir
4. Satıcı 1–3 iş günü içinde iade onayı/reddi verir
5. Onay verilirse müşteri parası HepsiPay cüzdana iade edilir

Zunapro iade modülü tüm bu adımları otomatik takip eder; satıcıya panel bildirimi atar, müşteri iadeleri için otomatik iade faturası keser.

Zunapro ile Hepsiburada Entegrasyonu — 4 Adımda Kurulum (10 Dakika)

1. Hepsiburada Mağaza Bilgilerinizi Girin — Zunapro panelde Marketplace → Hepsiburada sekmesinden MerchantId, OAuth2 client_id ve client_secret bilgilerini girersiniz.
2. Mevcut Sitenizi Bağlayın — Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop ve Magento için hazır konnektörler. API URL + access key girilir.
3. Kategori Eşleme Sihirbazı — Sitenizdeki kategorileri Hepsiburada kategorilerine sürükle-bırak ile eşlersiniz. Yapay zeka önerileri dakikalar içinde tamamlar.
4. İlk Senkronizasyon — Ürün, stok, fiyat, sipariş, kargo — hepsi otomatik senkron başlar. 10 dakika içinde Hepsiburada mağazanız Zunapro panelinden yönetilebilir.

Hepsiburada Entegrasyonu Hakkında Sıkça Sorulan Sorular (SSS)