N11 API · Soru-cevap

N11 müşteri soruları API: listeleme, detay ve cevaplama

N11 müşteri soruları SOAP ProductService üzerinden yönetilir: GetProductQuestionList soruları listeler, GetProductQuestionDetail tek sorunun ayrıntısını verir, SaveProductAnswer cevabı kaydeder. Liste dakikada yalnız bir kez çekilebilir; startDate, endDate, currentPage ve pageSize zorunludur ve tarihler GG/AA/YYYY biçimindedir. Her soru bir kez cevaplanır, cevap 1 ile 2.048 karakter arasında olmalıdır.

SOAPhttps://api.n11.com/ws/productService.wsdlMetotlar: GetProductQuestionList, GetProductQuestionDetail, SaveProductAnswer.

Soruları listelemek

GetProductQuestionListRequest, auth bloğundan sonra productQuestionSearch ve pagingData bloklarını alır.

AlanZorunluAçıklama
productQuestionSearch.startDateEvetGG/AA/YYYY, örneğin 11/03/2026
productQuestionSearch.endDateEvetGG/AA/YYYY
productQuestionSearch.statusHayırOPEN ya da CLOSED; boşsa OPEN
productQuestionSearch.productIdHayırN11 ürün numarası
productQuestionSearch.buyerEmailHayırMüşteri e-postası
productQuestionSearch.subjectHayırSoru konusu
pagingData.currentPageEvet0'dan başlar
pagingData.pageSizeEvetSayfadaki soru sayısı

Yanıtta her productQuestion için id, productId, productTitle, question, questionSubject ve varsa answer gelir. pagingData altında totalCount ve pageCount bulunur. Listede soru tarihi yer almaz.

Ayrıntı ve cevap

GetProductQuestionDetail, listeden gelen id değerini productQuestionId alanında alır. Yanıt; soru tarihi (questionDate), cevap ve cevap tarihi (answer, answeredDate), müşteri adı ve e-postası, ürün durumu, sorunun durumu ve paylaşım tercihlerini (buyerExpose, sellerExpose) verir. Soru tarihine ihtiyacınız varsa bu servisi çağırmanız gerekir.

SaveProductAnswer iki alanla çalışır: productQuestionId ve answer. Kurallar şunlardır:

  • Cevap en az 1, en fazla 2.048 karakter olabilir.
  • Bir soru yalnız bir kez cevaplanır.
  • Cevap gönderilince sorunun durumu CLOSED olur.

Yanıtta result.status success ya da failure döner. Cevap metnindeki & ve < gibi karakterleri XML kaçış karakteriyle yazın.

Sınırlar ve tasarım önerileri

Soru listesi dakikada bir kez çekilebilir; daha sık istek uyarı mesajı döndürür. Bu sınır üç tasarım kararını zorunlu kılar:

  • Önbellek: Son listeyi en az bir dakika saklayın. Kullanıcı arayüzündeki her yenileme N11'e gitmemeli.
  • Tek çağrı: Açık ve kapalı soruları ayrı ayrı çekmek iki istek demektir. Hangi listenin gerçekten gerektiğine karar verin.
  • Yerel güncelleme: Cevap gönderdikten sonra listeyi yeniden çekmek yerine soruyu kendi tarafınızda cevaplandı olarak işaretleyin.

Status boş bırakıldığında yalnız açık (OPEN) sorular gelir. Cevaplanmış soru arşivi istiyorsanız CLOSED değeriyle ayrı bir sorgu yapın.

Sık hatalar

  • startDate boş: Tarih alanları zorunludur; boş gönderilirse istek reddedilir.
  • Yanlış tarih biçimi: Dokümandaki biçim GG/AA/YYYY'dir.
  • Aynı soruyu iki kez cevaplamak: İkinci cevap kabul edilmez; cevabı göndermeden önce kontrol edin.
  • Kimlik doğrulama hatası: REST çalışırken SOAP'ta doğrulama hatası alıyorsanız auth bloğundaki değerlerde boşluk olup olmadığına bakın.

Hızlı cevabın satışa etkisini anlatan yazımız: müşteri sorularına hızlı cevap.

Sık sorulanlar

N11 soruları REST API ile alınabilir mi?

Hayır. N11 ürün soruları yalnız SOAP ProductService ile sunuluyor. Listeleme, ayrıntı ve cevaplama metotları aynı WSDL altındadır.

N11 soru listesi ne sıklıkla çekilebilir?

Dakikada bir kez. Daha sık istek atıldığında N11 uyarı mesajı döner. Listeyi en az bir dakika önbellekte tutmak gerekir.

N11 soru cevabı kaç karakter olabilir?

En az 1, en fazla 2.048 karakter. Her soru bir kez cevaplanır ve cevaptan sonra sorunun durumu CLOSED olur.

Soru tarihi neden listede yok?

GetProductQuestionList yanıtı soru tarihini içermez. Tarih ve müşteri bilgisi GetProductQuestionDetail servisinden soru bazında alınır.

Kaynaklar

İlgili N11 API konuları

Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı

N11 entegrasyonunu kod yazmadan kurun

Saystok bu API'lerle stok, sipariş ve fiyatı sizin yerinize eşitler. 30 gün ücretsiz.