발송처리 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	해당 주문 내역이 없습니다.	JWT의 ID와 다른 판매자의 주문번호이거나 주문번호 오류
3000	지원하지 않는 택배사입니다.	택배사 코드 오류일 경우
3000	{DeliveryCompanyCode} 는 {택배사명}의 운송장번호 규칙에 어긋납니다.	운송장 번호 유효성 검사에 부합하지 않을 경우
3000	해당 주문은 3PL 주문입니다.	풀필먼트 스타배송 상품의 주문 건을 처리하려고 할 경우
3000	판매자 스타배송 주문은 계약 완료된 전용 택배사로만 발송처리가 가능합니다.	판매자 스타배송과 계약되지 않은 택배사 코드를 연동할 경우
3000	주문번호:{OrderNo}의 경매상태가 발송가능한 상태가 아닙니다.	발송처리 불가한 주문 상태일 경우
3000	통합 API 취소요청건 발송처리를 위한 취소철회가 실패하였습니다.	취소완료된 주문번호에 발송처리 요청할 경우
3000	주문확인 진행중입니다. 잠시 후 다시 진행해주세요	주문확인 내부 진행 중인데 발송처리 요청이 들어올 경우
3000	매개 변수 값을 Int64에서 Int32(으)로 변환하지 못했습니다.	OrderNo 자릿수 오류
2141	제휴사 주문번호의 최대길이는 30byte입니다.\\n	판매자 자사몰 주문번호가 30byte 초과했을 경우
2141	제휴사 상품번호의 최대길이는 30byte입니다.\\n	판매자 자사몰 상품번호가 30byte 초과했을 경우

'주문 | 배송 API' 카테고리의 다른 글

주문확인 API (0)	2022.10.12
발송예정일 등록 API (0)	2022.10.12
배송완료 API (0)	2022.10.12
주문상태조회 API (0)	2022.10.12
배송진행정보 조회 API (0)	2022.10.04

ESM Trading API