修改批次预算API

最新更新时间:2020.11.04 版本说明


商户可以通过该接口修改批次单天发放上限数量或者批次最大发放数量

接口说明

适用对象:直连商户 服务商 渠道商

请求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}/budget

请求方式:Patch

前置条件: 已创建商家券批次,且修改时间位于有效期结束时间前

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


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"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
批次当前最大发放个数 max_coupons int 批次最大发放个数
示例值:300
当前单天发放上限个数 max_coupons_by_day int 当前单天发放上限个数
示例值:100

返回示例


{
  "max_coupons": 300,
  "max_coupons_by_day": 100
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
404 RESOURCE_NOT_EXISTS 批次不存在 请检查批次id
403 RULELIMIT 仅创建方有权限使券失效 仅创建方有权限使券失效
404 RESOURCE_NOT_EXISTS 批次已过期 只能修改运行中的批次预算
403 RULELIMIT 批次正在修改中,请稍后重试 批次正在修改中,请稍后重试
403 RULE_LIMIT 批次库存的当前值错误,请获取批次详情查看最新值 批次库存的当前值错误,请获取批次详情查看最新值
403 RULELIMIT 目标库存数目不能小于批次已发放库存数目 目标库存数目不能小于批次已发放库存数目
429 FREQUENCY_LIMITED 调用太频繁,请降低调用接口频率 调用太频繁,请降低调用接口频率


版本说明

关闭
V1.0
2020年11月04
修改批次预算接口上线

技术咨询

反馈有奖