修改可用单品编码

更新时间：2026.01.13

应用场景

可通过该接口修改增删商品编码，至少需要保留一个商品编码。

接口说明

接口url	https://api.mch.weixin.qq.com/v3/marketing/favor/stocks/{stock_id}/modify-goods-id
请求方式	post

请求参数

变量名	所处位置	数据类型	必填	描述
stock_creator_mchid	query	String（20）	是	批次创建方商户号示例值: 9865000
stock_id	path	String（20）	是	批次号示例值: 9865000
add_goods_id_list	query	String(20)	否	增加单品编码列表示例值:34565，12342
Delete_goods_id_list	query	String(20)	否	删除单品编码列表示例值:123545，12345

请求包体样例

1{
2	"stock_creator_mchid": "9865000",
3	"add_goods_id_list": "34565，12342",
4	"Delete_goods_id_list": "123545，12345",
5}

返回结果

变量名	数据类型	必填	示例	描述
pause_time	string	是	2015-05-20T13:29:35.120+08:00	生效时间
stock_id	string	是	9865000	批次号

应答样例 200 Response

1{
2	"stock_id": "9865000",
3	"pause_time": "2015-05-20T13:29:35.120+08:00",
4}

错误码

名称	描述
APPID_MCHID_NOT_MATCH	商户号与appid不匹配
FREQUENCY_LIMIT_EXCEED	接口限频
PARAM_ERROR	回调url不能为空
PARAM_ERROR	回调商户不能为空
PARAM_ERROR	券id必填
INVALID_REQUEST	openid与appID不匹配
MCH_NOT_EXISTS	商户号不合法
NOT_ENOUGH	批次预算不足
INVALID_REQUEST	appid与openid不匹配
INVALID_REQUEST	appid与openid不匹配
PARAM_ERROR	appid必填
PARAM_ERROR	openid必填
PARAM_ERROR	页大小超过阈值
PARAM_ERROR	输入时间格式错误
PARAM_ERROR	批次号必填
PARAM_ERROR	商户号必填
REQUEST_BLOCKED	调用商户无权限
REQUEST_BLOCKED	商户无权发券
REQUEST_BLOCKED	批次不支持跨商户发券
REQUEST_BLOCKED	用户被限领拦截
PARAM_ERROR	非法的批次状态
RESOURCE_NOT_EXISTS	批次不存在
INVALID_REQUEST	活动已结束或未激活
RESOURCE_NOT_EXISTS	批次不存在
RESOURCE_NOT_EXISTS	批次不存在
INVALID_REQUEST	非法的商户号
USER_ACCOUNT_ABNORMAL	用户非法
INVALID_REQUEST	批次预算不足
INVALID_REQUEST	调用频率过高
REQUEST_BLOCKED	请开通回调通知产品权限
PARAM_ERROR	查询回调通知地址时商户号不能为空
REQUEST_BLOCKED	请先设置回调通知地址
REQUEST_BLOCKED	非单品券或者商品信息为空
PARAM_ERROR	请检查请求参数，关键信息不能为空
PARAM_ERROR	可用时间规则只能指定一种
REQUEST_BLOCKED	未知批次类型
REQUEST_BLOCKED	未知券类型
REQUEST_BLOCKED	请传入正确的批次预算
REQUEST_BLOCKED	修改预算的必须为面额整数倍
REQUEST_BLOCKED	需要删除的可用商户不存在
REQUEST_BLOCKED	需要新增的可用商户校验失败
REQUEST_BLOCKED	删除不存在的商品编码
REQUEST_BLOCKED	当前状态的批次不可修改
REQUEST_BLOCKED	查询规则失败
REQUEST_BLOCKED	用户被已达最大领券次数
REQUEST_BLOCKED	活动未开始或已结束
REQUEST_BLOCKED	批次预算耗尽
REQUEST_BLOCKED	不能再api渠道发放
REQUEST_BLOCKED	不支持指定面额发券
REQUEST_BLOCKED	发券超过单天限额
REQUEST_BLOCKED	被自然人规则拦截
REQUEST_BLOCKED	尽在广告场景下发放批次
REQUEST_BLOCKED	账户余额不足，请充值
REQUEST_BLOCKED	api能力被冻结
RESOURCE_NOT_EXISTS	账单文件不存在
REQUEST_BLOCKED	请在批次过期后第二天10点后下载

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服