# 上架商品
接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090
(最新稳定版下载),wx-server-sdk
>=0.4.0
# 接口说明
# 接口英文名
listShopOpenComponentV1SPU
# 功能描述
该接口用于上架标准版交易组件的商品。
# 注意事项
- 商品有2份数据,草稿和线上数据 调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效。
- 上架接口调用次数太多可能会被拉黑 建议先检查在spu/get或spu/get_list检查商品里的字段edit_status,如果在审核中就不要重复提交了。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/product/spu/listing?access_token=ACCESS_TOKEN
# 云调用
出入参和HTTPS调用相同,调用方式可查看云调用说明文档
接口方法为: openapi.product.spu.listing
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:70
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
product_id | number | 否 | 小商店内部商品ID,与out_product_id二选一 |
out_product_id | string | 否 | 商家自定义商品ID,与product_id二选一 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 调用示例
示例说明: 请求示例1
# 请求数据示例
{
"product_id":1234234,
"out_product_id": "1234566"
}
# 返回数据示例
{
"errcode": 0,
"errmsg":"ok"
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
100002 | ||
100003 | ||
100005 | ||
100020 | ||
108001 | ||
209001 | ||
209004 | ||
209005 | ||
300000 | 瞬时请求频率过高,请降低频率重试 | |
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
-2 | token太长 | |
9401020 | 非法参数 | 非法参数 |
9401021 | 没有商品权限 | 没有商品权限 |
9401002 | 商品不存在 | 商品不存在 |
9401023 | SPU_NOT_ALLOW_EDIT | SPU不允许编辑 |
9401001 | 商品已存在 | 商品已存在 |
9401032 | 类目非法 | |
9401033 | 商家不具备当前类目资质 | |
9401040 | 商品详情图片desc_info.imgs过多 | |
9401044 | SKU商品编码sku_code过长 | |
9401045 | sku销售属性长度非法 | 请检查后重新提交 |
9401050 | 图片 url 非法:为空字符串,或域名不为store.mp.video.tencent-cloud.com,或 url 前缀不为mmbizurl.cn/p/,或 url 前缀不为mmecimage.cn/p/(请参考文档的【注意】) | |
9401054 | sku价格为0 | |
9401055 | sku售卖价格sale_price大于等于市场价格market_price | |
9401056 | 账号注销中 | 账号注销中 |
9401058 | 当前选择类目不可用 | 请重新选择类目 |
9401060 | 商品标题不得仅为数字、字母、字符,请修改后重新提交 | |
9401063 | 商品品牌id无效 | 请检查商品品牌id后重新提交 |
9401064 | 商品正在审核中,无法编辑 | 商品正在审核中,请等待审核完成或者撤回审核 |
9401076 | 当前运费模版计价方式为[按重量],提交商品重量为0 | 请正确上传商品重量 |