---
title: "배송흐름 벌크 조회"
method: POST
path: "/v1/ezadmin/order/status/bulk"
tags: ["Etc. EzAdmin API"]
---

# 배송흐름 벌크 조회

`POST /v1/ezadmin/order/status/bulk`

제휴사 주문번호 여러 건(최대 50건)의 배송 상태/흐름을 한번에 조회. 배송조회 진입/새로고침용.
- 응답은 단건 조회(/order/status/partnerOrderNo/{no})와 동일한 DTO 리스트이며, 각 원소의 partnerOrderNo 로 그룹핑할 수 있습니다.
- 존재하지 않는 주문번호는 응답에서 제외됩니다.

## Request body

- EzadminBulkStatusRequestDTO — 조회 대상 제휴사 주문번호 목록 (최대 50건)
  - `partnerOrderNos` string[] — 조회 대상 제휴사 주문번호 목록 (최대 50건)

## Response `200`

성공

- JFSOrderStatusHistoryItemSimpleBoxDTOList — 주문 상태 조회 응답
  - `success` boolean — 성공여부
  - `message` string — 메시지
  - `data` OrderStatusHistoryItemSimpleBoxDTO[]
    - `orderNo` string — 주문 번호
    - `invoiceNo` string — 박스(운송장) 번호
    - `transporter` 'HANJIN,CUHOME,EPOST,CJGLS' — 배송사 코드
    - `transporterInvoiceNo` string — 배송사 송장번호
    - `relayTransporter` 'HANJIN,CUHOME,EPOST,CJGLS' — 연계배송사 코드
    - `relayTransporterInvoiceNo` string — 연계배송사 운송장번호
    - `partnerOrderNo` string — 제휴사 주문번호
    - `partnerInvoiceNo` string — 제휴사 운송장번호
    - `partnerMemo` string — 제휴사 메모
    - `statusList` OrderStatusHistoryItemSimpleDTO[] — 주문 상태 이력 리스트
      - `createdDateTime` string — 상태 생성일시
      - `orderStatus` 'RESERVED' | 'RESERVED_CANCELED' | 'RECEIVED' | 'TRANSFERRED' | 'ALLOCATED' | 'PICKUP_START' | 'PICKUP_FAILED' | 'PICKUP' | 'MOVING' | 'DLV_START' | 'WAYPOINT_ARRIVAL' | 'COMPLETED' | 'CANCELED' — 주문상태
      - `orderStatusName` '예약' | '예약취소' | '접수완료' | '이관' | '배차' | '픽업출발' | '미픽업' | '픽업완료' | '이동중' | '배송출발' | '경유지도착' | '배송완료' | '취소' — 주문상태명
      - `orderStatusDateTime` string — 상태 일시
      - `location` string — 현재 위치(지점)
      - `tmsStatusName` string — 배송사 상태명
      - `driverName` string — 기사명
      - `driverPhoneNumber` string — 기사 연락처
      - `reasonType` string — 사유(픽업/배송)
      - `contents` string — 사유텍스트
    - `costChangeHistory` OrderBoxCostChangeHistoryDTO[] — 추가요금 이력 리스트
      - `id` string
      - `changedAmount` integer
      - `reason` string
      - `createdDateTime` string, date-time
    - `boxCost` integer — 박스금액
    - `addedCost` integer — 추가금액
    - `cancelAmount` integer — 취소금액
    - `cart` boolean
  - `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)