교환재발송 송장등록 API – ESM Trading API

교환재발송 송장등록 API

[POST] https://sa.esmplus.com/claim/v1/sa/exchange/{orderNo}/resend

Description
교환 주문 건에 대해, 교환재발송 송장등록을 필수로 등록합니다
교환송장등록은 업데이트 가능합니다
Request Description
G마켓/G9 주문조회 시, G마켓 ID의 토큰으로 조회해주세요. 옥션 주문조회 시, 옥션 ID의 토큰으로 조회해주세요
항목항목명필수여부TypeDescription
OrderNo 주문번호 Y Path 처리하려는 주문번호 입력
DeliveryCompCode 택배사코드 Y int 택배사별 5자리 코드
아래 택배사코드 참고
InvoiceNo송장번호 Y string
SiteType사이트구분 Y int처리하려는 주문번호 사이트구분 선택
1:옥션
2:G마켓 +G9
3:G9
JSONSample Code 1
{
  "SiteType": int,
  "DeliveryCompCode": int,
  "InvoiceNo": "string"
}

{
  "SiteType": 3,
  "DeliveryCompCode": 10086,
  "InvoiceNo": "20180829"
}

택배사코드
택배사코드택배사명비고
10001G마켓/옥션 지정택배 코드판매자가 처리는 불가하나 반품조회/교환조회 Response로 내려갈 수 있음
10003로젠택배
10005우체국택배
10006등기우편상품 등록/수정시 사용 불가
발송처리시 사용 가능
10007한진택배
10008롯데택배
10013CJ대한통운
10014대신택배
10015일양택배
10016경동택배
10017천일택배
10022DHL
10023FEDEX
10024일반우편
10027LG전자물류
10028삼성전자물류
10031(G마켓)직접배달
10032(G마켓)자체배송구매자 배송조회 불가
제한코드로 해당 코드 사용 필요시 협의 필요
10034기타택배
10035방문수령상품 등록/수정시 사용 불가
발송처리시 사용 가능
10036EMS
10039호남택배
10041USPS
10042UPS
10043GSMNTON
10044WarpEx
10045성원글로벌
10050건영택배
10051WIZWA
10072CJ국제특송
10073편의점택배(GS25)
10074합동택배
10075롯데국제특송
10077SLX
10078동부대우전자/대우전자
10079범한판토스
10080GPS LOGIX
10081한의사랑택배
10082세방택배
10084쉽트랙
10085ACI
10097Qxpress
10098현대글로비스
10089택배사미정
10099부릉
10056(해외)DPD해외배송 전용 택배사/G마켓만 지원
10086GSfresh당일배송 마트판매자 전용
10087롯데fresh당일배송 마트판매자 전용
10048홈플러스당일배송 마트판매자 전용
10096롯데마트당일배송 마트판매자 전용
10100이마트몰당일배송 마트판매자 전용
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":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": "W13-5",

    "Data": null

}

Error Code
결과코드비즈룰코드메시지원인
99999 API Error - 교환택배사가 존재하지 않습니다 택배사코드가 유효하지 않을 경우
8668W22-3요청한 주문번호가 반품 및 교환 배송건이 아닙니다.옥션용_클레임 이슈가 없는 일반 배송주문건 호출 했을 경우
8668W22-4요청한 주문번호가 반품 및 교환 배송건이 아닙니다.옥션용_교환철회 주문건으로 시도한 경우
8668W22-6요청한 송장번호가 유효하지 않습니다.옥션용_클레임 상태이면서 유효하지 않은 송장번호 입력한 경우