Parametreler ve sayfa bilgisi
| Alan | Yön | Anlamı |
|---|---|---|
| page | İstek | Sayfa numarası, 0'dan başlar |
| size | İstek | Sayfa boyutu; en fazla 100 |
| data | Yanıt | Ürün satırları |
| totalElements | Yanıt | Toplam ürün sayısı |
| totalPages | Yanıt | Toplam sayfa sayısı |
| number | Yanıt | Bu sayfanın numarası |
| last | Yanıt | Son sayfa mı |
Döngüyü last alanına göre bitirin. size 100'ün üzerinde istenirse sunucu yine 100 döner; "istenenden az geldi" kuralı ilk sayfada durur.
Ürün satırındaki alanlar
| Alan | Anlamı | Not |
|---|---|---|
| hbSku | Hepsiburada SKU'su | Bazı ürünlerde hiç gelmez |
| merchantSku | Satıcı stok kodu | Listing ile eşlemenin anahtarı |
| barcode | Barkod | İkinci eşleme anahtarı |
| productName | Ürün adı | Listing'de bulunmayabilir; buradan alın |
| categoryName | Kategori adı | Raporlama için |
| brand | Marka | |
| price, listPrice | Fiyat ve liste fiyatı | |
| images | Görseller | Dizi ya da tek adres olabilir |
| listingStatus | Listeleme durumu | Örneğin Active |
Görsel alanı her üründe aynı biçimde gelmeyebilir. Hem diziyi hem tek adresi okuyabilen bir kod yazın.
Stok alanına neden güvenilmez?
Canlı kullanımda bu uçtaki stok değeri kronik biçimde bayat çıktı. Başarılı stok güncellemelerinden saatler, hatta günler sonra bile eski ya da sıfır değer döndü. Bu değeri geri okuyup kendi kaydınıza yazmak, stokta olan ürünleri "sıfıra düştü" diye işaretler ve yanlış uyarılar üretir.
Doğru yol: ad, görsel, kategori ve markayı buradan; stok ve fiyatı Listing listesinden almak. Listing listesi listeleri çekme sayfasında.
Bu ayrım özellikle başka kanallarla eşleşmiş ürünlerde önemlidir. Stok sizin ana kaynağınızdan Hepsiburada'ya yazılıyorsa, aynı stoğu bayat bir uçtan geri okuyup ana kayda yazmak döngüsel bir hata üretir: doğru değer gider, yanlış değer geri gelir. Eşleşmiş ürünlerde stok alanını senkrondan tamamen hariç tutmak en güvenli yoldur. Ayrıntı stok senkronu mimarisi sayfasında.
Listing verisiyle birleştirmek
- Listing listesini sayfa sayfa okuyun ve satıcı stok kodundan Hepsiburada SKU'suna, stok koduyla barkoddan stoğa giden iki harita kurun.
- MPOP satırında hbSku yoksa SKU'yu Listing haritasından satıcı stok koduyla bulun.
- Stoğu Listing haritasından alın. Ürün Listing'de yoksa stoğu "bilinmiyor" sayın ve eski değeri koruyun; sıfır yazmayın.
- Listing'e erişilemezse senkronu durdurmayın; ad ve görsel güncellemesi yine yapılabilir.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Yalnız 100 ürün geliyor | Döngü istenen boyuta göre kesiliyor | last alanını kullanın |
| Stoklar sıfır ya da eski | Stok bu uçtan okunuyor | Stoğu Listing'den okuyun |
| Stok güncellemesi ListingNotFound | hbSku boş, yerine stok kodu kullanılmış | SKU'yu Listing listesinden eşleyin |
| Görseller okunamıyor | Alan bazen tek adres | Dizi ve tek değeri birlikte destekleyin |
Sık sorulanlar
Hepsiburada ürün adlarını hangi uçtan alırım?
MPOP servisindeki all-products-of-merchant ucundan. Listing listesinde ürün adı bulunmayabilir.
Sayfa başına kaç ürün gelir?
En fazla 100. Döngüyü yanıttaki last alanına göre bitirin.
Bu uçtaki stok değerini kullanabilir miyim?
Önerilmez. Canlıda saatler ve günler boyunca bayat kaldığı görüldü. Stoğu Listing servisinden okuyun.
hbSku boş gelirse ne yapmalıyım?
Listing listesindeki satıcı stok koduyla gerçek Hepsiburada SKU'sunu bulun. Stok kodunu SKU yerine kullanmak ListingNotFound hatası üretir.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı