반품승인 API

Description

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

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

 

Request Description

OrderNo	주문번호	필수여부	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	처리 할 수 없는 주문상태입니다	반품철회된 주문건을 승인처리 시도할 경우