본문 바로가기
스마일배송 API/외부주문

반품/교환입고 등록 API

Description
[POST] https://sa2.esmplus.com/efm/v1/api/service/SetOuterclaim
외부사이트에서 반품/교환신청되어 스마일배송센터로 회수 입고될 대상 주문을 등록하는 API입니다.

Request Description

항목 항목명 필수여부 Type Description
SmileOrderNo 스마일주문번호 Y long 반품/교환입고요청 하려는 대상 스마일주문번호 입력
ClaimType 클레임구분 Y string 반품건인지 교환건인지 구분코드 입력
RT : 반품
EX : 교환
DeliveryCompCode 택배사코드   Int 회수될 택배사코드 입력
InvoiceNo 송장번호   string 회수될 송장번호 입력
DeliveryPayType 선불/착불여부   string 회수될 택배사 선불로 반품배송비 결제된 건인지 착불요청된 건인지 구분코드 입력
Y : 선불
N : 착불
JSON
{
  "SmileOrderNo": 0,
  "ClaimType": "string",
  "DeliveryCompCode": "string",
  "InvoiceNo": "string",
  "DeliveryPayType": "string"
}

 

Response Description

항목 항목명 Type Description
ResultCode 결과코드 int 성공: 0
실패 :Error Massage 참고
Message 메시지 string  
Data > SmileOrderNo 스마일주문번호 long 등록된 스마일주문번호 내려감

 JSON_Success

{
  "ResultCode": 0,
  "Message": "",
  "Data": {
    "SmileOrderNo": 0
  }
}

Error Code

결과코드 메시지 원인
1400 반품교환입고할 스마일주문번호를 입력해주세요.
SmileOrderNo > 미입력 or 0 or 음수 입력 시
1400 유효하지 않은 주문번호입니다. SmileOrderNo > 스마일주문번호가 유효하지 않은 경우
1400 판매자의 주문번호가 아닙니다. SmileOrderNo > 스마일주문번호가 다른 판매자의 주문일 경우
1400 출고요청하지 않은 주문은 반품/교환입고 요청이 불가능합니다. SmileOrderNo > 출고요청하지 않은 주문일 경우
1400 실패 혹은 취소된 주문은 반품/교환입고 요청이 불가능합니다. SmileOrderNo > 출고취소된 주문 반품/교환입고 요청할 경우
1409 이미 반품/교환입고 요청된 주문입니다. : 클레임번호 {클레임번호} 이미 클레임신청한 주문건을 중복 신청시도할 경우
1400 클레임구분은 교환(EX), 반품(RT)만 입력 가능합니다. ClaimType > 유효하지 않은 값 입력 시
1400 수거택배사는 필수입니다.
DeliveryCompCode > 미입력 시
1400 지원하지 않는 택배사입니다. : {입력값} DeliveryCompCode > 유효하지 않은 값 입력 시
1400 수거송장번호는 필수입니다. InvoiceNo > 미입력 시
1400 선불/착불여부는 선불(Y), 착불(N)만 입력 가능합니다. DeliveryPayType > 유효하지 않은 값 입력 시

 

'스마일배송 API > 외부주문' 카테고리의 다른 글

외부주문 출고요청 API  (0) 2022.11.03
외부주문 출고취소 API  (0) 2022.11.03
외부주문 삭제 API  (0) 2022.11.03
반품/교환입고 조회 API  (0) 2022.10.11
사이트 코드  (0) 2022.10.07