Takip akışı
| Adım | İstek | Sonuç |
|---|---|---|
| 1 | POST stock-uploads ya da inventory-uploads | Gövdede id döner |
| 2 | Kısa bekleme | İşlem sırada |
| 3 | GET .../stock-uploads/id/TAKIP_ID | Durum ve hata listesi |
| 4 | Değerlendirme | Done ve boş hata: başarılı; dolu hata: başarısız |
İlk yanıt "isteğiniz alındı" demektir. Hepsiburada'nın listelemeyi gerçekten güncellediğini yalnız üçüncü adım gösterir. Bu adımı atlayan bir entegrasyon, reddedilen güncellemeleri başarılı sayar.
Takip kimliği isteği yaptığınız uca bağlıdır. Stok yüklemesinin kimliği stock-uploads yolunda, envanter yüklemesinin kimliği inventory-uploads yolunda sorgulanır. İki ucu birlikte kullanan bir entegrasyonda kimliği, hangi uçtan geldiği bilgisiyle birlikte saklamak karışıklığı önler.
Yanıtı yorumlamak
| Alan | Görülen değer | Anlamı |
|---|---|---|
| status | Done | İşlem tamamlandı |
| errors | Boş (null) | Hata yok |
| errors | Dolu liste | Satırlardan biri ya da birkaçı reddedildi |
Done dışındaki durum değerlerinin tam listesi için resmî dokümana bakın. Pratik kural şudur: Done görmeden başarı ilan etmeyin. errors boş ama durum henüz Done değilse işlem sürüyor olabilir; bir süre sonra yeniden sorgulayın.
Ne zaman ve kaç kez sorgulanmalı?
Gönderimden hemen sonra sorgulamak çoğu zaman işlemi henüz bitmemiş yakalar. Birkaç saniyelik bir bekleme ile başlayın. Durum Done değilse aralığı açarak birkaç kez daha deneyin ve bir üst sınır koyun.
- İlk sorgu: birkaç saniye sonra.
- Sonraki sorgular: aralığı her seferinde artırarak.
- Üst sınıra ulaşınca: güncellemeyi "doğrulanamadı" olarak işaretleyin, bir sonraki senkron turunda Listing listesinden gerçek değeri okuyun.
Takip kimliğini isteğin içeriğiyle birlikte saklayın. Hata çıktığında hangi ürünlerin pakette olduğunu bilmeden sorunu çözemezsiniz.
Hata çıkınca ne yapılmalı?
Hata listesi doluysa paketi kör biçimde yeniden göndermeyin. Önce hatanın türüne bakın:
- ListingNotFound: SKU'yu Listing listesinden tazeleyin, sonra yeniden gönderin.
- DuplicateHepsiburadaSkuSpecified: paketin tamamı reddedilmiştir; tekilleştirip yeniden gönderin.
- Alan hatası: alan adlarının yazımını kontrol edin.
En önemlisi, başarısız güncellemeyi kendi kaydınıza "yapıldı" diye yazmayın. Aksi hâlde sizin sisteminiz sıfır, Hepsiburada eski stok gösterir ve fark kimse bakana kadar fark edilmez.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Güncellemeler başarılı görünüyor, panel eski | Takip sonucu hiç okunmuyor | Her gönderimden sonra takip ucunu sorgulayın |
| 404 | Envanter kimliği stok yolunda sorgulanmış | Kimliği aldığınız uçla aynı yolu kullanın |
| Ara durumda başarı ilan edildi | Yalnız errors alanına bakılmış | Done durumunu da bekleyin |
| Hata sonrası sistemler ayrıştı | Başarısız güncelleme kayda yazılmış | Yalnız doğrulanan güncellemeleri kaydedin |
Sık sorulanlar
Hepsiburada stock-uploads takip kimliği nerede?
Stok ya da envanter yükleme isteğinin yanıt gövdesindeki id alanında.
Başarılı sonuç nasıl görünür?
Durum Done ve hata listesi boştur.
Takip sonucunu hiç okumazsam ne olur?
Reddedilen güncellemeleri başarılı sanırsınız. Canlıda bu yüzden yaklaşık iki yüz ürün uzun süre yanlış stokta kaldı.
Envanter yüklemesinin sonucunu hangi yoldan sorgularım?
inventory-uploads/id/TAKIP_ID yolundan. Stok yüklemesi için stock-uploads/id/TAKIP_ID kullanılır.
Durum uzun süre Done olmazsa ne yapmalıyım?
Birkaç denemeden sonra güncellemeyi doğrulanamadı olarak işaretleyin. Bir sonraki turda Listing listesinden gerçek stoğu okuyup gerekirse güncellemeyi yeniden gönderin.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı