Önemli
Talep Entegrasyonu methodlarımız ile ilgili sorularınız olması durumunda Sıkça Sorulan Sorular sayfamızı ziyaret edebilirsiniz.
Talep Oluşturma
Bu methodumuza entegre olan satıcılarımız,statüsü Teslim Edildi olarak ifade edilen siparişler için kalem bazlı talep(iade) başlatabilir.
- 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. |
Alan Adı Açıklamaları
Alan Adı |
Açıklama |
|---|---|
|
CarrierId
|
89100 : Taşımacılık firmadadır. 50 : Taşımacılık Hepsiburada ekibindedir. Boş gönderilebilir.
|
|
Reasons
|
ProductIsBrokenOrDamaged: "Bozuk / hasarlı geldi"
NotArrivedWhenNeeded: "İhtiyacım olan zamanda gelmedi"
FoundCheaper: "Daha ucuzunu buldum"
PoorQuality: "Kalitesiz buldum"
IncompatiblyProduct: "Bedeni / boyutu uymadı"
MissingProduct: "Siparişimde eksik ürün var"
WrongProduct: "Yanlış ürün geldi"
Siparişim Teslim Edildi görünmesine rağmen Teslim Edilmedi"
ProductHasExpired: "Son kullanma tarihi geçmiş"
|
|
Reports
|
Base64 tipinde iade resmi gönderilebilir. Zorunlu alan değildir.
|
|
RequestedProduct
|
Talep edilen üründür. Boş gönderilebilir.
|
|
UserId
|
String değer olup customer’a ait unique değerdir. Boş gönderilebilir.
|
|
ClaimType
|
Return : "İade"
|
|
Explanation
|
İade talebi oluşturma açıklaması.
|
|
OrderLineId
|
Kalem unique id bilgisi.
|
|
Quantity
|
İade miktar adedi.
|
Hata Durumları
| HataKodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Password ve şifre hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz. İstek gönderdiğiniz lineitemId ile işlem yapılamamaktadır.Id bulunmamaktadır veya MerchantId değeri bulunamamaktadır.Değerleri 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.
|
Talep Kabul Etme
Bu methodumuza entegre olan satıcılarımız,açılan taleplerin(iadelerin) satıcı tarafından kabul edildiği bildirimini gönderebilir.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Parametreler(Parameters)
| number | Her talebin(iadenin) unique talep numarasıdır.(claimNumber) |
Hata Durumları
| HataKodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Password ve şifre hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz. İstek gönderdiğiniz lineitemId ile işlem yapılamamaktadır.Id bulunmamaktadır veya MerchantId değeri bulunamamaktadır.Değerleri 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.
|
Talep Reddetme
Bu methodumuza entegre olan satıcılarımız,açılan taleplerin(iadelerin) satıcı tarafından kabul edilmediği bildirimini gönderebilir.
- API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.
Parametreler(Parameters)
| number | Her talebin(iadenin) unique talep numarasıdır.(claimNumber) |
Reddetme Sebepleri
BoxIsEmpty = 0,:
WrongProduct = 1,:
ProductIsDamaged = 2,:
NoSuchAccessory = 3,:
ItHasBeenSentWithOtherProducts = 4,:
ThereIsNoCargoReport = 5,:
CustomerReturnedWrongItem = 6,:
CustomerPackageIsNotInTheConditionISent = 7,:
ProductHasBeenUsed = 8,:
ProductIsNotInSellableCondition = 9,:
MissingInvoice = 10,:
SomePartsOrSomeAccessoriesOrSomePapersAreMissing = 11
Hata Durumları
| HataKodu | Hata Mesajı |
|---|---|
|
400
|
Bad Request: URL içerisindeki parametreleri kontrol edin.
|
|
401
|
Unauthorized: Password ve şifre hatalı girilmiştir. Lütfen kontrol ediniz.
|
|
404
|
Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz. İstek gönderdiğiniz lineitemId ile işlem yapılamamaktadır.Id bulunmamaktadır veya MerchantId değeri bulunamamaktadır.Değerleri 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.
|
Talep Detayını Listeleme
Bu methodumuza entegre olan satıcılarımız,tüm statülerdeki açılan taleplerin(iadelerin) statü bazlı veri bilgisini temin edebilir.
- 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. |
| status | talep(iade) statüleridir. (‘NewRequest’ , ‘AwaitingAction’ , ‘InDispute’ , ‘Accepted’ , ‘Rejected’ , ‘Refunded’ , ‘Cancelled’) değerlerini alabilir. |
| Limit ve Offset | Limit ve Offset parametreleri pagenation yapısı olarak işlev görmektedir. Limit bir sayfada kaç adet talebin listeleneceğini belirtirken, Offset hangi talebin sonraki taleplerinin gösterileceğini belirtir. Örneğin Limit:10 Offset:0 gönderildiğinde ilk 10 talep listelenecektir. Limit:10 Offset:10 gönderildiğinde ilk 10 talepten sonraki 10 talep listelenecektir. |
| beginDate ve endDate | beginDate ve endDate parametrelerini kullanarak tarih kısıtlaması sağlayabilirsiniz.Bu alan kullanımı opsiyoneldir. Format: &beginDate={yyyy-MM-dd HH:mm}&endDate={yyyy-MM-dd HH:mm} |
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
Number
|
Oluşturulan talebin numarasıdır.
|
|
Status
|
Talebin durumu hakkında bilgi verir. NewRequest: Yeni takep / AwaitingAction: Merchant tarafından aksiyon bekleniyor. / InDispute: İtilaflı / Accepted: Kabul edilmiş. / Rejected: red edildi. / Refunded: İade talepleri için müşteriye ödemesi yapıldı. / Cancelled: Talep kapatıldı.
|
|
ClaimType
|
Talebin hangi konu için açıldığını bildirir. Return: İade talebi / Missingpart: / Missingıtem: Eksik parça talebi / Damagedwithreport: Hasarlı ürün talebi / Wrongproduct: yanlış ürün talebi / Undeliveredproduct: Teslim edilemeyen ürün talebi / MissingInvoice: Eksik fatura talebi / Missingwaranty: Eksik garanti talebi
|
|
ClaimDate
|
Talebin oluşturulma tarihidir.
|
|
Quantity
|
Talep kaleminin adet bilgisidir.
|
|
Explanation
|
Talebin açıklama bilgisidir.
|
|
RefundAmount
|
İade edilen tutarın bilgisidir.
|
|
RefundCurrency
|
Talep içerisindeki tutarın para birimi cinsinden değeridir..
|
|
OrderNumber
|
Paketin bağlı olduğu sipariş numarasıdır.
|
|
OrderDate
|
Paketin bağlı olduğu siparişin tarih bilgisini verir.
|
|
CustomerName
|
Sipariş sahibinin adıdır.
|
|
MerchantRejectionStatement
|
Merchantın red nedeninin açıklamasıdır.
|
|
Reason
|
Seçilen talep nedenidir.
Kalitesiz buldum
Daha ucuzunu buldum
Bedeni / boyutu uymadı
Bozuk / hasarlı geldi
Ürünün parçası eksik
Yanlış ürün geldi
Diğer Faturam gelmedi
Faturamda hata var
Faturamı kaybettim
İhtiyacım olan zamanda gelmedi
Ürünün son kullanma tarihi geçmiş
Ürünüm farklı gramajda geldi
|