Hepsiburada Entegrasyonu Nasıl Yapılır? Adım Adım

Bu yazıda

Kısa cevap: Hepsiburada entegrasyonu nasıl yapılır?
Hepsiburada entegrasyonu neyi kapsar?
Siparişler programa neden düşmüyor?
Ürünler hangi statülerden geçer?
Fatura, fiyat ve stok güncellemesi
Kendi yazılımınızla bağlanmak
Hepsiburada'da kesintiler: entegrasyondan önce hesap
Webtegra'ya Hepsiburada mağazası bağlamak
Sık sorulanlar
Kaynaklar

Hepsiburada mağazanızı bir entegrasyon programına (entegratör) bağlamak Trendyol'dan biraz farklı işler. Trendyol'da API bilgilerini panelden kopyalayıp programa verirsiniz; Hepsiburada'da ise programa panelden yetki verir, ardından Mağaza ID'nizi paylaşırsınız. Yetki birkaç saatte devreye girer ve siparişlerin programa düşmesi bir paketleme ayarına bağlıdır.

Bu yazıda Hepsiburada entegrasyonunun adımlarını, siparişlerin programa düşmemesinin sık sebeplerini, ürünlerin geçtiği statüleri ve sık görülen uyarıları anlatıyoruz. Bilgilerin hepsi Hepsiburada'nın geliştirici portalındaki sıkça sorulan sorulardan (son güncelleme 21 Mayıs 2026) alındı ve 1 Kasım 2026'da okundu.

Kısa cevap: Hepsiburada entegrasyonu nasıl yapılır?

Çalışacağınız entegrasyon programından, programın Hepsiburada'da kullandığı geliştirici kullanıcı adını öğrenin.
Hepsiburada satıcı panelinde sağ üstteki mağaza adınıza tıklayın, Hesabım > Bilgilerim > Entegrasyon > Entegratör bilgileri alanını açın.
"Entegratör ekle" ile programa yetki verin. Aynı alanda yetkiyi silebilir ya da tarihle sınırlı verebilirsiniz.
Aynı alandaki Mağaza ID bilginizi kopyalayıp programınıza girin.
Bekleyin: Hepsiburada'ya göre yetkinin devreye girmesi 2 saate kadar sürebilir. İlk denemede "geçersiz" uyarısı alırsanız birkaç saat sonra yeniden deneyin.

Sonra siparişlerin hangi statüde çekildiğini programınızla konuşun ve otomatik paketleme ayarınızı ona göre seçin.

Hepsiburada entegrasyonu neyi kapsar?

Hepsiburada geliştirici sayfasında dört entegrasyon türü sayıyor:

Tür	Ne taşır
Katalog ürün entegrasyonu	Ürünleri API üzerinden toplu olarak Hepsiburada'ya gönderir
Listeleme entegrasyonu	Stok, fiyat ve kargoya veriliş süresini istediğiniz aralıklarla günceller
Sipariş entegrasyonu	Mağazanıza gelen siparişleri programınızda gösterir
Muhasebe entegrasyonu	Muhasebe kayıtları; servisleri geliştirici dokümanında ayrı bir başlıkta

Listeleme ve sipariş entegrasyonu birlikte kullanılabilir. Çoğu satıcı için asıl ihtiyaç ikisinin birlikte çalışmasıdır: stok tek yerden gider, sipariş tek yere gelir. Bağlantının genel mantığı pazaryeri entegrasyonu nedir yazısında, birden çok mağazada stoğun nasıl tutulacağı çoklu pazaryeri stok yönetimi yazısında.

Siparişler programa neden düşmüyor?

Hepsiburada iki sebep gösteriyor.

1. Yetki verilmemiş ya da henüz devreye girmemiş. Entegratör bilgileri alanında programın yetkili göründüğünü kontrol edin. Yetkiyi yeni verdiyseniz 2 saat bekleyin. Hata sürerse Hepsiburada, programın hangi adrese istek gönderdiğini ve aldığı cevabı programınızdan isteyip kendisine iletmenizi istiyor.

2. Otomatik paketleme ayarı programın beklentisiyle uyuşmuyor. Programlar siparişi iki yoldan çeker: otomatik paketleme kapalıysa ödemesi tamamlanmış siparişlerden, açıksa paket bilgilerinden. Ayar satıcı panelinde mağaza adınıza tıklayınca açılan menüde, Hesabım > Ayarlarım > Diğer ayarlar > Otomatik Paketleme alanındadır.

Otomatik paketleme	Ne olur	Paketlemeyi kim yapar
Kapalı	Sipariş gönderime hazır statüsüne kendiliğinden geçmez	Siz, panelden ya da programdan
Açık	Sipariş 15 dakika içinde gönderime hazır statüsüne geçer	Hepsiburada, siparişi kendiliğinden paketler

Programınıza "siparişleri hangi statüde çekiyorsunuz?" diye sorun ve ayarı ona göre seçin. Yanlış ayarda siparişler Hepsiburada'da görünür, programa düşmez.

Ürünler hangi statülerden geçer?

Hepsiburada'da ürün yüklemek, ürünü satışa açmak demek değildir. Yeni ürünler ürün giriş ekibinin kontrolünden geçer ve satışa hazır hâle gelir; satışa açmak için fiyat ve stok gönderilmesi gerekir. Statüler şöyle:

Statü	Anlamı	Ne yapmalı
İncelenecek	Ürün giriş ekibinin kontrolünü bekliyor	Bekleyin
Ürün bilgileri eksik	Gönderilen bilgilerde eksik var	Eksikleri tamamlayıp güncelleme gönderin
Katalog sürecinde	Ürün, ürün giriş ekibince giriliyor	API üzerinden güncelleme gönderilemez
Eşleşen	Ürün Hepsiburada kataloğunda zaten var	Eşleştirmeyi kontrol edip onay ya da red verin
Satışa hazır	Ürün kataloğa eklendi, ilanınız oluştu	Fiyat ve stok göndererek satışa açın
Reddedildi	İzin gerektiren ya da internette satışı yasak ürün	Kategori sorumlunuzla görüşün

Yüklediğiniz ürün panelde görünmüyorsa satıcı panelindeki Aksiyon Bekleyen Ürünler sekmesinde barkodla arayın. Kategori özelliklerinde zorunlu olanların hepsini, zorunlu olmayanları da mümkün olduğunca göndermek, Hepsiburada'ya göre ürünün açılması ve aramada çıkması için önemlidir.

Fatura, fiyat ve stok güncellemesi

Fatura: Hepsiburada sipariş faturasını, PDF uzantılı bir bağlantı olarak ve paket bazında ister. Programınız faturayı kesip bağlantısını bu şekilde göndermelidir.
Güncelleme sınırı: Aynı anda 5'ten çok bekleyen fiyat ve stok güncelleme işlemi olamaz; tek istekte 4.000 SKU'ya kadar güncelleme gönderilebilir. Çok ürününüz varsa programın güncellemeleri toplu gönderdiğinden emin olun.
Fiyat kontrolü: Hepsiburada'nın canlı sisteminde yanlış fiyata karşı çalışan bir mekanizma var. Fiyat beklenen aralığın dışındaysa "OutOfPriceRange" uyarısı döner.
Kampanyadaki ürün: Kampanyaya giren üründe fiyat artışı ya da stok düşüşü engellenebilir ("DiscountedListingPriceIncrease", "DiscountedListingStockDecrease"). Bu uyarıyı alırsanız kategori yöneticinizle görüşün. Kampanya haftasında stok düşüremediğiniz bir ürün, başka kanalda biterse fazla satışa yol açabilir; kampanyaya vereceğiniz stoğu baştan sınırlayın.
Kargo firması: Paketlenmiş siparişin kargo firmasını panelde gönderime hazır statüsünden ya da programdan değiştirebilirsiniz. Kendi anlaşmalı kargonuzla çıkmak için kategori sorumlunuzla görüşmeniz gerekir.

Kendi yazılımınızla bağlanmak

Hepsiburada'ya kendi yazılımınızla bağlanacaksanız satıcı panelinde Yardım Merkezi > Talepler > Taleplerimi Görüntüle ekranından yeni talep açıp "API ENTEGRASYON - API Entegratör Yetkilendirme İşlemleri" konusunu seçersiniz. Önce test ortamı bilgileri gönderilir; testleri tamamladıktan sonra aynı yoldan canlı ortam bilgisi istenir. Programla çalışıyorsanız bu adıma gerek yoktur.

Hepsiburada'da kesintiler: entegrasyondan önce hesap

Hepsiburada'da komisyon listeleme fiyatı üzerinden alınır ve üstüne KDV eklenir: %19 + KDV fiilen %22,8 eder. Kargo barem desteği dışında kalan siparişlerde ayrıca 10,5 TL + KDV hizmet bedeli alınır. Sitemizin Hepsiburada aracındaki örnekte 500 TL'lik bir satış, %19 + KDV komisyon, hepsiJET 0-1 desi kargo (98,39 TL, KDV dahil) ve 240 TL maliyetle cebinize 25,01 TL kalır; hizmet bedeli düşmeseydi 35,50 TL kalırdı. Kendi rakamlarınızı Hepsiburada komisyon ve kâr hesaplama aracında deneyin; bütün pazaryerlerinin kesintileri 2026 pazaryeri satıcı kesintileri yazımızda tek tabloda.

Webtegra'ya Hepsiburada mağazası bağlamak

Webtegra Hepsiburada'nın yanında Hepsiburada e-Faturam ve HepsiJET ile de çalışır: siparişler diğer pazaryerlerinizin siparişleriyle tek listeye düşer, fatura siparişten kesilip bağlantısı Hepsiburada'ya gönderilir, gönderi siparişten oluşturulur. Mağazayı bağlarken gereken yetki adımlarını destek ekibimiz uzaktan bağlanarak sizinle birlikte yapabilir; yerinde kurulum yapılmaz. Neler eşitlendiği Hepsiburada entegrasyonu sayfasında, siparişlerin tek listede nasıl yönetildiği sipariş yönetimi sayfasında, adım adım videolar eğitim sayfasında.

Kullandıkça Öde paketinde aylık sabit ücret yok, sipariş başı 3 TL (KDV dahil) ödersiniz. Mikro, KOBİ ve Kurumsal paketlerde 3 ay koşulsuz iade imkânı var.

Sık sorulanlar

Hepsiburada Mağaza ID nerede?

Satıcı panelinde sağ üstteki mağaza adınıza tıklayınca açılan menüde, Hesabım > Bilgilerim > Entegratör bilgileri alanında. Entegratöre yetki verdikten sonra bu numarayı programınızla paylaşırsınız.

Entegratöre yetki verdim ama hâlâ yetki uyarısı alıyorum. Ne yapmalıyım?

Hepsiburada'ya göre yetkinin devreye girmesi 2 saate kadar sürebilir; birkaç saat sonra yeniden deneyin. Hata sürerse programınızdan gönderdiği isteği ve aldığı cevabı isteyip Hepsiburada'ya iletin.

Entegratörün erişimini nasıl kaldırırım?

Aynı Entegratör bilgileri alanından yetkiyi silebilirsiniz. Yetkiyi baştan tarihle sınırlı da verebilirsiniz; deneme süresinde çalıştığınız bir program için kullanışlıdır.

Ürünlerimi yükledim, neden satışa açılmadı?

Yeni ürün önce ürün giriş ekibinin kontrolünden geçer. Satışa hazır statüsüne gelen ürün, fiyat ve stok gönderildiğinde satışa açılır. Statüsünü Aksiyon Bekleyen Ürünler sekmesinde barkodla görebilirsiniz.

Otomatik paketlemeyi açmalı mıyım?

Programınızın siparişi hangi statüde çektiğine bağlı. Program paket bilgilerinden çekiyorsa açık, ödemesi tamamlanmış siparişlerden çekiyorsa kapalı olmalı. Açıkken sipariş 15 dakika içinde gönderime hazır statüsüne geçer.

Bu yazı bilgilendirme amaçlıdır; mali ve hukuki görüş değildir. Adımlar 1 Kasım 2026 itibarıyla Hepsiburada'nın geliştirici portalından ve Destek Merkezi'nden derlendi; panel menü adları değişebilir. E-Fatura ve e-arşiv ayarlarınız için mali müşavirinize danışın.

Hepsiburada Entegrasyonu Nasıl Yapılır? Entegratör Yetkisi ve Mağaza ID Adım Adım