HTTP durum kodları
| Kod | Hepsiburada'da görülen durum | Çözüm |
|---|---|---|
| 200, işlenen kayıt yok | Stok yüklemesinde alan adları küçük harfle başlıyor | HepsiburadaSku, MerchantSku, AvailableStock yazımını kullanın |
| 400 "Merchant ID is not specified." | Yoldaki Merchant ID tanınmadı | Yoldaki kimliği kontrol edin |
| 401 "Missing Credentials!" | Authorization başlığı yok | Basic başlığını ekleyin |
| 401, başlık var | Yanlış kimlik ya da eski sipariş yolu kalıbı | Merchant ID ve servis anahtarını, sipariş yolunu kontrol edin |
| 404 | Var olmayan yol | Yolu doğrulayın; ör. yükleme durumu /products/status/ altındadır, /products/tracking/ değil |
| 500 | Katalog yüklemesinde emoji ya da sembol; JSON'un dosya yerine düz gövde gönderilmesi | Metni temizleyin, multipart/form-data ile dosya yükleyin |
500 yanıtı her zaman sunucu arızası değildir. Katalog servisinde izin verilmeyen karakter grubu da 500 döndürür. Hepsiburada desteğinin bu durumdaki açıklaması "İzin verilmeyen karakter grubu girildi" oldu.
Takip sonucundaki hata adları
Stok ve fiyat yüklemeleri sırayla işlenir. Hatalar çoğu zaman ilk yanıtta değil, takip numarasıyla yapılan sorguda görünür.
| Hata | Anlamı | Çözüm |
|---|---|---|
| ListingNotFound | Gönderilen Hepsiburada SKU'su için listeleme bulunamadı | SKU'yu Listing listesinden satıcı stok koduyla yeniden eşleyin |
| DuplicateHepsiburadaSkuSpecified | Aynı SKU pakette iki kez var; paketin tamamı reddedilir | Paketi SKU bazında tekilleştirin |
| AvailableStock - Required field | Alan adı beklenen yazımda değil | Alan adlarını büyük harfle başlatın |
ListingNotFound çoğu zaman yanlış kimlikten gelir. Hepsiburada bazı ürünlerin SKU'sunu zamanla değiştirebilir. Eski SKU ile gönderilen her güncelleme bu hatayı üretir. Ayrıntı SKU, stok kodu ve barkod sayfasında.
200 her zaman başarı değildir
Stok ve envanter yükleme uçları isteği alınca bir takip kimliği döndürür. Bu yanıt "kabul edildi" demektir, "işlendi" demek değildir. Sonucu takip kimliğiyle ayrıca sorgulamak gerekir.
Canlıda görülen en sinsi durum şuydu: alan adları küçük harfle başlayınca stok yükleme ucu 200 döndü ama hiçbir satırı işlemedi. Hata da vermedi. Entegrasyon güncellemeyi başarılı sandı, mağazada yüzlerce ürün sıfır stokta kaldı. Takip sonucunu okumayan her entegrasyon bu riski taşır. Takip akışı güncelleme durumu sayfasında.
Hata yanıtını doğru kaydetmek
- Durum kodunu, yanıttaki message alanını ve gövdenin tamamını kaydedin.
- İsteğin yolunu kaydedin ama sorgu parametrelerindeki kişisel verileri kırpın.
- Authorization başlığını asla kaydetmeyin.
- Toplu işlemlerde takip kimliğini ve takip sonucundaki errors listesini saklayın; destek talebinde ilk istenen bilgi budur.
Sık sorulanlar
Hepsiburada API 401 hatası neden olur?
Authorization başlığı eksikse "Missing Credentials!" mesajı gelir. Başlık varsa Merchant ID, servis anahtarı ya da sipariş yolu kalıbı yanlıştır.
ListingNotFound ne demek?
Gönderdiğiniz Hepsiburada SKU'su için bir listeleme yok demektir. Genelde eski ya da yanlış SKU kullanılmıştır; Listing listesinden doğru SKU'yu bulun.
DuplicateHepsiburadaSkuSpecified hatasında hangi ürünler güncellenir?
Hiçbiri. Aynı SKU pakette iki kez geçince paketin tamamı reddedilir. Paketi SKU bazında tekilleştirip yeniden gönderin.
Katalog yüklemede 500 alıyorum. Sunucu mu bozuk?
Genelde değil. Ürün adında ya da açıklamada emoji veya sembol varsa ya da JSON dosya olarak yüklenmediyse katalog servisi 500 döndürür.
Stok güncellemesi 200 döndü ama panelde değişmedi. Neden?
200 yanıtı yalnız isteğin kabul edildiğini gösterir. Takip kimliğiyle sonucu sorgulayın. Alan adları yanlış yazıldıysa hiçbir satır işlenmemiş olabilir; errors listesi ve işlenen kayıt sayısı bunu gösterir.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı