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.
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.
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 Tipi | Açıklama |
|---|---|---|
| Status | array[integer] | İlgili statüye göre 1,2,3,4 geçilebilir. |
| size | integer($int32) | Ne kadarlık bir soru listesi çekileceğini gösteren sayı. |
| page | integer($int32) | Hangi sayfanın çekileceğini gösteren parametredir, ilk sayfa 1 ile başlamaktadır. |
| sortBy | integer($int32) | 0: Soru sorulma tarihine göre sıralar, 1: Son güncellenme tarihine göre sıralar. 0 veya 1 kullanılır. |
| desc | boolean | sortBy için seçilen alanın asc/desc oluşuna karar verir, parametre true/false olarak kullanılır. |
| Alan Adı | Açıklama |
|---|---|
| createdAt | Sorunun müşteri tarafından sorulma tarihi |
| issueNumber | Soru numarası |
| customerId | Müşterinin hepsiburada’da kayıtlı guid id’si |
| orderNumber | Siparişlerim sayfasından sorulmuşsa yani bir sipariş üzerinden sorulmuş ise dolu gelir, sipariş numarasıdır. |
| lineItemId | Siparişlerim sayfasından sorulmuşsa yani bir sipariş üzerinden sorulmuş ise dolu gelir, siparişin kalemini belirtir. |
| Status | Sorunun 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.id | Konuya ait id bilgisidir |
| subject. Description | Konunun türkçe karşılığıdır. |
| lastContent | Henüz cevaplanmamış ise sorulan soru, cevaplanmış veya sorun bildirilmiş ise girilen son metindir. |
| conversations[x]. id | Yazışmaya ait id bilgisidir. |
| conversations[x]. createdAt | Yazışmanın oluşturulduğu tarihtir |
| conversations[x]. content | Yazışma içeriğidir. |
| conversations[x]. from | Yazışmanın kime ait olduğudur, Customer/Merchant gelir. |
| conversations[x]. files[y] | Eklenen döküman |
| conversations[x]. customerFeedback | Müşterinin verdiği feedback true/false gelir. |
| conversations[x]. rejectReason | Eğer cevaplamak yerine sorun bildirilirse bu alan dolar, girilen metin burada gösterilir. |
| merchant.id | Merchant id |
| merchant.name | Merchant 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 |
| expireDate | Sorunun son cevap verilebileceği tarihtir, soru sorulduktan sonra 2 iş günü setlenir. |
| lastModifiedAt | Soru ü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 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. |
| 415 – 422 | Client Error: Gönderilen dosya tipi hatalıdır. |
| 500 | Internal 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.
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