API 適用的买方用户區域:韓國、台灣
按諮詢號碼一一查詢聯絡中心的問詢。
對聯絡中心的過多詢問可能會被 Coupang 系統自動阻止。
路徑
GET
/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}
例子
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/1234567
請求引數
路徑引數
| 名稱 | 是否必須 | 型別 | 描述 |
| inquiryId | O | Number | 諮詢號碼 問題編號 |
請求體引數
無
返回資訊
| 名稱 | 型別 | 描述 | ||||||||||||
| code | Number | 伺服器響應code | ||||||||||||
| message | String | 伺服器響應資訊 | ||||||||||||
| data | Object | 結果 | ||||||||||||
| inquiryId | Number | 諮詢號碼 問題編號 |
||||||||||||
| inquiryStatus | String | 詢價狀態 進展或完成 |
||||||||||||
| csPartnerCounselingStatus | String | 應答狀態 請求答覆或已答覆 |
||||||||||||
| 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 (無應答) or requestAnswer (請求應答) or answered (應答完畢) |
||||||||||||
| partnerTransferCompleteReason | String |
處理已轉移給賣家的問詢單的原因
|
||||||||||||
| answerType | String | 回答者型別 csAgent(CS代理)或vendor(賣家) |
||||||||||||
| needAnswer | Boolean | 是否需要回答; 填true 或false |
||||||||||||
| 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 |
訂單ID 例: 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 |
||||||||||||
返回訊息例子
{
"code": 200,
"message": "OK",
"data": {
"inquiryId": 258799946,
"csPartnerCounselingStatus": "requestAnswer",
"inquiryStatus": "progress",
"vendorItemId": [
75235680736
],
"itemName": "제주 삼다수, 2L, 6개",
"content": "상담이력",
"answeredAt": "2025-01-15T14:17:13.973885-08:00",
"replies": [
{
"receptionistName": "OO스토아",
"receptionist": "cssp-hyjang15",
"replyAt": "2025-01-15T14:17:13.973885-08:00",
"content": "**\n\n\n※ 영업시간 기준 24시간 경과시, 자동으로 '24시간 미답변'에 대한 메세지가 노출될 예정입니다.\n\n안녕하세요 판매자님.\n반품/교환 관련해서 아래와 같이 변심 반품을 요청드리니 회신 부탁드립니다.\n\n[상담사 필수 기재 항목]\n1. 사용/조립 여부 : N\n2. 받은 그대로 재포장 가능여부 : Y\n3. 최종요청사항 : 주소오기재로 환불요청\n\n[판매자님 회신요청]\n1. 요청사항 이행 가능여부:\n2. 불가시 불가능한 사유 :\n3. 처리가능시, 회수여부 :",
"answerId": 21128942421017,
"parentAnswerId": null,
"partnerTransferStatus": "requestAnswer",
"partnerTransferCompleteReason": "NONE",
"answerType": "csAgent",
"needAnswer": true
}
],
"inquiryAt": "2025-01-15T14:17:13.973885-08:00",
"buyerEmail": "",
"buyerPhone": "+1(555)444-1234",
"orderId": 1900000******7,
"orderDate": "2025-01-15T14:17:13.973885-08:00",
"receiptCategory": "배송>배송>배송",
"saleStartedAt": "2023-07-24",
"saleEndedAt": "2099-12-29"
}
}
錯誤程式碼
| HTTP狀態程式碼 (錯誤型別) | 錯誤資訊 | 解決方案 |
|---|---|---|
| 400 (Check Request Parameter) | Invalid format inquiryId : xxxxxx | 確保inquiryId正確 |
| 404 (Check Request Parameter) | Inquiry not found | 確保inquiryId正確 |
| 404 (Check Request Parameter) | Vendor id should be same with the vendor id in this inquiry | 確保inquiryId正確 |
介面名稱
GET_ORIGIN_INQUIRY_BY_ID