---
title: "퀵/화물 통합 접수"
method: POST
path: "/v1/ezadmin/order"
tags: ["Etc. EzAdmin API"]
---

# 퀵/화물 통합 접수

`POST /v1/ezadmin/order`

deliveryType(D_QUICK|D_CARGO)으로 분기하여 접수. 해당 타입의 리스트만 채워 전달.
- 각 건은 요금조회에서 받은 id(quickInfoId/cargoInfoId)를 포함해야 합니다.

## Request body

- EzadminOrderRequestDTO — 퀵/화물 접수 정보
  - `deliveryType` 'D_QUICK' | 'D_CARGO' — 배송타입
  - `quick` OrderBoxQuickReceiptDTO[] — 퀵 접수 목록 (deliveryType=D_QUICK 인 경우)
    - `fromZipCode` 'range[0' | '5]' — 보내는 분 우편번호
    - `fromName` string — 보내는 분 이름
    - `fromPhoneNumber` string — 보내는 분 연락처(휴대폰)
    - `fromAddr1` string — 보내는 분 주소1
    - `fromAddr2` string — 보내는 분 주소2
    - `toZipCode` 'range[0' | '5]' — 받는 분 우편번호
    - `toName` string — 받는 분 이름
    - `toPhoneNumber` string — 받는 분 연락처
    - `toAddr1` string — 받는 분 주소1
    - `toAddr2` string — 받는 분 주소2
    - `boxType` 'XXSMALL' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'MEDIUM_LARGE' | 'LARGE' | 'XLARGE' — 박스 종류
    - `boxCount` integer — 박스 수량
    - `weight` integer — 무게 (kg)
    - `vehicleType` 'BIKE' | 'CAR' — 배송수단
    - `itemCategory` string — 상품 유형
    - `itemName` string — 상품명
    - `itemPrice` integer — 상품가격 (최대:200만원)
    - `itemQuantity` integer — 상품수량(박스 1개에 담긴 수량)
    - `pickupMessage` string — 픽업 기사에게 메시지
    - `deliveryMessage` string — 배달 기사에게 메시지
    - `pickupRequestDateTime` string — 픽업 요청(희망) 일시 (현재시간 이후)
    - `partnerOrderNo` string — 제휴사 주문번호
    - `partnerInvoiceNo` string — 제휴사 운송장번호
    - `quickInfoId` string — 퀵 요금조회 정보 id
    - `customData` JsonNode
  - `cargo` OrderBoxCargoReceiptDTO[] — 화물 접수 목록 (deliveryType=D_CARGO 인 경우)
    - `fromZipCode` 'range[0' | '5]' — 보내는 분 우편번호
    - `fromName` string — 보내는 분 이름
    - `fromPhoneNumber` string — 보내는 분 연락처(휴대폰)
    - `fromAddr1` string — 보내는 분 주소1
    - `fromAddr2` string — 보내는 분 주소2
    - `toZipCode` 'range[0' | '5]' — 받는 분 우편번호
    - `toName` string — 받는 분 이름
    - `toPhoneNumber` string — 받는 분 연락처
    - `toAddr1` string — 받는 분 주소1
    - `toAddr2` string — 받는 분 주소2
    - `pickupRequestDateTime` string — 픽업 요청(희망) 일시 (현재시간 이후)
    - `itemName` string — 상품명
    - `comment` string — 코멘트
    - `partnerOrderNo` string — 제휴사 주문번호
    - `partnerInvoiceNo` string — 제휴사 운송장번호
    - `cargoInfoId` string — 화물 요금조회 정보 id
    - `customData` JsonNode

## 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)