# YNT智能设备管理系统开放接口

## API Docs
- 认证 [登录](https://apitext.pc.untzg.com/527138056e0.md): 使用 YNT 后台账号登录开放接口并获取 token。
- 认证 [登录验证](https://apitext.pc.untzg.com/527138057e0.md): 传入token 验证是否失效
- 机构 [获取机构列表](https://apitext.pc.untzg.com/527138058e0.md): 返回商品品牌、是否限定机床及当前机构保存的限定机床 ID 列表。
- 机构 [添加机构](https://apitext.pc.untzg.com/527138059e0.md): 
- 机构 [编辑机构](https://apitext.pc.untzg.com/527138060e0.md): 编辑已存在机构信息（名称、客服电话、机器类型等）。需 token 及机构管理权限 `tissue`。
- 机构 [删除机构](https://apitext.pc.untzg.com/527138061e0.md): 
- 机构 [获取人员列表](https://apitext.pc.untzg.com/527138062e0.md): 
- 机构 [添加人员](https://apitext.pc.untzg.com/527138063e0.md): 
- 机构 [编辑人员](https://apitext.pc.untzg.com/527138064e0.md): 
- 机构 [删除人员](https://apitext.pc.untzg.com/527138065e0.md): 
- 机构 [后台用户列表](https://apitext.pc.untzg.com/527138066e0.md): 查询授权机构链内的后台用户，可用于工单 `receive[].id` 选人。
- 商品库 [获取分类列表](https://apitext.pc.untzg.com/527138067e0.md): 返回当前总机构下所有有效分类；`pic` 为 OSS 域名 + 相对路径拼接后的完整 URL。
- 商品库 [获取商品列表](https://apitext.pc.untzg.com/527138068e0.md): 
- 商品库 [新增/编辑/删除分类](https://apitext.pc.untzg.com/527138069e0.md): 同一接口按参数区分三种操作：
- 商品库 [新增/编辑/删除商品](https://apitext.pc.untzg.com/527138070e0.md): 同一接口按参数区分三种操作：
- 商品库 [删除商品](https://apitext.pc.untzg.com/527138071e0.md): 逻辑删除商品（`product.status=-1`）。也可使用 `openapi_saveProduct` 传 `pid` + `status=-1` 删除。
- 设备与货道 [获取机器列表](https://apitext.pc.untzg.com/527138072e0.md): 
- 设备与货道 [获取货道库存信息](https://apitext.pc.untzg.com/527138073e0.md): 查询授权范围内货道及绑定商品、库存。`isShowNull=false` 时不返回未绑定商品的货道。
- 设备与货道 [货道补货 / 编辑货道商品](https://apitext.pc.untzg.com/527138074e0.md): **补刀（货道补货）开放接口**，与 PC 后台 `/adminapi/saveRoad` **完全相同**（同一实现、同一参数）。
- 设备与货道 [查询格子柜格子信息](https://apitext.pc.untzg.com/527138075e0.md): 按机器编号查询授权机器下的格子信息。默认返回该机器全部格子类型，可用 `code` 查询单个格子，可用 `type` 过滤一个或多个格子类型。
- 设备与货道 [保存/修改已有格子信息](https://apitext.pc.untzg.com/527138076e0.md): 保存授权机器下一个已有格子的业务信息。接口只更新已有格子，不新增、不删除、不重排格子。旧 `/adminapi/openapi_saveBoxType` 仅保留为兼容别名，主路径请使用本接口。
- 设备与货道 [远程弹簧货道直出](https://apitext.pc.untzg.com/527138077e0.md): 按机器编号和管理后台显示的货道编号，直接向领业设备下发弹簧货道出货指令。本接口只执行硬件动作，不创建订单、不扣减库存、不写货道流水；商品为空或库存为零不会阻止执行。
- 设备与货道 [远程打开格子柜](https://apitext.pc.untzg.com/527138078e0.md): 客户只需传机器编号和管理后台显示的格子编号，系统会定位该格并自行选择设备实际执行地址，然后异步下发开柜指令。
- 设备与货道 [触发 RFID 单次读取](https://apitext.pc.untzg.com/527138079e0.md): 按机器编号下发 RFID 单次读取命令。后台只负责鉴权、检查机器 RFID 和开放接口开关、下发设备指令。
- 设备与货道 [修改机器基本信息](https://apitext.pc.untzg.com/527138080e0.md): 修改机器名称、备注等基础字段（不含货道库存补货）。
- 设备与货道 [格子记录](https://apitext.pc.untzg.com/527138081e0.md): 
- 设备与货道 [库存变动记录（主动查询）](https://apitext.pc.untzg.com/527138082e0.md): 分页/条数限制查询货道历史（`road_history`），用于对账或补偿 Webhook 漏推。
- 订单 [获取订单列表](https://apitext.pc.untzg.com/527138083e0.md): 查询授权范围内订单明细列表。字段与订单状态 Webhook 推送基本一致（含 **`work_number`** 工号、**`sku`** 规格系数）。
- 订单 [获取借用订单](https://apitext.pc.untzg.com/527138084e0.md): 查询授权范围内格子柜借用订单列表。
- 工单 [新增/编辑领料工单](https://apitext.pc.untzg.com/527138085e0.md): 在智能柜系统创建或更新**领料工单**（`order_receive`），供设备端按工单领刀/领料。
- 事件推送 [客户系统接收：领用工单查询（Android 发起）](https://apitext.pc.untzg.com/527138086e0.md): **本文档项不是智能柜服务端接口。** 启用条件：
- 事件推送 [客户系统接收：借还工单查询（Android 发起）](https://apitext.pc.untzg.com/527138087e0.md): **本文档项不是智能柜服务端接口。** 启用条件：
- 事件推送 [【Webhook 说明】货道变动推送（智能柜→客户）](https://apitext.pc.untzg.com/527138088e0.md): **本文档项不是智能柜服务端接口。** 智能柜在货道库存变化时，向客户在总机构配置的 URL **主动 POST**（`application/x-www-form-urlencoded`）。
- 事件推送 [【Webhook 说明】订单状态推送（智能柜→客户）](https://apitext.pc.untzg.com/527138089e0.md): **本文档项不是智能柜服务端接口。** 订单明细（`order_detailed`）状态变化时，向总机构配置的 `subscribe_notify_url` **POST**（`application/x-www-form-urlencoded`）。
- 事件推送 [【Webhook 说明】借用订单状态推送（智能柜→客户）](https://apitext.pc.untzg.com/527138090e0.md): **本文档项不是智能柜服务端接口。** 借用订单（`order_box`）状态变化时，向总机构配置的 `subscribe_borrow_notify_url` **POST**（`application/x-www-form-urlencoded`）。
- 报表统计 [售货机报表查询](https://apitext.pc.untzg.com/527138091e0.md): 
- 报表统计 [库存变动统计查询](https://apitext.pc.untzg.com/527138092e0.md): `key.time` 为可选的开始、结束时间数组；未传时默认查询**含今天在内的最近 30 个自然日**（服务器时区）。
- 报表统计 [库存变动统计（精简，无期初/期末）](https://apitext.pc.untzg.com/527138093e0.md): 与 `openapi_grantMacStatementsIndex` 类似，但**不含期初/期末库存**，仅统计区间内应出/补货等，性能更好。
- 机台 [查询机台](https://apitext.pc.untzg.com/527138094e0.md): 
- 机台 [修改机台](https://apitext.pc.untzg.com/527138095e0.md): 

## Schemas
- [OpenApiOutRoadRequest](https://apitext.pc.untzg.com/322340917d0.md): 
- [操作成功](https://apitext.pc.untzg.com/322340918d0.md):