商戶可以通過該接口修改批次單天發(fā)放上限數(shù)量或者批次最大發(fā)放數(shù)量
# 接口說明
支持商戶：
【普通服務商】【渠道商】
請求方式：
【PATCH】/v3/marketing/busifavor/stocks/{stock_id}/budget
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設置為
application/json - Content-Type 必填 string請設置為
application/json
Header HTTP頭參數(shù)
- stock_id 必填 string【批次號】 批次號
Path 路徑參數(shù)
- target_max_coupons 選填 integer【目標批次最大發(fā)放個數(shù)】 批次最大發(fā)放個數(shù)，target_max_coupons與target_max_coupons_by_day只能修改一個
注：目標批次即修改后的批次 - current_max_coupons 選填 integer【當前批次最大發(fā)放個數(shù)】 當前批次最大發(fā)放個數(shù)，當傳入target_max_coupons大于0時，current_max_coupons必傳
注：當前批次即未修改的批次 - target_max_coupons_by_day 選填 integer【目標單天發(fā)放上限個數(shù)】 單天發(fā)放上限個數(shù)，target_max_coupons與target_max_coupons_by_day只能修改一個
注：目標批次即修改后的批次 - current_max_coupons_by_day 選填 integer【當前單天發(fā)放上限個數(shù)】 當前單天發(fā)放上限個數(shù) ，當傳入target_max_coupons_by_day大于0時，current_max_coupons_by_day必填
注：當前批次即未修改的批次 - modify_budget_request_no 必填 string【修改預算請求單據號】 修改預算請求單據號
Body 包體參數(shù)
請求示例
PATCH
# 應答參數(shù)
- max_coupons 必填 integer【批次當前最大發(fā)放個數(shù)】 批次最大發(fā)放個數(shù)
- max_coupons_by_day 選填 integer【當前單天發(fā)放上限個數(shù)】 當前單天發(fā)放上限個數(shù)
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據錯誤提示正確傳入參數(shù) |
| 400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
| 401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
| 500 | SYSTEM_ERROR | 系統(tǒng)異常，請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 403 | RULE_LIMIT | 批次庫存的當前值錯誤，請獲取批次詳情查看最新值 | 批次庫存的當前值錯誤，請獲取批次詳情查看最新值 |
| 403 | RULELIMIT | 僅創(chuàng)建方有權限使券失效 | 僅創(chuàng)建方有權限使券失效 |
| 403 | RULELIMIT | 批次正在修改中，請稍后重試 | 批次正在修改中，請稍后重試 |
| 403 | RULELIMIT | 目標庫存數(shù)目不能小于批次已發(fā)放庫存數(shù)目 | 目標庫存數(shù)目不能小于批次已發(fā)放庫存數(shù)目 |
| 404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請檢查批次ID |
| 404 | RESOURCE_NOT_EXISTS | 批次已過期 | 只能修改運行中的批次預算 |
| 429 | FREQUENCY_LIMITED | 調用太頻繁，請降低調用接口頻率 | 調用太頻繁，請降低調用接口頻率 |
