Hepsiburada entegrasyonu:
ürün, stok ve sipariş tek panelde.

Hepsiburada entegrasyonu nedir ve hangi işleri devralır?

Hepsiburada entegrasyonu, satıcı panelinde elle yaptığınız işlerin Hepsiburada'nın web servisleri üzerinden otomatik yürütülmesidir. Hepsiburada Developer Portal'daki başlangıç belgesine göre bu model stok, fiyat ve kargoya veriliş süresini bir kez kurulduktan sonra otomatik aktarır ve ürünlerin toplu gönderilmesini sağlar. Servisler dört gruba ayrılır; bir entegrasyon yazılımı bunların bir kısmını ya da tamamını kullanabilir.

Hepsiburada API'sinin dört servis grubu

• Katalog ürün entegrasyonu: yeni ürünü kategori, özellik, görsel ve barkodla Hepsiburada'ya gönderir; ürün, giriş ekibince kontrol edilip onaylanır.
• Listeleme entegrasyonu: mevcut ilanınızın (listing) fiyatını, stoğunu ve kargoya veriliş süresini günceller, ilanı satışa açar ya da kapatır.
• Sipariş entegrasyonu: ödemesi tamamlanan siparişleri çeker, paketler, kargo ve fatura bilgisini pakete işler.
• Muhasebe entegrasyonu: sipariş teslim edildikten sonra oluşan finansal kayıtları (satış tutarı, komisyon, kargo, iade) listeler.

HepsiburadaSku ile kendi stok kodunuz arasındaki fark

Her ilanın iki kimliği vardır: Hepsiburada'nın verdiği HepsiburadaSku ve sizin stok kodunuz olan MerchantSku. Hepsiburada, MerchantSku'nun büyük harfle ve boşluksuz gönderilmesini ister; küçük harfle gelen kodu büyük harfe çevirerek kaydeder. Diğer kanallarda 'abc-12' diye yazdığınız kod Hepsiburada'da 'ABC-12' olarak durur, eşleştirme de bu farkı tanımalıdır.

Hepsiburada'da satıcı olmak: başvuru adımları ve satıcı tipleri

Hepsiburada'da mağaza açmak ücretsizdir ve başvuru satıcı panelindeki 'Yeni başvuru' sayfasından yapılır. Platformu işleten şirket D-Market Elektronik Hizmetler ve Ticaret A.Ş.'dir; satıcı sayfasında 101 binden fazla aktif mağaza ve aylık 210 milyon ziyaret rakamları yer alıyor. Hepsiburada'nın kendi açıklamasına göre başvuru şu sırayla ilerler:

1. 'Yeni başvuru'ya tıklayın, satıcı tipinizi seçin, mağaza adı ve şifre oluşturun.
2. Profil menüsünden Hesabım > Bilgilerim sayfasında eksik şirket ve adres bilgilerini tamamlayın.
3. Hesabım > Belgelerim sayfasından istenen belgeleri yükleyin, Sözleşmeler alanından satıcı sözleşmesini onaylayın.
4. Belgeler sözleşme ekibince incelenir; düzeltme gerekiyorsa ret sebebi e-postayla bildirilir.
5. Süreç tamamlanınca hesabınız aktif statüsüne geçer ve size e-posta gönderilir.

Standart satıcı mı, Girişimci Kadın mı?

Hepsiburada iki satıcı tipi tanımlar. Hisselerinin %51 ve fazlası kadına ait işletmeler 'Girişimci Kadın' tipini seçebilir; bu tipte özel komisyon, reklam desteği ve indirimli kargo sunulur. Diğer satıcılar 'Standart' tipindedir. Yeni mağazalara ayrıca 'Efsane Hoş Geldin Paketi' uygulanıyor: mağaza açıldıktan sonra 90 gün boyunca %50 komisyon indirimi (%10 + KDV uygulaması). İndirim elektronik ürünlerde geçerli değil; komisyonu zaten %10 + KDV'nin altında olan ürünlerde standart oran kalır. Hepsiburada kampanyaya katılım için son tarihi 31 Ekim 2026 olarak açıklıyor ve koşulları değiştirme hakkını saklı tutuyor.

İstenen belge listesi şirket türünüze göre Belgelerim sayfasında gösterilir; üçüncü taraf listeler yerine o sayfayı esas alın.

Hepsiburada komisyon oranları ve hakediş vadesi (Ekim 2026)

Hepsiburada komisyonu kategoriye göre değişir ve listeleme fiyatı üzerinden + KDV olarak hesaplanır. Kaynak, Hepsiburada'nın satıcı sayfasından bağlantı verdiği 'Ek-4 Kategori Bazlı Komisyon Oranları' belgesidir (dosya 27 Ağustos 2026 tarihli). Belgede her ürün grubunun ödeme vadesi de yazar. Aşağıdaki satırlar bu tablodan seçilmiş örneklerdir; marka bazında farklı oranlar ve sözleşmeye özel koşullar bulunabildiği için kendi oranınızı satıcı panelinizden ya da sözleşmenizden doğrulayın.

Hakediş vadesi nasıl sayılır?

Vade, siparişin müşteriye teslim edildiği tarihten başlar. Ek-4'e göre iş günü; cumartesi, pazar ve resmî tatiller dışındaki günlerdir, yani 24 iş günü takvimde yaklaşık beş haftaya denk gelir. Muhasebe servis belgesine göre finansal kayıtlar da teslimattan sonra oluşur ve her kayıt Paid (ödendi) ya da WillBePaid (ödenecek) durumuyla izlenir.

Komisyonu ilan bazında kontrol etmek

Listeleme servislerinde bir 'Komisyon Bilgisi Sorgulama' metodu vardır; tek istekte 50 SKU'ya kadar ilanın komisyonu okunabilir. İlan üzerinden bakmak marka bazlı istisnaları da yakalar. Bulduğunuz oranla satış fiyatını denemek için komisyon hesaplama aracını kullanabilirsiniz.

Hakedişten düşen kalemler ve örnek net kâr hesabı

Hepsiburada'da hakedişinize yalnız komisyon değil, kargo bedeli, işlem bedeli ve olası cezalar da yansır. Muhasebe entegrasyonu belgesi elliyi aşkın kayıt tipi tanımlar. Günlük işleyişte en sık göreceğiniz kalemler şunlardır:

• Commission: siparişin komisyon faturası; iade olursa CommissionRefund olarak geri yazılır.
• ShipmentCostSharingExpense: Hepsiburada anlaşmalı kargo desi/fiyat tablosuna göre kesilen kargo bedeli.
• DeliveryProcessingFee ve ProcessingFeeExpense: teslimat başına işlem bedeli ve ürünler üzerinden hizmet bedeli.
• CustomerSatisfaction ve LineItemTransferExpense: tedarik gecikmesi, iptal ve siparişin başka satıcıya kaydırılması nedeniyle kesilen tutarlar.
• CampaignDiscount ve AdSharingExpense: kampanya indirimleri ve reklam katılım bedelleri.

Buna ek olarak 1 Ocak 2025'ten bu yana, 22 Aralık 2024 tarihli Resmî Gazete'de yayımlanan 9284 sayılı Cumhurbaşkanı Kararı uyarınca pazaryeri ödemelerinde %1 gelir veya kurumlar vergisi kesintisi (stopaj) uygulanır; kesinti yıllık beyannamede mahsup edilir. Aşağıdaki tablo Ek-4 oranı ve 5 Ekim 2026 kargo tarifesiyle kurulmuş bir örnek hesaptır. İşlem ve hizmet bedeli sözleşmeye göre değiştiği için dahil edilmedi; KDV oranı örnek olarak %20 alındı.

Ürün maliyetinizi bu tutardan düşmeden fiyat belirlemeyin; kendi rakamlarınızla denemek için kâr hesaplama aracı yeterli. Yox İş Ortağım'da Hepsiburada siparişlerinde kesilen komisyon ve kargo bedeli sipariş bazında net kârla birlikte görünür; fazla kesinti ve ödenmeyen hakediş ayrı listelenir.

Hepsiburada entegrasyonu kurulumu: entegratör yetkisi ve servis anahtarı

Hepsiburada'da bağlantı mağaza şifresiyle değil, entegratöre verilen yetki ve bu yetkiye ait servis anahtarıyla kurulur. Hepsiburada, bütün servislerinin kimlik doğrulamasını servis anahtarı yapısına taşıdığını belgelerinde duyuruyor; istekler Basic Auth ile gönderilir. Yox İş Ortağım'a bağlanırken izlenecek yol:

1. Satıcı panelinde sağ üstteki mağaza adınıza tıklayın, Hesabım > Bilgilerim > Entegrasyon sayfasını açın.
2. Entegratör Bilgileri sekmesinde 'Entegratör ekle' ile entegratörü tanımlayın. Hepsiburada'nın SSS'sine göre entegratör, entegrasyon firmasının Hepsiburada'daki geliştirici kullanıcı (developer user) bilgisiyle eklenir; bu bilgiyi kurulum görüşmesinde sizinle paylaşıyoruz.
3. Aynı alandan Mağaza ID'nizi kopyalayın.
4. Yetki açıldıktan sonra Entegratörlerim listesinde ilgili satırın Servis Anahtarı düğmesine basın ve anahtarı kopyalayın.
5. Mağaza ID'sini ve servis anahtarını Yox İş Ortağım'daki Hepsiburada bağlantı ekranına girin. İlanlarınız barkod ya da stok koduyla ürün kartlarınıza eşleştirilir; siz onaylamadan hiçbir ilan değişmez.

Yetki neden hemen çalışmıyor?

Hepsiburada, yetkilendirmenin devreye girmesinin 2 saate kadar sürebileceğini belirtiyor. İlk denemede 'geçersiz' uyarısı alırsanız birkaç saat sonra tekrar denemek gerekir; sorun sürerse istek ve yanıt bilgileriyle Hepsiburada'ya kayıt açılır. Entegratör ekranında ekleme ve silmenin yanında tarih bazlı süreli yetki de tanımlanabilir. Kurulumu birlikte yapmak isterseniz Yox İş Ortağım'a başvurun; 3 günlük ücretsiz deneme bu adımlarla başlar.

Ürün gönderimi ve fiyat-stok güncellemesinde Hepsiburada kuralları

Hepsiburada'ya gönderilen yeni ürün doğrudan satışa açılmaz; önce ürün giriş ekibinin kontrolünden geçer. Barkodu katalogda olmayan ürün 'İncelenecek', barkodu zaten katalogda bulunan ürün 'Eşleşen' statüsüne düşer.

Ürün statüleri: İncelenecek'ten Satışa Hazır'a

• İncelenecek: ürün giriş ekibinin kontrolü bekleniyor.
• Ürün bilgileri eksik: zorunlu özellik ya da bilgi eksik, düzeltilip yeniden gönderilmeli.
• Eşleşen: ürün katalogda var; eşleşmeyi panelden ya da API ile onaylamanız veya reddetmeniz gerekir.
• Satışa Hazır: ilan oluştu; fiyat ve stok gönderildiğinde satışa açılır.
• Reddedildi: izin gerektiren ya da internette satışı yasak ürünler.

Görsel, varyant ve barkod kuralları

Görseller png ya da jpg olmalı; fon beyaz veya açık renk, üzerinde 'kargo bedava' gibi yazı, logo ya da filigran bulunmamalı, ürün görselin %80'ini kaplamalı. Görsel adresine ulaşılamazsa Hepsiburada beş kez dener, sonra ürün yeniden gönderilene kadar görseli almaz. Renk ve beden varyantları aynı VaryantGroupID ile gruplanır, barkod alanı EAN13 bekler. Ürün yalnız leaf, aktif ve available işaretli kategorilere açılabilir.

Toplu güncelleme limitleri ve fiyat kilidi

• Aynı anda devam eden ya da bekleyen en fazla 5 toplu yükleme olabilir; tek istekte 4.000 SKU'ya kadar güncelleme gider.
• Günlük toplu güncelleme limiti listing sayınızın 10 katıdır: 100 ilanı olan satıcı günde 1.000 güncelleme gönderebilir.
• Kategori bazlı eşiklerin dışındaki fiyat değişikliği ilgili SKU'yu kilitler; fiyat doğruysa kilit, kilit kaldırma servisiyle açılır.
• OutOfPriceRange: aynı üründeki diğer satıcı fiyatlarının ortalamasına göre belirlenen üst sınır aşılamaz; sınır 0–50 TL aralığında %250, 2.000 TL üzerinde %80'dir ve Hepsiburada bu kuralın kaldırılamayacağını belirtir.

Sipariş, kargo ve fatura akışı Hepsiburada'da nasıl işler?

Hepsiburada siparişi API'ye ödemesi tamamlandığında düşer; havaleli siparişler de ödeme onaylanınca aktarılır. Sipariş, siz ya da entegratör paketleyince 'gönderime hazır' olur; otomatik paketleme açıksa bu geçiş 15 dakika içinde kendiliğinden gerçekleşir. Ayar Hesabım > Ayarlarım > Diğer ayarlar altındadır ve entegratör siparişi bu ayara göre farklı servislerden çektiği için kurulumdan önce ayarın durumunu bilmek gerekir.

Anlaşmalı kargo desi tarifesi (5 Ekim 2026)

Hepsiburada'nın satıcılara yayımladığı tarifede bedel desiye ve firmaya göre değişir; fiyatlar KDV hariçtir ve 5 Ekim 2026'dan itibaren geçerlidir. Örnek satırlar:

Ürünlerinizin desisini desi hesaplama aracıyla önceden çıkarın. İlanda yalnız HepsiJET, Horoz ya da Borusan seçilirse yanına standart bir kargo firması eklenmelidir, yoksa MissingStandardCargoCompany hatası döner. Kendi kargo anlaşmanızla göndermek için Hepsiburada'nın SSS'si kategori sorumlunuzla görüşmenizi istiyor; kendi sözleşmenizle çalışmanın ayrıntıları Aras Kargo entegrasyonu sayfasında.

Fatura linki nasıl iletilir?

Fatura, paket bazında bir PDF ya da HTML adresi olarak gönderilir; servis yalnız içerik türü application/pdf veya text/html olan bağlantıyı kabul eder ve aynı pakete ikinci fatura eklenemez. Sipariş detayındaki hasInvoice alanı, faturanın yüklenip yüklenmediğini gösterir. Yox İş Ortağım'da belge bağlı muhasebe programınızdan kesilir ve fatura bilgisi Hepsiburada siparişine iletilir.

Hepsiburada entegrasyonu Yox İş Ortağım'da: işleyiş ve paket seçimi

Yox İş Ortağım, Hepsiburada mağazanızı diğer satış kanallarınızla aynı ürün kartından yönetmenizi sağlar. Ürünler Hepsiburada kategorisine ve özelliklerine eşleştirilir, başka kanalda biten stok Hepsiburada'da da düşer, siparişler tek listede kargo ve faturayla birlikte izlenir. Hangi paketin size uyacağını kanal sayısı ve aylık sipariş hacmi belirler:

Yıllık ödemede %20 indirim uygulanır; güncel karşılaştırma paketler bölümünde. Başvurudan sonra kısa bir ön görüşme yapıyor, 3 günlük ücretsiz denemede Hepsiburada mağazanızı bağlayıp ilanların panele nasıl okunduğunu birlikte kontrol ediyoruz. Trendyol'da da satıyorsanız iki kanalın farklarını Trendyol entegrasyonu sayfasında, e-Fatura tarafında örnek bir bağlantıyı Paraşüt entegrasyonu sayfasında, bütün kanal, kargo ve muhasebe bağlantılarını entegrasyon ana sayfasında görebilirsiniz.

Kurulum öncesi kontrol listesi ve en pahalı hatalar

Hepsiburada'da en pahalı hata, stok tutarsızlığı yüzünden sipariş iptal etmektir. Ürünü satan başka mağaza varsa sipariş ona aktarılır, aradaki fiyat farkı ve sözleşmedeki ceza size faturalanır; yoksa ceza faturası kesilir ve ürün satışa kilitlenir. Sipariş belgesindeki tablo:

İptal servisi yalnız paketlenmemiş siparişlerde çalışır ve günde 100 istekle sınırlıdır. Bağlantıyı açmadan önce şu soruları cevaplayın:

• Stok kodlarınız büyük harf ve boşluksuz mu, diğer kanallardaki kodlarla aynı mı?
• Otomatik paketleme ayarınızın açık mı kapalı mı olduğunu biliyor musunuz?
• Ürünlerin desisi ve ilanlardaki kargo firmaları (standart firma dahil) tanımlı mı?
• Eşleşen statüsünde onayınızı bekleyen ürün kaldı mı?
• Kampanyadaki ürünlerde fiyat artışı ya da stok düşüşü engeli olabileceğini hesaba kattınız mı?
• Fatura bağlantınız tarayıcıda doğrudan PDF olarak açılıyor mu?

Bu listede takıldığınız bir madde varsa iletişim sayfasından bize yazın; kurulumu ön görüşmede adım adım birlikte planlayabiliriz.