본문 바로가기
주문 | 배송 API

배송진행정보 조회 API

Description
[POST] https://sa2.esmplus.com/shipping/v1/Delivery/Progress
주문번호로 배송진행정보 및 클레임 히스토리를 조회합니다.
처리일시 시간순으로 데이터 정렬됩니다.

Request Description

항목 항목명 필수여부 Type Description
orderNo 주문번호 Y long 조회하고자 하는 주문번호 입력
JSON
{
  "OrderNo":0
}

 

Response Description

항목 항목명 Type Description
ResultCode 결과 string 성공: Success
실패: Error Massage 참고
Message 메시지 string  
TotalCount 총조회건수 int  
Data > EscrowType 처리구분 string  
Data > EscrowDt 처리일시 DateTime  
Data > TrackingUrl 택배송장URL string  

JSON_Success

{
  "TotalCount":0,
  "ResultCode":0,
  "Message":"string",
  "Data":[
     {
      "EscrowType":"string",
      "EscrowDt":"2019-04-11T04:58:40.046Z",
      "TrackingUrl":"string"
     }
  ]
}

JSON_Fail

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

Sample Code_Success

{
    "TotalCount": 7,
    "ResultCode": 0,
    "Message": "Success",
    "Data": [
        {
            "EscrowType": "결제일",
            "EscrowDt": "2021-12-01T13:26:00",
            "TrackingUrl": null
        },
        {
            "EscrowType": "배송중(발송처리일)",
            "EscrowDt": "2021-12-01T13:26:00",
            "TrackingUrl": "http://nplus.doortodoor.co.kr/web/info.jsp?slipno=11111111111"
        },
        {
            "EscrowType": "주문확인",
            "EscrowDt": "2021-12-01T13:29:00",
            "TrackingUrl": null
        },
        {
            "EscrowType": "정산완료",
            "EscrowDt": "2021-12-01T14:40:00",
            "TrackingUrl": null
        },
        {
            "EscrowType": "구매결정",
            "EscrowDt": "2021-12-01T14:40:00",
            "TrackingUrl": null
        },
        {
            "EscrowType": "거래완료 후 환불요청",
            "EscrowDt": "2023-05-09T15:57:21.887",
            "TrackingUrl": null
        },
        {
            "EscrowType": "거래완료 후 환불완료",
            "EscrowDt": "2023-05-09T16:02:02.483",
            "TrackingUrl": null
        }
    ]
}

Sample Code_Fail

{
  "ResultCode":3000,
  "Message":"매개 변수 값을 Int64에서 Int32(으)로 변환하지 못했습니다.",
  "Data":null
}

 

Error Code

결과코드 메시지 원인
3000 매개 변수 값을 Int64에서 Int32(으)로 변환하지 못했습니다. OrderNo 자릿수 오류

 

'주문 | 배송 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.12