新增/编辑领料工单

在智能柜系统创建或更新领料工单（order_receive），供设备端按工单领刀/领料。

与领刀出货的关系

客户通过本接口创建工单（含 receiveProduct 明细）

用户在刀具柜设备上按工单领用，系统生成订单（order，order_type=6）并关联 order.order_receive_id

出货后可能触发 订单状态 Webhook（subscribe_notify_url，v1.0.4+ 含 gdh 工单号）或 货道 Webhook

订单状态 Webhook 可凭 gdh / order_receive_id 回写 MES 工单；货道 Webhook 仍仅含 orderid（订单 ID）

receiveProduct[].id 为商品 ID（product.id），不是工单明细 ID。
receiveProduct[].proid 编辑已有工单明细时传 order_receive_goods.id。
receiveId：编辑工单时传 order_receive.id；新增不传或传 -1（可作为 query 或 JSON body 字段）。

鉴权：当前实现未调用 authApi，生产环境建议由网关或后续版本补齐 token 校验。

响应：成功返回 { code:200, msg:"操作成功" }，不返回工单 ID（orid）。

请求参数

Header 参数

Body 参数application/json

示例

{
    "name": "11",
    "gdsl": "1",
    "cpbm": "1",
    "th": "1",
    "v": "1",
    "sczs": "1",
    "mid": 13258,
    "jqcode": "10388",
    "receiveProduct": [
        {
            "id": 817,
            "num": 1,
            "demand_time": "2025-04-02 16:00:00",
            "scbz": "2",
            "remark": "备注",
            "proNumber": 1,
            "receivenum": 0
        }
    ],
    "receive": [
        {
            "id": 377
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

成功返回 code=200；当前响应体未返回工单 ID，请通过平台查询或记录创建前时间戳排查（后续版本计划返回 orid）

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "操作成功",
    "data": null
}

请求参数

请求示例代码

返回响应