Hepsiburada'ya XML ile Ürün Yükleme: Gönderimden Satışa Adım Adım

Tedarikçinizin XML'inden yüzlerce ürünü Hepsiburada'ya gönderdiniz. Entegrasyon ekranı "gönderildi" diyor. Ertesi gün mağazanıza bakıyorsunuz ve satışta tek ürün yok. Bir kısmı onayınızı bekliyor, bir kısmı eksik bilgide, bir kısmı satışa hazır ama kapalı.

Bu yazıda Hepsiburada'ya XML'den ürün yüklemeyi adım adım anlatıyoruz. Dayanağımız Hepsiburada'nın geliştirici portalındaki resmi dokümanlar ve duyurular. Paneli sınadığımız kendi canlı mağazamız da ikinci dayanak. Orada yaklaşık 100.000 ürünü beş pazaryerinde birden yönetiyoruz.

Bu süreç size neye mal olur?

• Satıldığını sandığınız ama satışta olmayan ürün. Gönderim başarılı görünür, ürün ise bir statüde bekler.
• Onayınızı bekleyen eşleşme. Siz onay ya da red vermeden ürün ilerlemez.
• Sıfır fiyatla açılan ilan. Fiyat biçimi hatalıysa ürün sıfır fiyat ve sıfır stokla satışa hazır hâle gelir.
• Kilitlenen ürün. Fiyatı Hepsiburada'nın izin verdiği aralığın dışına çıkan ürün kilitlenir ve satış durur.

Tek cümlelik özet. Hepsiburada'da "yüklendi" ile "satışta" arasında iki iş var. Ürün önce statülerden geçer. Satışa Hazır olduğunda da fiyat ve stok gönderilmeden satışa açılmaz.

Hepsiburada XML'inizi olduğu gibi okumaz

"Hepsiburada XML entegrasyonu" dendiğinde çoğu satıcı XML adresini verip beklemeyi düşünür. Oysa Hepsiburada'nın ürün yükleme servisi kendi modelinde hazırlanmış bir JSON dosyası bekler. Kategori kimliği, özellikler, barkod, marka, görseller ve varyant grubu bu dosyada Hepsiburada'nın alan adlarıyla yer alır.

Yani asıl iş, tedarikçinin XML'indeki her ürünü Hepsiburada'nın diline çevirmektir. Ürün açıldıktan sonraki fiyat ve stok güncellemesi ise daha esnektir. Hepsiburada bu servis için XML gövdesini de kabul ediyor.

Adım adım Hepsiburada'ya ürün yükleme

1. Entegratörünüze mağaza yetkisi verin

Hepsiburada'da entegrasyon yazılımı mağazanıza sizin verdiğiniz yetkiyle bağlanır. Yetkiyi satıcı panelinde Hesabım > Bilgilerim > Entegrasyon > Entegratör Bilgileri bölümünden verirsiniz. Aynı yerde entegratör için bir servis anahtarı oluşur. Bu anahtarı ve Mağaza ID'nizi entegrasyon ekranına girersiniz.

Kontrol edin. Hepsiburada'ya göre yetkinin devreye girmesi yaklaşık 2 saat sürebilir. İlk denemede "geçersiz" uyarısı alırsanız birkaç saat sonra tekrar deneyin. Servis anahtarını yenilerseniz yeni anahtarı entegrasyon ekranına da girmeniz gerekir.

2. Kategoriyi en alt kırılımda ve aktif olandan seçin

Hepsiburada ürünü yalnız en alt, aktif ve ürün açılabilir bir kategoriye kabul eder. Tedarikçinin "Ev" ya da "Aksesuar" gibi geniş başlığı yetmez. Her tedarikçi kategorisini bir kez Hepsiburada'daki karşılığına bağlarsınız. Sonraki ürünler aynı yoldan gider.

Kontrol edin. "Category is not a leaf category" uyarısı alıyorsanız seçtiğiniz kategori ya en alt basamak değildir ya da artık aktif değildir. Kategori listesini yeniden çekip eşlemeyi güncelleyin. Eşlemenin genel mantığını toptancı XML bayilik rehberimizde anlattık.

3. Zorunlu özellikleri Hepsiburada'nın listesinden doldurun

Her kategorinin kendi özellik listesi vardır. Zorunlu olanların hepsi gönderilmelidir. Bir kısmı liste tipindedir ve Hepsiburada'nın kendi değerlerinin girilmesi önceliklidir. Aynı "Renk" özelliği bir kategoride başka, başka bir kategoride başka değerler alabilir.

Zorunlu olmayan özellikleri de boş geçmeyin. Hepsiburada'nın kendi notuna göre bu özellikler ürünün açılması ve aramalarda çıkması için önemlidir.

Kontrol edin. Tedarikçinin "Gold" dediği renk Hepsiburada listesinde hangi değere karşılık geliyor? Birkaç ürünü açıp listedeki karşılığını gözle doğrulayın.

4. Barkodu doğru verin

Hepsiburada barkodun 13 haneli ve kendi içinde doğrulanabilir olmasını ister. Aynı barkodu mağazanızdaki iki farklı üründe kullanamazsınız. Kullanırsanız "Barcode must be unique" uyarısı döner.

Temmuz 2026'da önemli bir değişiklik duyuruldu. Barkodun artık yalnız sizin mağazanız içinde benzersiz olması bekleniyor. Katalogda aynı barkodlu bir ürün olsa bile ürününüz yalnız barkod yüzünden eşleşmeye düşmüyor. Eşleşmeye düşmesi için ad, açıklama, görsel ve özelliklerin mevcut bir katalog ürünüyle yüksek oranda örtüşmesi gerekiyor.

Kontrol edin. Tedarikçi XML'inde barkodu boş ya da 13 haneden kısa olan ürünleri gönderimden önce ayırın.

5. Varyantları aynı grup kimliğiyle, stok kodunu sabit gönderin

Aynı modelin renk ve bedenlerini Hepsiburada'da tek sayfada göstermek için hepsine aynı varyant grup kimliğini verirsiniz. Varyantı olmayan ürüne ise benzersiz bir kimlik verilir.

Stok kodunuz (merchantSku) büyük harfle ve boşluksuz gider. Küçük harfle gönderirseniz Hepsiburada onu büyük harfe çevirerek kaydeder. XML'de tedarikçinin ürün kodu sabitse onu kullanmak en güvenli yoldur. Fiyat ve stok güncellemeleri sonradan bu koda bağlanır.

6. Görselleri erişilebilir adresten ve kurallara uygun verin

Görseli Hepsiburada verdiğiniz adresten kendisi çeker. Adrese ulaşamazsa birkaç kez dener, sonra siz ürünü yeniden gönderene kadar o görseli almaz. Kabul edilen biçimler PNG ve JPG.

• Fon beyaz ya da açık renk olmalı.
• Görselde "kargo bedava" gibi yazı, logo ya da filigran olmamalı.
• Ürün görselin büyük kısmını kaplamalı ve çerçeve içinde olmamalı.

Kontrol edin. Tedarikçinin görsel adreslerinden birkaçını tarayıcıda açın. Yavaş açılan ya da hata veren sunucu, görselsiz kalan ürün demektir.

7. Gönderdikten sonra statüyü okuyun

Ürün dosyasını gönderdiğinizde Hepsiburada size bir takip numarası verir. Asıl sonuç bu numarayla, her ürün için ayrı ayrı okunur. Ürün şu statülerden birine düşer.

Statü	Ne demek	Sizin işiniz
İncelenecek	Ürün Hepsiburada'nın ürün giriş ekibinin kontrolünü bekliyor	Beklemek
Ürün bilgileri eksik	Gönderdiğiniz bilgide eksik var	Eksiği tamamlayıp yeniden göndermek
Görev açılmış	Ürün bilgisinde hata bulunmuş	Düzeltip yeniden göndermek
Eşleşen	Ürün katalogdaki bir ürünle eşleşmiş	Eşleşmeyi kontrol edip onay ya da red vermek
Satışa Hazır	Ürün kataloğa eklenmiş, mağazanıza ilan açılmış	Fiyat ve stokla satışa açmak

Eşleşmeyi reddederseniz ürün İncelenecek statüsüne geçer ve yeni ürün olarak değerlendirilir. "Katalog Sürecinde" ve "Satışa Hazır" statüsündeki ürüne ise ürün yükleme servisiyle güncelleme gönderemezsiniz.

Kontrol edin. Satıcı panelinde Aksiyon Bekleyen Ürünler bölümüne bakın. Onayınızı bekleyen eşleşmeler ve eksik bilgili ürünler orada durur.

8. Satışa açmayı ayrı bir adım olarak görün

Hepsiburada'nın kendi sık sorulan sorularında açıkça yazıyor. Ürün yüklemekle ürün doğrudan satışa açılmaz. Satışa Hazır olan ilan, fiyat ve stok gönderildiğinde satışa açılır. Fiyatı veya stoğu sıfır gönderirseniz ilan satışa kapanır.

Fiyat biçimine dikkat edin. Hepsiburada kuruşu virgülle ister, örneğin 14,50. Nokta ile yazılan fiyat hata verir. Bu kural n11'in tersidir, çok pazaryerinde satıyorsanız ayrıca dikkat edin. n11 rehberimizde oradaki biçimi anlattık.

İkinci dikkat noktası fiyat korumasıdır. Hepsiburada yanlış fiyata karşı bir aralık denetimi uyguluyor. Fiyat bu aralığın dışına çıkarsa hata döner ya da ilan kilitlenir. Kilitli ilanda satış durur. Fiyattan eminseniz kilidi kaldırabilirsiniz. Güncel aralığı ve kilitli ürünleri satıcı panelinizin envanter ekranından teyit edin.

Kontrol edin. XML'deki fiyat genelde alış fiyatıdır. Komisyon, kargo ve kâr eklenmeden Hepsiburada'ya gitmemeli. Hesabı pazaryeri komisyonu ve otomatik fiyat hesaplama yazımızda adım adım gösterdik.

Sık görülen uyarılar ve anlamları

Uyarı	Anlamı	Ne yapmalı
Category is not a leaf category	Kategori en alt basamak değil ya da aktif değil	Kategori listesini yeniden çekip eşlemeyi güncelleyin
Barcode must be unique	Bu barkodu mağazanızda başka bir üründe kullanmışsınız	Aksiyon Bekleyen Ürünler'de barkodu aratıp eski kaydı bulun
Can not update product in matched or in catalog progress status	Ürün eşleşmede ya da katalog sürecinde	Aynı ürünü tekrar göndermeyin, statüsüne bakın
InvalidPrice	Fiyat biçimi hatalı, çoğu zaman nokta kullanılmış	Kuruşu virgülle gönderin
OutOfPriceRange	Fiyat izin verilen aralığın dışında	Fiyat hesabınızı kontrol edin
restrictedProductBrand	Markada satış kısıtı var	Kategori yöneticinizle görüşün

Hızlı teşhis

• Hiçbir ürün gitmiyorsa önce entegratör yetkisine ve servis anahtarına bakın. Yeni verdiyseniz birkaç saat bekleyin.
• Ürün panelde görünmüyorsa gönderimin takip numarasıyla dönen uyarıyı okuyun.
• Ürün "Eşleşen" ise onayınızı bekliyordur. Katalogdaki ürünün marka, görsel ve adını sizinkiyle karşılaştırıp karar verin.
• Ürün Satışa Hazır ama satışta değilse fiyat ve stok gitmemiştir ya da sıfır gitmiştir.
• Ürün satıştayken kapandıysa kilitlenip kilitlenmediğine bakın. Stok akışının genel mantığını stok senkronizasyonu rehberimizde anlattık.

Kalıcı çözüm ilkesi

Hepsiburada'da iş "gönder ve unut" ile bitmez. Kalıcı çözüm üç parçalıdır. Eşlemeyi göndermeden önce bir kez doğru kurarsınız. Gönderdikten sonra statüyü okursunuz. Satışa açmayı fiyat ve stokla ayrıca yapar, sonra da izlersiniz. Bu üçünden biri eksik kalırsa ürün bir yerde bekler ve siz fark etmezsiniz.

Bunu Entegmar'da nasıl yapıyoruz

Entegmar'da tedarikçinizin XML kaynağını bir kez bağlarsınız, ürünler havuzda toplanır. Kategori ve özellik eşlemesini Hepsiburada'nın kendi listesiyle bir kez yaparsınız, ürünler Hepsiburada'nın beklediği modele çevrilip gönderilir. Gönderim sonrası inceleme sonuçlarını tek ekranda görürsünüz. Satış fiyatını komisyon, kargo ve kâr kuralınıza göre panel hesaplar. Tedarikçi XML'inde fiyat ya da stok değişince güncelleme Hepsiburada'ya da gider. Ekranları Hepsiburada entegrasyonu sayfamızda görebilirsiniz.

Sık sorulan sorular

Hepsiburada'ya XML adresimi doğrudan verebilir miyim?

Ürün yükleme servisi XML adresi değil, Hepsiburada modelinde hazırlanmış bir JSON dosyası bekler. Bu yüzden XML'deki ürünlerin önce Hepsiburada'nın kategori ve özellik diline çevrilmesi gerekir. Ürün açıldıktan sonraki fiyat ve stok güncellemesinde ise XML gövdesi de kabul ediliyor.

Ürünü yükledim, neden satışta değil?

Hepsiburada'da yükleme satışa açma değildir. Ürün önce İncelenecek ya da Eşleşen gibi bir statüden geçer. Satışa Hazır olduğunda fiyat ve stok gönderilince satışa açılır.

Aynı barkodlu ürün katalogda varsa ne olur?

Temmuz 2026 duyurusuna göre barkod tek başına eşleşme sebebi değil. Ürününüz ancak ad, görsel ve özellikleri de mevcut ürünle yüksek oranda örtüşürse eşleşmeye düşer. O durumda onay ya da red vermeniz beklenir.

Soru sormak istersem?

Kendi durumunuza özel bir sorunuz varsa iletişim formundan yazabilirsiniz.

Kendi XML'inizle birlikte bakalım

Hangi ürünlerinizin Hepsiburada'da ilk seferde doğru açılacağını, hangilerinin eşleme ya da barkod düzeltmesi isteyeceğini kendi XML'iniz üzerinden görmek en kısa yoldur. Kısa bir demoda tedarikçi dosyanızı birlikte açalım.

Demo talebi bırakın →