查询采购单列表

GET 
/openapi/2026-07/procurements

分页返回采购单列表。

请求

Query参数

cursor string

分页游标

page_size int32

每页记录数

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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

procurements object[]

采购单列表

Array [

idstring

采购 ID

procurement_snstring

采购单编号

supplier_idstring

供应商 ID

location_idstring

位置 ID

notestring

备注

stateint32

采购单状态

pending_quantityint32

待处理数量

received_quantityint32

已收货数量

rejected_quantityint32

被拒绝数量

transfer_quantityint32

调拨数量

created_bystring

创建人

created_atstring

创建时间，ISO-8601 格式

updated_atstring

最后更新时间，ISO-8601 格式

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "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
  }
}