# 上架商品
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:listingproduct
通过该接口可将商品(包括非卖赠品)上架到微信小店。
相关事件推送:
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/product/listing?access_token=ACCESS_TOKEN
# 云调用
调用方法:channels.ec.product.listing
出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档
# 第三方调用
本接口支持第三方平台代微信小店商家调用。
该接口所属的权限集 id 为:129
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商) |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
product_id | string | 是 | 1234234 | 商品ID(赠品ID); |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 示例 | 说明 |
---|---|---|---|
errcode | number | 0 | 错误码 |
errmsg | string | ok | 错误信息 |
# 4. 注意事项
商品上架查看:
商品有2份数据,草稿和线上数据 调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效;
频繁调用上架接口,会被封禁。建议先检查下商品状态,如果在审核中就不要重复提交了;
当商品处于上传中的状态,即edit_status==7时,调用本接口会返回10020067错误码;
每个小店调用接口新增、更新商品次数会合并计算,频率限制为:每小时200次,每天1000次;
- 商品新增或更新后撤回均会消耗次数;
- 已上架的商品仅更新“库存”,不消耗次数。
非卖赠品查看:
非卖赠品有2份数据,草稿和线上数据 调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效;
频繁调用上架接口,会被封禁。建议先检查下商品状态,如果在审核中就不要重复提交了;
每个小店调用接口新增、更新商品次数会合并计算,频率限制为:每小时200次,每天1000次;
- 赠品新增或更新后撤回均会消耗次数;
- 已上架的商品仅更新“库存”,不消耗次数。
# 5. 代码示例
请求示例
{
"product_id": "1234234"
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
10020008 | 当前商品不允许编辑 | |
10020011 | 商品的类目长度不对(预期是有三级类目) | |
10020012 | 销售属性不合法,不属于商品所属的三级类目 | |
10020013 | 商品sku数量不合理(sku数量必须在1-500之间) | |
10020014 | 该spu处于抢购状态,不能修改sku | |
10020016 | 批量添加sku失败 | |
10020017 | 类目非法 | |
10020018 | 商家不具备当前类目资质 | |
10020019 | 运费模版非法 | |
10020020 | 商品标题为空 | |
10020021 | 商品标题过长 | |
10020022 | 商品头图为空 | |
10020023 | 商品头图过多 | |
10020024 | 商品描述过长 | |
10020025 | 商品详情图片过多 | |
10020026 | 商品详情描述过长 | |
10020027 | 资质图片过多 | |
10020028 | sku价格过高 | |
10020029 | sku商品编码过长 | |
10020031 | sku销售属性相同key下不能超过100个不同value | |
10020032 | sku销售属性key过长 | |
10020033 | sku销售属性value过长 | |
10020035 | 图片/视频url非法,url前缀应为mmecimage.cn/p/ | |
10020036 | out_product_id过长 | |
10020037 | out_sku_id过长 | |
10020038 | 上架的商品缺少sku | |
10020039 | SKU价格为0 | |
10020040 | sku售卖价格大于市场价格 | |
10020041 | 账号注销中 | |
10020042 | 商品标题过短 | |
10020043 | 类目不可用,请更换类目 | |
10020045 | 商品标题不得仅为数字、字母、字符,不得含非法字符,请修改后重新提交 | |
10020046 | 商品信息设置有误,请重新输入 | |
10020048 | 由于类目保证金不足,已禁止新增商品 | |
10020049 | 商品正在审核中,无法编辑或删除 | |
10020050 | 没有商品权限 | |
10020051 | 参数错误 | |
10020052 | 商品不存在 | |
10020053 | 商品因违规已被封禁 | |
10020066 | 本店铺近1小时内提审次数超过限制,请1小时后再试 | |
10020067 | 该商品上一次提交正在上传中,请稍后再试 | |
10020068 | 当前运费模版计价方式为[按重量],且提交商品重量为0 | |
10020069 | 当前类目不允许选择无需快递的发货方式 | |
10020070 | 由于类目保证金不足,已下架所有商品 | |
10020083 | 该商品所需类目保证金高于当前保证金余额,请前往商家网页端添加一次该类目商品,即可完成保证金补缴 | |
10020088 | 当前类目不支持当前品牌,或商品品牌id非法,或商品品牌id未申请通过 | |
10020089 | 未开张商店发布商品 | |
10020091 | 暂不支持上架该类型的商品 | |
10020095 | 售后说明超过长度限制(200 UTF字符) | |
10020096 | 商品参数属性键attrs[].attr_key不能重复 | |
10020097 | 商品参数attrs缺少必填项,具体参考文档获取类目信息中的字段attr.product_attr_list[] | |
10020098 | 商品参数属性值attrs[].attr_value有误,具体参考文档获取类目信息中的字段attr.product_attr_list[] | |
10020099 | 预售时间为0 | |
10020100 | 预售开始时间大于等于结束时间 | |
10020101 | 预售时间区间大于15天 | |
10020102 | 预售结束时间距离现在大于30天 | |
10020103 | 预售发货预计时间无效,当前只能设置[预售结束1-3天]发货,或者[付款后4-15天]发货 | |
10020104 | 当前类目不支持预售,具体参考文档获取类目信息中的字段attr.pre_sale | |
10020106 | 请上传至少3张商品头图 | |
10020107 | 请上传至少1张商品详情图 | |
10020108 | 当前类目必须支持七天无理由退货,extra_service.seven_day_return必须为1或者2 | |
10020109 | 商品所属类目与主营类目不符,不支持上架 | |
10020110 | 商品信息检查不通过 | |
10020111 | 本店铺近1天内提审次数超过限制,请1天后再试 | |
10020113 | 商品参数属性值为空,请检查后重新提交 | |
10020208 | 本店铺的上架功能被封禁,请登录微信小店后台管理页查看详情 | |
10020221 | 根据《微信小店「运费险」管理规则》旗舰店类型小店需开通运费险服务方可上架商品,请使用网页端登录并开通 | |
10020222 | 根据《微信小店「运费险」管理规则》近7天退货率高于10%或商责纠纷率大于0.08%店铺需完成运费险开通签约方可上架商品,请使用网页端登录并开通 | |
10020223 | 根据《视频号商品质检功能服务协议》需开通质检仓方可上架商品,请使用网页端 登录并开通 | |
10020225 | 商品头图重复 | |
10020226 | 商品详情图重复 | |
10020228 | 商品头图与其他商品重复 | |
10020229 | 请上传至少4张商品头图 | |
10020230 | 请上传至少3张商品详情图 | |
10020231 | 根据《微信小店「运费险」管理规则》,预售功能需开通运费险功能后才可打开,当前暂未开通,请至网页端开通运费险功能后重新尝试 | |
10020234 | 根据《微信小店「运费险」管理规则》,旗舰店/服务违规小店/退货退款率较高小店需开通运费险服务方可上架商品,请使用网页端登录并开通运费险 | |
10020235 | 当前店铺包含需要质检服务的类目资质,无法经营和上架其他非质检类目商品。具体可参考相关条款 | |
10020247 | 由于未在限定时间内完成升级,该店铺已被限制商品新增能力,请尽快完成升级解除限制 |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。