適用對象： 直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}/budget
請求方式：Patch
前置條件： 已創(chuàng)建商家券批次，且修改時間位于有效期結束時間前
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 | 調用太頻繁，請降低調用接口頻率 | 調用太頻繁，請降低調用接口頻率 |