Hepsiburada entegrasyonu, Hepsiburada'da satış yapan bir mağazanın ürün, teklif (listing), stok, fiyat ve sipariş işlemlerini Hepsiburada'nın REST servisleri üzerinden yazılımdan yönetmesidir. Hepsiburada'da ürün ile teklif ayrı kavramlardır; entegrasyonu planlarken bu ayrımı bilmek gerekir.
İlgili içerikler: Pazaryeri entegrasyonu rehberi · Trendyol entegrasyonu · n11 entegrasyonu · Kargo entegrasyonu
API Bilgileri ve Test Ortamı
- Servis anahtarı: Satıcı panelinde Bilgilerim, Entegrasyon, Entegratör Bilgileri bölümünde tanımlanır. Anahtar entegratör bazında verilir; kendi yazılımınızla bağlanıyorsanız bunu belirtin.
- Kimlik doğrulama: Belge özetine göre canlı ortam, canlı için verilen kullanıcı adı ve şifreyle Basic Authentication ile çağrılır.
- Test ortamı: Belgedeki adreslerde
-siteki bulunur (ör.oms-external-sit,listing-external-sit). Canlı adres bu ek kaldırılarak elde edilir. - Adreslerde mağaza kimliği: Uç noktalar
merchantIddeğerini yol parametresi olarak alır.
Katalog (Ürün) ve Listing (Teklif) Ayrımı
| Katalog ürün entegrasyonu | Listing (teklif) entegrasyonu | |
|---|---|---|
| Ne yapar | Hepsiburada kataloğunda ürün oluşturur | Kataloğdaki ürüne sizin satış teklifinizi bağlar |
| Kapsam | Kategori ve özellik bilgileri, ürün bilgisi gönderme, ürün durumu sorgulama | Stok, fiyat, satışa açma ve kapatma, listing silme |
| Çalışma biçimi | Asenkron; dönen trackingId ile durum izlenir | Toplu yükleme ve sonuç sorgulama |
Belge menüsünde katalog tarafı için şu başlıklar yer alıyor: kategori bilgilerini alma, kategori özelliklerini alma, özellik değerini alma, ürün bilgisi gönderme, ürün durumu sorgulama ve trackingId geçmişini sorgulama.
Ana Uç Noktalar (Test Ortamı)
| İşlem | Yöntem ve adres |
|---|---|
| Teklif oluşturma (stok ve fiyat) | POST https://supplier-api-external-sit.hepsiburada.com/suppliers/{merchantId}/listingUpdateRequests |
| Listing fiyat güncelleme | POST https://listing-external-sit.hepsiburada.com/listings/merchantid/{merchantId}/price-uploads |
| Listing stok güncelleme sonucu | GET https://listing-external-sit.hepsiburada.com/listings/merchantid/{merchantId}/stock-uploads/id/{id} |
| Sipariş detayı | GET https://oms-external-sit.hepsiburada.com/orders/merchantid/{merchantId}/ordernumber/{orderNumber} |
| Test siparişi oluşturma | POST https://oms-stub-external-sit.hepsiburada.com/orders/merchantId/{merchantId} |
Sipariş Akışı ve Webhook
Belgenin sipariş bölümünde paket oluşturma, paket bilgisi listeleme, pakete ait kargo bilgisini alma, fatura bağlantısı gönderme ve teslimat durumu iletme başlıkları var. "Sipariş Webhook Modeli" sayfasında şu olaylar geçiyor:
- Create Order (sipariş oluştu)
- Create Packages ve Unpack (paket oluşturma ve bozma)
- Intransit, Deliver, Undeliver (kargo durumları)
- Order Cancel (iptal)
- Change Shipping Address Order (teslimat adresi değişikliği)
Teslimat tipi değişikliği (Hepsijet) için ayrı bir servis bulunuyor; belgeye göre bu değişiklik ürün depoya kabul edilmeden veya toplanmadan önce yapılmalıdır.
Entegrasyonu Planlarken
- SKU eşleştirme: Kendi stok kodunuzla Hepsiburada ürün kodunu eşleştiren bir tablo tutun; teklif işlemleri bu eşleşmeye dayanır.
- Asenkron sonuçlar: Ürün gönderimi ve toplu stok-fiyat güncellemeleri hemen sonuçlanmaz; dönen kimliklerle sonucu sorgulayan bir görev yazın.
- Test önce: SIT ortamında tüm akışı tamamlamadan canlı adrese geçmeyin.
Sık Sorulan Sorular
Test adresinden canlıya nasıl geçilir?
Adresteki -sit eki kaldırılır ve canlı için verilen kullanıcı bilgileri kullanılır.
Ürünü gönderdikten sonra durumunu nasıl izlerim?
Ürün gönderiminde dönen trackingId ile ürün durumu servisini sorgulayın.
Gerçek müşteri olmadan sipariş akışı nasıl test edilir?
Test ortamındaki test siparişi oluşturma servisiyle.
Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.