接口說明
適用對(duì)象： 服務(wù)商
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}
請(qǐng)求方式：Patch
前置條件： 已創(chuàng)建商家券批次，且修改時(shí)間位于有效期結(jié)束時(shí)間前
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
請(qǐng)求參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號(hào) | stock_id | string[1,20] | 是 | path批次號(hào) 示例值：101156451224 |
| +自定義入口 | custom_entrance | object | 否 | body卡詳情頁面，可選擇多種入口引導(dǎo)用戶 |
| 批次備注 | comment | string[1,20] | 否 | body僅配置商戶可見，用于自定義信息。字?jǐn)?shù)上限為20個(gè)，一個(gè)中文漢字/英文字母/數(shù)字均占用一個(gè)字?jǐn)?shù)。 示例值：活動(dòng)使用 |
| 適用商品范圍 | goods_name | string[1,15] | 否 | body用來描述批次在哪些商品可用，會(huì)顯示在微信卡包中。字?jǐn)?shù)上限為15個(gè)，一個(gè)中文漢字/英文字母/數(shù)字均占用一個(gè)字?jǐn)?shù)。 示例值：xxx商品使用 |
| 商戶請(qǐng)求單號(hào) | out_request_no | string[1,128] | 是 | body商戶修改批次憑據(jù)號(hào)（格式：商戶id+日期+流水號(hào)），商戶側(cè)需保持唯一性。 示例值：6122352020010133287985742 |
| +樣式信息 | display_pattern_info | object | 否 | body創(chuàng)建批次時(shí)的樣式信息。 |
| +核銷規(guī)則 | coupon_use_rule | object | 否 | body券核銷相關(guān)規(guī)則 |
| +發(fā)放規(guī)則 | stock_send_rule | object | 否 | body券發(fā)放相關(guān)規(guī)則 |
| +事件通知配置 | notify_config | object | 否 | body事件回調(diào)通知商戶的配置 |
卡券背景顏色圖
請(qǐng)求示例
{
"custom_entrance": {
"mini_programs_info": {
"mini_programs_appid": "wx234545656765876",
"mini_programs_path": "/path/index/index",
"entrance_words": "歡迎選購",
"guiding_words": "獲取更多優(yōu)惠"
},
"appid": "wx324345hgfhfghfg",
"hall_id": "233455656",
"code_display_mode": "BARCODE"
},
"comment": "活動(dòng)使用",
"goods_name": "xxx商品使用",
"out_request_no": "6122352020010133287985742",
"display_pattern_info": {
"description": "xxx門店可用",
"background_color": "xxxxx",
"coupon_image_url": "圖片cdn地址",
"finder_info": {
"finder_id": "sph6Rngt2T4RlUf",
"finder_video_cover_image_url": "https://wxpaylogo.qpic.cn/xxx",
"finder_video_id": "export/UzFfAgtgekIEAQAAAAAAb4MgnPInmAAAAAstQy6ubaLX4KHWvLEZgBPEwIEgVnk9HIP-zNPgMJofG6tpdGPJNg_ojtEjoT94"
}
},
"coupon_use_rule": {
"use_method": "OFF_LINE",
"mini_programs_appid": "wx23232232323",
"mini_programs_path": "/path/index/index"
},
"stock_send_rule": {
"prevent_api_abuse": false
},
"notify_config": {
"notify_appid": "wx23232232323"
}
}
錯(cuò)誤碼公共錯(cuò)誤碼
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 修改跳轉(zhuǎn)到小程序的自定義入口請(qǐng)?zhí)钊胄〕绦騛ppid | 需要修改小程序自定義入口，請(qǐng)?zhí)钊胝_的小程序appid |
| 404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請(qǐng)檢查批次id后重試 |
| 403 | RULELIMIT | 修改流程中僅允許創(chuàng)建方進(jìn)行操作 | 僅允許調(diào)用方進(jìn)行修改，請(qǐng)更換調(diào)用api的商戶號(hào) |
| 400 | INVALID_REQUEST | 修改字段中包含敏感詞 | 請(qǐng)更換提示的敏感詞字段后重試 |
| 404 | RESOURCE_NOT_EXISTS | 修改的appid不合法 | 請(qǐng)更換正確的appid后重試 |
| 400 | INVALID_REQUEST | 修改的appid與商戶號(hào)沒有綁定關(guān)系 | 請(qǐng)更換正確的appid后重試 |
| 404 | RESOURCE_NOT_EXISTS | 營銷館id不存在 | 請(qǐng)更換正確的營銷館id后重試 |
| 403 | RULELIMIT | 修改的營銷館無權(quán)限 | 請(qǐng)更換正確的營銷館id后重試 |
| 400 | INVALID_REQUEST | 修改的圖片url包含敏感內(nèi)容 | 請(qǐng)更換待修改圖片后重試 |