**版本：202601**

# 查询采购单列表

**GET** `/openapi/2026-01/procurements`

分页返回采购单列表。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `ids` string[]

  ID 列表。 示例：?ids=1001&ids=1002
- `state` int32

  采购单状态筛选，可选值：`1`（待到货）、`2`（部分收货）、`3`（收货完成）、`4`（已取消）
- `created_at_min` string

  最早创建时间
- `created_at_max` string

  最晚创建时间
- `updated_at_min` string

  最早更新时间
- `updated_at_max` string

  最晚更新时间

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `procurements` object[]

    采购单列表

    *   Array \[

    - `id` string

      采购 ID
    - `procurement_sn` string

      采购单编号
    - `supplier_id` string

      供应商 ID
    - `location_id` string

      位置 ID
    - `note` string

      备注
    - `state` int32

      采购单状态
    - `pending_quantity` int32

      待处理数量
    - `received_quantity` int32

      已收货数量
    - `rejected_quantity` int32

      被拒绝数量
    - `transfer_quantity` int32

      调拨数量
    - `created_by` string

      创建人
    - `created_at` string

      创建时间，ISO-8601 格式
    - `updated_at` string

      最后更新时间，ISO-8601 格式
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `total` int32

    全部页的总记录数(供 page 模式分页计算总页数)

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "procurements": [
      {
        "id": "string",
        "procurement_sn": "string",
        "supplier_id": "string",
        "location_id": "string",
        "note": "string",
        "state": 0,
        "pending_quantity": 0,
        "received_quantity": 0,
        "rejected_quantity": 0,
        "transfer_quantity": 0,
        "created_by": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```