---
title: "퀵/화물 요금조회"
method: POST
path: "/v1/ezadmin/totalCost"
tags: ["Etc. EzAdmin API"]
---

# 퀵/화물 요금조회

`POST /v1/ezadmin/totalCost`

퀵/화물 통합 요금조회. deliveryType(D_QUICK|D_CARGO)에 따라 quick/cargo 객체 필수.
- 접수(order) 시 필요한 요금조회 id(36자리 uuid)를 반환합니다.
- 경유지(waypoint)는 quick/cargo 객체 안에 포함하여 전달합니다.

## Request body

- TotalCostRequestDTO — 요금조회 정보
  - `deliveryType` 'D_QUICK' | 'D_CARGO' — 배송타입
  - `fromAddress1` string — 보내는 분 주소1
  - `fromAddress2` string — 보내는 분 주소2
  - `toAddress1` string — 받는 분 주소2
  - `toAddress2` string — 받는 분 주소2
  - `quick` TotalCostQuickDTO
    - `weight` integer — 무게(단위: kg)
    - `boxType` 'XSMALL' | 'SMALL' | 'LARGE' — 박스 종류
    - `boxCount` integer — 박스 수
    - `itemCategory` string — 상품 유형
    - `itemName` string — 상품명
    - `itemPrice` integer — 상품가격 (최대:200만원)
    - `itemQuantity` integer — 상품수량(박스 1개에 담긴 수량)
    - `pickupRequestDateTime` string, date-time — 픽업요청일시
    - `comment` string — 코멘트
    - `waypoint` OrderBoxWaypointDTO[] — 경유지
      - `address1` string — 주소1
      - `address2` string — 주소2
      - `name` string — 이름
      - `phoneNumber` string — 연락처(휴대폰)
      - `message` string — 메시지
    - `vehicleCategory` 'BIKE' | 'CAR' | 'ANY' — 배송수단 유형
    - `vehicleOption` 'BIKE_BOX' | 'BIKE_NO_BOX' | 'CAR_SUV' | 'CAR_ANY' — 배송수단 옵션 (배송수단이 BIKE, CAR 인 경우 필수)
  - `cargo` TotalCostCargoDTO
    - `weight` integer — 무게(단위: kg)
    - `boxType` 'XSMALL' | 'SMALL' | 'LARGE' — 박스 종류
    - `boxCount` integer — 박스 수
    - `itemCategory` string — 상품 유형
    - `itemName` string — 상품명
    - `itemPrice` integer — 상품가격 (최대:200만원)
    - `itemQuantity` integer — 상품수량(박스 1개에 담긴 수량)
    - `pickupRequestDateTime` string, date-time — 픽업요청일시
    - `comment` string — 코멘트
    - `waypoint` OrderBoxWaypointDTO[] — 경유지
      - `address1` string — 주소1
      - `address2` string — 주소2
      - `name` string — 이름
      - `phoneNumber` string — 연락처(휴대폰)
      - `message` string — 메시지
    - `vehicleType` 'DAMAS' | 'LABO' | '1T' | '1.4T' | '2.5T' | '3.5T' | '5T' | '8T' | '11T' | '14T' | '15T' | '18T' | '25T' — 배송수단 차종
    - `vehicleOption` 'DAMAS_NORMAL' | 'CARGO' | 'CANVAS' | 'BOX_TRUCK' | 'LOW_BOX_TRUCK' | 'WINGBODY_TRUCK' | 'FREEZER_TRUCK' | 'REFRIGERATOR_TRUCK' | 'LIFT_TRUCK' — 배송수단 옵션
    - `loadingPosition` 'LOADING_PARKING_SPACE' | 'NEED_ITEM_TRANSFER' — 출발지 상차위치
    - `loadingMethod` 'LOADING_YOURSELF' | 'LOADING_WITH_DRIVER' | 'LOADING_DRIVER' | 'LOADING_DRIVER_WITH_HELPER' — 출발지 상차방법
    - `unloadingPosition` 'UNLOADING_PARKING_SPACE' | 'NEED_ITEM_TRANSFER' — 도착지 하차위치
    - `unloadingMethod` 'UNLOADING_YOURSELF' | 'UNLOADING_WITH_DRIVER' | 'UNLOADING_DRIVER' | 'UNLOADING_DRIVER_WITH_HELPER' — 도착지 하차방법

## Response `200`

OK

---

[API](https://skmtc.dev/homepick/apis/homepick-api.md) · [All operations](https://skmtc.dev/homepick/apis/homepick-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/homepick/homepick-api/revisions/c6a379f962c8/schema)