获取采购单列表

接口说明

分页查询材料采购单，支持按创建时间、工厂等条件筛选；返回当前页列表、总条数及金额汇总信息。列表项中包含供应商名称、关联合同号、柜柜订单号、项目地址、客户名称、采购单附件数量等；若调用方用户无材料金额查看权限，金额相关字段会显示为「无权限查看」。

请求信息

请求 URL: http://lbl-open.thinkerx.com/api/lbl/methods/warehousePurchase
请求方式: POST 或 GET（路由为 any，参数可通过 query 或表单传递；建议与同类材料采购接口一致使用 POST）

请求参数

参数名	必选	类型	说明
login_token	是	string	通行证
user_id	否	int	操作用户 id；用于判断是否拥有「材料采购模块—->材料列表查看金额」权限。无权限时金额相关字段会返回「无权限查看」
page	否	int	页码，默认 `1`
pageSize	否	int	每页条数，默认 `10`
start_date	否	string	采购单创建时间起始（按天解析为当日 `00:00:00`），对应 `wh_purchase.create_time`
end_date	否	string	采购单创建时间结束（按天解析为当日 `23:59:59`），对应 `wh_purchase.create_time`
factory_id	条件	int	单库模式（`is_single`）下必填；非单库可不传。传入时仅查询 `wh_purchase.factory_id` 等于该值的采购单

返回示例

{
  "status": 0,
  "message": "ok",
  "data": {
    "page": 0,
    "pageSize": 10,
    "total": "156",
    "data": [
      {
        "id": "1",
        "purchase_code": "CLCG20260101-001",
        "supplier_id": "14",
        "supplier_name": "某某供应商",
        "money_sum": "524.00",
        "money_sum_zh": "伍佰贰拾肆元整",
        "money_sum_expect": "524.00",
        "money_pay": "0.00",
        "money_left": "524.00",
        "create_time": "2026-01-01 10:00:00",
        "pic_count": "2",
        "order_group_code": "YX2026001,YX2026002",
        "ggcode": "GG001",
        "buyer_address": "某市某区",
        "customer_name": "某某客户",
        "idx": 1
      }
    ]
  }
}

失败时（例如单库缺少 factory_id）lbl 返回 return 非 0，开放平台侧为 status 非 0，message 为错误文案。

返回参数说明

外层（开放平台）

参数名	类型	说明
status	int	`0` 成功，非 `0` 失败
message	string	提示或错误信息
data	object	业务数据，见下表

data（与 lbl 原结构一致）

参数名	类型	说明
page	int	注意：实现里为当前页起始偏移 `(page-1)*pageSize`，不是页码
pageSize	int	每页条数
total	string/int	符合条件的采购单总数（去重 `wh_purchase.id`）
data	array	当前页采购单列表

data.data[]（列表行，含 `wp.*` 及关联字段）

除下表外，其余字段来自表 wh_purchase（如采购单号、状态、备注、制单人等，以实际库表为准）。

参数名	类型	说明
id	int/string	采购单 id
supplier_name	string\	null	供应商名称（`wh_supplier.name`）
pic_count	string/int	采购单附件图数量
order_group_code	string	关联合同号；可能来自 `wh_purchase.group_id` 对应合同与 `wh_purchase_group` 多合同合并，逗号拼接
ggcode	string	柜柜订单号等，多合同合并后逗号拼接
buyer_address	string	项目地址，多值合并去重后逗号拼接
customer_name	string	客户名称，多值合并去重后逗号拼接
idx	int	当前页内序号（从 1 递增）
money_sum / money_sum_zh / money_sum_expect / money_pay / money_left	string	金额类字段；若 `user_id` 对应账号无「材料采购模块—->材料列表查看金额」权限，上述字段可能均为字符串「无权限查看」

备注

列表先按筛选条件统计 id 集合，再按 id 倒序分页查询；无数据时 data.data 为空数组。
单库场景务必传对 factory_id，否则会返回「缺少参数:factory_id」。
lbl 侧 Comm::success 使用字段名 return / error / data，开放平台会转换为 status / message / data，与《添加采购单》等文档中的外层结构一致。