İstek gövdesi
Gövde bir JSON dizisidir. Her öğe bir listelemeyi temsil eder. Örnek değerler sahtedir.
| 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ı | Yeni satılabilir stok | 12 |
Tek bir öğenin içeriği şöyle düşünülebilir:
- HepsiburadaSku: HBCV_ORNEK
- MerchantSku: STOK-001
- AvailableStock: 12
Başarılı bir istek, gövdede bir id döndürür. Bu kimlik sonucu sorgulamak için gerekir; kaydedin.
Alan adları neden büyük harfle başlar?
Canlı kullanımda bu uç alan adlarını büyük harfle başlayan biçimde (HepsiburadaSku, MerchantSku, AvailableStock) bekledi. Küçük harfle başlayan adlar gönderildiğinde uç 200 döndü, hata vermedi ama hiçbir satırı işlemedi.
Bu sessiz başarısızlık çok pahalıya mal olabilir. Bir mağazada gerçek stoğu olan yaklaşık iki yüz ürün uzun süre sıfır görünmeye devam etti; çünkü güncellemeler "başarılı" sanılıyordu. Doğru yazımla aynı istekler takip sonucunda Done durumuna geçti ve hata listesi boş döndü.
Sıfırdan pozitife geçişte bu uç yetmez
Bu uç stoğu düşürmek ve sıfırlamak için uygundur. Ama stoğu sıfır olan bir listelemeyi yeniden satışa açarken stok tek başına yetmez; fiyat ve stok birlikte gönderilmelidir. Canlıda stok ucu bu geçişi fiyat olmadan sessizce yok saydı.
| Geçiş | Kullanılacak uç |
|---|---|
| Pozitiften pozitife (12 → 8) | stock-uploads ya da inventory-uploads |
| Pozitiften sıfıra (5 → 0) | stock-uploads |
| Sıfırdan pozitife (0 → 3) | inventory-uploads, fiyatla birlikte |
Ayrıntı listelemeyi yeniden satışa açma sayfasında.
Paketi hazırlarken
- SKU'yu tekilleştirin: aynı Hepsiburada SKU'su pakette iki kez geçerse paketin tamamı DuplicateHepsiburadaSkuSpecified hatasıyla reddedilir. Çakışan iki değerden düşük olanı seçmek fazla satış riskini azaltır.
- SKU'yu Listing listesinden alın: katalogdaki eksik ya da eski SKU ListingNotFound üretir.
- Stoğu tam sayıya çevirin: negatif değerleri sıfıra çekin.
- Sonucu sorgulayın: birkaç saniye bekleyip takip kimliğiyle durumu okuyun. Akış güncelleme durumu sayfasında.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 200 ama stok değişmedi | Alan adları küçük harfle başlıyor | HepsiburadaSku, MerchantSku, AvailableStock yazın |
| Ürün sıfırdan çıkmıyor | Yeniden açma stok ucuyla denenmiş | inventory-uploads ile fiyatla gönderin |
| Paketin tamamı reddedildi | Aynı SKU iki kez | SKU bazında tekilleştirin |
| ListingNotFound | SKU eski ya da yanlış | SKU'yu Listing listesinden tazeleyin |
Elle, Excel ile ya da API ile stok güncelleme yollarının karşılaştırması Hepsiburada stok güncelleme yazısında.
Sık sorulanlar
Hepsiburada stok güncelleme API ucu nedir?
Listing servisinde POST /listings/merchantid/SATICI_ID/stock-uploads. Gövde HepsiburadaSku, MerchantSku ve AvailableStock alanlarından oluşan bir dizidir.
Stok güncellemesi hemen yansır mı?
İstek önce kabul edilir, sonra işlenir. Yanıttaki id ile sonucu sorgulayıp Done durumunu ve boş hata listesini görün.
Neden 200 aldığım hâlde stok değişmedi?
En sık neden alan adlarının küçük harfle başlamasıdır. Bu durumda uç hata vermeden hiçbir satırı işlemez.
Tükenen ürünü stok ucuyla yeniden açabilir miyim?
Canlıda açılmadı. Sıfırdan pozitife geçişte envanter ucuyla fiyat ve stoğu birlikte gönderin.
Tek istekte kaç ürün gönderebilirim?
Uç bir dizi kabul eder. Paket boyutunun üst sınırı için resmî dokümana bakın. Büyük paketlerde aynı SKU'nun iki kez geçmesi gibi tek bir hatanın paketin tamamını düşürebileceğini unutmayın; paketi göndermeden önce tekilleştirin.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı