[REQ-20260917-0003] 取货工单 MCP 查询工具（列表+详情） (#19)

xiaoqu-agent-service/doc/agent-mcp-tools-reference.md

@@ -648,6 +648,38 @@
 
 ---
 
+## 24. pickup.order.list.query
+
+分页查询取货工单，对应旧系统 `POST /pickup/pickupListByPage`。
+
+- 分类：workorder ｜ 类型：读
+- 数据来源：m2 `pickup_order`，物流来自 m1 `mall_order_logistics`。
+- 入参：`pickupOrderNo`、`installOrderNo`、`withdrawOrderNo`、`agentId`、`districtName`、
+  `type`、`orderState`、`sendMode`、`applyUserName`、申请/取货/完成日期范围及 `page/rows`。
+- `type`：0=装机发起，1=人工发起，2=撤机发起；`orderState`：-2=被驳回，-1=待审核，
+  0=待取货，1=待入库，2=已完成，3=已取消；`sendMode`：0=快递公司，1=自行派送。
+- 申请日期按 `apply_time` 查询；三组日期范围可同时过滤，结束日期含当天。
+- 行级权限：总部看全部；代理身份可看申请代理或所属代理在自己、授权代管范围内的工单，
+  以及授权代管物业和本人参与流程的工单；销售非负责人按其可见物业及本人参与流程过滤。
+- 返回 `total/page/rows/records`，固定按 ID 倒序；物流按本页单号一次批量查询。
+
+## 25. pickup.order.detail.query
+
+按 `id` 或 `pickupOrderNo` 查询详情，两者至少传一个；同时传入时必须匹配同一条可见记录。
+
+- 行级权限与列表完全一致；不存在和无权统一返回 `NOT_FOUND_OR_FORBIDDEN`。
+- `record/logistics`：取货主单、状态/来源文案及物流信息。
+- `pickupGoods`：m2 `pickup_order_details` 中 `type IN (0,2)` 的原取货物品。
+- `serialChanges`：同表 `type=1` 的取货后录入或调整 SN 明细。
+- `shippingFiles`：m1 `mall_logistics_pic` 物流取货图片。
+- `processes`：`schedule_state=2` 的流程记录及 m2 `warehouse_in_out_pic` 取货/入库凭证。
+- `relatedDocuments`：m2 `install_to_out_warehouse` 关联的出库、入库、调拨或划转单。
+- 同时返回关联装机单、撤机单及维修工单号；附件仅返回 `id/fileName/bucket/objectKey`。
+
+详细设计见 `pickup-order-mcp-tools-design.md`。
+
+---
+
 ## 附录：在线查看工具清单
 
 ```bash