coupang
GET/v2/providers/openapi/apis/api/v5/vendors/callCenterInquiries/{inquiryId}v1

쿠팡 고객센터 문의 단건 조회

# 01

요약

API 적용 가능한 구매자 사용자 지역 : 한국 , 대만 고객센터 문의를 상담번호 별로 한 건씩 조회합니다. 과도하게 고객센터 문의를 조회할 경우 시스템에 의해 자동으로 차단될 수 있습니다.

# 02

상세

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/1234567

Request 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
판매자이관글 완료사유
CODE NAME
NONE 없음
DISPUTE_PROCESS 직권처리
DISPUTE_PROCESS_COMPLETE 판매자확인
CANCEL 이관취소
    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