Shopify Hepsiburada Entegrasyonu Nasıl Yapılır?

Shopify Hepsiburada Entegrasyonu Nedir? Shopify Hepsiburada entegrasyonu, bir Shopify mağazasının ürün kataloğu ve stok verisini Hepsiburada Merchant API’si üzerinden Hepsiburada Satıcı Paneli’ne bağlayarak ürün listeleme, sipariş alma ve stok güncelleme işlemlerini otomatikleştiren teknik kurulum sürecidir.

Hepsiburada, satıcılarının sisteme bağlanması için Merchant API adını verdiği bir REST API sunar; bu API ürün kaydı, fiyat/stok güncelleme, sipariş çekme ve kargo bilgisi bildirme uç noktalarını kapsar (Hepsiburada Merchant API dokümantasyonu, 2025). Shopify tarafında bu API’ye hazır bir Shopify App üzerinden veya özel geliştirilmiş entegrasyon ile bağlanılır.

Hepsiburada’nın veri kalitesi kontrolü Trendyol’a göre daha katıdır GTIN/barkod eksikliği veya kategori ağacı uyumsuzluğu olan ürünler API seviyesinde değil, listeleme onay aşamasında reddedilir. Bu fark, entegrasyon kurulumunda dikkat edilmesi gereken en önemli operasyonel detaydır.

Hepsiburada Merchant API’si Neyi Kapsar?

Hepsiburada Merchant API’si, satıcı hesabına tanımlı kullanıcı adı ve şifre bilgileriyle kimlik doğrulaması yapan, ürün/stok/sipariş verisini JSON formatında aktaran bir REST API’dir.

API, ürün listeleme isteklerini “Listing” adı verilen bir kayıt üzerinden işler; her listing, bir Hepsiburada kategori kimliği (category ID) ve o kategoriye özgü zorunlu alanları (barkod, marka, model) içermek zorundadır (Hepsiburada Merchant API dokümantasyonu, 2025). İstek gönderildikten sonra Hepsiburada bu kaydı “PreControl” adı verilen bir ön kontrol sürecinden geçirir.

Bu ön kontrol süreci Trendyol’un batch sorgulama mantığına benzer ama daha katı çalışır: kategori uyuşmazlığı, marka onayı eksikliği veya barkod formatı hatası varsa listing “Rejected” durumuna düşer ve hata sebebi API yanıtında dönülür.

Kritik Not: Hepsiburada’da bir ürün “Waiting” (bekliyor) durumunda uzun süre kalıyorsa çoğunlukla kategori eşleştirmesi hatalıdır, API hatası değildir. Listing durumunu API üzerinden değil, satıcı panelinden manuel kontrol etmek kök nedeni daha hızlı gösterir.

Ürün Listeleme Onay Süreci Nasıl İşler?

Ürün listeleme onayı, her yeni ürünün Hepsiburada’nın kategori ve marka kurallarına uygunluğunun kontrol edilip yayına alınmasını kapsayan zorunlu bir aşamadır; bu süreç kategoriye göre saatler ile birkaç gün arasında değişir.

Hepsiburada, özellikle elektronik, kozmetik ve anne-bebek kategorilerinde ek marka onayı ister; bu kategorilerde satıcının yetkili distribütör olduğunu kanıtlayan belge talep edilebilir (Hepsiburada Satıcı Merkezi, 2025). Giyim ve ev/yaşam gibi kategorilerde onay süreci genelde daha kısa sürer çünkü marka kısıtlaması daha azdır.

Şu adımlar ürün listeleme onay sürecini Shopify tarafında yönetilebilir hale getirir:

1. Shopify ürün kategorisi, Hepsiburada kategori ağacındaki en yakın kategoriyle manuel eşleştirilir otomatik eşleştirme yanlış kategoriye düşürebilir.
2. Zorunlu attribute alanları (marka, model, barkod, menşei) ürün açıklamasına değil, ilgili özel alanlara girilir.
3. İlk 10-20 ürün gönderildikten sonra Hepsiburada panelinden “Rejected” durumundaki ürünler kontrol edilip hata nedenine göre düzeltilir.
4. Onaylanan ürün grubu baz alınarak geri kalan katalog toplu (bulk) olarak gönderilir.

Peki neden kategori eşleştirmesi otomatiğe bırakılmamalı? Shopify’ın kendi kategori yapısı Hepsiburada’nın kategori ağacıyla birebir örtüşmez; yanlış otomatik eşleştirme, ürünün yanlış kategoride düşük görünürlükle yayınlanmasına neden olur.

Barkod ve Kategori Ağacı Gereksinimleri Nelerdir?

Hepsiburada’da barkod (GTIN) zorunludur ve kategori ağacı, ürünün doğru arama sonuçlarında görünmesi için Hepsiburada’nın tanımladığı hiyerarşiye tam uyum ister.

İpucu: Yeni bir kategoriye ilk kez ürün gönderilecekse, önce Hepsiburada Satıcı Merkezi panelinden o kategorinin zorunlu alan listesi indirilip Shopify ürün şablonuna eklenmelidir. Bu, toplu yüklemede reddedilme oranını önemli ölçüde azaltır.

Sipariş ve Stok Senkronizasyonu Nasıl Kurulur?

Sipariş senkronizasyonu, Hepsiburada’da oluşan siparişlerin Shopify’a periyodik çekim veya bildirim yoluyla aktarılmasını, stok senkronizasyonu ise Shopify’daki stok değişikliğinin Merchant API üzerinden Hepsiburada’ya geri bildirilmesini kapsar.

Hepsiburada API’si stok güncellemelerini “Listing Update” isteğiyle alır ve bu isteklerde de bir rate limit uygulanır; toplu güncellemelerde istek sayısı sınırın üzerine çıkarsa sistem isteği geciktirir (Hepsiburada Merchant API dokümantasyonu, 2025). Bu davranış Trendyol’dakine benzer bir gecikme riski taşır birden fazla pazaryerine bağlı mağazalarda bu risk kanallar arasında birikir.

Uzak Durulması Gereken Risk: Hepsiburada ve başka bir pazaryerine aynı anda bağlı bir mağazada stok güncellemesi tek bir kaynaktan (Shopify) merkezi yönetilmezse, iki kanal arasında çelişen stok bilgisi oluşabilir. Stok güncellemesinin tek yönlü olarak Shopify’dan pazaryerlerine akması, tersine bir senkron döngüsünden daha güvenilir sonuç verir.

Hepsiburada Entegrasyonu Trendyol’dan Hangi Noktalarda Ayrışır?

Hepsiburada entegrasyonu, listeleme onay sürecinin katılığı ve kategori ağacı uyumluluğu açısından Trendyol’dan belirgin şekilde ayrışır; Trendyol’da ürün önce yayınlanıp sonra düzeltilebilirken Hepsiburada’da onay öncesi düzeltme zorunludur.

Bu ayrım, iki pazaryerine birlikte satış yapan mağazaların neden tek bir “genel” ürün şablonuyla çalışamayacağını açıklar her kanal için ayrı bir alan eşleştirme (mapping) tablosu tutmak, hata oranını gözle görülür şekilde azaltır. Aynı stok havuzunu ikiden fazla kanala dağıtan mağazalar için çoklu pazaryeri stok senkronizasyonu rehberi bu yapının nasıl kurulacağını detaylandırır.

Sipariş Faturalaması Nasıl Yönetilir?

Hepsiburada siparişlerinin faturalaması, satıcının kendi e-fatura/e-arşiv sistemi üzerinden yapılır ve bu sürecin Shopify sipariş kaydıyla senkron çalışması muhasebe hatalarını önler.

Fatura kesim süreci Hepsiburada API’sinin doğrudan kapsamında değildir; bu nedenle çoğu mağaza sahibi Shopify sipariş verisini bir ERP veya muhasebe yazılımına aktararak fatura otomasyonu kurar. Bu entegrasyonun nasıl kurulacağı Shopify ERP ve muhasebe entegrasyonu rehberi kaynağında ayrıntılı işlenir.

Hepsiburada Ürün İçerik Puanı Neye Göre Belirlenir?

Hepsiburada’nın ürün içerik puanı, başlık netliği, açıklama uzunluğu, görsel sayısı ve zorunlu attribute doluluğuna göre hesaplanır; düşük içerik puanı ürünün “Öne Çıkan Ürün” veya kampanya alanlarına seçilme ihtimalini azaltır.

Hepsiburada, ürün açıklamasında teknik özellik tablosunun eksiksiz doldurulmasını önemser çünkü müşteri karşılaştırma özelliği bu verileri doğrudan kullanır (Hepsiburada Satıcı Merkezi içerik kılavuzu, 2025). Bir elektronik ürününde işlemci, RAM veya ekran boyutu gibi attribute’lar boş bırakıldığında ürün, karşılaştırma filtrelerinde görünmeyebilir.

Görsel tarafında Hepsiburada en az 4 görsel önerir ve ana görselin beyaz fon üzerinde, ürünün tamamını gösterecek şekilde kadrajlanmasını ister. Ürün üzerinde fiyat etiketi, indirim yazısı veya marka dışı logo bulunan görseller otomatik reddedilir.

İpucu: Hepsiburada’da içerik puanı düşük ürünler, kategori sayfasında sıralama algoritması tarafından geriye itilir. Yeni yüklenen ürünlerde ilk hafta içinde içerik puanının panelden kontrol edilmesi, erken düzeltme fırsatı sağlar.

Hepsiburada İade Süreci Stok Yönetimini Nasıl Etkiler?

Hepsiburada’da iade süreci, müşterinin iade talebini açmasıyla başlar ve satıcı onayından sonra stok Shopify tarafında otomatik güncellenmez; bu adım manuel takip gerektirir.

Hepsiburada Merchant API’si iade bildirimini bir “Return Request” kaydı olarak sunar, ancak bu kaydın Shopify stok miktarına otomatik yansıması için ek bir geliştirme veya orta katman yazılım desteği gerekir (Hepsiburada Merchant API dokümantasyonu, 2025). Bu adım atlanan mağazalarda, özellikle yüksek iade oranlı kategorilerde (giyim, ayakkabı, elektronik aksesuar), gerçekte satışa hazır ürünler sistemde “stokta yok” görünmeye devam eder.

Uzak Durulması Gereken Risk: İade sürecini haftalık mutabakat rutinine dahil etmeyen mağazalarda, iade edilen ürünlerin toplam değeri zamanla önemli bir kayıp satış potansiyeline dönüşür. İade listesi ile stok kaydının düzenli karşılaştırılması bu kaybı önler.

Hepsiburada’da Sipariş Hazırlama Süresi Neden Önemli?

Sipariş hazırlama süresi, Hepsiburada’nın satıcı performans skorunu doğrudan etkileyen bir metriktir; taahhüt edilen sürenin aşılması ürün görünürlüğünü düşürür.

Hepsiburada, satıcıların kargoya verme süresini (genelde 1-2 iş günü) taahhüt etmesini ister ve bu süre aşıldığında sipariş “geciken sipariş” kategorisine düşer (Hepsiburada Satıcı Merkezi performans kriterleri, 2025). Bu durum tekrarlarsa satıcı hesabı üzerinde performans uyarısı oluşur ve bazı kampanya alanlarına erişim kısıtlanabilir.

Entegrasyon uygulamasının sipariş bildirimini gecikmesiz Shopify’a aktarması, bu taahhüdün karşılanmasının ön koşuludur sipariş bildirimi 30 dakika gecikirse hazırlama süresi taahhüdünden zaten bir bölüm kaybedilmiş olur.

Hepsiburada’da Kampanya ve Fiyat Güncellemesi Nasıl Otomatikleştirilir?

Hepsiburada’da kampanya katılımı, satıcının panelden kampanya başvurusu yapmasıyla başlar ve kampanya fiyatı, Shopify’daki temel liste fiyatından ayrı bir alan olarak yönetilir.

Bu ayrım, Trendyol’daki mantığa benzer bir risk taşır: kampanya bitiminde fiyat manuel güncellenmezse ürün indirimli fiyattan satılmaya devam edebilir (Hepsiburada Satıcı Merkezi kampanya rehberi, 2025). Hepsiburada’nın “Kampanya Yöneticisi” paneli, kampanya bitiş tarihini otomatik uygulayan bir seçenek sunar, ancak bu seçeneğin aktif olup olmadığı her kampanya öncesi kontrol edilmelidir.

Fiyat güncellemesinde bir diğer dikkat noktası, Hepsiburada’nın rakip fiyat karşılaştırması yapan “Öne Çıkan Teklif” algoritmasıdır; bu algoritma ürünün fiyatını benzer ürünlerle kıyaslayarak görünürlük sırasını belirler. Fiyat güncellemesi gecikmeli yapılan mağazalarda ürün, güncel olmayan bir fiyatla rakiplerle kıyaslanabilir.

İpucu: Kampanya dönemlerinde fiyat ve stok güncellemesinin senkron sıklığını geçici olarak artırmak (örneğin saatlik yerine 15 dakikada bir), hem overselling riskini hem de yanlış fiyat görünme riskini azaltır.

Hepsiburada API Kimlik Bilgileri Nasıl Korunur?

Hepsiburada Merchant API’sinin kullanıcı adı ve şifre bilgileri, Shopify entegrasyon uygulamasının şifreli ayar alanında saklanmalı ve API erişimi olan kişi sayısı sınırlı tutulmalıdır.

Bu bilgilerin ele geçirilmesi, üçüncü bir tarafın satıcı hesabı üzerinden ürün fiyatını veya stok bilgisini değiştirmesine imkan tanır (Hepsiburada Merchant API güvenlik rehberi, 2025). Ajans veya dış kaynaklı bir ekiple çalışan mağazalarda, erişim yetkisinin proje bitiminde geri alınması ihmal edilen bir güvenlik adımıdır.

Hepsiburada’da Çoklu Varyant Ürünler Nasıl Yönetilir?

Hepsiburada, renk ve beden gibi varyantları olan ürünleri “Ana Ürün” ve “Varyant” ilişkisiyle yönetir; her varyantın kendi barkodu ve stok miktarı ayrı ayrı tanımlanmak zorundadır.

Shopify’da bir ürünün 5 rengi ve 4 bedeni varsa bu 20 farklı varyant anlamına gelir ve her biri Hepsiburada’ya ayrı bir barkodla gönderilmelidir (Hepsiburada Merchant API dokümantasyonu, 2025). Varyantlardan biri eksik barkodla gönderildiğinde, o varyant listelenmez ama ana ürün genel olarak yayında kalabilir bu durum satıcının fark etmeden eksik bir varyant setiyle satış yapmasına neden olur.

Varyant sayısı yüksek kataloglarda, toplu yükleme öncesi her varyantın barkod alanının dolu olduğunu doğrulayan bir kontrol listesi (checklist) süreci, listelemenin eksiksiz tamamlanma ihtimalini artırır.

İpucu: Yeni bir varyantlı ürün grubu yüklenirken önce tek bir renk/beden kombinasyonuyla test yapılması, kategori ve attribute hatalarının tüm varyant setine yayılmadan erken fark edilmesini sağlar.

Entegrasyon Canlıya Alındıktan Sonra Ne Sıklıkla Kontrol Edilmeli?

Hepsiburada entegrasyonu canlıya alındıktan sonra, listing durumu, stok senkron logu ve iade bildirimleri en az haftalık olarak kontrol edilmelidir; ilk ay içinde bu kontrol sıklığının günlük yapılması hataların erken fark edilmesini sağlar.

Yeni kurulan bir entegrasyonda ilk haftalarda kategori eşleştirme hataları veya barkod format sorunları daha sık ortaya çıkar (sektör genelinde entegrasyon devreye alma pratikleri, 2025). Bu dönemde günlük kontrol, hatanın birikip toplu bir soruna dönüşmesini önler. Entegrasyon stabil çalışmaya başladıktan sonra kontrol sıklığı haftalığa düşürülebilir.

Kritik Not: İlk 30 gün içinde entegrasyonu “kur ve unut” yaklaşımıyla bırakmak, kategori veya attribute hatalarının fark edilmeden katalog genelinde tekrar etmesine yol açar. İlk ay yoğun kontrol, sonraki dönemde daha az manuel müdahale gerektiren bir kuruluma dönüşür.

Hepsiburada Entegrasyonunda Fiyat Rekabeti Nasıl Takip Edilir?

Hepsiburada’nın “Öne Çıkan Teklif” algoritması, aynı ürünü satan birden fazla satıcı olduğunda fiyat, teslimat süresi ve satıcı puanını karşılaştırarak vitrin konumunu belirler; bu nedenle fiyat takibi tek seferlik değil sürekli bir süreç olmalıdır.

Rakip bir satıcı fiyatını düşürdüğünde, güncellemesi gecikmiş bir mağaza vitrin konumunu kaybedebilir (Hepsiburada Satıcı Merkezi öne çıkan teklif rehberi, 2025). Bazı orta katman yazılımlar rakip fiyat izleme ve otomatik fiyat güncelleme (repricing) özelliği sunar; bu özellik, manuel takip yapan mağazalara göre vitrin konumunu koruma konusunda belirgin bir hız avantajı sağlar.

Fiyat rekabetine tamamen otomatik repricing ile girmek her kategori için uygun değildir kâr marjı dar ürünlerde otomatik fiyat düşürme, kârlılığı hızla eritebilir. Repricing kuralının alt sınır (minimum fiyat) ile birlikte tanımlanması bu riski sınırlar.

İpucu: Otomatik repricing kullanılacaksa, minimum fiyat sınırının maliyet + hedef kâr marjına göre sabitlenmesi, rekabetin kârlılığı sıfırlamasını önler.

Sık Sorulan Sorular

Shopify Hepsiburada entegrasyonu ne kadar sürede tamamlanır? Teknik kurulum 1-3 iş günü sürer, ancak kategori onayı gerektiren ürünlerde bu süre bir haftaya kadar uzayabilir. Marka onayı gereken kategorilerde ek belge süreci zaman ekler.

Hepsiburada’da barkod olmadan ürün satılabilir mi? Çoğu kategoride hayır, barkod (GTIN) zorunludur. Barkodu olmayan ürünler GS1 Türkiye üzerinden resmi barkod alarak listeye eklenmelidir.

Hepsiburada listing’i neden “Rejected” durumuna düşer? En sık neden kategori uyuşmazlığı, eksik marka onayı veya barkod format hatasıdır. Panelden reddedilme sebebi görüntülenip ilgili alan düzeltilerek ürün yeniden gönderilebilir.

Hepsiburada Merchant API’si ile Trendyol API’si aynı yöntemle mi çalışır? Hayır, kimlik doğrulama ve onay akışı farklıdır. Hepsiburada’da ürün onay öncesi “PreControl” sürecinden geçerken Trendyol’da ürün önce yayınlanıp hata sonradan görünür.

Hepsiburada’ya toplu ürün yüklemesi yapılabilir mi? Evet, Merchant API toplu (bulk) listing isteğini destekler. Ancak ilk toplu yüklemeden önce küçük bir örneklem grubuyla kategori eşleştirmesinin doğruluğu test edilmelidir.

Hepsiburada stok senkronizasyonu gerçek zamanlı mı çalışır? Gerçek zamanlıya yakın çalışır ama anlık değildir; API rate limit ve toplu güncelleme kuyruğu birkaç dakikalık gecikme yaratabilir. Yüksek hacimli mağazalarda bu gecikme overselling riskini artırabilir.

Hepsiburada’da hangi kategoriler en uzun onay süresine sahip? Elektronik, kozmetik ve anne-bebek gibi marka onayı gerektiren kategoriler genelde en uzun süreyi alır. Giyim ve ev/yaşam kategorileri kıyasla daha hızlı onaylanır.

Hepsiburada iadesi stoku otomatik artırır mı? Hayır, iade bildirimi Merchant API’de ayrı bir kayıt olarak tutulur ve stok güncellemesi otomatik gerçekleşmez. Bu adım manuel yapılmadığında satışa hazır ürünler sistemde tükenmiş görünmeye devam edebilir.

Hepsiburada’da sipariş hazırlama süresini kaçırmak ne gibi sonuç doğurur? Taahhüt edilen sürenin aşılması satıcı performans skorunu düşürür ve bazı kampanya alanlarına erişimi kısıtlayabilir. Sipariş bildiriminin gecikmesiz Shopify’a düşmesi bu riski azaltır.

Hepsiburada’da varyantlı bir ürünün tek bir rengi eksik barkodla gönderilirse ne olur? Yalnızca o varyant listelenmez, ana ürün genel olarak yayında kalmaya devam eder. Bu durum fark edilmezse katalog eksik varyant setiyle satışa açık kalır.

Hepsiburada’ya geçmeden önce Trendyol deneyimi işe yarar mı? Evet, her iki platformun API mantığı ve kategori/barkod gereksinimleri benzer prensiplere dayanır. Ancak Hepsiburada’nın onay öncesi PreControl süreci Trendyol’dan daha katı çalıştığı için ayrı bir öğrenme eğrisi gerektirir.

Sonraki Adım

Hepsiburada entegrasyonu tamamlandıktan sonra aynı ürün kataloğunu başka bir pazaryerine genişletmeyi planlayan mağazalar için Shopify Trendyol entegrasyonu rehberi alan eşleştirme farklarını gösterir. Tüm pazaryeri seçeneklerinin karşılaştırmalı görünümü için Shopify pazaryeri entegrasyonu rehberi kaynağına dönülebilir.