1. 事件推送
智能柜开放接口
  • 认证
    • 登录
      POST
    • 登录验证
      POST
  • 机构
    • 获取机构列表
      POST
    • 添加机构
      POST
    • 编辑机构
      POST
    • 删除机构
      POST
    • 获取人员列表
      POST
    • 添加人员
      POST
    • 编辑人员
      POST
    • 删除人员
      POST
    • 后台用户列表
      POST
  • 商品库
    • 获取分类列表
      POST
    • 获取商品列表
      POST
    • 新增/编辑/删除分类
      POST
    • 新增/编辑/删除商品
      POST
    • 删除商品
      POST
  • 设备与货道
    • 获取机器列表
      POST
    • 获取货道库存信息
      POST
    • 货道补货 / 编辑货道商品
      POST
    • 货道补货 / 编辑(与 openapi_saveRoad 相同)
      POST
    • 查询格子柜格子信息
      POST
    • 保存/修改已有格子信息
      POST
    • 远程弹簧货道直出
      POST
    • 触发 RFID 单次读取
      POST
    • 远程打开格子柜
      POST
    • 修改机器基本信息
      POST
    • 格子记录
      POST
    • 库存变动记录(主动查询)
      POST
  • 订单
    • 获取订单列表
    • 获取借用订单
  • 工单
    • 新增/编辑领料工单
  • 事件推送
    • 客户系统接收:领用工单查询(Android 发起)
      POST
    • 客户系统接收:借还工单查询(Android 发起)
      POST
    • 【Webhook 说明】货道变动推送(智能柜→客户)
      POST
    • 【Webhook 说明】订单状态推送(智能柜→客户)
      POST
    • 【Webhook 说明】借用订单状态推送(智能柜→客户)
      POST
  • 未开放
    • 调接口传数据给mes系统(刀具柜系统发起)
  • 报表统计
    • 售货机报表查询
    • 库存变动统计查询
    • 库存变动统计(精简,无期初/期末)
  • 机台
    • 查询机台
    • 修改机台
  • 数据模型
    • 操作成功
    • OpenApiOutRoadRequest
  1. 事件推送

客户系统接收:借还工单查询(Android 发起)

POST
/_documentation/customer-work-order-borrow-query
本文档项不是智能柜服务端接口。 启用条件:
PC 端 /machine → 工单模式弹窗中勾选 启用借还工单 并填写客户系统地址
Android 设备 WRHCType = 0
用户进入借用流程时输入或扫描工单号
Android 会直接向客户配置的 URL POST 本请求。客户返回工单商品后,Android 仅展示/允许工单内商品。
若 PC 端同时勾选 允许非工单领料,设备右上角显示“非工单领料”按钮,点击后显示全部商品。
请求字段与领用工单查询一致,仅 event 固定为 work_order.borrow.query。
请求中不会包含 authid、mid、name、sn,会包含 user.mobile。
响应商品行只使用 pcode、name、quantity,不要返回 product_id、line_no。
数量规则
借还柜、多物品借还柜只统计当前未归还数量;已归还不再占用
借还柜先开门再上传,上传到服务器后只记录,不因超限拒绝或回滚
重力柜在关门前若当前重量换算数量超过剩余值,只语音提示“超量了”;关门后不再提示,最终提交仍成功

请求参数

Body 参数application/json必填

示例
{
    "event": "work_order.borrow.query",
    "work_order_no": "BR202607040001",
    "user": {
        "aid": 123,
        "realname": "张三",
        "mobile": "13800138000"
    },
    "machine": {
        "jqcode": "10339"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.gdlykj.com/_documentation/customer-work-order-borrow-query' \
--header 'Content-Type: application/json' \
--data '{
    "event": "work_order.borrow.query",
    "work_order_no": "BR202607040001",
    "user": {
        "aid": 123,
        "realname": "张三",
        "mobile": "13800138000"
    },
    "machine": {
        "jqcode": "10339"
    }
}'

返回响应

🟢200
application/json
客户系统响应;结构与领用工单查询一致
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "work_order_no": "BR202607040001",
        "items": [
            {
                "pcode": "P001",
                "name": "扭矩扳手",
                "quantity": 1
            }
        ]
    }
}
修改于 2026-07-22 03:36:29
上一页
客户系统接收:领用工单查询(Android 发起)
下一页
【Webhook 说明】货道变动推送(智能柜→客户)
Built with