Hepsiburada Market/Su/Çiçek Dikeyimizde Hizmet Veren Satıcılarımız,Siparişin İade Statü ve Akış Bilgilendirmesine Ait Web Servis Format Mimarisine Bu Sayfadan Erişim Sağlayabilirler.
Önemli
Talep Entegrasyonu methodlarımız ile ilgili sorularınız olması durumunda Sıkça Sorulan Sorular sayfamızı ziyaret edebilirsiniz.
Aksiyon Bekleyen Talep Bildirimi
Teslim Edildi statüsünde olan siparişler özelinde bir talep(iade) bulunuyor ise,talep verilerine ait detay bilgiler kalem bazlı(satır bazlı) olarak Hepsiburada tarafından,satıcılarımızın web servisine iletilir.Bu aşamada satıcılarımızın ilgili verileri kontrol etmesi ve talep için almak istediği aksiyonu kararlaştırması beklenir.
Aksiyon kararı verildikten sonra Talep Kabul Etme ve Talep Reddetme methodları kullanılarak nihai sonuç bildirilir.
Not
Webhook modeli ile çalışacak olan firmalarımızın aşağıda ifade edilen json kontrat ile bir web servis geliştirmeleri ve web servise ait BaseURL,username ve password bilgisini Hepsiburada Entegrasyon Ekibi’ne servis tanımı yapılabilmesi amacıyla ticket üzerinden iletmeleri gerekmektedir. (Web servis güvenliği Basic Auth ile sağlanır.)
Hepsiburada Webhook Servisleri üzerinde operasyonel akışı kesecek herhangi bir kontrol veya kısıt olmamalıdır.Siparişe ait veriler tarafınıza iletildikten sonra gerekli kontrollerinizi iç sistemlerinizde sağlayabilirsiniz.
IIS’de baseurl oluşturuldugunda default PUT servisi kapalı gelir, bunu açmanız gerekir.
- Method PUT olarak ifade edilir.
Hepsiburada Tarafına Tanım İçin İletilmesi Gereken Örnek Satıcı Web Servis Url Bilgisi
https://{merchant_api_baseUrl}/claims/awaitingaction
Hepsiburada Tarafından Web Servisinize İletilecek Örnek Json Request Formatı
{
"claimNumber":"592453523",
"type":"Return",
"quantity":1,
"status":"AwaitingAction",
"customerId":"8c53fe2f-910e-4689-bc63-b20cae6c824a",
"customerName":"Muhammet Furkan DOĞAN",
"orderNumber":"2739107065",
"explanation":"test",
"claimDate":"2021-08-13T10:34:53.888Z",
"orderDate":"2021-08-13T10:34:10Z",
"line":{
"lineItemId":"61164aa2-4578-ac16-cb5d-e95106060606",
"productName":"Pepsi Twist 1 Lt Pet",
"listingId":"8e7ea954-dffe-48ca-bafd-7873ca224a96",
"merchantId":"791b919d-6ad0-4413-a780-8c37e44878a4",
"hbSku":"HBV00000NE0PC",
"merchantSku":"TESTHX1234",
"price":
{"currency":"TRY","amount":10.0},
"totalPrice":{"currency":"TRY","amount":10.0},
"productImageUrlFormat":"https://productimages.hepsiburada.net/s/31/{size}/10336882884658.jpg"},
"reason":"Yanlış ürün geldi",
"reports":[{"imageUrl":"https://images.hepsiburada.net/mp/claim-test/2021/8/13/951f60cc-6bd5-4fff-a3d6-1e8a4c8645f3.png","reportedBy":"Admin"}],
"delivery":{"code":"50214399480711",
"status":"Delivered",
"direction":"CustomerToMerchant",
"createdDate":"2021-08-13T10:34:53.97Z"}
}
Response
Response 204 (Success)
Not
Servise response iletirken idempotent mantığını kullanmanız önerilir.
Alan Adı Açıklamaları
| Alan Adı | Açıklama |
|---|---|
|
claimNumber
|
Claim unique numara bilgisi.
|
|
type
|
Claimin tipi.
|
|
quantity
|
Claim miktarı.
|
|
status
|
Claimin durumu.
|
|
customerId
|
Müşteri unique id bilgisi.
|
|
customerName
|
Müşteri adı.
|
|
orderNumber
|
Sipariş numarası.
|
|
explanation
|
Claim müşteri açıklaması.
|
|
claimDate
|
Claim 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
|
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.
|