API Reference

Aksiyon Bekleyen Talep Bildirimi (awaitingaction)

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.

❗️

Önemli Uyarı

  • Servise response iletirken idempotent mantığını kullanmanız önerilir.
  • MissingInvoice (Eksik Fatura) için açılan talepler yine bu webhook üzerinden iletilecektir fakat kabul edebilmek için fatura yüklemesi gerektiği için Merchant portal'den bu kabul etme işlemi yapılabilir. İlerideki dönemde web servisle faturanın yükleneceği bir şekilde kabul işlemi alınabilecektir.

📘

https://{merchant_api_baseUrl}/claims/awaitingaction

Not: {api_baseUrl} sizin tarafımıza ileteceğiniz urldir. Bu url altında "/claims/awaitingaction" pathinde bir PUT method bulunmalıdır.

{
   "claimNumber":"356189794",
   "type":"Return",
   "quantity":1,
   "status":"AwaitingAction",
   "customerId":"b5b0f469-dd8f-4b99-bc64-1a1f9e78dfae",
   "customerName":"Hepsi Burada",
   "orderNumber":"2152988946",
   "explanation":"",
   "claimDate":"2021-10-14T11:03:17.676Z",
   "orderDate":"2021-10-14T11:00:20Z",
   "line":{
      "lineItemId":"61680dc6-b404-55fe-1171-d92506060606",
      "productName":"George Adams Erkek Klasik Gömlek",
      "listingId":"224a525b-54be-4c85-b8b7-a48883cf53c9",
      "merchantId":"1a514334-5b66-45f9-9f47-7223ed8ca1db",
      "hbSku":"GYGEO11009AXL",
      "merchantSku":"KIVIRCIK20",
      "price":{
         "currency":"TRY",
         "amount":56.0
      },
      "totalPrice":{
         "currency":"TRY",
         "amount":56.0
      },
      "productImageUrlFormat":"https://productimages.hepsiburada.net/s/7/{size}/9073518510130.jpg"
   },
   "reason":"",
   "reports":[

   ],
   "delivery":{
      "code":"6225816234669",
      "status":"Delivered",
      "direction":"CustomerToMerchant",
      "createdDate":"2021-10-14T11:03:17.781Z"
   },
   "requestedProduct":{
      "sku":"GYGEO11009AM",
      "variantProperties":[
         {
            "name":"Beden",
            "value":"M"
         },
         {
            "name":"Renk",
            "value":"Açık Mavi"
         }
      ],
      "changeOption":"WithDifferentVariant"
   }
}

204
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ı ExtraProduct: Satıcı tarafından fazla gönderilen ürünlerin geri gönderilmesi için kullanılan talep 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
Farklı varyant değişim talebi ile yeni istenen ürüne ait bilgilerdir. Yeni ürün taleplerinde (Aynı varyant) bu alan null gönderilir.