Servisler
| İşlem | Yöntem ve yol |
|---|---|
| Ürün sorularını listeleme | GET /pim/vendor/{vendor}/question/filter |
| Tek ürün sorusu | GET /pim/vendor/{vendor}/question/{questionId} |
| Ürün sorusunu yanıtlama | POST /pim/vendor/{vendor}/question/{questionId}/answer |
| Sipariş sorularını listeleme | GET /pim/vendor/{vendorID}/order-question/filter |
| Tek sipariş sorusu | GET /pim/vendor/{vendorID}/order-question/{questionId} |
| Sipariş sorusunu yanıtlama | POST /pim/vendor/{vendorID}/order-question/{questionId}/answer |
Soru servisleri sipariş servisleri gibi /oms altında değil, /pim/vendor altında durur. Yoldaki {vendor} ve {vendorID}, Satıcı ID'nizdir.
İki soru türünün iş akışı farklıdır. Ürün sorusu vitrinde herkese görünür; verdiğiniz cevap diğer alıcıları da etkiler. Sipariş sorusu ise yalnız o siparişi veren müşteriyle aranızdadır ve genelde kargo süresi, fatura ya da ürün değişimi gibi konuları içerir. Bu yüzden sipariş sorularında orderNumber ve shipmentId ile siparişi bulup cevabı somut bilgiyle vermek gerekir.
Filtre parametreleri
| Parametre | Ürün soruları | Sipariş soruları |
|---|---|---|
| page | Var, varsayılan 1 | Var, varsayılan 1 |
| limit | En fazla 50, varsayılan 10 | Varsayılan 10 |
| startDate, endDate | Milisaniye zaman damgası | Milisaniye zaman damgası |
| sort | newest (varsayılan), oldest | newest (varsayılan), oldest |
| barcode | Var | Yok |
| orderNumber, shipmentId | Yok | Var |
| status | Yok | answered, unanswered |
Milisaniye zaman damgası, 1 Ocak 1970'ten bu yana geçen milisaniye sayısıdır ve bugünün tarihleri için 13 haneli bir sayıdır. Gün biçiminde tarih göndermeyin.
Yanıt ve cevap gövdesi
- Ürün sorusu cevabı: answer_body: Cevap metni.
- Sipariş sorusu cevabı: answer_body ve type; dokümandaki örnekte type: 1. type değerlerinin anlamı dokümanda açıklanmaz.
Ürün sorusu listesinde her kayıtta id, product, question, productQuestionAnswer (verilmiş cevaplar), readAt, publishedAt, createdAt, customerName (maskeli), barcode ve vendorStockCode bulunur. Cevap nesnesi answerBody, likeCount, dislikeCount ve bannedWords alanlarını taşır.
Sipariş sorusu listesinde orderNumber, shipmentId, reason (ör. Genel Soru), productCode, lastMessage, lastMessageDate ve isReadMessage alanları vardır. Böylece cevaplanmamış ve okunmamış soruları ayırabilirsiniz.
Pratik bir düzen: sipariş sorularını status=unanswered ile, ürün sorularını sort=newest ile birkaç dakikada bir çekin; cevaplanan soruyu kendi tarafınızda işaretleyin. Aynı soruya iki kez cevap göndermemek için cevabı göndermeden önce productQuestionAnswer dizisinin boş olduğunu kontrol edin.
Sık hatalar ve çözümleri
- Tarihi gün biçiminde göndermek: milisaniye zaman damgası beklenir.
- Ürün sorularında limit'i 50'nin üstünde istemek: en fazla 50 kayıt döner; sayfalayın.
- Ürün sorusu yolunu sipariş sorusu için kullanmak: sipariş soruları order-question altındadır.
- Alan adını karıştırmak: istekte answer_body, yanıtta answerBody kullanılır.
- Cevapları geç vermek: müşteri soruları satın alma kararını etkiler; hızlı yanıtın etkisi müşteri soruları ve yorumlar yazısında.
Sık sorulanlar
idefix müşteri sorularını API ile yanıtlayabilir miyim?
Evet. Ürün soruları POST /pim/vendor/{vendor}/question/{questionId}/answer, sipariş soruları POST /pim/vendor/{vendorID}/order-question/{questionId}/answer ile answer_body alanı gönderilerek yanıtlanır.
Sorular hangi tarih biçimiyle filtrelenir?
startDate ve endDate milisaniye cinsinden zaman damgası olarak gönderilir.
Sipariş sorusu ile ürün sorusu arasındaki fark nedir?
Ürün sorusu ürün sayfasından sorulur ve barkoda bağlıdır. Sipariş sorusu bir siparişe ve sevkiyata bağlıdır; orderNumber ve shipmentId ile filtrelenir.
Bir istekte kaç soru alınır?
Ürün sorularında sayfa başına en fazla 50, varsayılan 10 kayıt döner. Sipariş sorularında varsayılan 10'dur.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı