适用对象: 直连商户
请求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}/budget
请求方式:Patch
前置条件: 已创建商家券批次,且修改时间位于有效期结束时间前
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
批次号 | stock_id | string[1,20] | 是 | path批次号 示例值:98065001 |
目标批次最大发放个数 | target_max_coupons | int | 二选一 | body批次最大发放个数 注:目标批次即修改后的批次 示例值:3000 |
目标单天发放上限个数 | target_max_coupons_by_day | int | body单天发放上限个数 注:目标批次即修改后的批次 示例值:500 |
|
当前批次最大发放个数 | current_max_coupons | int | 否 | body当前批次最大发放个数,当传入target_max_coupons大于0时,current_max_coupons必传 注:当前批次即未修改的批次 示例值:500 |
当前单天发放上限个数 | current_max_coupons_by_day | int | 否 | body当前单天发放上限个数 ,当传入target_max_coupons_by_day大于0时,current_max_coupons_by_day必填 注:当前批次即未修改的批次 示例值:300 |
修改预算请求单据号 | modify_budget_request_no | string[1,128] | 是 | body修改预算请求单据号 示例值:1002600620019090123143254436 |
{
"target_max_coupons": 3000,
"current_max_coupons": 500,
"modify_budget_request_no": "1002600620019090123143254436"
}
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
批次当前最大发放个数 | max_coupons | int | 是 | 批次最大发放个数 示例值:300 |
当前单天发放上限个数 | max_coupons_by_day | int | 否 | 当前单天发放上限个数 示例值:100 |
{
"max_coupons": 300,
"max_coupons_by_day": 100
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
404 | RESOURCE_NOT_EXISTS | 批次不存在 | 请检查批次id |
403 | RULELIMIT | 仅创建方有权限使券失效 | 仅创建方有权限使券失效 |
404 | RESOURCE_NOT_EXISTS | 批次已过期 | 只能修改运行中的批次预算 |
403 | RULELIMIT | 批次正在修改中,请稍后重试 | 批次正在修改中,请稍后重试 |
403 | RULE_LIMIT | 批次库存的当前值错误,请获取批次详情查看最新值 | 批次库存的当前值错误,请获取批次详情查看最新值 |
403 | RULELIMIT | 目标库存数目不能小于批次已发放库存数目 | 目标库存数目不能小于批次已发放库存数目 |
429 | FREQUENCY_LIMITED | 调用太频繁,请降低调用接口频率 | 调用太频繁,请降低调用接口频率 |