客户系统接收：领用工单查询（Android 发起）

本文档项不是智能柜服务端接口。 启用条件：

PC 端 /machine → 工单模式弹窗中，领用工单模式选择 工单领料 或 工单与普通领料共存

勾选 启用第三方工单 并填写客户系统地址

Android 设备 WRHCType = 0

用户在 Android 端刷脸后输入或扫描工单号，Android 会直接向客户配置的 URL POST 本请求。
服务器只负责保存配置、下发配置、以及接收最终领用记录；本查询不是服务器端发起。

请求字段说明

字段	说明
`event`	固定为 `work_order.pickup.query`，表示领用工单查询
`work_order_no`	用户输入或扫描的工单号
`user.aid`	智能柜系统人员 ID（admin.id）
`user.realname`	当前刷脸/认证人员姓名
`user.mobile`	当前人员手机号；本版本新增
`machine.jqcode`	机器编号

请求中不会包含 authid、mid、name、sn。

响应字段说明

字段	说明
`code`	`200` 表示成功，其他值表示失败
`msg`	响应消息
`data.work_order_no`	工单号，可与请求一致
`data.items[].pcode`	商品编码，用于匹配智能柜本机商品编码 `product.number`
`data.items[].name`	商品显示名称
`data.items[].quantity`	计划/限制数量；`>0` 时生效，`<=0` 或缺失表示不限制

响应商品行不要返回 product_id、line_no。

数量规则

领用模式下，本机提交成功后会永久累计已领数量

quantity > 0 时，Android/服务器按剩余数量限制；quantity <= 0 不限制

{ "event": "work_order.pickup.query", "work_order_no": "MO202607040001", "user": { "aid": 123, "realname": "张三", "mobile": "13800138000" }, "machine": { "jqcode": "10339" } }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

客户系统响应；HTTP 200 且 body.code=200 视为成功

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "work_order_no": "MO202607040001",
        "items": [
            {
                "pcode": "P001",
                "name": "刀具A",
                "quantity": 2
            },
            {
                "pcode": "P002",
                "name": "刀具B",
                "quantity": 0
            }
        ]
    }
}

客户系统接收：领用工单查询（Android 发起）

请求参数

请求示例代码

返回响应