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

查詢酷澎客服中心的諮詢記錄

# 01

簡介

查詢酷澎客服中心的諮詢記錄

# 02

詳細內容

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

可在此查詢酷澎客服中心的諮詢記錄,並檢視顧客對於某件特定商品向酷澎客服中心提出的諮詢。

  • 若屬性ID和查詢時間段均有數值,則可查詢屬性ID和查詢時間段內的所有諮詢記錄
  • 若只有屬性ID值,則只能查詢屬性ID的諮詢記錄
  • 若只有查詢時間段的數值,則只能查詢查詢時間段內的諮詢記錄

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

路徑

GET

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

例子

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/callCenterInquiries?inquiryStartAt=2018-01-07&inquiryEndAt=2018-01-08&vendorId=A00012345&partnerCounselingStatus=NO_ANSWER&pageSize=10&pageNum=1

請求引數

路徑引數

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

連結請求引數

名稱 是否必須 型別 描述
vendorId O String 賣家ID
partnerCounselingStatus O String 諮詢狀態 名稱 含義 NONE 諮詢 ANSWER 已回覆 NO_ANSWER 未回覆: 需要賣家回覆 TRANSFER 待確認 : 酷澎已完成諮詢,現已轉交給賣家。需賣家確認,無需回覆
inquiryStartAt String 查詢開始日期 (符合ISO-8601標準) 格式: YYYY-MM-DD 如果vendorItemId為null,則須輸入該引數才能查詢。可檢視查詢開始日到結束日期間內的所有諮詢陣列(inquiryEndAt-inquiryStartAt = 7d) 如果有輸入的vendorItemId值,則不輸入引數也可以查詢 如果查詢開始日和查詢結束日為null,則可查詢vendorItemId的所有諮詢陣列 如果有查詢開始日和結束日的數值,則可查詢該期間內的所有諮詢陣列
inquiryEndAt String 查詢結束日期 (符合ISO-8601標準) 格式: YYYY-MM-DD
orderId Number 訂單編號 例: 1900000*******
vendorItemId String 屬性ID
如果諮詢開始日和結束日為null,則須使用該引數查詢指定vendorItemId的所有諮詢陣列 如果有諮詢開始日和查詢結束日的數值,則無需輸入該引數
pageNum Number 當前頁面 預設值: 1
pageSize Number 頁面大小 預設值: 10; 最大值: 30

請求體例子

返回訊息

名稱 型別 描述
code Number 伺服器響應碼
message String 伺服器響應訊息
data Object 結果
content Array 結果
inquiryId Number 諮詢編號 問題ID
inquiryStatus String 諮詢狀態 進行中或已完成
csPartnerCounselingStatus String 是否已回覆 requestAnswer or answered
vendorItemId Number 屬性ID
itemName String 單品名
content String 諮詢內容 問題內容
answeredAt String 回覆日期 (符合ISO-8601標準) 格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
replies Array 回覆陣列
answerId Number 回覆ID
parentAnswerId String ID對映的上層關係
partnerTransferStatus String 賣家對映狀態 none(不需要)或 requestAnswer(待回覆)或已回覆(answered))
partnerTransferCompleteReason String 賣家轉接完成理由 程式碼 含義 NONE 無 DISPUTE_PROCESS 依職權處理 DISPUTE_PROCESS_COMPLETE 賣家確認 CANCEL 取消轉接
answerType String 回覆者型別 csAgent (客服人員) or vendor (賣家)
needAnswer Boolean 是否需要回復 是或否
receptionistName String 負責人姓名
receptionist String 負責人
replyAt String 回覆日期 (符合ISO-8601標準) 格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
content String 回覆內容
inquiryAt String 諮詢日期 (符合ISO-8601標準 格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
buyerEmail String 未使用/則會顯示空值(“”)
buyerPhone String 顧客電話號碼 (格式需符合E.164標準)
orderId Long 訂單號 例: 1900000*******
orderDate String 下單日期 (符合ISO-8601標準) 格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
receiptCategory String 諮詢方式
saleStartedAt String 銷售開始日期 (符合ISO-8601标准) 格式: YYYY-MM-DD
saleEndedAt String 銷售結束日期 (符合ISO-8601標準) 格式: YYYY-MM-DD
pagination Object Pagination information
currentPage Number 當前頁面 預設值: 1
totalPages Number 總頁數
totalElements Number 總諮詢數
countPerPage Number 每頁諮詢數

返回訊息例子

{
"code": 200,
"message": "OK",
"data": {
"content": [
{
"inquiryId": 1015668177,
"csPartnerCounselingStatus": "answered",
"inquiryStatus": "progress",
"vendorItemId": [
3285906659
],
"itemName": "스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L",
"content": "상담이력",
"answeredAt": "2025-01-15T14:17:13.973885-08:00",
"replies": [
{
"receptionistName": "AA몰",
"receptionist": "10000058",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "[판매자이관]\n◼주문번호: 100000*******\n◼아이템: 스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L\n◼고객명/연락처: <</01*-->>\n◼문의내용: 고객 상품 반송하였다고 합니다. 반송장은 경비실에 맡겨서 모른다고 합니다.\n입고 확인후 환불 처리 부탁 드립니다.\n",
"answerId": 1027082307,
"parentAnswerId": 0,
"partnerTransferStatus": "answered",
"partnerTransferCompleteReason": "NONE",
"answerType": "csAgent",
"needAnswer": false
},
{
"receptionistName": "AA몰",
"receptionist": "elandmall",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n1/3일 입고 된것으로 확인됩니다.\r\n\r\n3영업일이 정상 검수기간으로 시일이 소요되기에 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
"answerId": 1027083739,
"parentAnswerId": 0,
"partnerTransferStatus": null,
"partnerTransferCompleteReason": "NONE",
"answerType": "vendor",
"needAnswer": false
}
],
"inquiryAt": "2025-01-15T14:17:13.973885-08:00",
"buyerEmail": "",
"buyerPhone": "+1(555)444-1234",
"orderId": 1000001
6,
"orderDate": "2025-01-15T14:17:13.973885-08:00",
"receiptCategory": "기타문의>기타>전상담사통화요청",
"saleStartedAt": "2017-12-12",
"saleEndedAt": "2099-12-30"
},
{
"inquiryId": 1015664934,
"csPartnerCounselingStatus": "answered",
"inquiryStatus": "progress",
"vendorItemId": [
3361159025
],
"itemName": "스파오(SPAO) 몬스터주식회사 맨투맨 (디즈니)_D/GYAY SPMB74VC19, (17)Dark Gray, S",
"content": "상담이력",
"answeredAt": "2025-01-15T14:17:13.973885-08:00",
"replies": [
{
"receptionistName": "AA몰",
"receptionist": "D002236",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "[입고완료이관] \nㅁ 고객명: \nㅁ 주문번호:100000\nㅁ 반송장번호: ********* CJ대한통운\nㅁ 입고일자: 12/30\n반송장조회 결과 입고완료로 확인됩니다. \n★환불승인★ 부탁드립니다. \n반품입고후 3영업일이 경과되면 환불 자동승인처리가 \n되오니, 입고 상품의 문제발생 시 쿠팡확인요청으로 \n이의제기를 등록해주셔야 합니다.",
"answerId": 1027076645,
"parentAnswerId": 0,
"partnerTransferStatus": "answered",
"partnerTransferCompleteReason": "NONE",
"answerType": "csAgent",
"needAnswer": false
},
{
"receptionistName": "AA몰",
"receptionist": "elandmall",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n담당부서측으로 내용 전달 완료 하였습니다.\r\n\r\n금일 내 확인될시 환불진행 하겠으나 , 평균 2영업일 소요되기에 익일까지 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
"answerId": 1027079048,
"parentAnswerId": 0,
"partnerTransferStatus": null,
"partnerTransferCompleteReason": "NONE",
"answerType": "vendor",
"needAnswer": false
}
],
"inquiryAt": "2025-01-15T14:17:13.973885-08:00",
"buyerEmail": "",
"buyerPhone": "+1(555)444-1234",
"orderId": 100000
*****0,
"orderDate": "2025-01-15T14:17:13.973885-08:00",
"receiptCategory": "취소/반품 후단관리>회수확인>고객반송확인",
"saleStartedAt": "2017-12-12",
"saleEndedAt": "2099-12-30"
}
],
"pagination": {
"currentPage": 1,
"totalPages": 7,
"totalElements": 13,
"countPerPage": 2
}
}
}

錯誤資訊

HTTP狀態程式碼(錯誤型別) 錯誤資訊 解決方案
400 (確認請求引數) time interval needs to be less than or equal to 7 days, pattern should be yyyy-MM-dd 請確認查詢時間段是否小於7天。
400 (確認請求引數) Invalid vendor ID 請確認輸入的賣家ID(vendorId)是否正確。

介面名稱

GET_INQUIRY_BY_QUERY

路徑

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

範例端點

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/callCenterInquiries?inquiryStartAt=2018-01-07&inquiryEndAt=2018-01-08&vendorId=A00012345&partnerCounselingStatus=NO_ANSWER&pageSize=10&pageNum=1
# 03

Path 參數

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

Query 參數

NameTypeDescription
partnerCounselingStatus*string
諮詢狀態
名稱 含義
NONE 諮詢
ANSWER 已回覆
NO_ANSWER 未回覆: 需要賣家回覆
TRANSFER 待確認 : 酷澎已完成諮詢,現已轉交給賣家。需賣家確認,無需回覆
inquiryStartAtstring
查詢開始日期 (符合ISO-8601標準)

格式: YYYY-MM-DD
  • 如果vendorItemId為null,則須輸入該引數才能查詢。可檢視查詢開始日到結束日期間內的所有諮詢陣列(inquiryEndAt-inquiryStartAt = 7d)
  • 如果有輸入的vendorItemId值,則不輸入引數也可以查詢
  • 如果查詢開始日和查詢結束日為null,則可查詢vendorItemId的所有諮詢陣列
  • 如果有查詢開始日和結束日的數值,則可查詢該期間內的所有諮詢陣列
inquiryEndAtstring
查詢結束日期 (符合ISO-8601標準)

格式: YYYY-MM-DD
orderIdnumber
訂單編號

例: 1900000*******
vendorItemIdstring
屬性ID
pageNumnumber
當前頁面

預設值: 1
pageSizenumber
頁面大小

預設值: 10; 最大值: 30
partnerCounselingStatus*string
諮詢狀態
名稱 含義
NONE 諮詢
ANSWER 已回覆
NO_ANSWER 未回覆: 需要賣家回覆
TRANSFER 待確認 : 酷澎已完成諮詢,現已轉交給賣家。需賣家確認,無需回覆
inquiryStartAtstring
查詢開始日期 (符合ISO-8601標準)

格式: YYYY-MM-DD
  • 如果vendorItemId為null,則須輸入該引數才能查詢。可檢視查詢開始日到結束日期間內的所有諮詢陣列(inquiryEndAt-inquiryStartAt = 7d)
  • 如果有輸入的vendorItemId值,則不輸入引數也可以查詢
  • 如果查詢開始日和查詢結束日為null,則可查詢vendorItemId的所有諮詢陣列
  • 如果有查詢開始日和結束日的數值,則可查詢該期間內的所有諮詢陣列
inquiryEndAtstring
查詢結束日期 (符合ISO-8601標準)

格式: YYYY-MM-DD
orderIdnumber
訂單編號

例: 1900000*******
vendorItemIdstring
屬性ID
pageNumnumber
當前頁面

預設值: 1
pageSizenumber
頁面大小

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

回應內容

回應訊息

NameTypeDescription
codenumber
伺服器響應碼
messagestring
伺服器響應訊息
dataobject
結果
content
data.content
object[]
結果
inquiryId
data.content[].inquiryId
number
諮詢編號

問題ID
inquiryStatus
data.content[].inquiryStatus
string
諮詢狀態

進行中或已完成
csPartnerCounselingStatus
data.content[].csPartnerCounselingStatus
string
是否已回覆

requestAnswer or answered
vendorItemId
data.content[].vendorItemId
number
屬性ID
itemName
data.content[].itemName
string
單品名
content
data.content[].content
string
諮詢內容

問題內容
answeredAt
data.content[].answeredAt
string
回覆日期 (符合ISO-8601標準)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
replies
data.content[].replies
object[]
回覆陣列
answerId
data.content[].replies[].answerId
number
回覆ID
parentAnswerId
data.content[].replies[].parentAnswerId
string
ID對映的上層關係
partnerTransferStatus
data.content[].replies[].partnerTransferStatus
string
賣家對映狀態

none(不需要)或 requestAnswer(待回覆)或已回覆(answered))
partnerTransferCompleteReason
data.content[].replies[].partnerTransferCompleteReason
string
賣家轉接完成理由
程式碼 含義
NONE
DISPUTE_PROCESS 依職權處理
DISPUTE_PROCESS_COMPLETE 賣家確認
CANCEL 取消轉接
answerType
data.content[].replies[].answerType
string
回覆者型別

csAgent (客服人員) or vendor (賣家)
needAnswer
data.content[].replies[].needAnswer
boolean
是否需要回復

是或否
receptionistName
data.content[].replies[].receptionistName
string
負責人姓名
receptionist
data.content[].replies[].receptionist
string
負責人
replyAt
data.content[].replies[].replyAt
string
回覆日期 (符合ISO-8601標準)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
content
data.content[].replies[].content
string
回覆內容
inquiryAt
data.content[].inquiryAt
string
諮詢日期 (符合ISO-8601標準

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
buyerEmail
data.content[].buyerEmail
string
未使用/則會顯示空值(“”)
buyerPhone
data.content[].buyerPhone
string
顧客電話號碼 (格式需符合E.164標準)
orderId
data.content[].orderId
integer
訂單號

例: 1900000*******
orderDate
data.content[].orderDate
string
下單日期 (符合ISO-8601標準)

格式: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
receiptCategory
data.content[].receiptCategory
string
諮詢方式
saleStartedAt
data.content[].saleStartedAt
string
銷售開始日期 (符合ISO-8601标准)

格式: YYYY-MM-DD
saleEndedAt
data.content[].saleEndedAt
string
銷售結束日期 (符合ISO-8601標準)

格式: YYYY-MM-DD
pagination
data.pagination
object
Pagination information
currentPage
data.pagination.currentPage
number
當前頁面

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

Response Example

{
 "code": 200,
 "message": "OK",
 "data": {
 "content": [
 {
 "inquiryId": 1015668177,
 "csPartnerCounselingStatus": "answered",
 "inquiryStatus": "progress",
 "vendorItemId": [
 3285906659
 ],
 "itemName": "스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L",
 "content": "상담이력",
 "answeredAt": "2025-01-15T14:17:13.973885-08:00",
 "replies": [
 {
 "receptionistName": "AA몰",
 "receptionist": "10000058",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "[판매자이관]\n◼주문번호: 100000*******\n◼아이템: 스파오(SPAO) 인조가죽 A라인 4부 스커트 SPWH749G22, (49)Khaki, L\n◼고객명/연락처: &lt;&lt;****/01*-****-****&gt;&gt;\n◼문의내용: 고객 상품 반송하였다고 합니다. 반송장은 경비실에 맡겨서 모른다고 합니다.\n입고 확인후 환불 처리 부탁 드립니다.\n",
 "answerId": 1027082307,
 "parentAnswerId": 0,
 "partnerTransferStatus": "answered",
 "partnerTransferCompleteReason": "NONE",
 "answerType": "csAgent",
 "needAnswer": false
 },
 {
 "receptionistName": "AA몰",
 "receptionist": "elandmall",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n1/3일 입고 된것으로 확인됩니다.\r\n\r\n3영업일이 정상 검수기간으로 시일이 소요되기에 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
 "answerId": 1027083739,
 "parentAnswerId": 0,
 "partnerTransferStatus": null,
 "partnerTransferCompleteReason": "NONE",
 "answerType": "vendor",
 "needAnswer": false
 }
 ],
 "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
 "buyerEmail": "",
 "buyerPhone": "+1(555)444-1234",
 "orderId": 1000001*******6,
 "orderDate": "2025-01-15T14:17:13.973885-08:00",
 "receiptCategory": "기타문의&gt;기타&gt;전상담사통화요청",
 "saleStartedAt": "2017-12-12",
 "saleEndedAt": "2099-12-30"
 },
 {
 "inquiryId": 1015664934,
 "csPartnerCounselingStatus": "answered",
 "inquiryStatus": "progress",
 "vendorItemId": [
 3361159025
 ],
 "itemName": "스파오(SPAO) 몬스터주식회사 맨투맨 (디즈니)_D/GYAY SPMB74VC19, (17)Dark Gray, S",
 "content": "상담이력",
 "answeredAt": "2025-01-15T14:17:13.973885-08:00",
 "replies": [
 {
 "receptionistName": "AA몰",
 "receptionist": "D002236",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "[입고완료이관] \nㅁ 고객명: ******\nㅁ 주문번호:100000******\nㅁ 반송장번호: ********* CJ대한통운\nㅁ 입고일자: 12/30\n반송장조회 결과 입고완료로 확인됩니다. \n★환불승인★ 부탁드립니다. \n반품입고후 3영업일이 경과되면 환불 자동승인처리가 \n되오니, 입고 상품의 문제발생 시 쿠팡확인요청으로 \n이의제기를 등록해주셔야 합니다.",
 "answerId": 1027076645,
 "parentAnswerId": 0,
 "partnerTransferStatus": "answered",
 "partnerTransferCompleteReason": "NONE",
 "answerType": "csAgent",
 "needAnswer": false
 },
 {
 "receptionistName": "AA몰",
 "receptionist": "elandmall",
 "replyAt": "2025-01-15T14:17:13.973885-08:00",
 "content": "안녕하세요, \r\nAA몰입니다.\r\n\r\n담당부서측으로 내용 전달 완료 하였습니다.\r\n\r\n금일 내 확인될시 환불진행 하겠으나 , 평균 2영업일 소요되기에 익일까지 양해 바랍니다.\r\n\r\n감사합니다.\r\n",
 "answerId": 1027079048,
 "parentAnswerId": 0,
 "partnerTransferStatus": null,
 "partnerTransferCompleteReason": "NONE",
 "answerType": "vendor",
 "needAnswer": false
 }
 ],
 "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
 "buyerEmail": "",
 "buyerPhone": "+1(555)444-1234",
 "orderId": 100000********0,
 "orderDate": "2025-01-15T14:17:13.973885-08:00",
 "receiptCategory": "취소/반품 후단관리&gt;회수확인&gt;고객반송확인",
 "saleStartedAt": "2017-12-12",
 "saleEndedAt": "2099-12-30"
 }
 ],
 "pagination": {
 "currentPage": 1,
 "totalPages": 7,
 "totalElements": 13,
 "countPerPage": 2
 }
 }
}
# 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 (確認請求引數)

Invalid vendor ID

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