GET
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/callCenterInquiries2609170000쿠팡 고객센터 문의조회
KRTW
# 01
요약
쿠팡 고객센터 문의조회
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국, 대만
쿠팡 고객센터 문의를 조회합니다. 고객이 특정 상품에 대해 쿠팡 고객센터에 접수한 문의를 조회 할 수 있습니다.
a. 옵션아이디와 조회기간 모두 값이 있을 경우, 해당 옵션아이디와 조회 기간내의 모든 상담을 조회 할 수 있습니다.
b. 옵션아이디만 값이 있을 경우, 해당 옵션아이디의 상담만 조회 할 수 있습니다.
c. 조회기간만 값이 있을 경우, 해당 조회 기간내의 상담만 조회 할 수 있습니다.
조회 기간은 최대 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=1URL API Name
GET_INQUIRY_BY_QUERY
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 판매자 ID
|
| vendorId* | string | 판매자 ID
|
# 04
Query 파라미터
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| partnerCounselingStatus* | string | 문의 상태
| ||||||||||
| inquiryStartAt | string | 조회시작일, 형식: yyyy-MM-dd
| ||||||||||
| inquiryEndAt | string | 조회종료일, 형식: yyyy-MM-dd
| ||||||||||
| orderId | number | 주문번호 예 : 1900000******7 | ||||||||||
| vendorItemId | string | 옵션 ID
| ||||||||||
| pageNum | number | 현재 페이지 기본값 : 1 | ||||||||||
| pageSize | number | 페이지 크기 기본값 : 10, 최대값 : 30 |
# 05
응답 본문
응답 메시지
| Name | Type | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | number | 서버 응답 코드
| ||||||||||
| message | string | 서버 응답 메시지
| ||||||||||
| data | object | 결과
| ||||||||||
| content data.content | object[] | 결과
| ||||||||||
| inquiryId data.content[].inquiryId | number | 상담번호 질문 ID | ||||||||||
| inquiryStatus data.content[].inquiryStatus | string | 문의상태 progress 또는 complete | ||||||||||
| csPartnerCounselingStatus data.content[].csPartnerCounselingStatus | string | 답변여부 requestAnswer 또는 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 (상담사) 또는 vendor (판매자) | ||||||||||
| needAnswer data.content[].replies[].needAnswer | boolean | 답변 필요여부 true 또는 false | ||||||||||
| 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 | |||||||||||
| buyerEmail data.content[].buyerEmail | string | 고객이메일 미사용(빈값) | ||||||||||
| buyerPhone data.content[].buyerPhone | string | 고객전화번호
| ||||||||||
| orderId data.content[].orderId | integer | 주문 번호 예 : 1900000******7 | ||||||||||
| 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 | 판매시작일시
| ||||||||||
| 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
}
}
}# 06
에러 코드
| 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)를 입력했는지 확인합니다. |