---
title: "퀵서비스 주문 접수"
method: POST
path: "/v1/orderQuick"
tags: ["3. Order"]
---

# 퀵서비스 주문 접수

`POST /v1/orderQuick`

홈픽 서비스 퀵서비스 주문정보 접수

## Query parameters

- `partnerOrderNoDuplicateCheck` boolean
- `partnerInvoiceNoDuplicateCheck` boolean

## Request body

- OrderBoxQuickReceiptDTO[] — 주문접수데이터
  - `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

## Response `200`

성공

- JFSOrderReceiptResponseDTO — 주문 접수 응답
  - `success` boolean — 성공여부
  - `message` string — 메시지
  - `data` OrderReceiptResponseDTOOrderBoxReceiptResponseDTO — 주문 접수 응답-data
    - `orderNo` string — 주문(접수) 번호
    - `orderBoxList` OrderBoxReceiptResponseDTO[] — 주문 박스 리스트
      - `deliveryType` string — 접수된 배송 유형
      - `deliveryTypeName` string — 접수된 배송 유형명
      - `invoiceNo` string — 박스(운송장) 번호
      - `boxType` string — 박스 종류
      - `boxTypeName` string — 박스 종류 명
      - `boxCost` integer — 박스 기본 가격
      - `addedCost` integer — 추가 요금(도선료 등)
      - `totalCost` integer — 박스 가격(기본가격 + 도선료)
      - `partnerOrderNo` string — 제휴사 주문번호
      - `partnerInvoiceNo` string — 제휴사 운송장번호
      - `partnerMemo` string — 제휴사 메모
      - `transporter` string — 배송사코드
      - `transporterName` string — 배송사명
      - `transporterInvoiceNo` string — 배송사운송장번호
      - `convenienceReserveNo` string — 편의점택배 예약번호 (송장번호와 별개, 편의점 방문 접수용)
      - `orderStatus` string — 배송상태
      - `orderStatusName` string — 배송상태명
      - `partnerOriginOrderNo` string — 반품/맞교환 시 원 주문번호
      - `tmsError` string — 배차 접수 실패 메시지 (자동 취소 시)
      - `toCoordinates` Coordinates
        - `latitude` number, double — 위도
        - `longitude` number, double — 경도
      - `fromCoordinates` Coordinates
        - `latitude` number, double — 위도
        - `longitude` number, double — 경도
  - `responseDateTime` string, date-time — 응답 서버 시간

---

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