Satıcıya Sor Önemli Bilgiler

Hepsiburada üzerinden müşterilerin , iş ortaklarımıza sormuş olduğu soruların bu entegrasyon modeli üzerinden yönetilmesini sağlamanıza olanak tanımaktadır.

❗️

NOT

Dökümanlar içerisinde yer alan request’ler test ortamına ait olan requestlerdir. Canlı ortam için istek denemek istediğinizde , canlı ortam bilgileriniz ile request içerisinde yeralan ” -sit “ alanının kaldırılması gerekmektedir.
Canlı ortam için istek atılmadan önce "Canlı Ortam; Merchant Panel > Yardım > Satıcı Destek Talep Formu > API Entegrasyon > API Entegratör Yetkilendirme" İşlemleri kategorisinden talep açarak Satıcıya soru sorulabilsin mi ? seçeneğinin aktif edilmesi talep edilmelidir.

Soru Oluşturma

Bu işlev yalnızca TEST ortamında mevcuttur. Testlerinizi tamamlayabilmeniz için soru oluşturmanıza olanak tanır.

  • Merchantid (gerekli, guid, b2910839-83b9-4d45-adb6-86bad457edcb) Her satıcının unique bir tanımlayıcısıdır.

❗️

NOT

merchantId değeri headers kısmında gönderilmelidir.
istek alanında bulunan issueCount değeri oluşturmak istediğiniz soru sayısını ifade etmektedir.

Soru Listesi

Müşterilerin sordukların yönetilmesini sağlamaktadır. Müşterilerin sordukları sorular 3 farklı başlık altında toplanır.
Cevap Bekleyenler; Müşteri tarafından sorulmuş, henüz satıcı tarafından yanıtlanmamış sorular burada listelenir.

❗️

NOT

  • Satıcıların, müşteri sorularını cevaplamak için 2 iş günü hakkı vardır.
  • Kalan süre arka tarafta Hepsiburada tarafından hesaplanır ve ne zaman süresinin dolacağı “expireDate” alanında belirtilir.
  • Cevap bekleyen soruların statusu=1’dir.
  • Özellik AdıData TipiAçıklama
    Statusarray[integer]İlgili statüye göre 1,2,3,4 geçilebilir.
    sizeinteger($int32)Ne kadarlık bir soru listesi çekileceğini gösteren sayı.
    pageinteger($int32)Hangi sayfanın çekileceğini gösteren parametredir, ilk sayfa 1 ile başlamaktadır.
    sortByinteger($int32)0: Soru sorulma tarihine göre sıralar,
    1: Son güncellenme tarihine göre sıralar.
    0 veya 1 kullanılır.
    descbooleansortBy için seçilen alanın asc/desc oluşuna karar verir, parametre true/false olarak kullanılır.
    Alan AdıAçıklama
    createdAtSorunun müşteri tarafından sorulma tarihi
    issueNumberSoru numarası
    customerIdMüşterinin hepsiburada’da kayıtlı guid id’si
    orderNumberSiparişlerim sayfasından sorulmuşsa yani bir sipariş üzerinden sorulmuş ise dolu gelir, sipariş numarasıdır.
    lineItemIdSiparişlerim sayfasından sorulmuşsa yani bir sipariş üzerinden sorulmuş ise dolu gelir, siparişin kalemini belirtir.
    StatusSorunun statüsüdür. Olabilecek statüler: “WaitingforAnswer” (cevap bekleyen), “Answered” (cevaplanan), “Rejected” (sorun bildirilen), “AutoClosed” (gerekli süre içinde cevaplanmadığı için otomatik kapatılan.
    subject.idKonuya ait id bilgisidir
    subject. DescriptionKonunun türkçe karşılığıdır.
    lastContentHenüz cevaplanmamış ise sorulan soru, cevaplanmış veya sorun bildirilmiş ise girilen son metindir.
    conversations[x]. idYazışmaya ait id bilgisidir.
    conversations[x]. createdAtYazışmanın oluşturulduğu tarihtir
    conversations[x]. contentYazışma içeriğidir.
    conversations[x]. fromYazışmanın kime ait olduğudur, Customer/Merchant gelir.
    conversations[x]. files[y]Eklenen döküman
    conversations[x]. customerFeedbackMüşterinin verdiği feedback true/false gelir.
    conversations[x]. rejectReasonEğer cevaplamak yerine sorun bildirilirse bu alan dolar, girilen metin burada gösterilir.
    merchant.idMerchant id
    merchant.nameMerchant ismi
    product.skuÜrüne ait sku bilgisi
    product.nameÜrün ismi
    product.imageUrlÜrüne ait resmin url bilgisi
    product. stockCodeÜrüne ait ilgili satıcıdaki stok kodu bilgisi
    expireDateSorunun son cevap verilebileceği tarihtir, soru sorulduktan sonra 2 iş günü setlenir.
    lastModifiedAtSoru üzerinde yapılan son güncellenme tarihi

    Cevaplananlar; Satıcı tarafından yanıtlanmış ve/veya belirtilen süre içinde yanıtlanmamış yani süresi dolan sorular da burada listelenir.

    ❗️

    NOT

    Cevaplanan soruların statüsü: (Answered) status=2
    Süresi dolan soruların statüsü: (AutoClosed) status=4
    Bu iki statüyü birden çekmek için query parametresinde status=4&status=2 şeklinde kullanılmalıdır.

    Sorun Bildirilenler; Satıcı tarafından yanıtlanmamak üzere “Sorun bildirilen” sorular burada listelenir.

    ❗️

    NOT

    Sorun bildirilen soruların statüsü (Rejected) status=4

    Hata KoduHata Mesajı
    400Bad Request: URL içerisindeki parametreleri kontrol edin.
    401Unauthorized: Password ve şifre hatalı girilmiştir. Lütfen kontrol ediniz.
    404Not Found: URL hatalı gönderilmiştir. Lütfen kontrol ediniz.
    415 – 422Client Error: Gönderilen dosya tipi hatalıdır.
    500Internal Server: Lütfen Ticket ileterek entegrasyon ekibi ile iletişime geçiniz.

    Soru Detayının Çekilmesi

    Bu metod soruların detaylarının çekilmesine olanak tanır.

    Soru Cevaplama

    Bu metod müşterilerin sorularını cevaplamak için kullanılmalıdır.

    ❗️

    NOT

    Müşterilerin sorularını cevaplamak için satıcıların 2 iş günü hakkı vardır. Kalan süre arka tarafta Hepsiburada tarafından hesaplanır ve ne zaman süresinin dolacağı “expireDate” alanında belirtilir. Belirtilen süre içerisinde cevaplanmayan sorular cevaplanmaya çalışırsa servis buna izin vermeyip hata verecektir. Yine belirtilen süre içerisinde cevaplanmayan sorular sistem tarafından otomatik olarak AutoClosed statüsüne çekilecektir ve artık WaitingForAnswer statüsü için çekilen soru listesinde gelmeyecektir.

  • number (zorunlu) - Listede yer alan soru numarası geçilerek ilgili sorunun detayına erişilir.
  • ❗️

    NOT

    Merchant tarafından cevaplama işlemi metin ile birlikte ekran görüntüsü / resim v.s yapılmak isteniliyor ise ;

    .jpg, .pdf, .docx, .xlsx, .bmp, .png formatında ekleme yapılması gerekmektedir.

    Sorun Bildirme

    Müşterilerin soruları cevap vermeye uygun değil ise, soru sorulmamış ise, hakaret edilmiş ise vb. durumlarda soru cevaplanmamak üzere sorun bildirilebilir. Sorun bildirme işlemi yapıldıktan sonra müşteriye sorunun cevaplanmadığına dair bildirim ve mail gider. Sorun bildirirken girilen metin Hepsiburada içindir, burada girilen metin müşteriye gösterilmez. Müşteri sadece sorunun yanıtlanmadığını görür.

    • number (zorunlu) integer($int32) – Listede yer alan soru numarası geçilerek ilgili sorunun detayına erişilir.
    • Request Body (application/json)
    • merchantId header kısmında gönderilmelidir.

    Statü Bazlı Soru Sayısı

    Satıcılara ait bekleyen(waitingForAnswer), cevaplanmış (answered + autoClosed) ve sorun bildirilmiş (rejected) soru sayılarına erişilmesini sağlar.

    Soruların Filtrelenmesi

    Soru listesi içerisinde filtreleme işlemleri yapılabilmesine olanak tanımaktadır.
    Filtreleme yapılabilecek alanlar aşağıdaki gibidir.
    Sorunun İletildiği Yere Göre
    sipariş veya ürün detay üzerinden filtreleme yapılabilmektedir.
    Soru Sorulma Tarihine Göre
    Tarih parametreleri seçilerek , tarih bazlı sorulara erişilebilinir.
    Son Güncellenme Tarihine Göre
    Konu başlığına Göre Listeleme
    Mesaj Numarasına Göre Listeleme