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

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

KRTW
# 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
# 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◼고객명/연락처: <<****/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
 }
 }
}
# 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)是否正確。