门店订单核销

请求路径

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://gateway.nuoyunapi.com/Api/Channel/doVerifyOrder/2.0.0
• 频率限制：10秒1000次

说明

• 按门店核销人身份核销指定订单商品。
• 商户 uid 由 API 鉴权结果带入，仅能核销本账号下门店订单。
• 需传入核销人 wechat_user_space_id 与门店 market_channel_id；服务端会校验该用户对该门店的核销权限，并自动补齐销售员/管理员身份。

请求参数

参数	必选	类型	描述
order_id	是	integer	订单 ID
market_channel_id	是	integer	门店 ID
wechat_user_space_id	是	integer	核销人用户 ID
goods_str	是	array	待核销商品列表，至少 1 条
verify_code	否	integer	核销码

goods_str 参数结构

参数	必选	类型	描述
goods_id	是	integer	商品 ID
num	是	integer	本次核销数量，须大于 0

请求示例

{
    "order_id": 10001,
    "market_channel_id": 12345,
    "wechat_user_space_id": 20401816,
    "goods_str": [
        {
            "goods_id": 54250,
            "num": 1
        }
    ]
}

响应参数

参数	必选	类型	描述
code	是	integer	状态码：200-成功，400-失败
msg	是	string	提示信息
data	是	object	消息内容

data 参数结构

参数	必选	类型	描述
verify_user	是	string	核销人名称
verify_wechat_user_space_id	是	integer	核销人用户 ID
goods_cnt	是	integer	本次核销商品总件数
verify_time	是	string	核销时间
goods_list	是	array	核销商品明细
has_remain	是	boolean	订单是否仍有待核销商品：true-有剩余，false-无剩余
channel_name	是	string	门店名称

goods_list 参数结构

参数	必选	类型	描述
id	是	integer	记录 ID
order_id	是	integer	订单 ID
goods_name	是	string	商品名称
goods_desc	是	string	商品描述
goods_pic	是	string	商品图片
goods_type	是	string	商品类型
goods_unit	是	string	商品单位
goods_cnt	是	integer	购买数量
verify_no	是	array	核销码列表
verify_num	是	integer	本次核销数量
goods_attribute	是	string	规格属性
goods_price	是	string	商品单价
group	是	string	核销组编号
goods_id	是	integer	商品 ID

响应示例

{
    "code": 200,
    "msg": "Success",
    "data": {
        "verify_user": "张三",
        "verify_wechat_user_space_id": 20401816,
        "goods_cnt": 1,
        "verify_time": "2026-08-05 15:30:00",
        "goods_list": [
            {
                "id": 1,
                "order_id": 10001,
                "goods_name": "商品名称",
                "goods_desc": "",
                "goods_pic": "https://example.com/pic.png",
                "goods_type": "virtual",
                "goods_unit": "个",
                "goods_cnt": 1,
                "verify_no": [
                    "343100000000"
                ],
                "verify_num": 1,
                "goods_attribute": "",
                "goods_price": "0.01",
                "group": "20351760695100000",
                "goods_id": 1001
            }
        ],
        "has_remain": false,
        "channel_name": "诺云旗舰店"
    }
}

状态码说明

状态码	描述
200	成功
400	失败（如参数错误、没有权限、订单不存在、非本门店订单、商品数量超限等）

鉴权说明

本接口为 OpenAPI 2.0.0 接口，需使用 API 鉴权（X-Ca-Key、X-Ca-Secret 或 X-Ca-Timestamp + X-Ca-Md5 签名），详见 接口签名介绍。