1.5 KiB
1.5 KiB
取货工单 MCP 工具设计
需求：REQ-20260917-0003；开发任务：#21964；设计文档：doc 12684。
工具
pickup.order.list.query：分页查询m2.pickup_order，支持工单号、公司、项目、类型、状态、取货方式、 申请人和申请/取货/完成日期过滤。固定按 ID 倒序，物流以本页工单号批量读取 m1，避免逐条查询。pickup.order.detail.query：按 ID 或工单号查询；返回主单、物流、原取货物品、SN 调整、物流图片、 已办流程与凭证、关联出入库/调拨/划转单。
权限
列表和详情统一调用 PermissionService.applyPickupOrderRowFilter：总部不加过滤；代理用户可见自己、
授权代管代理/物业范围及本人参与流程的工单（不扩展到直属下级代理）；销售非负责人使用其物业范围并保留本人流程参与范围。
不存在与无权访问统一返回 NOT_FOUND_OR_FORBIDDEN。
数据约定
- 申请日期按业务字段
apply_time，不沿用旧列表实际使用的create_time。 pickup_order_details.type IN (0,2)为原取货物品，type=1为取货后 SN 明细。- 流程只返回
schedule_state=2的已办记录，按operation_time,id正序。 - 流程附件限定
file_type=3、in_out_allocation_type=12。 - 附件只返回 bucket 与 objectKey，不拼接公开 URL。
- 不返回旧页面通过姓名字符串推断的
isReceipt/isPickupUI 操作标记。