Üç servis ve görevleri
| Servis | Temel adres | Görevi |
|---|---|---|
| Listing | https://listing-external.hepsiburada.com | Satıcı listelemeleri: fiyat, stok, satış durumu |
| MPOP | https://mpop.hepsiburada.com | Katalog: ürün yükleme, kategori, özellik, mağaza ürünleri |
| OMS | https://oms-external.hepsiburada.com | Siparişler, paketler, iptaller |
Ayrım, Hepsiburada'daki iki katmanlı ürün yapısından gelir. Katalog ürünü ortak kayıttır; adı, görselleri ve özellikleri burada durur. Listeleme ise sizin satış teklifinizdir; fiyat ve stok buradadır. Bu yüzden ürün açmak MPOP'a, stok değiştirmek Listing'e gider.
Hangi iş hangi yola gider?
Aşağıdaki yollar canlıda çalışan bir entegrasyonun kullandığı yollardır. SATICI_ID yerine Merchant ID'nizi yazın.
| İş | Servis | Yöntem ve yol |
|---|---|---|
| Listeleri çekme | Listing | GET /listings/merchantid/SATICI_ID |
| Stok güncelleme | Listing | POST /listings/merchantid/SATICI_ID/stock-uploads |
| Fiyat ve stok güncelleme | Listing | POST /listings/merchantid/SATICI_ID/inventory-uploads |
| Ürün yükleme | MPOP | POST /product/api/products/import |
| Yükleme durumu | MPOP | GET /product/api/products/status/TAKIP_NO |
| Kategori listesi | MPOP | GET /product/api/categories/get-all-categories |
| Kategori özellikleri | MPOP | GET /product/api/categories/KATEGORI_ID/attributes |
| Mağaza ürünleri | MPOP | GET /product/api/products/all-products-of-merchant/SATICI_ID |
| Paketlenecek siparişler | OMS | GET /orders/merchantid/SATICI_ID |
| Sipariş detayı | OMS | GET /orders/merchantid/SATICI_ID/ordernumber/SIPARIS_NO |
| Kargodaki paketler | OMS | GET /packages/merchantid/SATICI_ID/shipped |
| Fatura bekleyen paketler | OMS | GET /packages/merchantid/SATICI_ID/missing-invoice |
| İptal edilenler | OMS | GET /orders/merchantid/SATICI_ID/cancelled |
Neden iki ayrı ürün kaynağı var?
Ürün listesini iki yerden okuyabilirsiniz ve ikisi farklı şey söyler. MPOP mağaza ürün listesi ürün adını, görselleri, kategoriyi ve markayı verir. Listing listesi ise fiyatı ve gerçek stoğu verir.
Canlı kullanımda MPOP'taki stok alanının güvenilmez olduğu görüldü: başarılı stok güncellemelerinden saatler sonra bile eski ya da sıfır değer dönebiliyor. Listing yanıtında ise ürün adı ve görsel bulunmayabiliyor. Sağlam bir entegrasyon adı ve görseli MPOP'tan, stoğu ve fiyatı Listing'den alır.
Kimlik alanları da iki kaynakta aynı dolulukta gelmeyebilir. MPOP bazı ürünlerde Hepsiburada SKU'sunu hiç vermez. Bu durumda Listing listesindeki satıcı stok kodu üzerinden gerçek Hepsiburada SKU'su bulunur. Eşleme yapılmazsa stok güncellemeleri ListingNotFound hatasıyla reddedilir. Ayrıntı SKU, stok kodu ve barkod sayfasında.
Bağlantı ayarları
- Tüm adresler https ile başlar. Güncel TLS sürümlerini destekleyen bir istemci kullanın.
- Yanıtlar JSON döner. Accept başlığını application/json yapın.
- Uzun listelerde yanıt süresi uzayabilir. Zaman aşımını kısa tutmayın ve yeniden denemeyi sınırlı yapın.
- Adresleri koda gömmeyin. Test ortamına geçerken yalnız ayar değişsin; ayrıntı SIT ve canlı ortam sayfasında.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Sipariş listesi her zaman 401 | Eski /order/api/merchants/SATICI_ID/orders kalıbı kullanılmış | /orders/merchantid/SATICI_ID yolunu kullanın |
| 404 | Yol yanlış servise gönderilmiş | İşin hangi serviste olduğunu tablodan kontrol edin |
| Ürün adları boş görünüyor | Ad Listing yanıtından okunmaya çalışılmış | Adı MPOP ürün listesinden alın |
| Stoklar sıfır görünüyor | Stok MPOP'tan okunmuş | Stoğu Listing listesinden okuyun |
Sık sorulanlar
Hepsiburada API temel adresi nedir?
Tek bir temel adres yoktur. Listing için listing-external.hepsiburada.com, katalog için mpop.hepsiburada.com, sipariş için oms-external.hepsiburada.com kullanılır.
MPOP ne demek?
Hepsiburada'nın satıcı katalog servisidir. Ürün yükleme, kategori ve özellik listeleri ile mağaza ürün listesi bu servistedir.
Stok bilgisini hangi servisten okumalıyım?
Listing servisinden. MPOP ürün listesindeki stok alanı canlı kullanımda bayat ya da sıfır dönebildi.
Üç servis için üç ayrı anahtar gerekir mi?
Hayır. Merchant ID ve servis anahtarından oluşan aynı Basic başlığı üç serviste de çalışır.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı