诺云开放平台

Appearance

查询普通商品核销记录 ​

按核销时间范围分页查询当前企业的普通商品核销记录。接口为只读查询，不会执行核销或修改业务数据。

每次核销操作返回一条记录，同一 group_code 可能对应多条记录。查询结果包含买家自主核销记录，不包含自提码核销记录。

请求路径 ​

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

请求参数 ​

核销时间区间采用左闭右开规则，即 [verify_start_time, verify_end_time)，单次查询跨度不能超过 31 天。

参数必选类型描述
verify_start_time是integer核销开始时间，Unix 秒级时间戳，包含该时刻
verify_end_time是integer核销结束时间，Unix 秒级时间戳，不包含该时刻，且必须大于开始时间
cursor_id否integer游标 ID，不能小于 0；首次请求传 0，后续传上次响应的 next_cursor_id，默认 0
page_size否integer每页记录数，取值范围 1～100，默认 20
sort_order否string按记录 ID 排序：asc-升序，desc-降序，默认 desc

翻页期间，verify_start_time、verify_end_time 和 sort_order 必须保持不变。

请求示例 ​

json
{
  "verify_start_time": 1785427200,
  "verify_end_time": 1785513600,
  "cursor_id": 0,
  "page_size": 20,
  "sort_order": "desc"
}

响应参数 ​

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

data 参数结构 ​

参数必选类型描述
list是array核销记录列表，无数据时返回空数组 []
next_cursor_id是integer下一页游标；has_more 为 false 时返回 0
has_more是boolean是否还有下一页
page_size是integer本次请求使用的每页记录数

游标翻页规则：

  • sort_order=desc 时，下一页返回 ID 小于 cursor_id 的记录。
  • sort_order=asc 时，下一页返回 ID 大于 cursor_id 的记录。
  • 当 has_more=true 时，将当前响应的 next_cursor_id 原样传入下一次请求。
  • 接口不返回记录总数。

list 参数结构 ​

参数必选类型描述
id是integer核销记录 ID，同时作为游标排序 ID
group_code是string核销操作分组标识；同一分组可能返回多条记录，历史记录可能为空字符串
verify_code是string本次核销提交或扫描的核销码，可能为空字符串，详见下方说明
is_self_verify是integer是否买家自主核销：1-是，2-否
verify_num是integer本条记录对应商品的核销数量
verify_money是string本次核销操作金额，单位元，固定两位小数
verify_time是string核销时间，格式：YYYY-MM-DD HH:mm:ss，时区：Asia/Shanghai
order是object订单基本信息
room是object直播间或店铺基本信息
verify_info是object核销人基本信息
verify_list是array本条记录对应的商品明细，正常情况下只有一项

order 参数结构 ​

参数必选类型描述
order_id是integer订单 ID
order_sn是string订单编号
order_status是integer当前订单状态：1-待发货，2-待收货，3-申请退款，4-已退款，5-已完成，6-待付款，7-超时关闭，8-待成团，9-砍价中

room 参数结构 ​

参数必选类型描述
room_id是integer直播间 ID；非直播间订单返回 0
push_app_nick是string直播间名称；非直播间订单返回店铺名称

verify_info 参数结构 ​

参数必选类型描述
wechat_master_id是integer核销人主账号 ID；买家自主核销返回 0
wechat_user_space_id是integer核销用户 ID；买家自主核销时返回买家用户 ID
verify_people是string核销人姓名；买家自主核销固定返回“买家自主核销”

verify_list 参数结构 ​

参数必选类型描述
order_goods_id是integer订单商品明细 ID
goods_id是integer商品 ID
goods_name是string商品名称
goods_pic是string商品图片 URL
goods_unit是string商品单位
goods_price是string商品单价，单位元，固定两位小数
goods_cnt是integer订单购买数量
goods_attribute是string商品规格属性，无规格时返回空字符串
verify_num是integer本次核销该商品的数量
verify_no是array本次实际核销的有效商品核销码列表；无明细核销码时返回空数组 []

verify_code 为空说明 ​

verify_code 表示本次核销时提交或扫描的核销码。以下情况会返回空字符串 ""：

  1. 买家自主核销或其他无需提交、扫描核销码的核销流程。
  2. 部分历史核销记录未保存该字段，或保存值为空、0。

verify_code 为空不表示核销记录无效，请勿使用该字段是否为空判断核销结果。需要获取本次实际核销的商品核销码时，请读取 verify_list[].verify_no。

响应示例 ​

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 1024,
        "group_code": "V202607310001",
        "verify_code": "839201",
        "is_self_verify": 2,
        "verify_num": 2,
        "verify_money": "39.80",
        "verify_time": "2026-07-31 15:20:30",
        "order": {
          "order_id": 10001,
          "order_sn": "NY202607310001",
          "order_status": 5
        },
        "room": {
          "room_id": 20001,
          "push_app_nick": "示例直播间"
        },
        "verify_info": {
          "wechat_master_id": 30001,
          "wechat_user_space_id": 40001,
          "verify_people": "核销员"
        },
        "verify_list": [
          {
            "order_goods_id": 50001,
            "goods_id": 60001,
            "goods_name": "示例商品",
            "goods_pic": "https://example.com/goods.jpg",
            "goods_unit": "件",
            "goods_price": "19.90",
            "goods_cnt": 2,
            "goods_attribute": "红色",
            "verify_num": 2,
            "verify_no": [
              "CODE001",
              "CODE002"
            ]
          }
        ]
      }
    ],
    "next_cursor_id": 0,
    "has_more": false,
    "page_size": 20
  }
}

状态码说明 ​

状态码描述
200成功
400失败：请求参数错误
400失败：核销开始时间或结束时间未传，或不是秒级时间戳
400失败：核销开始时间必须小于结束时间
400失败：核销时间范围超过 31 天
400失败：cursor_id 小于 0
400失败：page_size 不在 1～100 范围内
400失败：sort_order 不是 asc 或 desc