最新更新時(shí)間：2019.11.8 版本說明
商家券的Code碼可由微信后臺(tái)隨機(jī)分配，同時(shí)支持商戶自定義。如商家已有自己的優(yōu)惠券系統(tǒng)，可直接使用自定義模式。即商家預(yù)先向微信支付上傳券Code，當(dāng)券在發(fā)放時(shí)，微信支付自動(dòng)從已導(dǎo)入的Code中隨機(jī)取值（不能指定），派發(fā)給用戶。
適用對(duì)象： 服務(wù)商
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}/couponcodes
請(qǐng)求方式：POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請(qǐng)求URL傳參
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號(hào) | stock_id | string[1,20] | 是 | path 微信為每個(gè)商家券批次分配的唯一ID 示例值：98065001 |
| 券code列表 | coupon_code_list | array | 否 | body 商戶上傳的券code列表，code允許包含的字符有0-9、a-z、A-Z、-、_、\、/、=、|。 特殊規(guī)則：?jiǎn)蝹€(gè)券code長(zhǎng)度為【1，32】，條目個(gè)數(shù)限制為【1，200】。 示例值：ABC9588200，ABC9588201 |
| 請(qǐng)求業(yè)務(wù)單據(jù)號(hào) | upload_request_no | string[1,128] | 是 | body 商戶上傳code的憑據(jù)號(hào)，商戶側(cè)需保持唯一性。 示例值：100002322019090134234sfdf |
{
"coupon_code_list": [
"ABC9588200",
"ABC9588201"
],
"upload_request_no": "100002322019090134234sfdf"
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號(hào) | stock_id | string[1,20] | 是 | 微信為每個(gè)商家券批次分配的唯一ID。 示例值：98065001 |
| 去重后上傳code總數(shù) | total_count | uint64 | 是 | 本次上傳操作，去重后實(shí)際上傳的code數(shù)目。 示例值：500 |
| 上傳成功code個(gè)數(shù) | success_count | uint64 | 是 | 本次上傳操作上傳成功個(gè)數(shù)。 示例值：20 |
| 上傳成功的code列表 | success_codes | array |
否 | 本次新增上傳成功的code信息。 特殊規(guī)則：?jiǎn)蝹€(gè)券code長(zhǎng)度為【1，32】，條目個(gè)數(shù)限制為【1，200】。 示例值：MMAA12345 |
| 上傳成功時(shí)間 | success_time | string[1,32] | 是 | 上傳操作完成時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。 示例值：2015-05-20T13:29:35+08:00 |
| 上傳失敗code個(gè)數(shù) | fail_count | uint64 | 否 | 本次上傳操作上傳失敗的code數(shù)。 示例值：10 |
| +上傳失敗的code及原因 | fail_codes | array | 否 | 本次導(dǎo)入失敗的code信息，請(qǐng)參照錯(cuò)誤信息，修改后重試。 |
| 已存在的code列表 | exist_codes | array | 否 | 歷史已存在的code列表，本次不會(huì)重復(fù)導(dǎo)入。 特殊規(guī)則：?jiǎn)蝹€(gè)券code長(zhǎng)度為【1，32】，條目個(gè)數(shù)限制為【1，200】。 示例值：ABCD2345 |
| 本次請(qǐng)求中重復(fù)的code列表 | duplicate_codes | array | 否 | 本次重復(fù)導(dǎo)入的code會(huì)被自動(dòng)過濾，僅保留一個(gè)做導(dǎo)入，如滿足要求則成功；如不滿足要求，則失敗；請(qǐng)參照?qǐng)?bào)錯(cuò)提示修改重試。 特殊規(guī)則：?jiǎn)蝹€(gè)券code長(zhǎng)度為【1，32】，條目個(gè)數(shù)限制為【1，200】。 示例值：AACC2345 |
{
"stock_id": "98065001",
"total_count": 500,
"success_count": 20,
"success_codes": [
"MMAA12345"
],
"success_time": "2015-05-20T13:29:35+08:00",
"fail_count": 10,
"fail_codes": [
{
"coupon_code": "ABCD23456",
"code": "LENGTH_LIMIT",
"message": "長(zhǎng)度超過最大值32位"
}
],
"exist_codes": [
"ABCD2345"
],
"duplicate_codes": [
"AACC2345"
]
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 查看具體錯(cuò)誤信息，調(diào)整參數(shù) |
| 400 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 400 | RESOURCE_ALREADY_EXISTS | 批次已存在 | 查看out_request_no字段是否重復(fù)使用 |
| 券已被其他訂單核銷 | 請(qǐng)通過查詢?nèi)疉PI確認(rèn)券是否已被其他訂單核銷 | ||
| 404 | RESOURCE_NOT_EXISTS | 查詢的資源不存在 | 請(qǐng)檢查查詢資源的對(duì)應(yīng)id是否填寫正確 |
| 403 | NOAUTH | 無(wú)權(quán)限 | 查看具體錯(cuò)誤信息，確認(rèn)是否有權(quán)限 |
| 400 | APPID_MCHID_NOT_MATCH | appid與請(qǐng)求方商戶無(wú)關(guān)聯(lián)關(guān)系 | appid與請(qǐng)求方商戶不匹配，請(qǐng)確認(rèn)appid與請(qǐng)求方商戶是否有關(guān)聯(lián)關(guān)系 |
| 400 | MCH_NOT_EXISTS | 商戶號(hào)不存在 | 請(qǐng)確認(rèn)傳入的商戶號(hào)是否正確 |
| 404 | USER_NOT_EXISTS | openid不正確 | 請(qǐng)確認(rèn)傳入的openid是否正確 |
| 500 | SYSTEM_ERROR | 系統(tǒng)失敗 | 多為網(wǎng)絡(luò)超時(shí)引起，重試 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 調(diào)用太頻繁，請(qǐng)降低調(diào)用接口頻率 |
| 403 | RULELIMIT | 券不在有效期 | 請(qǐng)確認(rèn)券是否能在當(dāng)前時(shí)間核銷 |
| 400 | INVALID_REQUEST | 發(fā)券模式不合法 | 請(qǐng)更換支持預(yù)上傳code的批次后重試 |
| 上傳的自定義code已達(dá)上限 | 請(qǐng)更換一個(gè)新的批次后重試 |