발송처리 API

Description

[POST] https://sa2.esmplus.com/shipping/v1/Delivery/ShippingInfo

주문 확인 후 주문에 대해 발송처리를 합니다 발송처리한 택배사 코드를 설정 후 발송처리 되어야 하며 택배사코드는 API 로 조회하여 확인 가능합니다. 발송처리시 구매자 마이페이지에서 “배송중”으로 상태 변경되며 판매자가 입력한 택배사 및 송장번호로 배송조회 가능합니다. 주문확인 이후 구매자가 취소요청한 주문건에 대해 취소불가 처리 기능도 수행합니다. (별도 취소거부API 없음) 입력한 발송정보 수정은 수정하고자 하는 정보 입력하여 재호출하여 처리하며 최종 입력한 정보로 업데이트 됩니다. 판매자 스타배송 주문 발송처리시 계약, 이용중인 택배사 코드로만 발송처리 가능 합니다. - CJ 대한통운 (10013), 한진택배 (10007), 롯데택배 (10008)

Request Description

항목	항목명	필수여부	Type	Description
orderNo	주문번호	Y	long	처리하고자 하는 주문번호 입력
ShippingDate	발송일시	Y	date	실제 발송된 일시 입력 YYYY-MM-DDThh:mm:ss 입력 호출시점 2일 이내로 입력 필요
DeliveryCompanyCode	택배사코드	Y	int	택배사 리스트 조회 API - [GET] https://sa2.esmplus.com/item/v1/shipping/delivery-company (참조 - https://etapi.gmarket.com/142)
InvoiceNo	송장번호	Y	string
SellerOrderNo	판매자 자사몰 주문번호		string	최대 30byte까지 입력가능 G마켓/옥션 주문번호와 매칭되는 판매자 자사몰의 주문번호 판매자 자사몰의 CS와 커뮤니케이션 시 이용하는 정보로 자사몰CS에서 확인가능한 실제 번호 연동
SellerItemNo	판매자 자사몰 상품번호		string	최대 30byte까지 입력가능 G마켓/옥션 주문번호와 매칭되는 판매자 자사몰의 상품번호 판매자 자사몰의 CS와 커뮤니케이션 시 이용하는 정보로 자사몰CS에서 확인가능한 실제 번호 연동

JSON
{
  "OrderNo": long,
  "ShippingDate":"YYYY-MM-DDThh:mm:ss",
  "DeliveryCompanyCode": int,
  "InvoiceNo":"string"
  "SellerOrderNo": "string",
  "SellerItemNo": "string"
}

 

Response Description

항목	항목명	Type	Description
ResultCode	결과	string	성공: Success 실패: Error Massage 참고
Message	메시지	string
Data > OrderNo	주문번호	int	처리된 주문번호 Return

 JSON_Success

{
  "ResultCode":0,
  "Message":"string",
  "Data":{
    "OrderNo":0
}
}

JSON_Fail

{
    "ResultCode": int,
    "Message": "string",
    "Data": null
}

Sample Code_Success

{
  "ResultCode":0,
  "Message":"Success",
  "Data":{
    "OrderNo":2503423671
}
}

Sample Code_Fail

{
  "ResultCode":3000,
  "Message":"해당 주문 내역이 없습니다.",
  "Data":null
}

 

Error Code

결과코드	메시지	원인
3000	해당 주문 내역이 없습니다.	토큰의 ID가 아닌 판매자의 주문건이거나 주문번호 오류
3000	매개 변수 값을 Int64에서 Int32(으)로 변환하지 못했습니다.	OrderNo 자릿수 오류
3000	해당 주문은 3PL 주문입니다	풀필먼트 스타배송 상품의 주문 건을 처리하려고 할 경우
3000	주문확인 진행중입니다. 잠시 후 다시 진행해주세요	주문확인 내부 진행중인데 발송처리 들어올 경우 재호출 요청
3000	주문번호:OrderNo의 경매상태가 발송가능한 상태가 아닙니다.	발송처리 불가한 주문상태일 경우
3000	XXX택배사의 운송장번호 규칙에 어긋납니다	운송장번호 유효성에 걸렸을 경우
3000	지원하지 않는 택배사입니다	택배사코드 오류일 경우
2141	제휴사 주문번호의 최대길이는 30byte입니다.\\n	판매자 자사몰 주문번호가 30byte 초과했을 경우
2141	제휴사 상품번호의 최대길이는 30byte입니다.\\n	판매자 자사몰 상품번호 최대길이가 30byte 초과했을 경우