반품수거 송장등록 API

Description

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

반품요청 주문에 대해 G마켓/옥션 지정택배(G마켓/옥션에서 직접 택배사 수거 요청)를 이용하지 않고 판매자 지정택배(판매자가 직접 택배사 수거 요청)을 하는 경우라면 반품수거 송장등록을 필수로 등록합니다. 등록된 반품송장은 업데이트 가능합니다.

 

Request Description

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

Sample Code_Success

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

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

Sample Code_Fail

지마켓
{
  "ResultCode":99999,
  "Message":"API Error - 반품택배사가 존재하지 않습니다",
  "Data":null
}

옥션
 1) Result Code 1000 / 2000 / 8000일 경우,
{
    "ResultCode": 1000,
    "Message": "데이터 조회 실패. - 교환재발송 완료 대상건",
    "BizRuleCode": "",
    "Data": null
}
 
 2) Result Code 8668일 경우,
{
    "ResultCode": 8668,
    "Message": "요청한 주문번호가 반품 및 교환 배송건이 아닙니다.",
    "BizRuleCode": "W22-3",
    "Data": null
}

 

Error Code

결과코드	비즈룰코드	메시지	원인
99999		API Error - 반품택배사가 존재하지 않습니다	택배사코드가 유효하지 않을 경우
8668		ShowAlertException$요청한 주문번호가 반품 및 교환 배송건이 아닙니다.	반품이나 교환상태가 아닐경우
8668	W22-2	스마일배송 주문건은 수거지시 할 수 없습니다.	옥션용_스마일배송 주문건 수거지시 시도할 경우
8668	W22-3	요청한 주문번호가 반품 및 교환 배송건이 아닙니다.	옥션용_클레임 이슈가 없는 일반 배송주문건 호출 했을 경우 or 클레임 이슈가 없으면서 유효하지 않은 송장번호 입력한 경우
8668	W22-4	요청한 주문번호가 반품 및 교환 배송건이 아닙니다.	옥션용_반품철회한 주문건을 처리 시도할 경우
8668	W22-5	요청한 주문번호의 반품정보의 발송방법이 택배발송이 아닙니다.	옥션용_해당 주문의 발송방법이 택배발송건이 아닌 주문건을 호출 했을 경우
8668	W22-6	요청한 송장번호가 유효하지 않습니다.	옥션용_클레임 상태이면서 유효하지 않은 송장번호 입력한 경우