교환건 반품전환 API – ESM Trading API

교환건 반품전환 API

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

Description
교환주문 건을 반품전환합니다
교환사유가 판매자귀책이면 반품전환 시 판매자귀책으로 전환되고, 교환사유가 구매자귀책이면 반품전환 시 구매자귀책으로 전환됩니다. (결제수단은 “판매자 직접결제”로 내려감)
G마켓 주문건일 경우, “반품신청”상태로 전환되며(반품보류 및 반품승인은 API 각기 처리해야함), 옥션 주문건일 경우, 바로 반품환불승인된 상태로 전환됩니다
Request Description
G마켓/G9 주문조회 시, G마켓 ID의 토큰으로 조회해주세요. 옥션 주문조회 시, 옥션 ID의 토큰으로 조회해주세요
항목항목명필수여부TypeDescription
OrderNo 주문번호 Y Path 처리하려는 주문번호 입력
DeliveryCompCode 재배송 택배사코드 int Sitetype > 1일 경우 필수입력
택배사별 5자리 코드
발송처리 Sheet 택배사코드 참고
InvoiceNo 재배송 송장번호 string Sitetype > 1일 경우 필수입력
SiteType사이트구분 Y int처리하려는 주문번호 사이트구분 선택
1:옥션
2:G마켓 +G9
3:G9
JSONSample Code_1
{
  "SiteType": int
}


{
  "SiteType": 3
}

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

{
   "ResultCode":0,
   "Message":"Success",
   "Data":null
}

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

{
   "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회 신청하였을 경우 중복으로 교환신청 상태로 돌릴 수 없음(옥션만)
8668W13-2빠른환불 대상건은 교환 변경 불가 합니다옥션용_빠른환불 대상 주문 교환전환 시도할 경우