주문 API

판매자 주문 목록·상세 조회 및 주문 상태 변경 API입니다.

엔드포인트

구분설명

GET /orders

주문 목록 (orders:read)

GET /orders/{order_number}

주문 상세 (orders:read)

PATCH /orders/{order_number}

주문 상태 변경 (orders:write)

목록 조회

쿼리: startDate, endDate, status, payment_status, search, page, limit(1~100, 기본 20)

식별자는 order_number입니다. 내부 UUID는 응답에 포함되지 않습니다.

bash

curl "https://qnector.kr/api/v1/seller/orders?status=confirmed&page=1&limit=20" \
  -H "Authorization: Bearer qnc_live_YOUR_API_KEY"

엔드포인트 예시

GET /orders

주문 목록 (orders:read)

응답 예시 (200)

json

{
  "data": [
    {
      "order_number": "ORD-20260626-001",
      "buyer_name": "테스트 구매자",
      "total_amount": 45000,
      "status": "confirmed",
      "payment_status": "DONE",
      "created_at": "2026-06-26T10:00:00Z",
      "order_items": [
        {
          "prod_code": "SKU-001",
          "prod_name": "사과 5kg",
          "warehouse_code": "WH-01",
          "warehouse_name": "본사 창고",
          "quantity": 3,
          "price_per_unit": 15000,
          "total_price": 45000
        }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 },
  "errors": []
}

상세 조회

경로의 order_number로 단일 주문을 조회합니다. 품목 라인에 prod_code·warehouse_code가 포함됩니다.

bash

curl "https://qnector.kr/api/v1/seller/orders/ORD-20260626-001" \
  -H "Authorization: Bearer qnc_live_YOUR_API_KEY"

엔드포인트 예시

GET /orders/{order_number}

주문 상세 (orders:read)

응답 예시 (200)

json

{
  "data": {
    "order_number": "ORD-20260626-001",
    "buyer_name": "테스트 구매자",
    "buyer_business_number": "123-45-67890",
    "status": "confirmed",
    "total_amount": 45000,
    "created_at": "2026-06-26T10:00:00Z",
    "items": [
      {
        "prod_code": "SKU-001",
        "prod_name": "사과 5kg",
        "warehouse_code": "WH-01",
        "warehouse_name": "본사 창고",
        "quantity": 3,
        "price_per_unit": 15000,
        "total_amount": 45000
      }
    ]
  },
  "meta": {},
  "errors": []
}

상태 변경

PATCH /orders/{order_number} — status는 필수입니다. tracking_number·delivery_company는 선택입니다.

변경 가능한 status는 판매자 주문 UI와 동일합니다: pending(대기), processing(처리중), completed(완료), cancelled(취소).

필드	필수여부	자릿수/형식	설명
status	필수	string · pending \| processing \| completed \| cancelled	대기 · 처리중 · 완료 · 취소
tracking_number	선택	string	송장번호. 빈 문자열이면 송장번호 삭제
delivery_company	선택	string · 택배사 목록 값 또는 ""	택배사명. 빈 문자열이면 삭제. 목록 외 값은 400

엔드포인트 예시

PATCH /orders/{order_number}

주문 상태 변경 (orders:write)

요청 예시

json

{
  "status": "processing",
  "delivery_company": "CJ대한통운",
  "tracking_number": "123456789012"
}

응답 예시 (200)

json

{
  "data": {
    "success": true
  },
  "meta": {},
  "errors": []
}

택배사 목록

delivery_company에 사용할 수 있는 값입니다. 판매자 주문 관리 화면과 동일합니다.

구분설명

롯데택배

허용

우체국택배

허용

CJ대한통운

허용

한진택배

허용

로젠택배

허용

경동택배

허용

대신택배

허용

합동택배

허용

일양로지스

허용

용마로지스

허용

GS편의점택배

허용

천일택배

허용

EMS

허용

FedEx

허용

UPS Korea

허용

자체배송

허용

"" (빈 문자열)

택배사 삭제(선택안함)