采购单活动类型列表

编号  :  001

请求参数

返回值

{
    "status": 200,
    "msg": "获取采购单活动类型列表成功",
    "data": [
        {
            "id": 1,
            "code": "amount",
            "name": "活动金额"
        },
        {
            "id": 2,
            "code": "time",
            "name": "活动时间"
        }
    ]
}

备注

返回全部采购单活动类型，按sort倒序、id正序排列；data直接是数组，不返回分页对象。code=amount表示活动金额，code=time表示活动时间。

商户可选采购单活动列表

编号  :  003

请求参数

返回值

{
    "status": 200, // 状态码
    "msg": "获取商户可选采购单活动列表成功", // 提示信息
    "data": { // 分页返回数据
        "total": 1, // 总条数
        "per_page": 10, // 每页条数
        "current_page": 1, // 当前页码
        "last_page": 1, // 最后一页页码
        "data": [ // 商户当前开启的采购单活动列表
            {
                "id": 101, // 商户采购单活动详情ID，采购单add/edit提交此值
                "vid": 17, // 商户ID，对应bbc_vendor.vid
                "activity_type_id": 1, // 采购单活动类型ID
                "activity_type_code": "amount", // 活动类型编码：amount=活动金额，time=活动时间
                "activity_type_name": "活动金额", // 活动类型名称
                "activity_amount": "1000000.00", // 活动金额；amount类型返回金额，time类型返回null
                "remaining_amount": "200000.00", // 活动剩余金额；amount类型返回实时余额，time类型返回null
                "start_time": null, // 活动开始时间；time类型返回时间，amount类型返回null
                "end_time": null, // 活动结束时间；time类型返回时间，amount类型返回null
                "activity_content": "采购满额活动", // 活动内容
                "status": 1, // 活动状态，固定为1活动开启
                "status_name": "活动开启", // 活动状态名称
                "created_at": "2026-08-07 10:00:00" // 创建时间
            }
        ]
    }
}

备注

分页查询指定商户vid下status=1的采购单活动，默认按活动ID倒序。activity_type_code=amount时返回activity_amount和remaining_amount；remaining_amount按活动金额减去所有已绑定采购单total_amount实时计算。activity_type_code=time时activity_amount和remaining_amount均为null。请求示例：?vid=17&page=1&pageSize=10。

商户采购单活动列表

编号  :  002

请求参数

返回值

{
    "status": 200, // 状态码
    "msg": "获取商户采购单活动列表成功", // 提示信息
    "data": { // 分页返回数据
        "total": 1, // 总条数
        "per_page": 10, // 每页条数
        "current_page": 1, // 当前页码
        "last_page": 1, // 最后一页页码
        "data": [ // 商户采购单活动列表
            {
                "id": 101, // 商户采购单活动详情ID
                "vid": 12, // 商户ID，对应bbc_vendor.vid
                "store_name": "示例商户", // 商户名称
                "activity_type_id": 1, // 采购单活动类型ID
                "activity_type_code": "amount", // 活动类型编码：amount=活动金额，time=活动时间
                "activity_type_name": "活动金额", // 活动类型名称
                "activity_amount": "500.00", // 活动金额；amount类型返回金额，time类型返回null
                "remaining_amount": "200.00", // 活动剩余金额；amount类型返回实时余额，time类型返回null
                "start_time": null, // 活动开始时间；time类型返回时间，amount类型返回null
                "end_time": null, // 活动结束时间；time类型返回时间，amount类型返回null
                "activity_content": "采购金额活动", // 活动内容
                "status": 1, // 活动状态：1=活动开启，0=活动已结束
                "status_name": "活动开启", // 活动状态名称
                "ended_at": null, // 活动实际结束时间，未结束时为null
                "admin_id": 3, // 创建管理员ID
                "admin_name": "admin", // 创建管理员名称
                "created_at": "2026-08-05 10:00:00", // 创建时间
                "updated_at": null // 修改时间，未修改时为null
            }
        ]
    }
}

备注

分页查询商户采购单活动，vid为可选参数；不传vid时查询全部商户的活动，传vid时只查询指定商户的活动。默认先按状态倒序排列，status=1的活动开启数据排在status=0的活动已结束数据前面；同一状态内按活动详情ID倒序。activity_type_code=amount时返回remaining_amount，按活动金额减去所有已绑定采购单total_amount实时计算；time类型返回null。返回商户名称store_name、活动类型编码activity_type_code、活动类型名称activity_type_name、状态名称status_name和创建管理员名称admin_name。ended_at为调用结束接口时记录的实际结束时间。所有时间筛选均支持Y-m-d或Y-m-d H:i:s；下限只传日期时补为00:00:00，上限只传日期时补为23:59:59。

添加商户采购单活动详情

编号  :  004

请求参数

返回值

{
    "status": 200,
    "msg": "添加商户采购单活动详情成功",
    "data": {
        "activity_ids": [101, 102],
        "vids": [12, 15],
        "created_count": 2
    }
}

备注

商户参数支持单个vid、vid数组、vids数组或英文逗号分隔字符串，服务端会去重并校验商户存在；多个商户在同一事务内分别生成活动详情。activity_type_id对应bbc_buy_order_activity_type.id，服务端按类型code校验：amount类型只填写activity_amount，time类型只填写start_time和end_time。时间支持Y-m-d和Y-m-d H:i:s；只传日期时，开始时间保存为00:00:00，结束时间保存为23:59:59。金额示例：{"vids":[12,15],"activity_type_id":1,"activity_amount":"500.00","activity_content":"采购金额活动"}；时间示例：{"vid":12,"activity_type_id":2,"start_time":"2026-08-03","end_time":"2026-08-10 18:30:00","activity_content":"采购时间活动"}。活动类型ID请以实际执行类型表初始化SQL后生成的数据为准，不依赖固定ID。

结束商户采购单活动

编号  :  005

请求参数

返回值

{
    "status": 200, // 状态码
    "msg": "结束商户采购单活动成功", // 提示信息
    "data": {
        "id": 101, // 商户采购单活动详情ID
        "status": 0, // 活动状态：0=活动已结束
        "status_name": "活动已结束", // 活动状态名称
        "ended_at": "2026-08-06 10:00:00" // 活动实际结束时间
    }
}

备注

只能结束status=1的商户采购单活动。接口在事务内对活动记录加排他锁，将status更新为0，并将ended_at记录为当前结束时间；已结束的活动不能重复结束。