coupang
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=1

URL API Name

GET_INQUIRY_BY_QUERY
# 03

Path 파라미터

NameTypeDescription
vendorId*string
판매자 ID
vendorId*string
판매자 ID
# 04

Query 파라미터

NameTypeDescription
partnerCounselingStatus*string
문의 상태
Name Status
NONE 전체
ANSWER 답변완료
NO_ANSWER 미답변 : 판매자의 답변이 필요한 상태
TRANSFER 미확인 : 쿠팡이 상담완료한 업체이관 건으로 판매자의 확인이 필요한 상태, 답변은 필요없음
inquiryStartAtstring
조회시작일, 형식: yyyy-MM-dd
  1. vendorItemId가 null인 경우, 반드시 이 파라미터를 입력하여 조회합니다.
    해당 조회시작일과 종료일 기간의 모든 상담리스트를 조회할 수 있습니다.(inquiryEndAt - inquiryStartAt = 7d)
  2. vendorItemId 값 입력이 있을 경우 이 파라미터는 입력하지 않아도 조회가 가능합니다.
    a. 조회시작일과 조회종료일이 null인 경우, 해당 vendorItemId의 모든 상담리스트를 조회할수있습니다.
    b. 조회시작일과 조회종료일 값이 있을 경우 해당 기간의 모든 상담리스트를 조회할수있습니다.
inquiryEndAtstring
조회종료일, 형식: yyyy-MM-dd
orderIdnumber
주문번호

예 : 1900000******7
vendorItemIdstring
옵션 ID
  1. 조회시작일과 조회종료일이 null인 경우, 이 파라미터를 사용해야만 해당 vendorItemId 아래의 모든 상담리스트를 조회할 수 있습니다.
  2. 조회시작일과 조회종료일 값이 있을 경우 이 파라미터는 입력할 필요 없습니다.
pageNumnumber
현재 페이지
기본값 : 1
pageSizenumber
페이지 크기
기본값 : 10, 최대값 : 30
# 05

응답 본문

응답 메시지

NameTypeDescription
codenumber
서버 응답 코드
messagestring
서버 응답 메시지
dataobject
결과
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
답장 날자 (ISO-8601 표준 준수)

형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
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
판매자이관글 완료사유
CODE NAME
NONE 없음
DISPUTE_PROCESS 직권처리
DISPUTE_PROCESS_COMPLETE 판매자확인
CANCEL 이관취소
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
문의 날짜 (ISO-8601 표준 준수)

형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
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코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
400400 (요청변수확인)

time interval needs to be less than or equal to 7 days, pattern should be yyyy-MM-dd

조회기간이 7일 이하 인지 확인합니다.

400400 (요청변수확인)

Invalid vendor ID

올바른 판매자 ID (vendorId)를 입력했는지 확인합니다.