修改批次预算

更新时间:2023.08.16

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

# 接口说明

支持商户:
【普通商户】
请求方式:
【PATCH】/v3/marketing/busifavor/stocks/{stock_id}/budget
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
    Path 路径参数
  • stock_id 必填 string
    【批次号】 批次号
    Body 包体参数
  • target_max_coupons 选填 integer
    【目标批次最大发放个数】 批次最大发放个数,target_max_coupons与target_max_coupons_by_day只能修改一个
    注:目标批次即修改后的批次
  • current_max_coupons 选填 integer
    【当前批次最大发放个数】 当前批次最大发放个数,当传入target_max_coupons大于0时,current_max_coupons必传
    注:当前批次即未修改的批次
  • target_max_coupons_by_day 选填 integer
    【目标单天发放上限个数】 单天发放上限个数,target_max_coupons与target_max_coupons_by_day只能修改一个
    注:目标批次即修改后的批次
  • current_max_coupons_by_day 选填 integer
    【当前单天发放上限个数】 当前单天发放上限个数 ,当传入target_max_coupons_by_day大于0时,current_max_coupons_by_day必填
    注:当前批次即未修改的批次
  • modify_budget_request_no 必填 string
    【修改预算请求单据号】 修改预算请求单据号

请求示例

PATCH

# 应答参数

    200OK
  • max_coupons 必填 integer
    【批次当前最大发放个数】 批次最大发放个数
  • max_coupons_by_day 选填 integer
    【当前单天发放上限个数】 当前单天发放上限个数

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

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