coupang
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiriesv1

按商品查詢顧客諮詢

# 01

簡介

API 適用的买方用户區域:韓國、台灣 您可在此查詢顧客與賣家的Q&A。賣家可透過該API查詢在售商品的諮詢記錄。 查詢時間段最長可設定為7天。

# 02

詳細內容

API 適用的买方用户區域:韓國、台灣

您可在此查詢顧客與賣家的Q&A。賣家可透過該API查詢在售商品的諮詢記錄。  

查詢時間段最長可設定為7天。

路徑

GET

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries

例子

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/onlineInquiries?inquiryStartAt=2019-06-25&inquiryEndAt=2019-06-26&vendorId=A00012345&answeredType=NOANSWER&pageSize=10&pageNum=1

請求引數

路徑引數

名稱  是否必須 型別  描述 
vendorId   String  賣家ID

查詢引數

名稱 是否必須 型別 描述
vendorId   O  String  賣家ID 
answeredType   O  String 

Answer status 

名稱  含義
ALL  檢視全部 
ANSWERED  已回覆 
NOANSWER  未回覆 

 

inquiryStartAt    String 

查詢開始日期 (符合ISO-8601標準)

格式: YYYY-MM-DD  

最長查詢日期間隔為一週。 您可查詢該時間段內的所有諮詢記錄(inquiryEndAt -inquiryStartAt < = 7days)。 

inquiryEndAt    String  

查詢結束日期 (符合ISO-8601標準)

格式: YYYY-MM-DD  

pageNum    Number 

當前頁 

預設值: 1 

pageSize    Number 

頁面大小 

預設值: 10; 最大: 50 

請求體引數

返回訊息

名稱  狀態 描述
code  Number  伺服器響應碼 
message  String  伺服器響應訊息 
data  Object  查詢結果 
  content  Array  結果 
    inquiryId  Number 

Question Id 

問題ID 

    productId  Number  顯示商品ID 
    sellerProductId  Number  註冊商品ID 
    sellerItemId  Number  sellerItemId 
    vendorItemId  Number  屬性ID 
    content  String  問題內容  
    inquiryAt  String 

查詢時間 (符合ISO-8601标准)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm  

    orderIds  List 

訂單號 

[16000009476673] 

    commentDtoList  Array  問題回覆 
      inquiryCommentId  Number  Reply ID 
      inquiryId  Number  Question ID 
      content  String  問題回覆內容 
      inquiryCommentAt  String 

回覆時間  (符合ISO-8601標準)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm  

  pagination  Object  Pagination information 
    currentPage  Number 

當前頁 

預設值: 1 

    totalPages  Number  總頁數  
    totalElements  Number  總諮詢數 
    countPerPage  Number  每頁諮詢數 

 

返回訊息例子

{
   "code": 200,
   "message": "OK",
   "data": {
       "content": [
           {
               "inquiryId": 39352323,
               "productId": 231526161,
               "sellerProductId": 786583589,
               "sellerItemId": 1891732488,
               "vendorItemId": 4855652221,
               "content": "포장 3천원 입금하였습니다.",
               "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
               "orderIds": [
                   19000041361951
               ],
               "commentDtoList": [
                   {
                       "inquiryCommentId": 36881065,
                       "inquiryId": 39352323,
                       "content": "고객님 안녕하세요. OOO 입니다. 입금확인되었고 포장하여 금일 출고하겠습니다. 감사합니다.",
                       "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
                   }
               ]
           },
           {
               "inquiryId": 39352273,
               "productId": 212844716,
               "sellerProductId": 718482283,
               "sellerItemId": 1699726710,
               "vendorItemId": 4675663991,
               "content": "스판이 강한가요?",
               "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
               "orderIds": [],
               "commentDtoList": [
                   {
                       "inquiryCommentId": 36885408,
                       "inquiryId": 39352273,
                       "content": "고객님 안녕하세요. OOO 입니다. 문의주신 제품 스판이 좋은 제품이긴하오나 개개인마다 생각이 다르기 때문에 개인차 있습니다 . 구매시 참고 부탁드립니다 . 감사합니다.",
                       "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
                   }
               ]
           },
           {
               "inquiryId": 39352362,
               "productId": 130048576,
               "sellerProductId": 375487954,
               "sellerItemId": 910365921,
               "vendorItemId": 3929087307,
               "content": "언제도착입니까? 21일도착예정인데 준비중이고\r\n문의해도 답변없고 취소도 안되고\r\n환불해줘요",
               "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
               "orderIds": [
                   5000041411986
               ],
               "commentDtoList": [
                   {
                       "inquiryCommentId": 36885330,
                       "inquiryId": 39352362,
                       "content": "고객님 안녕하세요. OOO 입니다.   업체에서 확인되는 고객님 주문날짜는 6월24일이며 금일 출고요청된것으로 확인됩니다. 송장은 출고일 저녁 자동 등록되며   혹 구입일이 6월24일 이전일 경우 구매하신 쿠팡고객센터 1577-7011로 문의 부탁드립니다.  감사합니다. ",
                       "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
                   }
               ]
           }
       ],
       "pagination": {
           "currentPage": 6,
           "totalPages": 102,
           "totalElements": 304,
           "countPerPage": 3
       }
   }
}

錯誤資訊

HTTP狀態程式碼(錯誤型別) 

 

錯誤資訊  解決方案 
400 (確認請求引數)  time interval needs to be less than or equal to 7 days, pattern should be yyyy-MM-dd  請確認查詢時間段是否小於7天。 
400 (確認請求引數)  Read timed out  將查詢時間段及頁面大小數值分別設定為查詢時間段(1天)和頁面大小數值(10)後再次傳送請求。若因陣列資料量大而發生超時,請增加 X-EXTENDED-TIMEOUT 設定值後再次傳送請求。* FAQ連結
400 (確認請求引數)  Invalid vendor ID  請確認輸入的賣家ID(vendorId)是否正確。 

介面名稱

GET_CUSTOMER_SERVICE_REQUEST