商戶可以通過該接口修改批次單天發(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請設(shè)置為
application/json
- Content-Type 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- stock_id 必填 string【批次號】 批次號
Path 路徑參數(shù)
- target_max_coupons 選填 integer【目標(biāo)批次最大發(fā)放個數(shù)】 批次最大發(fā)放個數(shù),target_max_coupons與target_max_coupons_by_day只能修改一個
注:目標(biāo)批次即修改后的批次 - current_max_coupons 選填 integer【當(dāng)前批次最大發(fā)放個數(shù)】 當(dāng)前批次最大發(fā)放個數(shù),當(dāng)傳入target_max_coupons大于0時,current_max_coupons必傳
注:當(dāng)前批次即未修改的批次 - target_max_coupons_by_day 選填 integer【目標(biāo)單天發(fā)放上限個數(shù)】 單天發(fā)放上限個數(shù),target_max_coupons與target_max_coupons_by_day只能修改一個
注:目標(biāo)批次即修改后的批次 - current_max_coupons_by_day 選填 integer【當(dāng)前單天發(fā)放上限個數(shù)】 當(dāng)前單天發(fā)放上限個數(shù) ,當(dāng)傳入target_max_coupons_by_day大于0時,current_max_coupons_by_day必填
注:當(dāng)前批次即未修改的批次 - modify_budget_request_no 必填 string【修改預(yù)算請求單據(jù)號】 修改預(yù)算請求單據(jù)號
Body 包體參數(shù)
請求示例
PATCH
# 應(yīng)答參數(shù)
- max_coupons 必填 integer【批次當(dāng)前最大發(fā)放個數(shù)】 批次最大發(fā)放個數(shù)
- max_coupons_by_day 選填 integer【當(dāng)前單天發(fā)放上限個數(shù)】 當(dāng)前單天發(fā)放上限個數(shù)
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | RULE_LIMIT | 批次庫存的當(dāng)前值錯誤,請獲取批次詳情查看最新值 | 批次庫存的當(dāng)前值錯誤,請獲取批次詳情查看最新值 |
403 | RULELIMIT | 僅創(chuàng)建方有權(quán)限使券失效 | 僅創(chuàng)建方有權(quán)限使券失效 |
403 | RULELIMIT | 批次正在修改中,請稍后重試 | 批次正在修改中,請稍后重試 |
403 | RULELIMIT | 目標(biāo)庫存數(shù)目不能小于批次已發(fā)放庫存數(shù)目 | 目標(biāo)庫存數(shù)目不能小于批次已發(fā)放庫存數(shù)目 |
404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請檢查批次ID |
404 | RESOURCE_NOT_EXISTS | 批次已過期 | 只能修改運行中的批次預(yù)算 |
429 | FREQUENCY_LIMITED | 調(diào)用太頻繁,請降低調(diào)用接口頻率 | 調(diào)用太頻繁,請降低調(diào)用接口頻率 |