Talep Önemli Bilgiler

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.

  • 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 portallerden bu kabul etme işlemi yapılabilir. İlerideki dönemde web servisle faturanın yükleneceği bir şekilde kabul işlemi alınabilecektir.
  • Alan Açıklamaları
    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.

  • Müşteriler ürünü teslim aldıktan sonra yeni ürün talebi oluşturabilir.
  • Yeni ürün talep edilecek ürünün stoğu minimum 5 ise bu talep oluşturulabilir.
  • Satın alınan satıcı gönderim yapamaz ise farklı bir satıcıya transfer olabilir.
  • Müşterinin değişim ürün kargo bedeli satıcıya aittir.
  • Yeni ürün talep edilen ürünün fiyatında değişim olması bu talebin açılmasını engellemez.
  • Satıcı eğer ürünü kusurlu ya da yanlış göndermiş ise aradaki fiyat farkı satıcıya aittir.
  • Satıcı ürünü teslim aldıktan sonra , 48 saat içerisinde yeni ürün talebine cevap vermelidir.
  • Satıcı kusurlu ürün için açılan iade talebine 3 şekilde cevap verebilir;
    • Yeni ürün talebini onayla
    • Ücret iadesini onayla.
    • Talebi reddet. (ihtilaflı süreci)
  • Satıcı yanlış ürün için açılan iade talebine 2 şekilde cevap verebilir;
    • Yeni ürün talebini onayla
    • Talebi reddet. (ihtilaflı süreci)
  • Satıcının talebi iade ile onaylaması durumunda iade süreci başlar.
  • Satıcının talebe yanıt vermemesi durumunda yeni ürün talebi ürün gönderimi ile onaylanır.
  • Yeni ürün talebini kabul eden satıcı, ürünü müşteriye göndermezse mevcut ceza süreçleri işler.

  • 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.
  • Sipariş yaratılırken KDV Oranı %10 ve %20 olacak şekilde oluşturulmalıdır.
  • Sipariş numarası 10 haneli olmalıdır.
  • Not: Ürün değişim onaylama servisinde body bilgisi gönderilmez ise değişim olarak onaylanmaktadır.
  • Ü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.

  • Müşteriler ürünü teslim aldıktan sonra değişim talebi oluşturabilir.
  • Değişim talebi sadece müşterinin sipariş verdiği satıcı üzerinden yapılabilir.
  • Ürünün stok durumuna göre renk ve/veya beden değişimi yapılabilir.
  • Müşterinin değişim ürün kargo bedeli satıcıya aittir.
  • Değişim talep edilen ürün fiyatı satın alınan ürün ile %5 -+ olabilir. Bu fark satıcıya aittir.
  • Değişim onaylandığında iade gelen ürün için kesilen fatura iptal edilerek, yeni ürün için yeni fatura kesilmesi gerekmektedir.
  • Satıcı ürünü teslim aldıktan sonra , 48 saat içerisinde değişim talebine cevap vermelidir.
  • Satıcı talebe 3 şekilde cevap verebilir;
  • Ürün değişimini onayla
  • Ücret iadesini onayla.
  • Talebi reddet. (ihtilaflı süreci)
  • Satıcının talebi iade ile onaylaması ya da talebe yanıt vermemesi durumunda iade süreci başlar.
  • Değişim talebini kabul eden satıcı, ürünü müşteriye göndermezse mevcut ceza süreçleri işler.
  • Kusurlu/hasarlı ürün değişimi de bu uygulama üzerinden gerçekleşir.
  • Müşteriye değişim yapabileceği ürün seçenekleri sunulurken ana ürüne fiyatına göre varyantlar arasında en fazla %5 oranında yukarı yönlü fiyat farkı olabilecek seçenekler sunulacaktır. Bu aradaki farkın satıcı tarafından karşılanması beklenmektedir.

  • 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
  • Sipariş yaratılırken KDV Oranı %8 ve %18 olacak şekilde oluşturulmalıdır.
  • Sipariş numarası 10 haneli olmalıdır.
  • Not: Ürün değişim onaylama servisinde body bilgisi gönderilmez ise İade olarak onaylanmaktadır
  • 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

  • StockProblem
  • ProductNotDefective
  • Other
  • 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

  • BoxIsEmpty = 0,
  • WrongProduct = 1,
  • ProductIsDamaged = 2,
  • NoSuchAccessory = 3,
  • ItHasBeenSentWithOtherProducts = 4,
  • ThereIsNoCargoReport = 5,
  • CustomerReturnedWrongItem = 6,
  • CustomerPackageIsNotInTheConditionISent = 7,
  • ProductHasBeenUsed = 8,
  • ProductIsNotInSellableCondition = 9,
  • MissingInvoice = 10,
  • SomePartsOrSomeAccessoriesOrSomePapersAreMissing = 11
  • StockProblem = 12 (Sadece Yeni Ürün Talebi için kullanılır.)
  • ProductNotDefective = 13 (Sadece Yeni Ürün Talebi için kullanılır.)
  • Other = 14 (Sadece Yeni Ürün Talebi için kullanılır)
  • MarkedAsServiceProcess
  • 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

  • Limit Offset pagenation yapısı olarak işlev görmektedir. Limit bir sayfada kaç adet talep listeleneceğini belirtirken, Offset hangi talepten sonraki siparişlerin gösterileceğini belirtir.
  • 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.
  • Limit Offset kullanılması zorunludur.
  • Opsiyonel olan begindate ve enddate parametrelerini kullandığınızda talep detaylarınızı belirli bir tarih arasında listeleyebilirsiniz, Limit Offset kullanılması zorunludur.
  • **Alan Açıklamaları**
    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)