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
  • 订单
    • 获取订单列表
      POST
    • 获取借用订单
      POST
  • 工单
    • 新增/编辑领料工单
  • 事件推送
    • 客户系统接收:领用工单查询(Android 发起)
    • 客户系统接收:借还工单查询(Android 发起)
    • 【Webhook 说明】货道变动推送(智能柜→客户)
    • 【Webhook 说明】订单状态推送(智能柜→客户)
    • 【Webhook 说明】借用订单状态推送(智能柜→客户)
  • 未开放
    • 调接口传数据给mes系统(刀具柜系统发起)
  • 报表统计
    • 售货机报表查询
    • 库存变动统计查询
    • 库存变动统计(精简,无期初/期末)
  • 机台
    • 查询机台
    • 修改机台
  • 数据模型
    • 操作成功
    • OpenApiOutRoadRequest
  1. 订单

获取借用订单

POST
/adminapi/openapi_orderBoxIndex
查询授权范围内格子柜借用订单列表。
订单备注(v1.0.27+):每条记录返回 tag(订单备注,包含微仓工单码),
取自 order_box.tag。无备注时保留原值 null 或空字符串;多行文本、空白和工单码前缀原样返回,
不受 PC 备注列显示配置、微仓工单码录入开关或 lld_type 影响。
微仓扫码/手输工单码示例:[借用工单码] WO20260911001、WO20260911002,多个码以顿号分隔。
gdh 仍是独立的工单号字段,不从备注中提取;gdh / work_order_no 筛选仍只匹配 gdh,不搜索备注。
日期筛选(可选):参数 days=开始日期,结束日期(YYYY-MM-DD,英文逗号)。不传则不限日期。
示例:2025-02-01,2025-03-01,包含首尾日全天。
time_type=borrow(默认)按借用时间 creat_time(数据库 order_box.cread_time);
time_type=return 按归还时间 end_time。非法类型返回参数错误(code=400)。
例如:days=2026-09-01,2026-09-14&time_type=return 查询该日期范围内归还的订单。
归还时间为空的记录不命中归还时间范围;不会自动追加或改变 type 状态条件。
兼容参数 key.time 也使用顶层 time_type 指定的字段;与 days 同传时两个范围取交集。
搜索筛选(可选):type 按借用订单状态筛选,gdh 按工单号模糊搜索。
也支持按机台/CNC、机器、商品、人员等筛选:lid、lname / cnc、jqcode / mid、pid、pcode、pname、realname、rno。
借用人与归还人(v1.0.29+):每条记录均返回 realname(借用人)和 endrealname(归还/终止操作人姓名)。
endrealname 通过订单已保存的 order_box.end_uid 关联人员资料,不使用借用人姓名兜底。
本人归还时两个姓名相同;他人代还时返回实际归还人的姓名。
未记录归还人(end_uid 为空或 0)、关联人员记录不存在时,endrealname 返回 null,订单仍正常返回。
人员已软删除但记录仍存在时保留其姓名;姓名为空字符串时原样返回空字符串。
type=3 表示管理员终止,此时 endrealname 为终止操作人,不表示发生了实际归还。
姓名取当前人员资料。realname 及其别名筛选仍匹配借用人,本次未增加归还人筛选参数。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "limit": 100,
    "days": "2026-09-01,2026-09-14",
    "time_type": "return"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.gdlykj.com/adminapi/openapi_orderBoxIndex?limit=2&days=2025-02-01%2C2025-03-01&time_type=return&type=1&gdh=GDH-20250717-001&lid=undefined&lname=undefined&jqcode=undefined&mid=undefined&pcode=undefined&pname=undefined&realname=undefined' \
--header 'token: aaa62f15311e04b08a9f56818046fcb5' \
--header 'Content-Type: application/json' \
--data '{
    "limit": 100,
    "days": "2026-09-01,2026-09-14",
    "time_type": "return"
}'

返回响应

🟢200
application/json
Bodyapplication/json

示例
{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "bordermark1": null,
            "bordermark2": null,
            "bordermark3": null,
            "brordermark1": null,
            "brordermark2": null,
            "brordermark3": null,
            "count": 1,
            "before_count": null,
            "after_count": null,
            "remaining_count": null,
            "id": 6402,
            "realname": "测试总管理员",
            "endrealname": null,
            "creat_time": "2025-07-17 17:25:28",
            "end_time": null,
            "type": 5,
            "tag": null,
            "gdh": "GDH-20250717-001",
            "lid": 2162,
            "lname": "CNC-01",
            "pname": "D10*",
            "pcode": "P001",
            "jqcode": "10346",
            "mname": "",
            "rno": null,
            "organization_name": "智能柜出厂测试",
            "cname": "铣刀"
        },
        {
            "bordermark1": null,
            "bordermark2": null,
            "bordermark3": null,
            "brordermark1": null,
            "brordermark2": null,
            "brordermark3": null,
            "count": 1,
            "before_count": null,
            "after_count": null,
            "remaining_count": null,
            "id": 6401,
            "realname": "测试总管理员",
            "endrealname": null,
            "creat_time": "2025-07-17 17:25:09",
            "end_time": null,
            "type": 5,
            "tag": "",
            "gdh": "GDH-20250717-002",
            "pname": "Nestle Coffee",
            "jqcode": "10346",
            "mname": "",
            "rno": null,
            "organization_name": "智能柜出厂测试",
            "cname": "Beverages"
        },
        {
            "id": 6400,
            "organization_name": "示例机构",
            "realname": "示例使用人",
            "endrealname": null,
            "jqcode": "WC-001",
            "mname": "微仓",
            "cname": "工装",
            "pname": "示例物品",
            "rno": "2207",
            "creat_time": "2026-09-11 10:39:00",
            "end_time": null,
            "type": 1,
            "gdh": null,
            "tag": "[借用工单码] WO20260911001、WO20260911002",
            "count": "1"
        },
        {
            "id": 6399,
            "organization_name": "示例机构",
            "realname": "示例借用人甲",
            "endrealname": "示例借用人甲",
            "jqcode": "WC-001",
            "pname": "示例物品",
            "creat_time": "2026-09-12 09:00:00",
            "end_time": "2026-09-15 10:00:00",
            "type": 2,
            "tag": null
        },
        {
            "id": 6398,
            "organization_name": "示例机构",
            "realname": "示例借用人甲",
            "endrealname": "示例归还人乙",
            "jqcode": "WC-001",
            "pname": "示例物品",
            "creat_time": "2026-09-12 09:00:00",
            "end_time": "2026-09-15 11:00:00",
            "type": 2,
            "tag": "[借用工单码] WO20260912001"
        },
        {
            "id": 6397,
            "organization_name": "示例机构",
            "realname": "示例借用人甲",
            "endrealname": "示例管理员",
            "jqcode": "WC-001",
            "pname": "示例物品",
            "creat_time": "2026-09-12 09:00:00",
            "end_time": "2026-09-15 12:00:00",
            "type": 3,
            "tag": null
        }
    ]
}
修改于 2026-09-21 07:23:30
上一页
获取订单列表
下一页
新增/编辑领料工单
Built with