適用對象:直連商戶 服務商 渠道商
請求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}/budget
請求方式:Patch
前置條件: 已創(chuàng)建商家券批次,且修改時間位于有效期結束時間前
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
批次號 | stock_id | string[1,20] | 是 | path批次號 示例值:98065001 |
目標批次最大發(fā)放個數(shù) | target_max_coupons | int | 二選一 | body批次最大發(fā)放個數(shù) 示例值:3000 |
目標單天發(fā)放上限個數(shù) | target_max_coupons_by_day | int | body單天發(fā)放上限個數(shù) 示例值:500 |
|
當前批次最大發(fā)放個數(shù) | current_max_coupons | int | 否 | body當前批次最大發(fā)放個數(shù),當傳入target_max_coupons大于0時,current_max_coupons必傳 示例值:500 |
當前單天發(fā)放上限個數(shù) | current_max_coupons_by_day | int | 否 | body當前單天發(fā)放上限個數(shù) ,當傳入target_max_coupons_by_day大于0時,current_max_coupons_by_day必填 示例值:300 |
修改預算請求單據(jù)號 | modify_budget_request_no | string[1,128] | 是 | body修改預算請求單據(jù)號 示例值:1002600620019090123143254436 |
{
"target_max_coupons": 3000,
"current_max_coupons": 500,
"modify_budget_request_no": "1002600620019090123143254436"
}
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
批次當前最大發(fā)放個數(shù) | max_coupons | int | 是 | 批次最大發(fā)放個數(shù) 示例值:300 |
當前單天發(fā)放上限個數(shù) | max_coupons_by_day | int | 否 | 當前單天發(fā)放上限個數(shù) 示例值:100 |
{
"max_coupons": 300,
"max_coupons_by_day": 100
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請檢查批次id |
403 | RULELIMIT | 僅創(chuàng)建方有權限使券失效 | 僅創(chuàng)建方有權限使券失效 |
404 | RESOURCE_NOT_EXISTS | 批次已過期 | 只能修改運行中的批次預算 |
403 | RULELIMIT | 批次正在修改中,請稍后重試 | 批次正在修改中,請稍后重試 |
403 | RULE_LIMIT | 批次庫存的當前值錯誤,請獲取批次詳情查看最新值 | 批次庫存的當前值錯誤,請獲取批次詳情查看最新值 |
403 | RULELIMIT | 目標庫存數(shù)目不能小于批次已發(fā)放庫存數(shù)目 | 目標庫存數(shù)目不能小于批次已發(fā)放庫存數(shù)目 |
429 | FREQUENCY_LIMITED | 調用太頻繁,請降低調用接口頻率 | 調用太頻繁,請降低調用接口頻率 |