Odoo ile Hepsiburada API Entegrasyonu: Tam Kurulum Kılavuzu

Türkiye'nin e-ticaret ortamında iki baskın platform bulunuyor ve Hepsiburada her ciddi satıcının ustalaşması gereken platformdur. 2000 yılında kurulan Hepsiburada, aylık 100 milyondan fazla ziyareti, 65.000'den fazla satıcısı ve elektronikten modaya, otomotiv parçaları ve endüstriyel malzemelere kadar her tüketici kategorisini kapsayan ürün kataloğuyla Türkiye'nin en eski ve en güvenilir çevrimiçi pazar yerlerinden biridir. Operasyonlarını Odoo ERP üzerinde yürüten satıcılar için Hepsiburada'nın güçlü API'si aracılığıyla entegre edilmesi, Türkiye pazarında verimli, ölçeklenebilir satışa giden yoldur.

Önemli Çıkarımlar

• Hepsiburada aylık 100 milyondan fazla ziyaret alıyor ve Türkiye'nin en çok ziyaret edilen pazar yeri
• Platform, 50 milyondan fazla ürün listelemesiyle 65.000'den fazla satıcıya ev sahipliği yapıyor
• Hepsiburada, 2021'de NASDAQ'ta halka açıldı ve kurumsal düzeyde pazaryeri altyapısını gösterdi
• Hepsi Burada API (HBAPI) ürünler, siparişler, envanter ve talepler için kapsamlı entegrasyon uç noktaları sağlar
• ECOSIRE'ın konektörü Türkçe yerelleştirmeyi, KDV vergisi uyumluluğunu ve çoklu kargo entegrasyonunu yönetir
• API ile entegre satıcılar %40 daha hızlı sipariş işleme ve %90 daha az envanter hatası elde ediyor

---

Hepsiburada Neden Önemli?

Trendyol moda ve günlük sipariş hacminde lider olurken, Hepsiburada elektronik, beyaz eşya, otomotiv ve endüstriyel kategorilerinde belirgin avantajlara sahip. Platformun 25 yıllık faaliyet süresi boyunca edindiği tüketici güveni itibarı, ona Trendyol'un hedef kitlesiyle örtüşen ancak onlardan farklı olan sadık bir müşteri tabanı kazandırıyor. Başarılı Türk e-ticaret satıcılarının çoğu her iki platformda da faaliyet gösteriyor ve Trendyol ile Hepsiburada entegrasyonunu standart bir gereklilik haline getiriyor.

Hepsiburada İstatistikleri (2025-2026)

Hepsiburada'nın Rekabetçi Konumu

Hepsiburada şu özellikleriyle farklılaşıyor:

• Güven: 25 yıllık faaliyet, özellikle yüksek değerli satın alımlarda derin tüketici güveni oluşturdu
• Elektroniğin gücü: Tüketici elektroniği, bilgi işlem ve mobil cihazlarda lider pazar payı
• HepsiJet lojistiği: Büyük şehirlerde aynı gün teslimatla şirket içi lojistik ağı
• HepsiPay: Taksit seçenekleriyle entegre ödeme sistemi (Türkiye taksitli pazarda kritik)
• Kurumsal satışlar: Ticari satın almalara yönelik B2B pazar segmenti
• Hepsiglobal: Uluslararası pazarlara ulaşan sınır ötesi satış programı

---

Hepsiburada API (HBAPI) Ayrıntılı İnceleme

Hepsiburada, kapsamlı satıcı entegrasyonunu mümkün kılan iyi yapılandırılmış bir REST API sağlar. API belgeleri İngilizce olarak mevcuttur (bazı Türk platform API'lerinin aksine), bu da onu uluslararası geliştirme ekiplerinin erişimine uygun hale getirir.

API Mimarisi

HBAPI hizmet alanları halinde düzenlenmiştir:

Listeleme Hizmeti

• Tam özellik kümeleriyle ürün listelemeleri oluşturun
• Çeşitleri yönetin (renk, boyut, model, kapasite)
• Resim yükleme ve sipariş verme işlemlerini gerçekleştirin
• Hepsiburada'nın kategori taksonomisinin haritası
• Listeleme durumunu yönetin (aktif, pasif, kilitli)
• Barkod (GTIN/EAN) gerekliliklerini yerine getirin

Sipariş Hizmeti

• Yeni siparişleri alın (paketlenebilir siparişler)
• Sipariş ayrıntılarına erişim (satır öğeleri, miktarlar, adresler)
• Sipariş satırı durumunu güncelleyin (toplama, faturalandı, gönderildi)
• Paketler oluşturun ve kargo şirketlerini atayın
• Kısmi gönderimi gerçekleştirin (önce mevcut ürünleri gönderin)

Envanter Hizmeti

• Depo başına listeleme başına stok miktarlarını güncelleyin
• Kullanılabilirlik durumunu ayarlayın
• Çoklu depo stok tahsisini yönetin

Talep Hizmeti

• Alıcı taleplerini işleme alın (yanlış ürün, hasarlı, eksik)
• Kanıtlarla birlikte talep yanıtlarını gönderin
• Talep sonuçlarını ve mali etkiyi takip edin

Finansal Hizmet

• Yerleşim raporlarına erişin
• Komisyon dökümlerini görüntüleyin
• Ceza ve düzeltme kesintilerini takip edin
• Faturaları ve mali belgeleri indirin

Kimlik Doğrulaması

HBAPI, Hepsiburada Satıcı Paneli aracılığıyla sağlanan satıcı kimliği, kullanıcı adı ve şifreyle HTTP Temel Kimlik Doğrulamasını kullanır. Bazı uç noktalar, güvenlik için ek IP beyaz listesi gerektirir.

Hız Sınırları ve En İyi Uygulamalar

• Standart hız sınırları: uç nokta başına dakikada 100 istek
• Envanter güncellemeleri: Toplu işlemler önerilir (istek başına en fazla 100 SKU)
• Sipariş yoklaması: Her 10 dakikada bir önerilir
• Ürün oluşturma: Yoğun dönemlerde saatte 500 yeni listelemeyle sınırlıdır

---

Entegrasyon Mimarisi

Sipariş İşleme Hattı

Hepsiburada'nın sipariş yaşam döngüsü diğer pazaryerlerinden biraz farklıdır. Siparişler belirli bir durum makinesinden geçer:

New → Picking → Invoiced → Packaged → Shipped → Delivered
  ↓        ↓         ↓          ↓
Cancel  Re-stock  [Skip if    Tracking
                   digital]    Push

Entegrasyon bu durum makinesine saygı duymalıdır; durumların atlanması veya sıra dışı güncelleme, API hatalarına ve olası sipariş işleme hatalarına neden olur.

Bileşen 1: Ürün Listeleme Entegrasyonu

Hepsiburada'da ilan oluşturmak ve yönetmek, platforma özel gereksinimlere dikkat etmeyi gerektirir:

• Kategori özellikleri: Her kategorinin zorunlu ve isteğe bağlı özellikleri vardır. Elektronik marka, model, teknik özellikler ve garanti süresi gerektirir. Moda, beden tablosu, malzeme ve bakım talimatları gerektirir
• Barkod gereksinimi: Tüm fiziksel ürünlerin geçerli GTIN/EAN barkodları olmalıdır. Entegrasyon, gönderimden önce barkod formatını doğrulamalıdır
• Resim gereksinimleri: Minimum 500x500 piksel, ana görsel için beyaz arka plan, liste başına en fazla 8 görsel
• Marka doğrulama: Ürünlerin listelenebilmesi için markaların Hepsiburada'da onaylanması gerekir. Entegrasyon, liste oluşturmayı denemeden önce marka onay durumunu kontrol etmelidir
• İçerik dili: Yurt içi pazar için tüm listeleme içeriği Türkçe olmalıdır

Bağlayıcı, Odoo ürün verilerini Hepsiburada'nın listeleme formatıyla eşleştirir, zorunlu özellikleri doğrular ve resim formatı dönüşümünü gerçekleştirir.

Bileşen 2: Sipariş İçe Aktarma ve Durum Yönetimi

Bağlayıcı, yeni paketlenebilir siparişler için HBAPI'yi yoklar ve aşağıdakilerle Odoo satış siparişleri oluşturur:

• Tam ürün ve varyant haritalaması
• Müşteri teslimat adresi
• Durum güncelleme takibi için sipariş düzeyinde ve satır düzeyinde kimlikler
• Ödeme yöntemi bilgileri
• Teslimat SLA gereksinimleri

Durum güncellemeleri Hepsiburada'nın gerekli sırasını takip eder:

1. Toplama: Siparişin alındığını onaylayın ve depo işlemlerini başlatın
2. Faturalandı: Fatura oluşturun ve kaydedin (paketlemeden önce gereklidir)
3. Paketlenmiş: Boyutları, ağırlığı ve tahsis edilen kargo şirketi ile paket oluşturun
4. Gönderildi: Kargo takip numarasını iletin

Her durum geçişi, uygun verilerle HBAPI'yi çağırır ve bağlayıcı, geçici hatalara yönelik yeniden denemeleri yönetir.

Bileşen 3: Envanter Yönetimi

Stok durumu toplu API çağrıları aracılığıyla Odoo'dan Hepsiburada'ya iletilir:

• Her 15-30 dakikada bir güncellenen SKU başına stok miktarları
• Çok kanallı satıcılar için uygulanan güvenlik tamponları
• Hepsiburada'da sıfır stoklu ürünler otomatik olarak devre dışı bırakıldı
• Stok restorasyonu otomatik yeniden etkinleştirmeyi tetikler

Hepsiburada envanterinin diğer satış kanallarıyla koordine edilmesi, gerçek zamanlı envanter senkronizasyonu kılavuzumuzda açıklanan merkezi yaklaşımı gerektirir.

Bileşen 4: Kargo ve Lojistik

Hepsiburada birden fazla kargo seçeneğini destekliyor:

• HepsiJet: Hepsiburada'nın kendi lojistik ağı (büyük şehirlerde aynı gün teslimat)
• Yurtic Kargo: Türkiye'nin en büyük kargo taşıyıcısı
• Aras Kargo: Rekabetçi fiyatlarla ülke çapında kapsama alanı
• MNG Kargo: Kurumsal ve hacimli kargo teslimatında güçlü
• Surat Kargo: Standart teslimatlar için bütçe dostu seçenek
• UPS Türkiye: Uluslararası ve premium teslimatlar için

Konektör, yapılandırılabilir kurallara (ürün kategorisi, varış yeri, ağırlık, aciliyet) göre uygun taşıyıcıyı atamak için Odoo'nun gönderim modülüyle entegre olur ve takip bilgilerini Hepsiburada'ya iletir.

Bileşen 5: Talepler ve Satış Sonrası

Hepsiburada'nın hasar sistemi, alıcı anlaşmazlıklarını ele alır:

• Yanlış ürün: Alıcı siparişinden farklı bir ürün aldı
• Hasarlı: Ürün hasarlı olarak geldi
• Eksik ürünler: Eksik sipariş teslimatı
• Kalite: Ürün liste açıklamasıyla eşleşmiyor

Bağlayıcı, talepleri Odoo'nun yardım masası modülüne aktararak müşteri hizmetleri ekibinizin kanıtları gözden geçirmesine, yanıtlar göndermesine ve sonuçları takip etmesine olanak tanır; üstelik tüm bunları Odoo içinden yapabilirsiniz. Talep çözümleme kalitesi, satıcı puanını etkileyerek verimli işlemeyi kritik hale getirir.

Bileşen 6: Mali Uzlaşma

İki haftada bir yapılan ödemeler şunları içerir:

• Sipariş satırı başına brüt satış geliri
• Kategoriye özel komisyonlar (%6-18)
• HepsiJet lojistik ücretleri
• Hizmet ücretleri (listeleme, işlem)
• Ceza kesintileri (Geç gönderim, iptal, hasar kayıpları)
• Promosyon katkıları

Bağlayıcı, her bir ödeme bileşeni için ayrıntılı günlük girişleri oluşturarak Odoo'da ürün başına ve kategori başına karlılık analizinin doğru yapılmasını sağlar.

---

Kurulum Kılavuzu

Adım 1: Hepsiburada Satıcı Hesabı

1. Hepsiburada Üye İşyeri Paneline Kayıt Olun
2. Kimlik ve vergi doğrulamasını tamamlayın
3. API erişimi isteyin ve kimlik bilgilerini alın (satıcı kimliği, kullanıcı adı, şifre)
4. API erişimi için IP beyaz listesini gönderin
5. Ürün markalarınız için marka onayları isteyin

Adım 2: Odoo Yapılandırması

1. Türkçe yerelleştirme: Türkiye'ye özel muhasebe, vergi ve belge modüllerini yükleyin
2. Para birimi: Otomatik döviz kuru güncellemeleriyle TL'yi yapılandırın
3. KDV (KDV) kurulumu: Ürün kategorisine göre vergi oranlarını (%1, %10, %20) yapılandırın
4. Satış kanalı: "Hepsiburada" satış ekibini oluşturun
5. Müşteri: "Hepsiburada Pazaryeri" müşteri kaydını oluşturun
6. Taşıyıcılar: Odoo teslimat modülünde HepsiJet ve onaylı kargo şirketlerini yapılandırın
7. Hesaplar: Komisyonlar, lojistik ücretleri ve cezalar için gider hesapları oluşturun

Adım 3: ECOSIRE Konektörünü Kurun

ECOSIRE Hepsiburada bağlayıcısını dağıtın:

1. Odoo Uygulamaları aracılığıyla yükleyin
2. Ayarlar > Hepsiburada Entegrasyonu'na gidin
3. Satıcı kimliğini, API kullanıcı adını ve şifresini girin
4. Gerekirse IP beyaz listesini yapılandırın
5. Senkronizasyon aralıklarını ayarlayın:

• Siparişler: her 10 dakikada bir
• Envanter: her 15 dakikada bir
• Ürünler: 4 saatte bir veya manuel

6. Ürün kategorilerini Hepsiburada taksonomisine göre eşleştirin

Adım 4: Ürün Listeleme Yapılandırması

1. Odoo ürünlerini zorunlu niteliklerle Hepsiburada kategorileriyle eşleştirin
2. Tüm ürünler için GTIN/EAN barkodlarını doğrulayın
3. Türkçe ürün içeriği hazırlayın
4. Uyumlu ürün görsellerini yükleyin
5. Komisyona duyarlı marjlarla TL fiyatlandırmasını belirleyin
6. İlk kataloğu senkronize edin ve listeleme onayını izleyin

Adım 5: İş Akışı Kurulumunu Sipariş Edin

1. Sipariş içe aktarma ve durum yönetimini yapılandırın
2. Hepsiburada siparişleri için depo atama kuralları belirleyin
3. Fatura oluşturmayı yapılandırın (Hepsiburada akışında paketlemeden önce gereklidir)
4. Kargo atama kurallarını ayarlayın
5. Uçtan uca sipariş işlemeyi test edin

Adım 6: Finansal Kurulum

1. Ürün kategorisine göre komisyon oranlarını haritalandırın
2. Yerleşim içe aktarma planını yapılandırın
3. Ücrete özel gider hesapları oluşturun
4. Küçük farklılıklar için uzlaşma toleransını tanımlayın

---

Hepsiburada'ya Özel Zorluklar

1. Zorluk: Paketten Önce Fatura Gerekliliği

Hepsiburada, satıcıların bir kargo paketi oluşturmadan önce fatura oluşturmasını gerektirir; bu, faturalamanın kargodan sonra veya kargoyla eş zamanlı olarak gerçekleştiği çoğu pazaryerinden farklı bir sıradır.

Çözüm: Bağlayıcı, Odoo'da fatura oluşturma adımını otomatik hale getirir ve toplama onaylanır onaylanmaz faturayı oluşturur ve kaydeder. Bu, doğru durum sırasının (Toplama > Faturalanmış > Paketlenmiş > Sevk Edildi) her zaman takip edilmesini sağlar.

2. Zorluk: Taksitli Ödeme Kültürü

Türkiye'de güçlü bir taksitli ödeme kültürü var; tüketiciler alışverişlerini sıklıkla 3, 6, 9 veya 12 aylık taksitlerle ödüyorlar. Hepsiburada ve HepsiPay tüketici taksit ilişkisini yönetirken, satıcılar ödemenin tamamını (komisyonlar hariç) normal takas şartlarına göre alıyor.

Çözüm: Bağlayıcı, tüketicinin taksit planına bakılmaksızın ödeme tutarının tamamını Odoo'ya doğru şekilde kaydediyor. Taksit yapısı bilgilendirme amaçlı olarak kaydedilir ancak satıcının muhasebe uygulamasını etkilemez.

Challenge 3: Hepsiglobal Sınır Ötesi Karmaşıklık

Hepsiburada'nın Hepsiglobal programı, sınır ötesi satışa olanak tanıyor, birden fazla para biriminde fiyatlandırma, uluslararası nakliye lojistiği ve gümrük belgelendirme gerekliliklerini getiriyor.

Çözüm: Konektör, hedef pazara göre ayrı fiyatlandırma yapılandırmaları, uluslararası operatör entegrasyonu ve Odoo aracılığıyla gümrük belgeleri oluşturma özellikleriyle Hepsiglobal'ı destekliyor.

Mücadele 4: Elektronikte Yüksek Rekabet

Elektronik Hepsiburada'nın en güçlü kategorisi ama aynı zamanda en rekabetçi kategorisi. Fiyat hassasiyeti son derece yüksektir ve Satın Alma Kutusu rekabeti, gerçek zamanlı fiyatlandırma duyarlılığı gerektirir.

Çözüm: Bağlayıcı, rekabetçi konum ve marj tabanlarına göre ayarlanan fiyatlandırma kurallarını destekler. Rekabetin yüksek olduğu kategoriler için fiyatlandırma güncellemeleri daha sık tetiklenebilirken aynı zamanda kârlılık bariyerleri de korunabilir.

5. Zorluk: Mevsimsel Talep Ani Yükselişleri

Türk e-ticaretinde 11.11 (Bekarlar Günü), Kara Cuma ve Ramazan öncesi alışveriş dönemlerinde büyük talep artışları görülüyor. Bu etkinlikler sırasında sipariş hacimleri 3-5 kat artabilir.

Çözüm: Konektör, artırılmış senkronizasyon frekansı, daha büyük güvenlik arabellekleri ve otomatik kapasite uyarıları ile en yüksek mod yapılandırmalarını destekler. Etkinlik öncesi kontrol listeleri, talepteki artışlardan önce envanter, fiyatlandırma ve sipariş karşılama kapasitesinin hazırlanmasını sağlar.

---

Manuel vs ECOSIRE Konektörü

---

İkili Platform Stratejisi: Hepsiburada + Trendyol

En başarılı Türk e-ticaret satıcıları hem Hepsiburada'da hem de Trendyol'da aynı anda faaliyet gösteriyor. İki platformun farklı güçlü yönleri var:

• Hepsiburada: Elektronikte, beyaz eşyada, B2B'de daha güçlü. Daha yaşlı, daha yüksek gelirli demografik
• Trendyol: Modada, güzellikte, alışverişte daha güçlü. Daha genç, mobil öncelikli demografik

Her ikisini de Odoo'dan çalıştırmak şunları gerektirir:

1. Birleşik envanter: Güvenlik tamponlarıyla her iki platforma tahsis edilmiş tek stok havuzu
2. Platforma özel fiyatlandırma: Platform başına farklı komisyon oranları ve rekabet dinamikleri
3. Ayrı performans takibi: Her platformun kendi satıcı puanı algoritması vardır
4. Konsolide raporlama: Platformlar arası gelir, marj ve performans karşılaştırması

ECOSIRE konektörü, çoklu platform Odoo yapılandırmasını destekler ve çoklu pazaryeri yönetim kılavuzumuz operasyonel stratejiyi ayrıntılı olarak kapsar.

---

ECOSIRE Entegrasyon Hizmetleri

ECOSIRE'ın Odoo entegrasyon hizmetleri Hepsiburada satıcılarına tam destek sağlar:

• Uçtan uca bağlayıcı dağıtımı ve yapılandırması
• Türkçe yerelleştirme (KDV, muhasebe, e-fatura)
• Özel yerine getirme iş akışı tasarımı
• Kargo taşıyıcısı entegrasyonu ve optimizasyonu
• Çift platformlu kurulum (Tek Odoo'dan Hepsiburada + Trendyol)
• Personel eğitimi ve sürekli destek

Mevcut tüm entegrasyonlar için ECOSIRE'ın pazar yeri bağlayıcı kataloğuna göz atın.

---

Sıkça Sorulan Sorular

Konektör HepsiJet ve diğer Türk kargo şirketlerini destekliyor mu?

Evet. Konektör HepsiJet, Yurtiç Kargo, Aras Kargo, MNG Kargo, Sürat Kargo ve UPS Türkiye ile entegre olur. Taşıyıcı ataması kural tabanlıdır (ürün kategorisi, ağırlık, varış yeri ve aciliyet için kuralları yapılandırırsınız) ve takip numaraları Odoo'nun teslimat modülünden otomatik olarak Hepsiburada'ya iletilir.

Türk vergileri (KDV) nasıl ele alınıyor?

Bağlayıcı, Hepsiburada ürün kategorilerini doğru KDV oranıyla (%1, %10 veya %20) eşleştirir. Odoo'da oluşturulan faturalar uygun vergi hesaplamalarını taşır ve hesap mutabakatı vergi tutarlarını Hepsiburada'nın kayıtlarına göre doğrular. Mevzuata uyum açısından Türkçe e-fatura (e-Fatura) formatı desteklenmektedir.

Sipariş durumu güncellemesi sırasında API çağrısı başarısız olursa ne olur?

Bağlayıcı, geçici API hataları için üstel geri çekilmeyle yeniden deneme mantığını uygular. Yeniden denemelerden sonra durum güncellemesi başarısız olursa, manuel olarak ilgilenilmesi için sipariş Odoo'da işaretlenir ve yapılandırılmış operasyonlar ilgili kişisine bir uyarı gönderilir. Sistem, sistemik sorunları belirlemek için API güvenilirlik ölçümlerini izler.

Hangi Odoo sürümleri destekleniyor?

ECOSIRE Hepsiburada konektörü Odoo 17, 18 ve 19'u (Community ve Enterprise sürümleri) destekler. Türkçe yerelleştirme özellikleri modülle birlikte verilmektedir.

---

Sonuç

Hepsiburada'nın yoğun trafiği, 25 yılda oluşturulan tüketici güveni ve yüksek değerli kategorilerdeki güçlü konumu, onu Türkiye pazarını hedefleyen her satıcı için vazgeçilmez bir satış kanalı haline getiriyor. Platformun yapılandırılmış API'si otomasyon için sağlam bir temel sağlıyor ancak entegrasyonun Hepsiburada'nın özel gereksinimlerine (sipariş durumu makinesi, paket öncesi fatura iş akışı, kargo entegrasyonu ve talep yönetimi gibi) saygı göstermesi gerekiyor; bunların hepsinin platforma özgü nüansları var.

Uygun Hepsiburada-Odoo entegrasyonuna yatırım yapan satıcılar bileşik bir avantaj elde ediyor: Daha hızlı sipariş işleme, satıcı puanlarını iyileştiriyor, bu da görünürlüğü artırıyor, bu da daha fazla sipariş alınmasını sağlıyor; operasyonel verimlilikle desteklenen verimli bir döngü. Manuel süreçlere güvenenler tam tersini buluyor: Yavaş işleme, puanın düşmesine, görünürlüğün azalmasına ve satışların azalmasına neden oluyor.

İleriye giden yol açıktır. İster Hepsiburada'daki ilk varlığınızı oluşturuyor olun ister mevcut bir operasyonunuzu ölçeklendiriyor olun, platformu Odoo ERP'nize ECOSIRE'ın amaca yönelik tasarlanmış konektörü aracılığıyla bağlamak, büyümeyi sınırlayan ve marjları aşındıran operasyonel sürtünmeyi ortadan kaldırır.