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

# 배송흐름 벌크 조회

`POST /v1/sellers/order/status/bulk`

## Request

- Base URL: `https://api.homepick.com`
- URL: `https://api.homepick.com/v1/sellers/order/status/bulk`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/homepick/apis/homepick-api/docs/v1/sellers/order/status/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

셀러스 주문번호 여러 건(최대 50건)의 배송 상태/흐름을 한번에 조회. 배송조회 진입/새로고침용.
- 응답 각 원소의 partnerOrderNo 로 그룹핑할 수 있습니다.
- 존재하지 않는 주문번호는 응답에서 제외됩니다.
- completedOrCanceled=true 인 건은 배송 상태가 더 바뀌지 않으므로 재조회 대상에서 빼면 됩니다. 단 배송완료 이후에도 추가운임은 붙을 수 있고, 그건 조회가 아니라 통보로 전달됩니다.

## Request body

- SellersBulkStatusRequestDTO: 조회 대상 셀러스 주문번호 목록 (최대 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: 사유텍스트
    - `completedOrCanceled` boolean: 배송 종결 여부(배송완료 또는 취소). true 면 상태가 더 바뀌지 않으므로 재조회할 필요가 없다. 배송완료 이후에도 추가운임은 붙을 수 있어 '금액 확정'을 뜻하지는 않는다.
    - `costChangeHistory` OrderBoxCostChangeHistoryDTO[]: 추가요금 이력 리스트
      - `id` string
      - `changedAmount` integer
      - `reason` string
      - `createdDateTime` string, date-time
    - `boxCost` integer: 박스금액
    - `addedCost` integer: 추가금액
    - `cancelAmount` integer: 취소금액
    - `cart` boolean
  - `responseDateTime` string, date-time: 응답 서버 시간

## Changes

- **2026-09-07** `bec7a1780b65`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/homepick/apis/homepick-api/changes/v1/sellers/order/status/bulk/post.md)

---

[API](https://skmtc.dev/homepick/apis/homepick-api.md) - [All operations](https://skmtc.dev/homepick/apis/homepick-api/llms.txt) - [OpenAPI document](https://skmtc.dev/homepick/apis/homepick-api/revisions/12409651b2e4?raw)