Sign in
3. Order

퀵서비스 주문 접수

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

post/v1/orderQuick

Query parameters

partnerOrderNoDuplicateCheckboolean

제휴사 주문번호 중복 체크 여부

partnerInvoiceNoDuplicateCheckboolean

제휴사 운송장번호 중복 체크 여부

Request body

fromZipCode'range[0' | '5]'

보내는 분 우편번호

fromNamestring

보내는 분 이름

fromPhoneNumberstring

보내는 분 연락처(휴대폰)

fromAddr1string

보내는 분 주소1

fromAddr2string

보내는 분 주소2

toZipCode'range[0' | '5]'

받는 분 우편번호

toNamestring

받는 분 이름

toPhoneNumberstring

받는 분 연락처

toAddr1string

받는 분 주소1

toAddr2string

받는 분 주소2

boxType'XXSMALL' | 'XSMALL' | 'SMALL' | 'MEDIUM' | 'MEDIUM_LARGE' | 'LARGE' | 'XLARGE'

박스 종류

boxCountinteger

박스 수량

weightinteger

무게 (kg)

vehicleType'BIKE' | 'CAR'

배송수단

itemCategorystring

상품 유형

itemNamestring

상품명

itemPriceinteger

상품가격 (최대:200만원)

itemQuantityinteger

상품수량(박스 1개에 담긴 수량)

pickupMessagestring

픽업 기사에게 메시지

deliveryMessagestring

배달 기사에게 메시지

pickupRequestDateTimestring

픽업 요청(희망) 일시 (현재시간 이후)

partnerOrderNostring

제휴사 주문번호

partnerInvoiceNostring

제휴사 운송장번호

quickInfoIdstring

퀵 요금조회 정보 id

customDataJsonNode

Example request

[
  {
    "fromZipCode": "07988",
    "fromName": "홍길동",
    "fromPhoneNumber": "01011110000",
    "fromAddr1": "서울 양천구 목동서로 117",
    "fromAddr2": "2층 굿스코아",
    "toZipCode": "06095",
    "toName": "임꺽정",
    "toPhoneNumber": "01011110000",
    "toAddr1": "서울 강남구 봉은사로 479",
    "toAddr2": "479타워 16층 굿스플로",
    "boxType": "SMALL",
    "boxCount": 1,
    "weight": 5,
    "vehicleType": "BIKE",
    "itemCategory": "옷",
    "itemName": "폴로셔츠",
    "itemPrice": 50000,
    "itemQuantity": 1,
    "pickupMessage": "현관 앞에 둘게요.",
    "deliveryMessage": "경비실에 맡겨 주세요.",
    "pickupRequestDateTime": "2023-02-27 13:00",
    "quickInfoId": "퀵 요금조회 정보 id"
  }
]

Response

성공

successboolean

성공여부

messagestring

메시지

responseDateTimestring date-time

응답 서버 시간

Example response

{
  "success": true,
  "message": "오류가 있을 경우 오류 메시지",
  "data": {
    "orderNo": "210518-00077",
    "orderBoxList": [
      {
        "deliveryType": "D_PICKUP",
        "deliveryTypeName": "오늘픽업",
        "invoiceNo": "220527-00077-001",
        "boxType": "SMALL",
        "boxTypeName": "소형",
        "boxCost": 4500,
        "addedCost": 5000,
        "totalCost": 9500,
        "partnerMemo": "홍길동 고객님 접수 건",
        "transporter": "HOMEPICK3",
        "transporterName": "홈픽v3",
        "orderStatus": "RECEIVED",
        "orderStatusName": "접수완료",
        "partnerOriginOrderNo": "OD-54472342001",
        "toCoordinates": {
          "latitude": 37.4979,
          "longitude": 127.0276
        },
        "fromCoordinates": {
          "latitude": 37.4979,
          "longitude": 127.0276
        }
      }
    ]
  },
  "responseDateTime": "2022-05-27T14:45:13.051+09:00"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.