İstek gövdesi
| Alan | Tür | Açıklama | Örnek |
|---|---|---|---|
| HepsiburadaSku | Metin | Listelemenin Hepsiburada SKU'su | HBCV_ORNEK |
| MerchantSku | Metin | Satıcı stok kodu | STOK-001 |
| AvailableStock | Tam sayı | Satılabilir stok | 7 |
| Price | Sayı | Satış fiyatı | 1299.90 |
| ListPrice | Sayı, isteğe bağlı | Liste fiyatı | 1499.90 |
Bu uçta fiyat JSON sayısı olarak gönderilir ve canlıda bu biçimle işlendi. Katalog yükleme dosyasındaki "virgüllü metin" kuralı burada geçerli değildir; iki ucu karıştırmayın.
Alan adları stok ucundaki gibi büyük harfle başlar. Küçük harfle gönderildiğinde bu uç "AvailableStock - Required field" hatası verdi.
Price ve ListPrice
Price, müşterinin ödediği satış fiyatıdır. ListPrice ise liste fiyatıdır ve isteğe bağlıdır. ListPrice'ı yalnız gerçekten bildiğiniz durumda gönderin.
- Liste fiyatı satış fiyatının altında olmamalıdır. Bilinmiyorsa ya da düşükse satış fiyatına eşitlemek güvenli bir varsayılandır.
- Komisyon ve kargo payını hesaba katmadan fiyat göndermeyin. Hesap için satış fiyatı hesaplama aracını kullanabilirsiniz.
- Kampanya dönemlerinde fiyatı toplu değiştirmeden önce küçük bir grupla deneyin.
Yalnız fiyat değiştirmek
Saystok'un kullandığı uçlar arasında yalnız fiyat alan ayrı bir uç yoktur; fiyat değişikliği de bu uçla, güncel stokla birlikte gönderilir. Bu durumun bir tuzağı vardır: elinizdeki stok bayatsa, fiyatı değiştirirken stoğu da eski değere çekersiniz.
- Fiyat güncellemesinden önce stoğu güncel kaynaktan okuyun.
- Stoğu bilinmeyen bir listelemenin fiyatını değiştirmeyi erteleyin.
- Fiyat ve stok değişikliklerini aynı pakette birleştirmek, iki ayrı isteğin birbirini ezmesini önler.
Sıra da önemlidir. Bir fiyat isteği ile bir stok isteği aynı anda yola çıkarsa, sonra işlenen öncekinin stok değerini ezer. Aynı listeleme için yeni bir paket göndermeden önce önceki paketin takip sonucunu beklemek bu yarışı ortadan kaldırır.
Yer tutucu fiyat göndermeyin
Fiyatı bilinmeyen bir ürün için 1 gibi bir yer tutucu değer göndermek, listelemeyi o fiyattan satışa açar. Pozitif stokla birlikte gönderilen yanlış fiyat, dakikalar içinde zararına satış demektir.
Doğru davranış atlamaktır: fiyatı sıfır ya da eksik olan ürüne pozitif stok göndermeyin, ürünü bir uyarı listesine alın. Stoğu sıfıra çekmek gerekiyorsa bunu fiyat istemeyen stok ucuyla yapın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| "AvailableStock - Required field" | Alan adları küçük harfle başlıyor | Büyük harfle başlayan adları kullanın |
| Fiyat yanlış işlendi | Fiyat virgüllü metin olarak gönderilmiş | JSON sayısı gönderin |
| Fiyat değişti, stok geriye gitti | Bayat stokla birlikte gönderilmiş | Stoğu önce güncel kaynaktan okuyun |
| Paketin tamamı reddedildi | Aynı SKU iki kez | SKU bazında tekilleştirin |
| ListingNotFound | SKU eski | SKU'yu Listing listesinden tazeleyin |
Sık sorulanlar
Hepsiburada fiyat güncelleme API ucu nedir?
Listing servisinde POST /listings/merchantid/SATICI_ID/inventory-uploads. Fiyat, stokla birlikte gönderilir.
Fiyatı virgülle mi noktayla mı yazmalıyım?
Bu uçta JSON sayısı olarak, noktalı ondalıkla. Virgüllü metin kuralı yalnız katalog yükleme dosyası içindir.
ListPrice zorunlu mu?
Hayır, isteğe bağlıdır. Gönderirseniz satış fiyatının altında olmamasına dikkat edin.
Yalnız fiyatı nasıl değiştiririm?
Bu uçla güncel stoğu da göndererek. Stok bayatsa önce güncel değeri okuyun.
Envanter güncellemesinin sonucunu nasıl görürüm?
Yanıttaki id ile inventory-uploads takip ucunu sorgulayın. Ayrıntı güncelleme durumu sayfasında.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı