Delivery

배송 관련 정보를 제공하는 서비스입니다.

배송조회 가능 택배가코드 조회 서비스
배송조회에 이용할 택배사코드 리스트를 리턴합니다.(Delivery Tracker 제공)
End Point Method Parameter
/v1/delivery/inquiry/carrier-codes GET Query

Response
필드 설명 타입
name 택배사이름 String
id 택배사코드 String
tel 전화번호 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 28,
    "list": [
      {
        "name": "DHL",
        "tel": "+8215880001",
        "id": "de.dhl"
      },
      {
        "name": "Sagawa",
        "tel": "+810120189595",
        "id": "jp.sagawa"
      },
      {
        "name": "Kuroneko Yamato",
        "tel": "+810120189595",
        "id": "jp.yamato"
      },
      {
        "name": "Japan Post",
        "tel": "+810570046111",
        "id": "jp.yuubin"
      },
      {
        "name": "천일택배",
        "tel": "+8218776606",
        "id": "kr.chunilps"
      },
      {
        "name": "CJ대한통운",
        "tel": "+8215881255",
        "id": "kr.cjlogistics"
      },
      {
        "name": "CU 편의점택배",
        "tel": "+8215771287",
        "id": "kr.cupost"
      },
      {
        "name": "GS Postbox 택배",
        "tel": "+8215771287",
        "id": "kr.cvsnet"
      },
      {
        "name": "CWAY (Woori Express)",
        "tel": "+8215884899",
        "id": "kr.cway"
      },
      {
        "name": "대신택배",
        "tel": "+82314620100",
        "id": "kr.daesin"
      },
      {
        "name": "우체국 택배",
        "tel": "+8215881300",
        "id": "kr.epost"
      },
      {
        "name": "한의사랑택배",
        "tel": "+8216001055",
        "id": "kr.hanips"
      },
      {
        "name": "한진택배",
        "tel": "+8215880011",
        "id": "kr.hanjin"
      },
      {
        "name": "합동택배",
        "tel": "+8218993392",
        "id": "kr.hdexp"
      },
      {
        "name": "홈픽",
        "tel": "+8218000987",
        "id": "kr.homepick"
      },
      {
        "name": "한서호남택배",
        "tel": "+8218770572",
        "id": "kr.honamlogis"
      },
      {
        "name": "일양로지스",
        "tel": "+8215880002",
        "id": "kr.ilyanglogis"
      },
      {
        "name": "경동택배",
        "tel": "+8218995368",
        "id": "kr.kdexp"
      },
      {
        "name": "건영택배",
        "tel": "+82533543001",
        "id": "kr.kunyoung"
      },
      {
        "name": "로젠택배",
        "tel": "+8215889988",
        "id": "kr.logen"
      },
      {
        "name": "롯데택배",
        "tel": "+8215882121",
        "id": "kr.lotte"
      },
      {
        "name": "SLX",
        "tel": "+82316375400",
        "id": "kr.slx"
      },
      {
        "name": "성원글로벌카고",
        "tel": "+82327469984",
        "id": "kr.swgexp"
      },
      {
        "name": "TNT",
        "id": "nl.tnt"
      },
      {
        "name": "EMS",
        "id": "un.upu.ems"
      },
      {
        "name": "Fedex",
        "id": "us.fedex"
      },
      {
        "name": "UPS",
        "id": "us.ups"
      },
      {
        "name": "USPS",
        "id": "us.usps"
      }
    ]
  }
}
배송조회 서비스
운송장번호에 대한 배송조회 결과를 리턴합니다.(Delivery Tracker 제공)
End Point Method Parameter
/v1/delivery/inquiry/tracks GET Query

Response
필드 설명 타입
carrier 택배사정보 Object
progresses 배송이력 Object
from 보내는분 Object
to 받는분 Object
state 배송상태 Object

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "carrier": {
      "name": "CJ대한통운",
      "tel": "+8215881255",
      "id": "655786650052"
    },
    "progresses": [
      {
        "description": "보내시는 고객님으로부터 상품을 인수받았습니다",
        "location": {
          "name": "서울잠원나루"
        },
        "time": "2023-04-27T19:18:00+09:00",
        "status": {
          "id": "at_pickup",
          "text": "상품인수"
        }
      },
      {
        "description": "배송지역으로 상품이 이동중입니다.",
        "location": {
          "name": "곤지암Hub"
        },
        "time": "2023-04-28T03:17:07+09:00",
        "status": {
          "id": "in_transit",
          "text": "상품이동중"
        }
      },
      {
        "description": "고객님의 상품을 배송할 예정입니다.(15∼17시)(배송담당:손*호 010-****-****)",
        "location": {
          "name": "서울가락동"
        },
        "time": "2023-04-28T11:46:49+09:00",
        "status": {
          "id": "out_for_delivery",
          "text": "배송출발"
        }
      },
      {
        "description": "고객님의 상품이 배송완료 되었습니다.(담당사원:손*호 010-****-****)",
        "location": {
          "name": "서울가락동"
        },
        "time": "2023-04-28T16:08:41+09:00",
        "status": {
          "id": "delivered",
          "text": "배달완료"
        }
      }
    ],
    "from": {
      "name": "바*",
      "time": "2023-04-27T19:18:00+09:00"
    },
    "to": {
      "name": "김*",
      "time": "2023-04-28T16:08:41+09:00"
    },
    "state": {
      "id": "delivered",
      "text": "배달완료"
    }
  }
}