Müşteri talep (iade, değişim, eksik parça vs.) süreçlerinin entegrasyon ile yönetilmesini sağlamaktır. Entegrasyon modelimizde yer alan servislere ait detayları ilgili servisin altında yer alan linkler üzerinden erişebilirsiniz.
Önemli Bilgi
Bu dokümanda yer alan endpoint url'leri test ortamına aittir. Dokumanda sayfasında test ortam endpointleri test edilebilir. Canlı ortam url'leri endpoint içinde "-sit" ifadesi kaldırılarak oluşturabilirsiniz. Canlı ortam endpoint'ine canlı ortam için verilen User/Password ile istek gönderilebilir.
Hepsiburada API Authentication Bilgilendirmesi
Mevcuttaki tüm servislerimizin authentication yapısında değişiklik yapılmıştır. Sizlerden servislerimizdeki bu değişikliğin hızla yapılması noktasında desteğinizi rica ederiz.
Entegratöre Servis Anahtarı Ekleme/Görüntüleme işlemleri için hazırladığımız sayfamızı inceleyebilirsiniz.
Aksiyon Bekleyen Talep Bildirimi
Müşteri tarafından oluşturulup, satıcı tarafından aksiyon alınması gereken talep bilgilerinin bildirimi için satıcı tarafından oluşturulan servistir.
| Alan Adı | Açıklama |
|---|---|
|
claimNumber
|
Talebin unique numara bilgisi
|
|
type
|
Talebin tipi
|
|
quantity
|
Talebin miktarı
|
|
status
|
Talebin durumu
|
|
customerId
|
Müşteri unique id bilgisi
|
|
customerName
|
Müşteri adı
|
|
orderNumber
|
Sipariş numarası
|
|
explanation
|
Talep için müşteri açıklaması
|
|
claimDate
|
Talebin oluşturulma tarihi
|
|
orderDate
|
Sipariş tarihi
|
|
lineItemId
|
Kalem unique id
|
|
productName
|
Ürün adı
|
|
emaproductImageUrlFormat
|
Ürün resim linki
|
|
listingId
|
Kalem listing id
|
|
merchantId
|
Kalem mağaza id
|
|
hbSku
|
Kalem hb Sku
|
|
merchantSku
|
Kalem mağaza sku
|
|
price
|
Kalem fiyatı
|
|
totalPrice
|
Kalem toplam fiyatı
|
|
reports
|
Müşteri tarafından yüklenen rapor url bilgileri
|
|
delivery
|
Eğer müşteri tarafından satıcı deposuna geri iade edilen bi paket var ise bilgisi
|
|
Reason
|
Açıklama alanına gelebilecek değerler;
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
Değişim
|
|
requestedProduct
|
Değişim talebi ile yeni istenen ürüne ait bilgilerdir.
|
Yeni Ürün Opsiyonu
Bu method ile hem müşteri memnuniyetini arttırmak hem de sizlerin iade oranlarınızı düşürmek adına müşterilerimize kusurlu ya da yanlış ürün gönderimi olduğu durumda yeni ürün gönderimi opsiyonu sunmayı hedefliyoruz.
- Yeni ürün talebini onayla
- Ücret iadesini onayla.
- Talebi reddet. (ihtilaflı süreci)
- Yeni ürün talebini onayla
- Talebi reddet. (ihtilaflı süreci)
Test ortamında ürün değişim seçeneklerinde yukarıdaki kurallar geçerli değildir,sipariş oluştururken aşağıdaki kurallara dikkat etmenizi rica ederiz.
Ürün Değişimi Opsiyonu
Bu method ile hem müşteri memnuniyetini arttırmak hem de sizlerin satış kayıplarını önlemek adına müşterilerimize ürün değişim opsiyonu sunmayı hedefliyoruz. Bu method sadece Fashion kategorilerinde geçerlidir.
Test ortamında ürün değişim seçeneklerinde yukarıdaki kurallar geçerli değildir,sipariş oluştururken aşağıdaki kurallara dikkat etmenizi rica ederiz
Talep Kabul Etme (Accept Request)
Müşterilerin açtıkları talepleri kabul etmek için kullanılması gereken servistir.
Yeni Ürün Talebi İade İle Onaylama Sebepleri
Hata Durumları
| Hata Kodu | 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.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen Ticket ileterek entegrasyon ekibi ile iletişime geçiniz.
|
Talep Reddetme(Reject Request)
Müşterilerin açtıkları talepleri reddetmek için kullanılması gereken servistir.
Reddetme Sebepleri
Return(Iade) & RenewProduct(Temin) ve MissingItem (Eksik Urun) & MissingPart (Eksik Parca) alanında talep reddederken kullanılacak alanlar iletilmiştir. İletilen bilgilerin sol tarafı talep reddetme endointi içerisinde ClaimRejectionReason alanına gönderilmelidir. Sonraki açıklama kısmı gönderilmemelidir, girilecek alanların açıklamaları için verilmiştir.
Return(Iade) & RenewProduct(Temin)
MissingItem (Eksik Urun) & MissingPart (Eksik Parca)
Hata Durumları
| Hata Kodu | 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.
|
|
405
|
Not Allowed: Http Protokol hatası. Lütfen kontrol ediniz.
|
|
500
|
Internal Server: Lütfen Ticket ileterek entegrasyon ekibi ile iletişime geçiniz.
|
İhtilaflı Talep Kabul/Red Bildirimi
Müşterilerin açtıkları taleplerin Hepsiburada tarafından (ihtilaflı statüdeki) talebin onay/red sonucunu bildirmede kullanılmaktadır.
Talep Kabul/Red Sonucu Oluşan Paket Bildirimi (Claim Package)
Müşteri tarafından açılan taleplere istinaden müşteriye gönderilmesi gereken paketlerin oluşturulduğu endpointtir.
Alan Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
id
|
Paketin unique id bilgisi
|
|
status
|
Paketin durumu
|
|
customerId
|
Müşteri unique id bilgisi
|
|
barcode
|
Paketin barkod bilgisi
|
|
packageNumber
|
Paketin unqiue numarası
|
|
cargoCompany
|
Kargo firması adı
|
|
shippingAddressDetail
|
Alıcı adres bilgisi
|
|
recipientName
|
Alıcı adres adı
|
|
shippingCountryCode
|
Alıcı adres ülke kodu
|
|
shippingDistrict
|
Alıcı adres semt bilgisi
|
|
shippingTown
|
Alıcı adres ilçe bilgisi
|
|
shippingCity
|
Alıcı adres ili
|
|
email
|
E-mail adresi
|
|
phoneNumber
|
Telefon numarası
|
|
claims
|
Müşteri talebi
|
|
claims.id
|
Claim unique id bilgisi
|
|
claims.number
|
Claim unique numara bilgisi
|
|
claims.status
|
Claimin durumu
|
|
claims.claimType
|
Claimin tipi
|
|
claims.claimDate
|
Claim oluşturulma tarihi
|
|
claims.quantity
|
Claim miktarı
|
|
claims.explanation
|
Claim müşteri açıklaması
|
|
claims.refundAmount
|
Claim refund tutarı
|
|
claims.refundCurrency
|
Claim refund kuru
|
|
claims.refundDate
|
Claim refund tarihi
|
|
claims.merchantRejectionStatement
|
Mağaza ihtilaflı açıklaması
|
|
claims.sku
|
Ürün sku
|
|
claims.priceAmount
|
Ürün fiyatı
|
|
claims.totalPriceAmount
|
Kalem toplam fiyatı
|
|
claims.priceCurrency
|
Fiyat kuru
|
|
claims.orderNumber
|
Sipariş numarası
|
|
claims.orderDate
|
Sipariş tarihi
|
|
claims.customerName
|
Müşteri adı
|
|
claims.line
|
Talep kalem bilgisi
|
|
claims.line.lineItemId
|
Kalem unique id
|
|
claims.line.listingId
|
Kalem listing id
|
|
claims.line.merchantId
|
Kalem mağaza id
|
|
claims.line.hbSku
|
Kalem hb Sku
|
|
claims.line.merchantSku
|
Kalem mağaza sku
|
|
claims.line.quantity
|
Kalem miktarı
|
|
claims.line.price
|
Kalem fiyatı
|
|
claims.line.commission
|
Kalem komisyon bilgisi
|
|
claims.line.unitHBDiscount
|
Kalem hb indirim tutarı
|
|
claims.line.totalHBDiscount
|
Kalem toplam hb indiriim tutarı
|
|
claims.line.merchantUnitPrice
|
Mağaza fiyat bilgisi
|
|
claims.line.merchantTotalPrice
|
Mağaza toplam fiyat bilgisi
|
|
claims.line.customizedText01
|
Özelleştirilen ürün açıklaması 1
|
|
claims.line.customizedText02
|
Özelleştirilen ürün açıklaması 2
|
|
claims.line.customizedText03
|
Özelleştirilen ürün açıklaması 3
|
|
claims.line.customizedText04
|
Özelleştirilen ürün açıklaması 4
|
|
claims.line.productName
|
Ürün adı
|
|
direction
|
Paket yön bilgisi
|
|
slot
|
Paket slot bilgisi
|
Talep Detayını Listeleme
| Alan Adı | Açıklama |
|---|---|
|
Number
|
Oluşturulan talebin numarasıdır.
|
|
Status
|
Talebin durumu hakkında bilgi verir. NewRequest: Yeni talep / AwaitingAction: Merchant tarafından aksiyon bekleniyor. / InDispute: İhtilaflı / 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 / ExtraProduct: Satıcı tarafından fazla gönderilen ürünlerin geri gönderilmesi için kullanılan talep
|
|
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.
|
|
lineItemId
|
Her sipariş kaleminin unique bir tanımlayıcısıdır.
|
|
AwaitingActionExpireDate
|
Talep için aksiyon alınabilecek son tarih bilgisi.
|
|
MerchantSku
|
Satıcı stok kodu.
|
|
Reason
|
Açıklama alanına gelebilecek değerler;
PoorQuality: "Kalitesiz buldum",
ChangedMindOrUnlikedIt: "Ürünü almaktan vazgeçtim / beğenmedim",
ProductIsBroken: "Ürünüm arızalı geldi",
ProductIsDamaged: "Ürünüm hasarlı geldi",
SizeTooSmall: "Bedeni / boyutu küçük geldi",
SizeTooLarge: "Bedeni / boyutu büyük geldi",
MissingProduct: "Ürünün parçası eksik",
WrongProductOrderedByCustomer: "Yanlış sipariş verdim",
WrongProductSentByMerchant: "Siparişimden farklı ürün gönderildi",
NotArrivedInvoice: "Faturam gelmedi",
IncorrectInvoice: "Faturamda hata var",
MissingInvoice: "Faturamı kaybettim",
ProductHasExpired: "Ürünün son kullanma tarihi geçmiş",
ProductIsWrongWeight: "Ürünüm farklı gramajda geldi",
FoundCheaper: "Daha ucuzunu buldum",
IncompatiblyProduct: "Bedeni / boyutu uymadı",
ProductIsBrokenOrDamaged: "Bozuk / hasarlı geldi",
WrongProduct: "Yanlış ürün geldi",
NotArrivedWhenNeeded: "İhtiyacım olan zamanda gelmedi",
Other: "Diğer",
Değişim:
|
|
requestedProduct
|
Değişim talebi ile yeni istenen ürüne ait bilgilerdir.
|
|
finalizedWith
|
Onaylanan talebin onay türünü belirtir. (Refund: Ücret iadesi yapacağım, Change: Yeni ürün ile değiştireceğim)
|