반품승인 API

Description

[PUT] https://sa2.esmplus.com/claim/v1/sa/return/{orderNo}

반품 승인 시 자동으로 반품 보류 해제 및 반품수거송장의 배송 완료가 처리되며 구매자 환불 진행됩니다. 바로 환불 처리가 되는 것이 아니고, 고객 결제 수단 및 타 장바구니 클레임 진행 여부에 따라 실제 고객 환불 진행됩니다. 고객과의 분쟁으로 추가 커뮤니케이션이 필요한 경우는 양사 CS를 통해 분쟁 건으로 조정되어야 합니다.

 

Request Description

OrderNo	주문번호	Y	Path	처리하려는 주문번호 입력
SiteType	사이트구분	Y	int	처리하려는 주문번호 사이트구분 선택 1 : 옥션 2 : G마켓

JSON
{
  "SiteType": int
}

 

Response Description

항목	항목명	Type	Description
ResultCode	결과코드	int	성공 : 0 실패 : Error Massage 참고 옥션의 경우, 아래규칙으로 내려감 Result Code 1000 (데이터 조회 없음) Result Code 2000 (파라미터 유효하지 않음) Result Code 8000 (처리결과 실패) Result Code 8668 (비즈니스 에러) >> 원인별 상세 “BizRuleCode” 값 내려감
Message	메시지	string
BizRuleCode	(옥션용)Unique코드	string	ResultCode가 8668(비즈니스에러)일 경우 사유별 처리 가능하도록 Unique 코드 내려감
Data	Data	string

 JSON_Success

{
   "ResultCode": 0,
   "Message": "string",
   "Data": {}
}

JSON_Fail

{
  "ResultCode":int,
  "Message":"string",
  "Data":string
}

Sample Code_Success

지마켓
{
   "ResultCode":0,
   "Message":"Success",
   "Data":null
}

옥션
{
    "ResultCode": 0,
    "Message": "Success",
    "BizRuleCode": "",
    "Data": null
}

Sample Code_Fail

지마켓
{
: "ResultCode":5800,
: "Message":"이미 환불된 건입니다",
: "Data":null
}

옥션
1) Result Code 1000 / 2000 / 8000일 경우,
{
    "ResultCode": 1000,
    "Message": "데이터 조회 실패. - 교환재발송 완료 대상건",
    "BizRuleCode": "",
    "Data": null
}
 
2) Result Code 8668일 경우,
{
    "ResultCode": 8668,
    "Message": "취소 가능한 주문상태가 아닙니다",
    "BizRuleCode": "W8-1",
    "Data": null
}

 

Error Code

결과코드	비즈룰코드	메시지	원인
5800		이미 수거완료된 건입니다.	이미 반품승인된 상태인데 중복호출 된 경우
5800		이미 환불된 건입니다.	이미 환불된 상태인데 중복호출 된 경우
5900		ReturnApproveFlowException$반품 정보 조회 실패	반품 클레임 상태가 아닐 경우
0		반품수거완료(환불대기)상태로 처리완료되었습니다(장바구니내 남아있는 클레임건이 있습니다.)	장바구내 내 클레임진행건이 있어 환불대기 상태로 반품승인된 상태로 정상임
8668	W18-1	이미 처리된 건입니다	옥션용_이미 처리된 주문건을 호출할 경우
8668	W18-3	처리 할 수 없는 주문상태입니다	반품철회된 주문건을 승인처리 시도할 경우