List Orders

주문 상태별 품목 목록을 조회합니다.

Endpoint


POST /vendor-api/orders

Description

status 파라미터로 지정한 상태에 해당하는 주문 품목 목록을 조회합니다. 인증된 입점사에 해당하는 품목만 반환되며, 브라이트몰 자사제품은 자동으로 제외됩니다.

Request

Headers

Header	Required	Description
`Content-Type`	O	`application/json`
`X-Vendor-Api-Key`	O	발급받은 API Key
`X-Vendor-Id`	O	입점사 고유 ID

Body Parameters

Field	Type	Required	Description
`start_date`	string	O	조회 시작일 (`YYYY-MM-DD`)
`end_date`	string	O	조회 종료일 (`YYYY-MM-DD`)
`status`	string	O	주문 상태 (`결제완료`, `배송준비`, `배송중`, `배송완료`)
`page`	number	-	페이지 번호 (기본값: 1)
`limit`	number	-	페이지당 항목 수 (기본값: 100, 최대: 100)

Request Example


curl -X POST "https://staging-brightmall-backend.certi.life/vendor-api/orders" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: bm_xOpGAqgHbJQBXxBBbUIZ_bAGZk4wK2FdLgF50277PU8" \
  -H "X-Vendor-Id: 01KC51ST1WSTAET481SHPH3PSY" \
  -d '{
    "start_date": "2026-01-01",
    "end_date": "2026-01-31",
    "status": "결제완료",
    "page": 1,
    "limit": 50
  }'

Response

Response Example


{
  "request_id": "req_mkp3h2qk_abc123",
  "timestamp": "2026-01-22T06:50:00.000Z",
  "order_list": [
    {
      "ord_no": "202601220157_000020196",
      "ord_prd_no": "202601220157_000020196_[1]",
      "ord_date": "2026-01-22",
      "pay_date": "2026-01-22",
      "hope_deli_sdate": null,
      "item_status": "pending",
 
      "order_tel": "02-1234-5678",
      "order_hp": "010-1234-5678",
      "order_id": "customer@example.com",
      "ord_name": "홍길동",
 
      "recv_name": "김도희",
      "recv_zipcode": "06234",
      "recv_addr1": "서울특별시 강남구 테헤란로 123",
      "recv_addr2": "4층",
      "recv_tel": "02-1234-5678",
      "recv_hp": "010-1234-5678",
 
      "paymethod": "카드",
      "ord_memo": "빠른 배송 부탁드립니다",
      "ord_price": 150000,
      "in_price": 150000,
      "ship_fee": 3000,
      "afterdeli": false,
 
      "ord_company": "치과의원",
      "ord_company_num": "123-45-67890",
      "ord_taxorgnum": "1234567890",
 
      "partner_code": "SEIL",
      "user_hname": "김영수",
      "user_phone": "010-9876-5432",
      "real_customer_info": null,
 
      "prd_name": "델리킷 Impre Kicker",
      "prd_match": null,
      "prd_code": "SEIL-001",
      "uitem_code": "variant-123",
      "item_name": "델리킷 Impre Kicker / M사이즈",
      "item_cnt": 2,
      "item_price": 75000,
 
      "trade_num": null,
      "trade_date": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "has_more": false
  }
}

Response Fields

주문 기본 정보

Field	Type	Description
`ord_no`	string	주문번호
`ord_prd_no`	string	주문품목번호 (PK)
`ord_date`	string	주문일자
`pay_date`	string	결제일자
`hope_deli_sdate`	string\|null	희망배송일
`item_status`	string	품목 상태 (`pending`, `preparing`, `shipped`, `delivered`)

주문자 정보

Field	Type	Description
`order_tel`	string	주문자 전화번호
`order_hp`	string	주문자 휴대폰
`order_id`	string	주문자 이메일
`ord_name`	string	주문자명

수령인 정보

Field	Type	Description
`recv_name`	string	수령인명 (담당자명만 추출)
`recv_zipcode`	string	수령인 우편번호
`recv_addr1`	string	수령인 주소
`recv_addr2`	string\|null	수령인 상세주소
`recv_tel`	string	수령인 전화번호
`recv_hp`	string	수령인 휴대폰

결제 정보

Field	Type	Description
`paymethod`	string	결제수단
`ord_memo`	string\|null	주문 메모
`ord_price`	number	주문 금액
`in_price`	number	결제 금액
`ship_fee`	number	배송비 (첫 번째 품목에만 표시)
`afterdeli`	boolean	착불 여부

사업자 정보

Field	Type	Description
`ord_company`	string	주문자 회사명
`ord_company_num`	string	사업자등록번호
`ord_taxorgnum`	string	종사업장번호

입점사/회원 정보

Field	Type	Description
`partner_code`	string\|null	입점사 코드 (해당 품목 공급 입점사)
`user_hname`	string	회원 실명
`user_phone`	string	회원 전화번호
`real_customer_info`	string\|null	실제 고객 정보

상품 정보

Field	Type	Description
`prd_name`	string	상품명
`prd_match`	string\|null	매칭 정보
`prd_code`	string	상품 코드
`uitem_code`	string	옵션 코드
`item_name`	string	품목명 (상품명 / 옵션)
`item_cnt`	number	수량
`item_price`	number	품목 단가

거래 정보

Field	Type	Description
`trade_num`	string\|null	거래번호
`trade_date`	string\|null	거래일자

Pagination

Field	Type	Description
`page`	number	현재 페이지 번호
`limit`	number	페이지당 항목 수
`total`	number	전체 항목 수
`has_more`	boolean	다음 페이지 존재 여부

Notes

status 파라미터에 따라 해당 상태의 품목만 필터링됩니다 (품목 단위 필터링).
recv_name은 슬래시(/)로 구분된 형식인 경우 마지막 부분(담당자명)만 반환됩니다.
ship_fee는 동일 주문 내 첫 번째 품목에만 주문 전체 배송비가 표시됩니다.
ord_prd_no의 인덱스는 원본 데이터 기준이며, 자사제품 제외로 일부만 반환되더라도 재정렬되지 않습니다.
조회 결과가 없으면 빈 배열(order_list: [])이 반환됩니다.

status 파라미터와 item_status 매핑

status (요청)	item_status (응답)
`결제완료`	`pending`, `null`
`배송준비`	`preparing`
`배송중`	`shipped`
`배송완료`	`delivered`