GET
/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}2609170000쿠팡 고객센터 문의 단건 조회
KRTW
# 01
요약
쿠팡 고객센터 문의 단건 조회
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국, 대만
고객센터 문의를 상담번호 별로 한 건씩 조회합니다.
과도하게 고객센터 문의를 조회할 경우 시스템에 의해 자동으로 차단될 수 있습니다.
경로
GET/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}
예시 엔드포인트
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/1234567URL API Name
GET_ORIGIN_INQUIRY_BY_ID
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| inquiryId* | number | 상담번호 질문 ID |
# 04
응답 본문
응답 메시지
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | number | 서버 응답 코드
| ||||||||||
| message | string | 서버 응답 메시지
| ||||||||||
| data | object | 결과
| ||||||||||
| inquiryId data.inquiryId | number | 상담번호 질문 ID | ||||||||||
| inquiryStatus data.inquiryStatus | string | 문의상태 progress 또는 complete | ||||||||||
| csPartnerCounselingStatus data.csPartnerCounselingStatus | string | 답변여부 requestAnswer 또는 answered | ||||||||||
| vendorItemId data.vendorItemId | number | 옵션 ID
| ||||||||||
| itemName data.itemName | string | 아이템 이름
| ||||||||||
| content data.content | string | 문의 내용 질문 내용 | ||||||||||
| answeredAt data.answeredAt | string | 답장 날짜 (ISO-8601 표준 준수) 형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm | ||||||||||
| replies data.replies | object[] | 답장 목록
| ||||||||||
| answerId data.replies[].answerId | number | 답변 ID
| ||||||||||
| parentAnswerId data.replies[].parentAnswerId | string | 부모 이관글 ID
| ||||||||||
| partnerTransferStatus data.replies[].partnerTransferStatus | string | 판매자 이관 상태 none(대상 아님) 또는 requestAnswer(답변 요청) 또는 answered(답변 완료) | ||||||||||
| partnerTransferCompleteReason data.replies[].partnerTransferCompleteReason | string | 판매자이관글 완료사유
| ||||||||||
| answerType data.replies[].answerType | string | 작성자 타입 csAgent (상담사) 또는 vendor (판매자) | ||||||||||
| needAnswer data.replies[].needAnswer | boolean | 답변 필요여부 true 또는 false | ||||||||||
| receptionistName data.replies[].receptionistName | string | 담당자 이름
| ||||||||||
| receptionist data.replies[].receptionist | string | 담당자
| ||||||||||
| replyAt data.replies[].replyAt | string | 답장일 (ISO-8601 표준 준수) 형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm | ||||||||||
| content data.replies[].content | string | 답변내용
| ||||||||||
| inquiryAt data.inquiryAt | string | 문의 날짜 (ISO-8601 표준 준수) 형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm | ||||||||||
| buyerEmail data.buyerEmail | string | 미사용(빈값)
| ||||||||||
| buyerPhone data.buyerPhone | string | 고객전화번호
| ||||||||||
| orderId data.orderId | integer | 주문 번호 예 : 1900000******7 | ||||||||||
| orderDate data.orderDate | string | 주문일시 (ISO-8601 표준 준수) 형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm | ||||||||||
| receiptCategory data.receiptCategory | string | 문의유형
| ||||||||||
| saleStartedAt data.saleStartedAt | string | 판매시작일시
| ||||||||||
| saleEndedAt data.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"
}
}# 05
에러 코드
| HTTP | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | Invalid format inquiryId : xxxxxx | 올바른 inquiryId 값을 입력했는지 확인합니다. |
| 404 | 404 (요청변수확인) | Inquiry not found | 올바른 inquiryId 값을 입력했는지 확인합니다. |
| 404 | 404 (요청변수확인) | Vendor id should be same with the vendor id in this inquiry | 올바른 inquiryId 값을 입력했는지 확인합니다. |