coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산Rocket Growth
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiriesv1

상품별 고객문의 조회

# 01

요약

API 적용 가능한 구매자 사용자 지역 : 한국 , 대만 고객과 판매자 간의 Q&A를 조회합니다. 판매자는 이 API를 사용하여 판매중인 제품에 대한 상담을 조회 할 수 있습니다. 최대 조회 기간 7일까지 설정가능합니다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국, 대만

고객과 판매자 간의 Q&A를 조회합니다. 판매자는 이 API를 사용하여 판매중인 제품에 대한 상담을 조회 할 수 있습니다.
최대 조회 기간 7일까지 설정가능합니다.

Path

GET

/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries

Example Endpoint

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/onlineInquiries?inquiryStartAt=2019-06-25&inquiryEndAt=2019-06-26&vendorId=A00012345&answeredType=NOANSWER&pageSize=10&pageNum=1

Request Parameters

Path Segment Parameter

Name Required Type Description
vendorId O  String
판매자 ID

Query String Parameter

Name Required Type Description
vendorId  O String
판매자 ID
answeredType  O String

답변 상태

Name Status
ALL 전체보기
ANSWERED 답변완료
NOANSWER 미답변
inquiryStartAt  O String
조회시작일, 형식: yyyy-MM-dd
최대 조회일 간격은 일주일입니다. 해당 조회 기간내의 모든 상담을 조회할 수 있습니다 (inquiryEndAt - inquiryStartAt < = 7days).
inquiryEndAt  O String 
조회종료일, 형식: yyyy-MM-dd
pageNum   Number
현재 페이지
기본값 : 1
pageSize   Number
페이지 크기
기본값 : 10, 최대값 : 50

Request Example

 
not require body
 

Response Message

Name Type Description
code Number
서버 응답 코드
message String
서버 응답 메시지
data Object
조회 결과
  content Array
결과
    inquiryId Number
Question Id
질문 ID
    productId Number
노출상품 ID
    sellerProductId Number
등록상품 ID
    sellerItemId Number
sellerItemId
    vendorItemId Number
옵션 ID
    content String
질문 내용
    inquiryAt String

조회 시간 (ISO-8601 표준 준수) 

형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
    orderIds List
주문 번호
[16000009476673]
    commentDtoList Array
질문에 대한 답변
      inquiryCommentId Number
Reply ID
      inquiryId Number
Question ID
      content String
질문에 대한 답변 내용
      inquiryCommentAt String

답변시간 (ISO-8601 표준 준수) 

형식: YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
  pagination Object
Pagination information
    currentPage Number
현재 페이지
기본값 : 1
    totalPages Number
총 페이지수
    totalElements Number
총 문의수
    countPerPage Number
페이지 당 문의 수

Response Example

{
   "code": 200,
   "message": "OK",
   "data": {
       "content": [
           {
               "inquiryId": 39352323,
               "productId": 231526161,
               "sellerProductId": 786583589,
               "sellerItemId": 1891732488,
               "vendorItemId": 4855652221,
               "content": "포장 3천원 입금하였습니다.",
               "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
               "orderIds": [
                   19000041361951
               ],
               "commentDtoList": [
                   {
                       "inquiryCommentId": 36881065,
                       "inquiryId": 39352323,
                       "content": "고객님 안녕하세요. OOO 입니다. 입금확인되었고 포장하여 금일 출고하겠습니다. 감사합니다.",
                       "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
                   }
               ]
           },
           {
               "inquiryId": 39352273,
               "productId": 212844716,
               "sellerProductId": 718482283,
               "sellerItemId": 1699726710,
               "vendorItemId": 4675663991,
               "content": "스판이 강한가요?",
               "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
               "orderIds": [],
               "commentDtoList": [
                   {
                       "inquiryCommentId": 36885408,
                       "inquiryId": 39352273,
                       "content": "고객님 안녕하세요. OOO 입니다. 문의주신 제품 스판이 좋은 제품이긴하오나 개개인마다 생각이 다르기 때문에 개인차 있습니다 . 구매시 참고 부탁드립니다 . 감사합니다.",
                       "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
                   }
               ]
           },
           {
               "inquiryId": 39352362,
               "productId": 130048576,
               "sellerProductId": 375487954,
               "sellerItemId": 910365921,
               "vendorItemId": 3929087307,
               "content": "언제도착입니까? 21일도착예정인데 준비중이고\r\n문의해도 답변없고 취소도 안되고\r\n환불해줘요",
               "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
               "orderIds": [
                   5000041411986
               ],
               "commentDtoList": [
                   {
                       "inquiryCommentId": 36885330,
                       "inquiryId": 39352362,
                       "content": "고객님 안녕하세요. OOO 입니다.   업체에서 확인되는 고객님 주문날짜는 6월24일이며 금일 출고요청된것으로 확인됩니다. 송장은 출고일 저녁 자동 등록되며   혹 구입일이 6월24일 이전일 경우 구매하신 쿠팡고객센터 1577-7011로 문의 부탁드립니다.  감사합니다. ",
                       "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
                   }
               ]
           }
       ],
       "pagination": {
           "currentPage": 6,
           "totalPages": 102,
           "totalElements": 304,
           "countPerPage": 3
       }
   }
}

Error Spec

HTTP 상태 코드 (오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) time interval needs to be less than or equal to 7 days， pattern should be yyyy-MM-dd 조회기간이 7일 이하 인지 확인합니다.
400 (타임설정확인) Read timed out 설정한 조회기간(1일), 페이지 크기값(10)으로 재설정 후 재요청 합니다. 목록데이터가 많아 타임아웃이 발생할 경우 X-EXTENDED-TIMEOUT 설정값을 늘린 후 재요청합니다.  *관련 FAQ 링크
400 (요청변수확인) Invalid vendor ID 올바른 판매자 ID (vendorId)를 입력했는지 확인합니다.

URL API Name

GET_CUSTOMER_SERVICE_REQUEST