반품건 교환전환 API

Description

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

반품주문 건을 교환으로 전환합니다. 반품 사유가 판매자 귀책이면 교환 전환시 판매자 귀책으로 전환되고, 반품 사유가 구매자 귀책이면 교환 전환시 구매자 귀책으로 전환됩니다. (결제수단은 “판매자 직접결제”로 내려감) G마켓 주문 경우 “교환신청”상태로 전환되며, 옥션 주문 경우 “교환재발송 송장등록” 상태(재발송완료는 아님)로 전환됩니다. 옥션 주문일 경우 재발송택배사 및 송장번호를 필수로 입력해야 합니다.

 

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,
  "DeliveryCompCode": int,
  "InvoiceNo": "string"  
}

 

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":8668,
   "Message":"교환신청을 1회 했을 경우 신청 할 수 없습니다.",
   "Data":null
}

옥션
 1) Result Code 1000 / 2000 / 8000일 경우,
{
    "ResultCode": 1000,
    "Message": "데이터 조회 실패. - 교환재발송 완료 대상건",
    "BizRuleCode": "",
    "Data": null
}
 
2) Result Code 8668일 경우,
{
    "ResultCode": 8668,
    "Message": "빠른환불 대상건은 교환 변경 불가 합니다",
    "BizRuleCode": "W13-2",
    "Data": null
}

 

Error Code

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