coupang
API 文件
商品 API品類 API運輸 / 訂單 API退貨 API換貨 API物流資訊客服 / 諮詢
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries2609170000

按商品查詢顧客諮詢

# 01

簡介

按商品查詢顧客諮詢

# 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 O 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

路徑

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
# 03

Path 參數

NameTypeDescription
vendorId*string
賣家ID
vendorId*string
賣家ID
vendorId*string
賣家ID
vendorId*string
賣家ID
# 04

Query 參數

NameTypeDescription
answeredType*string
Answer status
名稱 含義
ALL 檢視全部
ANSWERED 已回覆
NOANSWER 未回覆
inquiryStartAtstring
查詢開始日期 (符合ISO-8601標準)

格式： YYYY-MM-DD

最長查詢日期間隔為一週。 您可查詢該時間段內的所有諮詢記錄（inquiryEndAt -inquiryStartAt < = 7days）。
inquiryEndAtstring
查詢結束日期 (符合ISO-8601標準)

格式： YYYY-MM-DD
pageNumnumber
當前頁

預設值: 1
pageSizenumber
頁面大小

預設值: 10; 最大: 50
answeredType*string
Answer status
名稱 含義
ALL 檢視全部
ANSWERED 已回覆
NOANSWER 未回覆
inquiryStartAtstring
查詢開始日期 (符合ISO-8601標準)

格式： YYYY-MM-DD

最長查詢日期間隔為一週。 您可查詢該時間段內的所有諮詢記錄（inquiryEndAt -inquiryStartAt < = 7days）。
inquiryEndAtstring
查詢結束日期 (符合ISO-8601標準)

格式： YYYY-MM-DD
pageNumnumber
當前頁

預設值: 1
pageSizenumber
頁面大小

預設值: 10; 最大: 50
# 05

回應內容

回應訊息

NameTypeDescription
codeinteger
伺服器響應碼
messagestring
伺服器響應訊息
dataobject
查詢結果
content
data.content
object[]
結果
inquiryId
data.content[].inquiryId
integer
Question Id

問題ID
productId
data.content[].productId
integer
顯示商品ID
sellerProductId
data.content[].sellerProductId
integer
註冊商品ID
sellerItemId
data.content[].sellerItemId
integer
sellerItemId
vendorItemId
data.content[].vendorItemId
integer
屬性ID
content
data.content[].content
string
問題內容
inquiryAt
data.content[].inquiryAt
string
查詢時間 (符合ISO-8601标准)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
orderIds
data.content[].orderIds
object[]
訂單號

[16000009476673]
commentDtoList
data.content[].commentDtoList
object[]
問題回覆
inquiryCommentId
data.content[].commentDtoList[].inquiryCommentId
integer
Reply ID
inquiryId
data.content[].commentDtoList[].inquiryId
integer
Question ID
content
data.content[].commentDtoList[].content
string
問題回覆內容
inquiryCommentAt
data.content[].commentDtoList[].inquiryCommentAt
string
回覆時間 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
pagination
data.pagination
object
Pagination information
currentPage
data.pagination.currentPage
integer
當前頁

預設值: 1
totalPages
data.pagination.totalPages
integer
總頁數
totalElements
data.pagination.totalElements
integer
總諮詢數
countPerPage
data.pagination.countPerPage
integer
每頁諮詢數

Response Example

{
  "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
    }
  }
}
# 06

錯誤碼

HTTP代碼訊息
400HTTP_400Bad Request

錯誤說明

HTTP類型錯誤訊息解決方案
400400 (確認請求引數)

time interval needs to be less than or equal to 7 days， pattern should be yyyy-MM-dd

請確認查詢時間段是否小於7天。

400400 (確認請求引數)

Read timed out

將查詢時間段及頁面大小數值分別設定為查詢時間段（1天）和頁面大小數值（10）後再次傳送請求。若因陣列資料量大而發生超時，請增加 X-EXTENDED-TIMEOUT 設定值後再次傳送請求。* FAQ連結

400400 (確認請求引數)

Invalid vendor ID

請確認輸入的賣家ID(vendorId)是否正確。