Hepsiburada API · Ürün ve katalog

Hepsiburada ürün yükleme durumunu takip numarasıyla sorgulama

Hepsiburada'ya gönderilen bir ürünün durumu, yüklemeden dönen takip numarasıyla MPOP servisindeki GET /product/api/products/status/TAKIP_NO ucundan sorgulanır. Yanıt yükleme sonucunu (importStatus) ve varsa hataları verir. Başarılı sonuç ürünün satışa açıldığı anlamına gelmez; ürün önce Hepsiburada'nın incelemesine düşer. Yayını kesin olarak doğrulamak için ürünün listede görünmesini de kontrol edin.

GET/product/api/products/status/{trackingId}Saystok'un canlıda kullandığı MPOP ucu

Yüklemeden yayına akış

AdımNe olurNerede görülür
1. YüklemeTakip numarası dönerimport yanıtı
2. SorguDosyanın kabul edilip edilmediği ve hatalarstatus ucu
3. İncelemeÜrün "İncelenecek" durumuna geçerSatıcı paneli
4. YayınListeleme oluşurListing listesi ve MPOP mağaza ürünleri

İkinci adım teknik kabulü, dördüncü adım gerçek yayını gösterir. Arada Hepsiburada'nın içerik incelemesi vardır. Yalnız ikinci adıma bakan bir entegrasyon, incelemede reddedilen ürünü "yüklendi" sanar.

Yanıtı yorumlamak

Canlıda görülen başarılı değer importStatus alanında SUCCESS'tir. Yanıt ürün bazında satırlar da taşıyabilir; satırda stok kodu, durum ve hata metni yer alır.

Görülen durumAnlamıNe yapılır
SUCCESS ve boş hata listesiDosya ve alanlar kabul edildiİnceleme sonucunu bekleyin
Hata içeren durum ya da dolu hata listesiÜrün reddedildiHata metnine göre düzeltip yeniden gönderin
Boş ya da ara durumİşlem sürüyorBir süre sonra yeniden sorgulayın

Durum değerlerinin tam listesi için resmî dokümana bakın. Tanımadığınız bir değeri "başarısız" saymak yerine "bekliyor" sayıp yeniden sorgulamak, yanlış alarmı önler.

Ne sıklıkla sorgulanmalı?

Yüklemenin hemen ardından sorgulamak çoğu zaman "işleniyor" yanıtı verir. Kısa bir bekleme ile başlayın ve aralığı giderek açın. Aynı takip numarasını saniyede bir sorgulamak hem gereksiz yük üretir hem istek sınırına yaklaştırır.

Takip sorgusunun yanında ikinci bir doğrulama kurun: ürün, mağaza ürün listesinde ya da Listing listesinde stok kodu veya barkodla görünüyor mu? Görünüyorsa yayın tamamdır. Belli bir süre sonra hâlâ görünmüyorsa gönderimi başarısız sayıp satıcıyı uyarın.

Takip numarasını kaybetmeyin

  • Takip numarasını ürünün stok koduyla birlikte saklayın.
  • Aynı ürünü onay beklerken yeniden göndermeyin; mükerrer kayıt ve karışık sonuç üretir.
  • Destek talebinde takip numarasını paylaşın; sorunun izi bu numarayla sürülür.
  • Toplu gönderimde her ürünün takip numarasını ayrı tutun; tek bir numarayla tüm grubu izlemeye çalışmayın.

Sık hatalar ve çözümleri

BelirtiOlası nedenÇözüm
404/product/api/products/tracking/ yolu kullanılmış/product/api/products/status/ kullanın
SUCCESS ama ürün satışta yokÜrün incelemede ya da reddedildiPaneli ve Listing listesini kontrol edin
Sorgu boş dönüyorTakip numarası yerine stok kodu gönderilmişimport yanıtındaki trackingId değerini kullanın
Ürün iki kez yüklendiOnay beklenmeden yeniden gönderilmişBekleyen gönderimleri işaretleyip tekrar göndermeyin

Sık sorulanlar

Hepsiburada trackingId ile ne sorgulanır?

Katalog yüklemesinin sonucu. MPOP servisinde GET /product/api/products/status/TAKIP_NO ucu kullanılır.

importStatus SUCCESS ne demek?

Dosya ve alanlar kabul edildi demektir. Ürün yine de Hepsiburada'nın incelemesinden geçmelidir.

Ürünün yayına çıktığını nasıl anlarım?

Ürünün stok kodu ya da barkodu Listing listesinde veya mağaza ürün listesinde görünüyorsa yayındadır.

Takip numarasını kaybettim, ne yaparım?

Ürünün mağaza listesinde görünüp görünmediğine bakın. Görünmüyorsa ve bekleyen bir gönderim kaydınız yoksa ürünü yeniden gönderin.

Reddedilen ürünü nasıl düzeltirim?

Takip sonucundaki hata metnini okuyun. Eksik zorunlu özellik, tanınmayan marka ya da açılmayan görsel adresi olası nedenler arasındadır. Alanı düzeltip ürünü yeniden gönderin ve yeni takip numarasını saklayın.

Kaynaklar

İlgili Hepsiburada API konuları

Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı

Hepsiburada entegrasyonunu kod yazmadan kurun

Saystok bu API'lerle stok, sipariş ve fiyatı sizin yerinize eşitler. 30 gün ücretsiz.