Önemli
Fiyat/Stok Entegrasyonu methodlarımız ile ilgili sorularınız olması durumunda Sıkça Sorulan Sorular sayfamızı ziyaret edebilirsiniz.
Satıcı Listing Bilgilerini Listeleme
Not
SIT(Test) ortamımızda siz değerli satıcılarımız için test hesabınız özelinde örnek envanter listesi oluşturduk.Belirtilen envanterinizdeki dummy ürünleriniz ile test entegrasyon sürecinizi yönetebilirsiniz.
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait Hepsiburada sistemimizde belirtilen güncel bilgilere mağaza/bayi bazlı erişim sağlayabilir.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
- Envanter liste bilgilerinizi merchantSku bazlı alabilmeniz için örnek istek endpointinde belirtebileceğiniz maksimum merchantSku sayı adedi 50’dir.
Parametreler(Parameters)
| merchantid | (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) ; Her satıcı mağazanın/bayinin unique bilgisidir. |
| hepsiburadaSku | Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir. |
| merchantSku | Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir. |
| Limit ve Offset | Limit ve Offset parametreleri pagenation yapısı olarak işlev görmektedir. Limit bir sayfada kaç adet envanterin listeleneceğini belirtirken, Offset hangi envanterden sonraki listinglerin gösterileceğini belirtir. Örneğin Limit:10 Offset:0 gönderildiğinde ilk 10 envanter listelenecektir. Limit:10 Offset:10 gönderildiğinde ilk 10 envanterden sonraki 10 envanter listelenecektir. |
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
HepsiburadaSku
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
MerchantSku
|
Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Price
|
Envanterin güncel fiyat bilgisidir.
|
|
AvailableStock
|
Envanterin güncel stok bilgisidir.
|
|
CriticalStockAmount
|
Envanterin kritik stok bilgisidir. Bu miktarın altına düşen ürün otomatik olarak satışa kapatılır.
|
|
DispatchTime
|
Envanterin kargoya veriliş süresidir.
|
|
CargoCompany1
|
Envanterin üzerinde tanımlı olan kargo firmasıdır.
|
|
CargoCompany2
|
Envanterin üzerinde tanımlı olan kargo firmasıdır.
|
|
CargoCompany3
|
Envanterin üzerinde tanımlı olan kargo firmasıdır.
|
|
ShippingAddressLabel
|
Göndericinin adres satırıdır.
|
|
ClaimAddressLabel
|
İade ve talepler için adres satırıdır.
|
|
Pricing.FinalPrice
|
Envanter özelindeki indirim ve kampanya tanımında ifade edilen yeni satış fiyatıdır.
|
|
Pricing.StartDate
|
Envanter özelindeki indirim ve kampanya tanımının başlama tarihini verir.
|
|
Pricing.EndDate
|
Envanter özelindeki indirim ve kampanya tanımının bitiş tarihini verir.
|
|
Pricing.Debtor
|
Envanter özelindeki indirim ve kampanyanın hangi işbirliği tarafından karşılanacağını isim olarak belirtir. (Örneğin Hepsiburada,Mağaza gibi)
|
|
Pricing.Amount
|
Envanter özelindeki indirim ve kampanyanın işbirliği tarafından hangi yüzdelik oran olarak karşılanacağı bilgisini verir.
|
|
MaximumPurchasableQuantity
|
Envanterin son kullanıcı tarafından tek bir seferde sepette satın alabileceği maksimum adet sayısını belirtir.
|
|
IsSalable
|
Envanterin satış durumunu belirtir. True: satışta / False: satışta değil.
|
|
CustomizableProperties
|
Envanterin özelleştirilebilir ürün olduğunu belirtir.
|
|
IsSuspended
|
Envanterin askı durumunu belirtir. True: Askıda / False: Askıda Değil.
|
|
IsLocked
|
Envanterin kilit durumunu gösterir. True: Kilitli / False: Kilitli Değil.
|
|
LockReasons
|
Envanterin kilitlenme nedenini belirtir.
|
|
IsFrozen
|
Envanterin dondurulma durumunu belirtir.
|
|
CommissionRate
|
Envanterin üzerine uygulanan Hepsiburada'nın aldığı komisyon oranını belirtir.
|
|
BuyboxOrder
|
Hepsiburada üzerinde envanter bazında kaçıncı sırada görüneceğini belirtir.
|
Hata Durumları
Hata Kodu |
Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Username veya Password (Şifre) hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen ticket üzerinden entegrasyon ekibi ile iletişime geçiniz.
|
Envanterde Fiyat/Stok Bilgilerini Güncelleme – JSON Format
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait mağaza/bayi bazlı güncel fiyat/stok bilgilerini Hepsiburada sistemine iletebilir.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Parametreler(Parameters)
| merchantid | (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) ; Her satıcı mağazanın/bayinin unique bilgisidir. |
Not
Tek mağaza için aynı anda POST ettiğiniz envanter güncelleme iletimlerinizin devam etme / bekleme sayısı, fiyat/stok güncelleme metodu için limit 10, ayrı ayrı fiyat ve stok JSON formatlı işlemleri için limit 5’i geçemez. Limit kuralına takılan satıcılarımız ‘Günlük Toplu Güncelleme Limitinizin Sınırını Aştınız’ hatası ile karşılaşır.
Eğer bir envanter satışa kapatılmak isteniyorsa stok veya fiyat bilgisinin sıfır gönderilmesi yeterlidir.
Eğer bir envanter satışa açılmak isteniyorsa fiyat ve stok bilgisinin sıfırdan farklı bir değer gönderilmesi yeterlidir.
Request body de sadece hepsiburadaSku veya sadece merchantSku parametresinin belirtilmesi yeterlidir.İkisininde aynı bodyde gönderilmesi zorunlu değildir.Satıcılarımız birini tercih edebilir.
- Göndermiş olduğunuz istek tarafınızdan başarılı bir şekilde Hepsiburada sistemine iletilmiş ise yukarıda Response Body örneğinde ifade edildiği üzere Inventory Upload Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Inventory Upload Id bilgisini tarafınızda kaydetmenizi ve 2.madde de ifade edilen GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
- Göndermiş olduğunuz istek içerisinde zorunlu alanlarda eksiklik tespit edilir ise Inventory Upload Id bilgisi dönmeyecektir. Aşağıda ifade edilen örnekte belirtildiği gibi hatanın neden kaynaklandığı bilgisini içeren bir Response satıcılarımız ile paylaşılacaktır.Response da dönen bilgileri dikkate alarak göndermiş olduğunuz istekte iyileştirilmesi gereken noktalar ile ilgili aksiyon alabilirsiniz.
Bilgi
MaximumPurchasableQuantity parametresinin gönderimi opsiyoneldir.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
HepsiburadaSku
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
MerchantSku
|
Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Price
|
Envanterin fiyat bilgisidir.
|
|
AvailableStock
|
Envanterin stok bilgisidir.
|
|
DispatchTime
|
Envanterin kargoya veriliş süresidir.
|
|
MaximumPurchasableQuantity
|
Envanterin son kullanıcı tarafından tek bir seferde sepette satın alabileceği maksimum adet sayısını belirtir.
|
|
CriticalStockAmount
|
Envanterde ifade edilen ürünün kritik stok miktarıdır. Bu adetin altına düşen ürün satışa otomatik kapatılır.
|
Envanterde Fiyat/Stok Bilgilerini Güncelleme İşlem Kontrolünü bu method ile sağlayabilirsiniz
Parametreler(Parameters)
| merchantid | (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) ; Her satıcı mağazanın/bayinin unique bilgisidir. |
| inventory-uploadsid | (gerekli, guid, 32910839-83b9-4545-adb6-76dad457edc4) ; Hepsiburada sistemimizin her fiyat/stok güncelleme isteği için satıcıya iletim sağladığı unique bilgidir. |
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
Id
|
Hepsiburada sistemimizin her fiyat/stok güncelleme isteği için satıcıya iletim sağladığı unique bilgidir.
|
|
Status
|
Gönderilen requestin başarı durumunu belirtir. Done: Tamamlandı / Failed: Hata aldı.
|
|
CreatedAt
|
Envanter güncelleme isteğinin tarih ve saat bilgisidir.
|
|
Total
|
Envanter güncelleme işlemi için göndermiş olduğunuz request içerisindeki toplam envanter sayısıdır.
|
|
Errors.Errors.ElementNo
|
Envanter güncelleme işleminde göndermiş olduğunuz request içerisindeki envanter sırasını belirtir.
|
|
Errors.Errors.HepsiburadaSku
|
Envanterde ifade edilen hata alan ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
Errors.Errors.MerchantSku
|
Envanterde ifade edilen hata alan ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Errors.Errors.string
|
Hata alan envanterdeki ürünün hata nedenini belirtir.
|
Not
Envanter güncelleme isteğiniz başarısız ise ‘Güncelleme İsteği Sorgulaması Sonucunda Süreçte Hata İle Karşılaşılan Response Body ‘ örneğinde ifade edildiği gibi hatanın neden kaynaklandığı bilgisini içeren bir Response satıcılarımız ile paylaşılacaktır.Response da dönen bilgileri dikkate alarak göndermiş olduğunuz istekte iyileştirilmesi gereken noktalar ile ilgili aksiyon alabilirsiniz. Errors.Errors.string parametresinin alabileceği değerler aşağıda belirtilmiştir.
Hata Açıklamaları
| Hata Adı | Açıklama |
|---|---|
|
ProductNotFound
|
Girilen HBSku bilgisi kataloğumuzda yer almıyor ise dönen hatadır.
|
|
MismatchingSkusSpecified
|
Girilen HBSku ve MerchantSku bilgileri yanlış eşleştirildiğinde alınan hatadır.
|
|
DuplicateHepsiburadaSkuSpecified
|
Yollanılan dosya ya da yüklenen excel dosyasının içerisinde birden fazla HBSku kodu bulunduğu zaman alınan hatadır.
|
|
DuplicateMerchantSkuSpecified
|
Yollanılan dosya ya da yüklenen excel dosyasının içerisinde birden fazla MerchantSku kodu bulunduğu zaman alınan hatadır.
|
|
MissingHeaders
|
Yollanılan dosyada tag yada excel dosyasında başlık eksik ise alınan hatadır.
|
|
InvalidPrice
|
Fiyat bilgisi decimal dışında bir değer girildiği zaman alınan hatadır. Aynı zamanda fiyat bilgisi nokta ile yazıldığında da dönülmektedir.
|
|
InvalidAvailableStock
|
Stok bilgisi tam sayı dışında bir değer girildiği zaman alınan hatadır.
|
|
InvalidDispatchTime
|
Kontrol edildiğinde ürün güncelleme işleminde " Girilen Fiyat indirim süresince geçerli değerden daha yüksek " olduğundan hata alınmıştır.
|
|
DiscountedListingPriceIncrease
|
Kontrol edildiğinde ürün güncelleme işleminde " Girilen Fiyat indirim süresince geçerli değerden daha yüksek " olduğundan hata alınmıştır.
|
|
MerchantAlreadyListedAgainstProduct
|
Ürün mükerrer yaratılmış gözükmektedir. Bu yüzden ürünü güncelleyemiyorsunuz. Askıda olan ürünün silinmesi gereklidir.
|
|
ListingDeletedRecently
|
Silinmiş yada listingler arasında olmayan sku için güncelleme gönderilemez.
|
|
ListingFrozen
|
Kilitli listing için güncelleme yapılamaz.
|
Hata Durumları
| Hata Kodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Username veya Password (Şifre) hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen ticket üzerinden entegrasyon ekibi ile iletişime geçiniz.
|
Envanterde Fiyat/Stok Bilgilerini Güncelleme – JSON Format
JSON Formatı ile Envanterde Fiyat Bilgilerini Güncelleme methodu ile sadece fiyat güncellemesi yapılabilmektedir.
Body’de hepsiburadaSku bilgisi ve merchantSku bilgisi tek başına olabilir veya ikiside aynı anda olabilir.
Üründe stok girilmiş ise ve fiyat’ı da sıfırdan büyük olarak güncellendiğinde ürün otomatik satışa açılacaktır.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Parametreler(Parameters)
| merchantid | (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) ; Her satıcı mağazanın/bayinin unique bilgisidir. |
| processid | (gerekli, guid, 32910839-83b9-4545-adb6-76dad457edc4) ; Hepsiburada sistemimizin her fiyat/stok güncelleme isteği için satıcıya iletim sağladığı unique bilgidir. |
Not
Tek mağaza için aynı anda POST ettiğiniz envanter güncelleme iletimlerinizin devam etme / bekleme sayısı, fiyat/stok güncelleme metodu için limit 10, ayrı ayrı fiyat ve stok JSON formatlı işlemleri için limit 5’i geçemez. Limit kuralına takılan satıcılarımız ‘Günlük Toplu Güncelleme Limitinizin Sınırını Aştınız’ hatası ile karşılaşır.
Eğer bir envanter satışa kapatılmak isteniyorsa stok veya fiyat bilgisinin sıfır gönderilmesi yeterlidir.
Eğer bir envanter satışa açılmak isteniyorsa fiyat ve stok bilgisinin sıfırdan farklı bir değer gönderilmesi yeterlidir.
Request body de sadece hepsiburadaSku veya sadece merchantSku parametresinin belirtilmesi yeterlidir.İkisininde aynı bodyde gönderilmesi zorunlu değildir.Satıcılarımız birini tercih edebilir.
- Göndermiş olduğunuz istek tarafınızdan başarılı bir şekilde Hepsiburada sistemine iletilmiş ise yukarıda Response Body örneğinde ifade edildiği üzere Process Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Process Id bilgisini tarafınızda kaydetmenizi ve 2.madde de ifade edilen GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
HepsiburadaSku
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
MerchantSku
|
Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Price
|
Envanterin fiyat bilgisidir.
|
Bilgi
JSON Formatı ile Envanterde Fiyat Bilgilerini Güncelleme İşlem Kontrolünü bu method ile sağlayabilirsiniz
JSON Formatı ile Envanterde Stok Bilgilerini Güncelleme methodu ile sadece stok güncellemesi yapılabilmektedir.
Body’de hepsiburadaSku bilgisi ve merchantSku bilgisi tek başına olabilir veya ikiside aynı anda olabilir.
Üründe fiyat girilmiş ise ve stok da sıfırdan büyük olarak güncellendiğinde ürün otomatik satışa açılacaktır.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Not
Göndermiş olduğunuz istek tarafınızdan başarılı bir şekilde Hepsiburada sistemine iletilmiş ise yukarıda Response Body örneğinde ifade edildiği üzere Process Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Process Id bilgisini tarafınızda kaydetmenizi ve 4.madde de ifade edilen GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
HepsiburadaSku
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
MerchantSku
|
Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
AvailableStock
|
Envanterin stok bilgisidir.
|
|
CriticalStock
|
Envanterin kritik stok bilgisidir. Bu miktarın altına düşen ürün otomatik satışa kapatılır.
|
Bilgi
JSON Formatı ile Envanterde Stok Bilgilerini Güncelleme İşlem Kontrolünü bu method ile sağlayabilirsiniz
Fiyat ve Stok İşlem Kontrolü Sonucu Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
Id
|
Hepsiburada sistemimizin her fiyat/stok güncelleme isteği için satıcıya iletim sağladığı unique bilgidir.
|
|
Status
|
Gönderilen requestin başarı durumunu belirtir. Done: Tamamlandı / Failed: Hata aldı.
|
|
CreatedAt
|
Envanter güncelleme isteğinin tarih ve saat bilgisidir.
|
|
Total
|
Envanter güncelleme işlemi için göndermiş olduğunuz request içerisindeki toplam envanter sayısıdır.
|
|
Errors.Errors.ElementNo
|
Envanter güncelleme işleminde göndermiş olduğunuz request içerisindeki envanter sırasını belirtir.
|
|
Errors.Errors.HepsiburadaSku
|
Envanterde ifade edilen hata alan ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
Errors.Errors.MerchantSku
|
Envanterde ifade edilen hata alan ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Errors.Errors.string
|
Hata alan envanterdeki ürünün hata nedenini belirtir.
|
Not
Envanter güncelleme isteğiniz başarısız ise ‘Güncelleme İsteği Sorgulaması Sonucunda Süreçte Hata İle Karşılaşılan Response Body ‘ örneklerinde ifade edildiği gibi hatanın neden kaynaklandığı bilgisini içeren bir Response satıcılarımız ile paylaşılacaktır.Response da dönen bilgileri dikkate alarak göndermiş olduğunuz istekte iyileştirilmesi gereken noktalar ile ilgili aksiyon alabilirsiniz.
Hata Durumları
| Hata Kodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Username veya Password (Şifre) hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen ticket üzerinden entegrasyon ekibi ile iletişime geçiniz.
|
Envanterde Fiyat/Stok Bilgilerini Bulk Güncelleme – JSON Format
JSON Formatı ile Envanterde Fiyat/Stok Bilgilerini Bulk Güncelleme methodumuz, tek bir istekte birden fazla mağaza/bayi için birden fazla ürün üzerinde farklı veya aynı fiyat/stok güncellemesi yapmaya olanak tanır.
Body’de hepsiburadaSku bilgisi ve merchantSku bilgisi tek başına olabilir veya ikiside aynı anda olabilir.
Body’de stok bilgisi ve fiyat bilgisi tek başına olabilir veya ikiside aynı anda olabilir.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Parametreler(Parameters)
| inventory-uploadsid | (gerekli, guid, 32910839-83b9-4545-adb6-76dad457edc4) ; Hepsiburada sistemimizin her fiyat/stok güncelleme isteği için satıcıya iletim sağladığı unique bilgidir. |
Not
Göndermiş olduğunuz istek tarafınızdan başarılı bir şekilde Hepsiburada sistemine iletilmiş ise yukarıda Response Body örneğinde ifade edildiği üzere Inventory Upload Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Inventory Upload Id bilgisini tarafınızda kaydetmenizi ve 2.madde de ifade edilen GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
HepsiburadaSku
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
MerchantSku
|
Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Price
|
Envanterin fiyat bilgisidir.
|
|
AvailableStock
|
Envanterin stok bilgisidir.
|
|
MerchantId
|
Her satıcı mağazanın/bayinin unique bilgisidir.
|
Bilgi
JSON Formatı ile Envanterde Fiyat/Stok Bilgilerini Bulk Güncelleme İşlem Kontrolünü bu method ile sağlayabilirsiniz
Not
Bulk methodu için query’den offset ve limit değerleri gönderilmezse default değerler baz alınır. Default değerler:
Offset = 0
Limit = 50
Envanterde Fiyat/Stok Bilgilerini Ana Satıcı Üzerinden Bulk Güncelleme – JSON Format
Bu method ile ana satıcınız (mega merchantınız) üzerinden mağaza/bayi bazlı tek seferde aynı fiyat/stok bilgisini gönderebilirsiniz.
Body’de hepsiburadaSku bilgisi ve merchantSku bilgisi tek başına olabilir veya ikiside aynı anda olabilir.
Üründe fiyat girilmiş ise ve stok da sıfırdan büyük olarak güncellendiğinde ürün otomatik satışa açılacaktır.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Not
Göndermiş olduğunuz istek tarafınızdan başarılı bir şekilde Hepsiburada sistemine iletilmiş ise yukarıda Response Body örneğinde ifade edildiği üzere Inventory Upload Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Inventory Upload Id bilgisini tarafınızda kaydetmenizi ve 2.madde de ifade edilen GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
HepsiburadaSku
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
MerchantSku
|
Envanterde ifade edilen ürünün satıcı tarafından tanımlanan unique kod bilgisidir.Satıcı stok kodu olarak ifade edilir.Satıcı tarafından ürün yaratılırken bu bilgi belirtilmiştir.
|
|
Price
|
Envanterin fiyat bilgisidir.
|
|
AvailableStock
|
Envanterin stok bilgisidir.
|
Bilgi
JSON Formatı ile Envanterde Ana Satıcı Üzerinden Fiyat/Stok Bilgilerini Bulk Güncelleme İşlem Kontrolünü bu method ile sağlayabilirsiniz
Not
Bulk methodu için query’den offset ve limit değerleri gönderilmezse default değerler baz alınır. Default değerler:
Offset = 0
Limit = 50
Hata Durumları
| Hata Kodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Username veya Password (Şifre) hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen ticket üzerinden entegrasyon ekibi ile iletişime geçiniz.
|
Envanteri Satışa Açma/Kapatma
Satışa açma ve satışa kapatma methodlarımıza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerini mağaza/bayi bazlı satışa açıp/kapatabilir.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
| merchantid | (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) ; Her satıcı mağazanın/bayinin unique bilgisidir. |
| sku | (gerekli, string, MTALTUSDERDONAL309) ; Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir. |
Parametreler(Parameters)
Not
Envanterdeki ürünü satışa açabilmek için stok ve fiyat bilgisinin daha önceden girilmiş olması gereklidir. Stok ve fiyat bilgisi 0 olan ürünler bu method üzerinden satışa açılamaz.
Hata Durumları
| Hata Kodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Username veya Password (Şifre) hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen ticket üzerinden entegrasyon ekibi ile iletişime geçiniz.
|