판매자문의 조회 API

Description

[POST] https://sa2.esmplus.com/item/v1/communications/customer/bulletin-board

고객이 상품 및 주문관련 문의한 내용을 조회합니다,

Request Description

항목	항목명	필수여부	Type	Description
qnaType	조회구분	Y	int	조회 구분 1 : 옥션(일반) 2 : 옥션(비밀글) 3 : 전체(G마켓은 해당 구분만 사용)
status	처리상태	Y	int	문의 답변 처리상태 관련 조회 1 : 전체 2 : 미처리 3 : 처리완료 4 : 처리중(G마켓용) 5 : 중복문의(G마켓용)
type	조회기준 구분	Y	int	조회기준 구분 (접수일로만 지원) 1 : 접수일
startDate	조회기준 시작일	Y	date	- YYYY-MM-DD 형식으로 입력 - 7일 단위로 조회 가능
endDate	조회기준 종료일	Y	date	- YYYY-MM-DD 형식으로 입력 - 7일 단위로 조회 가능 - 당일 조회시 시작일 +1일로 조회

JSON
{
  "status": int,
  "qnaType": int,
  "type": int,
  "startDate": "2019-04-15",
  "endDate": "2019-04-15"
}

 

Response Description

항목	항목명	Type	Description
resultCode	결과코드	int	실패했을 경우 에러코드 내려감
message	메시지	string	실패사유
token	토큰	string	답변 작성 시, 문의번호와 token 함께 요청되어야 함
QnaType	사이트구분	int	조회된 게시판 1 : 옥션(일반) 2 : 옥션(비밀글) 3 : 전체
SellerId	판매자 사이트ID	string
contractType	문의유형	string	[옥션] 전체,상품(성능/사이즈),배송,교환,반품/취소/환불,기타 [G마켓] 상품, 배송, 반품/환불, 교환, 취소, 안전거래, 기타
InformStatus	문의답변상태	string	문의에 답변이 처리되었은지 여부 미처리, 처리완료
ReAsking	재질문여부	Boolean	옥션/G마켓 기준 재질문인지 여부 체크 true: 재질문 false : 재질문 아님
MessageNo	문의번호	string	문의번호 기준으로 답변 처리 필요 중복문의 동일건 문의에 대해 No별 관리 필요
ReceiveDate	접수일시	date	- 판매자 문의 발생 시간 - YYYY-MM-DD hh:mm:ss+09:00 형식으로 조회됨
AnswerDate	처리일시	date	- 판매자문의 답변처리 시간 - YYYY-MM-DD hh:mm:ss+09:00 형식으로 조회됨
GoodsNo	마스터상품번호	string	2.0 상품 경우 ESM 마스터번호 조회됨
SiteGoodsNo	Site 상품번호	string	Site 상품번호 조회됨
PayNo	장바구니번호	string	대표 장바구니번호 조회됨
OrderNo	주문번호	string	- 대표 주문번호 조회됨 - 데이터 없을 경우, 옥션 "0" / G마켓 "-"로 내려감
orderType	주문종류	string	참고용 데이터로, 아래 텍스트로 내려감 일반주문,물류주문,상품문의는 null
SellStatus	판매진행상태	string	참고용 데이터(현재 옥션만 지원) 접수 시점 해당 주문의 최종 주문상태 예) 교환물품도착, 반품보류 등
Title	제목	string	문의 제목
Details	내용	string	문의 내용 옥션은 채팅형으로 판매자가 답변하기 이전 문의를 묶어서 채팅순으로 조회됨 판매자가 답변 후 재문의한 경우 "[처리완료내역][문의번호:최신문의번호]History내용" 으로 기존 문의한 내용이 내려감(판매자 답변 내용은 내려가지 않으므로 문의번호로 조회 필요) 미처리된 내용은 [미처리][문의번호:]로 내려감
InquirerName	문의자명	string	문의자 이름
InquirerPhone	문의자연락처	string	문의자 전화번호
branchId	지점코드	string	당배관 판매자위함(추후 제공)

 JSON_Success

{
  "qnaType": 0,
  "reAsking": true,
  "inquirerName": "string",
  "inquirerPhone": "string",
  "branchId": "string",
  "messageNo": "string",
  "sellerId": "string",
  "goodsNo": "string",
  "siteGoodsNo": "string",
  "orderNo": "string",
  "orderType": "string",
  "sellStatus": "string",
  "payNo": "string",
  "informStatus": "string",
  "receiveDate": "2019-04-15T07:55:06+09:00",
  "answerDate": "2019-04-15T07:55:06+09:00",
  "contractType": "string",
  "title": "string",
  "details": "string",
  "token": "string"
}

JSON_Fail

{
  "resultCode": 0,
  "message": "string"
}

Sample Code_Success

지마켓
[
 {
  "qnaType":3,
  "reAsking":false,
  "inquirerName":"고객명",
  "inquirerPhone":"010-1234-5678",
  "branchId":null,
  "messageNo":"375419346",
  "sellerId":"sellerid_test",
  "goodsNo":"1149444776",
  "siteGoodsNo":"1527058123",
  "orderNo":"2949069764",
  "orderType":"일반주문",
  "sellStatus":"-",
  "payNo":"4456043527",
  "informStatus":"처리완료",
  "receiveDate":"2019-04-15T04:05:00+09:00",
  "answerDate":"0001-01-01T00:00:00+09:00",
  "contractType":"상품",
  "title":"가장 최근 도정한 쌀로 배송 부탁드립니다",
  "details":"가장 최근 도정한 쌀로 배송 부탁드립니다",
  "token":"!CB+jUisBwjBTI1i3FNGgn5QHqBuWT0T+j4xvGEAEnap/xSdrxDUnpMNIQYoKctP3tAj0KJ0amY97Hfrpqbuy8A=="
 }
]

옥션
[
 {
  "qnaType":1,
  "reAsking":true,
  "inquirerName":"고객명",
  "inquirerPhone":"010-1234-5678",
  "branchId":null,
  "messageNo":"215952467",
  "sellerId":"sellerid_test",
  "goodsNo":"2300050758",
  "siteGoodsNo":"B642025679",
  "orderNo":"0",
  "orderType":"",
  "sellStatus":"-",
  "payNo":"-",
  "informStatus":"미처리",
  "receiveDate":"2019-04-01T01:29:00+09:00",
  "answerDate":"2019-04-01T08:45:00+09:00",
  "contractType":"교환",
   "title":"안녕하세요",
  "details":"[처리완료내역][문의번호: 215952273]안녕하세요\n 교환가능할지 문의드립니다 \n[미처리][문의번호: 215952467]언제 답변받을 수 있나요?",
  "token":"!aTZ74zqPIImaqRkDvn8JUz/r173SHmXAoljxKI9kP9MvNXaKZ9gzCguvpDI36TlFzSju8JetoYyz3sMH95IRSg=="
 }
]

Sample Code_Fail

{
    "resultCode": 1000,
    "message": "7일 기간이상 조회 요청이 불가능합니다."
}

 

Error Code

결과코드	메시지	원인
1000	조회된 기간에 조회 대상이 없습니다	기간 내 문의건이 없을 경우
1000	7일 기간이상 조회 요청이 불가능합니다.	조회기간 날짜가 7일을 초과할 경우