Hepsiburada API Entegrasyonu: Satıcılar İçin Teknik Rehber
Hepsiburada'da satış yapıyorsanız ve operasyonel yükü azaltmak istiyorsanız API entegrasyonu kritik bir adımdır. Gerçek proje deneyimiyle hazırlanmış teknik rehber.
Hepsiburada API Nedir?
Hepsiburada Marketplace API, satıcıların ürün, stok, sipariş ve fiyat verilerini kendi yazılımlarından yönetmelerine olanak tanıyan programatik bir arayüzdür. Manuel panel girişi yerine tüm işlemler otomatik gerçekleşir. Hem tek satıcı hem de çok kanallı (Trendyol + Hepsiburada) operasyonlar için idealdir.
API Erişim Koşulları
Hepsiburada API'sine erişim için bazı ön koşullar vardır:
- Aktif Hepsiburada merchant hesabı
- Merchant ID ve API anahtarı (merchant panel > API Yönetimi)
- Minimum stok / satış hacmi eşiği (Hepsiburada onay sürecine tabidir)
- Teknik entegrasyon belgesi imzalanması
Temel API Fonksiyonları
Hepsiburada API'sinin en çok kullanılan uç noktaları şunlardır:
- Ürün listeleme: Yeni ürün ekle, mevcut ürün güncelle
- Stok güncelleme: Anlık stok miktarı güncellemesi
- Fiyat güncelleme: Toplu veya tekil fiyat değişikliği
- Sipariş çekme: Yeni siparişleri otomatik al
- Kargo güncelleme: Takip numarası ve kargo firması bildirimi
- İptal/İade yönetimi: İade taleplerini programatik işle
Trendyol + Hepsiburada Çift Kanal Entegrasyonu
Türkiye'deki büyük e-ticaret satıcılarının önemli bir kısmı hem Trendyol hem Hepsiburada'da satış yapar. Bu iki kanalın stok ve siparişlerini elle yönetmek yüksek hata riskine yol açar. Solman Digital tarafından geliştirilen çift kanal panel; iki platformu tek arayüzden yönetir, stok aşım riskini ortadan kaldırır ve sipariş fulfillment sürecini otomatize eder.
Teknik Mimari
Hepsiburada API entegrasyonu genellikle şu bileşenlerden oluşur:
- Next.js API route veya Node.js servisi — API çağrılarını yönetir
- Cron job (scheduled job) — stok ve fiyat güncelleme döngüsü (15 dk'da bir)
- PostgreSQL veritabanı (Supabase) — sipariş ve stok geçmişi
- Webhook endpoint — Hepsiburada'dan anlık sipariş bildirimi
- Hata yönetimi ve yeniden deneme (retry) mekanizması
Sık Karşılaşılan Sorunlar
Entegrasyonlarda en çok karşılaştığımız teknik problemler:
- Rate limiting: API çağrı limitleri aşıldığında 429 hatası — istek kuyruğu gerekli
- Ürün eşleştirme: Kendi veritabanı ile Hepsiburada ürün ID'lerinin tutarlı tutulması
- Stok negatife düşme: Eş zamanlı sipariş durumunda koruma mekanizması şart
- Token yenileme: API token süresi dolduğunda otomatik yenileme
Sık Sorulan Sorular
Hepsiburada API entegrasyonu ne kadar sürer?
Temel entegrasyon (stok + sipariş) 5–7 iş günü. Trendyol ile çift kanal panel dahil kapsamlı bir çözüm 2–3 haftada tamamlanır.
Hepsiburada API ücretsiz mi?
API erişimi ücretli değildir; merchant hesabı olan satıcılar Hepsiburada onay sürecinden geçtikten sonra ücretsiz kullanabilir.
Trendyol ve Hepsiburada entegrasyonunu aynı sistemde yapabilir misiniz?
Evet. Solman Digital'in tamamladığı referans projelerden biri, iki pazaryerini tek panelde birleştiren çift kanal yönetim sistemidir. Stok, sipariş ve fiyat senkronizasyonu her iki platformda anlık çalışır.
Hepsiburada veya çift kanal API entegrasyonu için
Marketplace Entegrasyon Hizmeti