Önemli
Üstü Çizili Fiyat Entegrasyonu methodlarımız ile ilgili sorularınız olması durumunda Sıkça Sorulan Sorular sayfamızı ziyaret edebilirsiniz.
Not
Aynı merchant ve aynı sku değeri için çift indirim tanımlanmaması adına servisimize istek gönderirken tarafınızdan double call’ı önlemenizi rica ederiz.
Üstü Çizili(İndirimli) Fiyat Yaratma
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde “Satışta” ifade edilen ürünlerine ait belirtilen zaman aralığında ürünün indirimli fiyattan satılmasını mağaza/bayi bazlı yönetebilir.
- 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
Göndermiş olduğunuz istek tarafınızdan başarılı bir şekilde Hepsiburada sistemine iletilmiş ise Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Id bilgisini tarafınızda kaydetmenizi ve İndirimi Id Bazlı Sorgulama methodunda ifade edilen GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
Hata Durumları
Hata Kodu |
Hata Mesajı |
|---|---|
|
1043 - FailedToCreateProductCampaignException
|
Ürün Kampanyası Oluşturulamadı.
|
|
1033 - ListingDiscountTargetsNotValidException
|
Listeleme İndirim Hedefleri Geçerli Değil.
|
|
1158-Discount's end date may not be less than its start date...
|
Indirim bitiş tarihi başlangıç tarihinden küçük olamaz.
|
Bulk Üstü Çizili(İndirimli) Fiyat Yaratma
Bu method tek bir bulk isteğinde birden fazla mağaza/bayi için ürünlerde indirim tanımlamanıza olanak tanı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 Id bilgisi sistemimiz tarafından sizlere iletilecektir, bu Id bilgisini tarafınızda kaydetmenizi ve Bulk Yaratılan İndirimi Sorgulama GET methodunu kullanarak güncelleme isteğinizin nihai sonucunu öğrenmenizi öneririz.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
discountName
|
İndirim Adı.
|
|
discountAmount
|
İndirim Tutarı.
|
|
shortDescription
|
İndirim Açıklaması.
|
|
startDate
|
İndirim Başlama Tarihi.
|
|
endDate
|
İndirim Sonlanma Tarihi.
|
|
includedSkus
|
Envanterde ifade edilen ürünün Hepsiburada sistemi tarafından tanımlanan unique kod bilgisidir.
|
|
includedMerchantSkus
|
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.
|
Üstü Çizili(İndirimli) Fiyat Bilgileri Güncelleme
Bu method üründe yarattığınız indirim bilgilerinde güncelleme yapabilmenize olanak tanır.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Hata Durumları
Hata Kodu |
Hata Mesajı |
|---|---|
|
1028 - ListingDiscountAlreadyRemovedException
|
Listing İndirimi Önceden Kaldırılmış.
|
|
1030 - ListingDiscountNotFoundException
|
Listing İndirimi Bulunamadı.
|
|
1043 - FailedToCreateProductCampaignException
|
Ürün Kampanyası Oluşturulamadı.
|
|
1032 - ListingDiscountHasOngoingTasksException
|
Listing İndiriminin Devam Eden Görevleri Var.
|
|
1051 - ListingDiscountTargetsNotValidException
|
Listing İndirim Hedefleri Geçerli Değil.
|
|
1162 - Listing discount with id f04dabda-fe87-4c43-b568-005eed0855e1 which is already over cannot be updated.
|
Bitmiş olan indirim için güncelleme işlemi uygulanamaz.
|
|
1158-Discount's end date may not be less than its start date...
|
Indirim bitiş tarihi başlangıç tarihinden küçük olamaz.
|
Bulk Üstü Çizili(İndirimli) Fiyat Bilgileri Güncelleme
Bu method tek bir bulk isteğinde birden fazla mağaza/bayi için ürünlerde tanımlanmış indirim bilgilerinde güncelleme yapmanıza olanak tanır.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Ana Satıcı Üzerinden Bulk Üstü Çizili(İndirimli) Fiyat Bilgileri Yaratma
Bu method ile ana satıcınız (mega merchantınız) üzerinden mağaza/bayi bazlı tek seferde aynı üstü çizili fiyat bilgisini gönderebilirsiniz.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Ana Satıcı Üzerinden Bulk Üstü Çizili(İndirimli) Fiyat Bilgileri Güncelleme
Bu method ile ana satıcınız (mega merchantınız) üzerinden yaratmış olduğunuz mağaza/bayi bazlı üstü çizili fiyat bilgilerinizi bulk(toplu) şekilde güncelleyebilirsiniz.
Aktif veya henüz aktif olmamış indirimli fiyatlarınızı bu metod ile güncelleyebilirsiniz.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Not
Ana satıcı üzerinden oluşturulan bulk üstü çizili fiyat işlemlerinizi ve bu işlemlere ait güncelleme işlemlerinizi Ana Satıcı Üzerinden Yaratılan/Güncellenen Bulk İndirim Sorgulama metodu ile sorgulayabilirsiniz.
Üstü Çizili(İndirimli) Fiyat Bilgilerini Silme
Bu method indirimi silmenize olanak tanır.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Not
Aktif olan bir discount silinemez. Öncelikle PUT method ile discount sonlandırılmalıdır.
Hata Durumları
Hata Kodu |
Hata Mesajı |
|---|---|
|
1028 - ListingDiscountAlreadyRemovedException
|
Listing İndirimi Önceden Kaldırılmış.
|
|
1159 - Listing discount with id 71ac9c37-e29c-47de-9537-4382f0a17918 which is already active cannot be deleted
|
Aktif olan indirim için silinme işlemi uygulanamaz.
|
|
1031 - FailedToUpdateProductCampaignException
|
Ürün Kampanyası Güncellenemedi.
|
|
1050 - ListingDiscountHasOngoingTasksException
|
Listing İndirim Hedefleri Geçerli Değil.
|
|
1161-Listing discount with id 3dc7b5c5-2bb8-4f25-88f4-afab90e7288e which is already paused cannot be deleted
|
Duraklatılmış olan indirim için silinme işlemi uygulanamaz.
|
|
1160-Listing discount with id 71ac9c37-e29c-47de-9537-4382f0a17918 which is already over cannot be deleted
|
Bitmiş olan indirim için silinme işlemi uygulanamaz.
|
İndirimi Id Bazlı Sorgulama
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait Üstü Çizili(İndirimli) Fiyat Yaratma methodunu kullanarak yaratmış olduğu indirim detaylarına 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.
Parametreler(Parameters)
| merchantid | (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) ; Her satıcı mağazanın/bayinin unique bilgisidir. |
| DiscountId | Envanterde Üstü Çizili(İndirimli) Fiyat Yaratma methodunun response'da elde edilen unique id değeridir. |
| Status Bilgileri | All status : 0 Passive: 1 Active : 2 Paused: 3 Ended : 4 Eğer status 1,2,3,4 dışında bir statü ile servis çağırılır ise , response'ta tüm statüleri getirecektir. |
İndirimi Statü Bazlı Sorgulama
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait Üstü Çizili(İndirimli) Fiyat Yaratma methodunu kullanarak yaratmış olduğu indirim detaylarına 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.
Not
GetByMerchantIdAndStatus 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
Bulk Yaratılan İndirimi Sorgulama
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait Bulk Üstü Çizili(İndirimli) Fiyat Yaratma methodunu kullanarak yaratmış olduğu indirim detaylarına 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.
Bulk Güncellenen İndirimi Sorgulama
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait Bulk Üstü Çizili(İndirimli) Fiyat Bilgileri Güncelleme methodunu kullanarak yaratmış olduğu indirim detaylarına 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.
Ana Satıcı Üzerinden Yaratılan/Güncellenen Bulk İndirim Sorgulama
Bu methodumuza entegre olan satıcılarımız,envanter listelerinde ifade edilen ürünlerine ait Ana Satıcı Üzerinden Bulk Üstü Çizili(İndirimli) Fiyat Bilgileri Yaratma ve Güncelleme methodunu kullanarak yaratmış olduğu indirim detaylarına 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.