/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries2609170000查詢酷澎客服中心的諮詢記錄
簡介
查詢酷澎客服中心的諮詢記錄
詳細內容
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": 10000016,
"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
路徑
範例端點
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=1Path 參數
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 賣家ID
|
| vendorId* | string | 賣家ID
|
| vendorId* | string | 賣家ID
|
| vendorId* | string | 賣家ID
|
Query 參數
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| partnerCounselingStatus* | string | 諮詢狀態
| ||||||||||
| inquiryStartAt | string | 查詢開始日期 (符合ISO-8601標準) 格式: YYYY-MM-DD
| ||||||||||
| inquiryEndAt | string | |||||||||||
| orderId | number | 訂單編號 例: 1900000******* | ||||||||||
| vendorItemId | string | 屬性ID
| ||||||||||
| pageNum | number | 當前頁面 預設值: 1 | ||||||||||
| pageSize | number | 頁面大小 預設值: 10; 最大值: 30 | ||||||||||
| partnerCounselingStatus* | string | 諮詢狀態
| ||||||||||
| inquiryStartAt | string | 查詢開始日期 (符合ISO-8601標準) 格式: YYYY-MM-DD
| ||||||||||
| inquiryEndAt | string | |||||||||||
| orderId | number | 訂單編號 例: 1900000******* | ||||||||||
| vendorItemId | string | 屬性ID
| ||||||||||
| pageNum | number | 當前頁面 預設值: 1 | ||||||||||
| pageSize | number | 頁面大小 預設值: 10; 最大值: 30 |
回應內容
回應訊息
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | number | 伺服器響應碼
| ||||||||||
| message | string | 伺服器響應訊息
| ||||||||||
| data | object | 結果
| ||||||||||
| 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 | |||||||||||
| 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 | 賣家轉接完成理由
| ||||||||||
| 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 | |||||||||||
| content data.content[].replies[].content | string | 回覆內容
| ||||||||||
| inquiryAt data.content[].inquiryAt | string | |||||||||||
| buyerEmail data.content[].buyerEmail | string | 未使用/則會顯示空值(“”)
| ||||||||||
| buyerPhone data.content[].buyerPhone | string | 顧客電話號碼 (格式需符合E.164標準)
| ||||||||||
| orderId data.content[].orderId | integer | 訂單號 例: 1900000******* | ||||||||||
| orderDate data.content[].orderDate | string | |||||||||||
| receiptCategory data.content[].receiptCategory | string | 諮詢方式
| ||||||||||
| saleStartedAt data.content[].saleStartedAt | string | |||||||||||
| saleEndedAt data.content[].saleEndedAt | string | |||||||||||
| 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
}
}
}錯誤碼
| HTTP | 代碼 | 訊息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
錯誤說明
| HTTP | 類型 | 錯誤訊息 | 解決方案 |
|---|---|---|---|
| 400 | 400 (確認請求引數) | time interval needs to be less than or equal to 7 days, pattern should be yyyy-MM-dd | 請確認查詢時間段是否小於7天。 |
| 400 | 400 (確認請求引數) | Invalid vendor ID | 請確認輸入的賣家ID(vendorId)是否正確。 |