# 上架商品

# 接口说明

通过该接口可将商品上架到视频号小店。

# 注意事项

  • 商品有2份数据,草稿和线上数据 调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效;
  • 频繁调用上架接口,会被封禁。建议先检查下商品状态,如果在审核中就不要重复提交了;
  • 当商品处于上传中的状态,即edit_status==7时,调用本接口会返回10020067错误码;
  • 每个小店调用接口新增、更新商品次数会合并计算,频率限制为:每小时200次,每天1000次;
    1. 商品新增或更新后撤回均会消耗次数;
    2. 已上架的商品仅更新“库存”,不消耗次数。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/product/listing?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 是否必填 描述
product string(uint64) 商品ID

# 请求参数示例

{
    "product_id": "1234234"
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok"
}

# 错误码

错误码 错误描述
公共错误码 -
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 当前店铺包含需要质检服务的类目资质,无法经营和上架其他非质检类目商品。具体可参考相关条款