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

获取借用订单

POST
/adminapi/openapi_orderBoxIndex
查询授权范围内格子柜借用订单列表。
借用/归还独立筛选(v1.0.30+):realname(借用人)、endrealname(归还/终止操作人)、
creat_time(借用时间范围)、end_time(归还时间范围)均为非必填,可通过 Query 或 JSON 请求体传入。
未传、null 或空白字符串不增加对应条件;两个姓名分别模糊匹配当前人员资料,多个筛选条件取交集。
时间范围使用英文逗号分隔开始、结束端点;每个端点支持 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss,可以混用。
开始端仅传日期时补 00:00:00,结束端仅传日期时补 23:59:59;完整时间保留秒数,范围包含两端。
例如 2026-09-01,2026-09-21 等价于 2026-09-01 00:00:00,2026-09-21 23:59:59。
缺少端点、格式错误、无效日期时间或开始晚于结束时返回参数错误(code=400)。
两个独立时间范围不受 time_type 切换影响;与原 days、time_type、key.time 同传时,各条件取交集。
原 days 仍按整日筛选,原 key.time 保留日期/分钟规则;需要秒级筛选时使用 creat_time 或 end_time。
归还时间为空的订单不命中归还时间范围;筛选不自动限制订单状态,type=3 仍表示管理员终止操作人及时间。
订单备注(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 及其别名筛选仍匹配借用人,endrealname 独立筛选归还/终止操作人。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "limit": 100,
    "creat_time": "2026-09-01,2026-09-12",
    "end_time": "2026-09-15,2026-09-21"
}

请求示例代码

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.untzg.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=%E7%A4%BA%E4%BE%8B%E5%80%9F%E7%94%A8%E4%BA%BA%E7%94%B2&endrealname=%E7%A4%BA%E4%BE%8B%E5%BD%92%E8%BF%98%E4%BA%BA%E4%B9%99&creat_time=2026-09-01%2C2026-09-21&end_time=2026-09-21%2009%3A00%3A00%2C2026-09-21%2018%3A00%3A00' \
--header 'token;' \
--header 'Content-Type: application/json' \
--data '{
    "limit": 100,
    "creat_time": "2026-09-01,2026-09-12",
    "end_time": "2026-09-15,2026-09-21"
}'

返回响应

🟢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-10-21 07:38:36
上一页
获取订单列表
下一页
新增/编辑领料工单
Built with