API 적용 가능한 구매자 사용자 지역: 한국, 대만
고객센터 문의를 상담번호 별로 한 건씩 조회합니다.
과도하게 고객센터 문의를 조회할 경우 시스템에 의해 자동으로 차단될 수 있습니다.
Path
GET/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/1234567Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| inquiryId | O | Number |
상담번호
질문 ID
|
||||
Request Example
not require body
Response Message
| Name | Type | Description | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
서버 응답 코드
|
|||||||||||||
| message | String |
서버 응답 메시지
|
|||||||||||||
| data | Object |
결과
|
|||||||||||||
| inquiryId | Number |
상담번호
질문 ID
|
|||||||||||||
| inquiryStatus | String |
문의상태
progress 또는 complete
|
|||||||||||||
| csPartnerCounselingStatus | String |
답변여부
requestAnswer 또는 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 |
판매자이관글 완료사유
|
|||||||||||||
| answerType | String |
작성자 타입
csAgent (상담사) 또는 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 |
고객전화번호
|
|||||||||||||
| orderId | Long |
주문 번호
예 : 1900000******7
|
|||||||||||||
| orderDate | String |
주문일시 (ISO-8601 표준 준수)
형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
|||||||||||||
| receiptCategory | String |
문의유형
|
|||||||||||||
| saleStartedAt | String |
판매시작일시
|
|||||||||||||
| saleEndedAt | String |
판매종료일시
|
|||||||||||||
Response Example
{"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"
}
}
Error Spec
| HTTP 상태 코드 (오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) |
Invalid format inquiryId : xxxxxx
|
올바른 inquiryId 값을 입력했는지 확인합니다. |
| 404 (요청변수확인) |
Inquiry not found
|
올바른 inquiryId 값을 입력했는지 확인합니다. |
| 404 (요청변수확인) |
Vendor id should be same with the vendor id in this inquiry
|
올바른 inquiryId 값을 입력했는지 확인합니다. |
URL API Name
GET_ORIGIN_INQUIRY_BY_ID