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. 事件推送

【Webhook 说明】订单状态推送（智能柜→客户）

POST
/_documentation/webhook-order-status
本文档项不是智能柜服务端接口。 订单明细（order_detailed）状态变化时，向总机构配置的 subscribe_notify_url POST（application/x-www-form-urlencoded）。

启用条件#

subscribe_notify_enable = 1
subscribe_notify_url 非空
当前 order_status 在 subscribe_notify_statuses 列表中

推送字段（当前实现，节选）#

id（order_detailed.id）、order_status、outstate、ono、order_type、jqcode、jqname、pname、cname、pcode、rno、return_no、return_box_id、return_box_code、user_id、realname、work_number、creat_time、organization_id、organization_name 等。

降级推送（v1.0.6+）#

若完整连表查询失败，仍会推送上述核心订单字段（不含工单字段），避免静默不推送。客户侧应能处理「仅有核心字段、无工单字段」的 payload。

工单字段（v1.0.5+，条件返回）#

仅当订单所属设备 工单模式 lld_type 为 1 或 2 时推送下列字段；lld_type=0 时不含工单相关字段。
字段说明
order_receive_id工单 ID（order_receive.id）
receive_goods_id工单明细 ID（order_receive_goods.id）
gdh工单号（openapi_saveReceive 的 name）
gdsl客户 MES 自定义字段
proNumber工单明细行号/编号
th / cpbm / v / sczs图号、产品编码、版本、生产总数等
原有字段不变。

与工单的关系#

推送仍基于 订单明细（order_detailed.id = 推送中的 id）
领刀场景可通过 gdh 或 order_receive_id 回写 MES 工单状态
ono 仍为智能柜订单号，与工单号 gdh 不同

请求参数

Body 参数application/x-www-form-urlencoded

请求示例代码

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/webhook-order-status' \
--data-urlencode 'id=' \
--data-urlencode 'order_status=' \
--data-urlencode 'order_type=' \
--data-urlencode 'ono=' \
--data-urlencode 'jqcode=' \
--data-urlencode 'jqname=' \
--data-urlencode 'pname=' \
--data-urlencode 'cname=' \
--data-urlencode 'pcode=' \
--data-urlencode 'rno=' \
--data-urlencode 'return_no=' \
--data-urlencode 'return_box_id=' \
--data-urlencode 'return_box_code=' \
--data-urlencode 'realname=' \
--data-urlencode 'user_id=' \
--data-urlencode 'work_number=' \
--data-urlencode 'creat_time=' \
--data-urlencode 'organization_id=' \
--data-urlencode 'organization_name=' \
--data-urlencode 'order_receive_id=' \
--data-urlencode 'receive_goods_id=' \
--data-urlencode 'gdh=' \
--data-urlencode 'gdsl=' \
--data-urlencode 'proNumber=' \
--data-urlencode 'th=' \
--data-urlencode 'cpbm=' \
--data-urlencode 'v=' \
--data-urlencode 'sczs='

返回响应

🟢200
客户 URL 应返回 HTTP 200
该响应没有 Body
修改于 2026-07-22 03:36:29
上一页
【Webhook 说明】货道变动推送（智能柜→客户）
下一页
【Webhook 说明】借用订单状态推送（智能柜→客户）
Built with