교환건 반품전환 API

Description

[POST] https://sa2.esmplus.com/claim/v1/sa/exchange/{orderno}/return

교환 주문을 반품으로 전환합니다. 교환 사유가 판매자 귀책이면 전환 시 판매자 귀책으로 전환되고 구매자 귀책이면 구매자 귀책으로 전환됩니다. (결제수단은 “판매자 직접결제”로 내려감) G마켓 주문일 경우 “반품신청” 상태로 전환되며(반품보류 및 반품승인은 API 각기 처리해야함), 옥션 주문일 경우 바로 반품 환불 승인된 상태로 전환됩니다.

 

Request Description

항목	항목명	필수여부	Type	Description
OrderNo	주문번호	Y	Path	처리하려는 주문번호 입력
DeliveryCompCode	재배송 택배사코드		int	Sitetype > 1일 경우 필수입력 택배사별 5자리 코드 (택배사 코드 참고)
InvoiceNo	재배송 송장번호		string	Sitetype > 1일 경우 필수입력
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": 0,
   "Message": "string",
   "Data": {}
}

Sample Code_Success

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

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

Sample Code_Fail

지마켓
{
   "ResultCode":8668,
   "Message":"8668$이미 처리된 건입니다.",
   "Data":null
}

옥션
1) Result Code 1000 / 2000 / 8000일 경우,
{
    "ResultCode": 1000,
    "Message": "데이터 조회 실패. - 교환재발송 완료 대상건",
    "BizRuleCode": "",
    "Data": null
}
 
2) Result Code 8668일 경우,
{
    "ResultCode": 8668,
    "Message": "이미 처리된 건입니다",
    "BizRuleCode": "W18-1",
    "Data": null
}

 

Error Code

결과코드	비즈룰코드	메시지	원인
8668		ShowAlertException$교환신청을 1회 했을 경우 신청 할 수 없습니다.	이미 교환신청을 이전에 1회 신청하였을 경우 중복으로 교환신청 상태로 돌릴 수 없음(옥션만)
8668	W13-2	빠른환불 대상건은 교환 변경 불가 합니다	옥션용_빠른환불 대상 주문 교환전환 시도할 경우