更新商品 | 微信开放文档

# 更新商品

# 接口说明

该接口用于对视频号小店内商品信息的更新

# 注意事项

商品有2份数据，草稿和线上数据，调用接口新增和修改商品数据后，影响的只是草稿数据，要调用上架商品接口（或本接口参数listing设置为1），并审核通过，草稿数据才会覆盖线上数据正式生效；
商品sku数量超过25个的情况下，接口会异步更新商品信息。在上传完成之前调用上架商品接口，会返回10020067，因此如果有更新商品并提交审核的需求，建议直接在本接口将listing参数设置为1，不需要再调用上架商品的接口；
该接口请求方式和添加商品接口基本一致，区别在于请求该接口时需要带上已存在的product_id；
该接口是覆盖写操作，每次提交后，草稿数据会被整体替换为本次请求上传的数据：
1. 若sku列表中带上已存在的sku_id，则会用新上传的内容更新对应的sku草稿；
2. 若列表中某个的sku没有传入sku_id，则视为新增的sku，分配新的sku_id并插入到商品草稿中；
3. 若原本存在于商品信息中的某个sku_id，在本次更新没有上传，则视为删除，商品草稿将移除该sku，在商品审核通过后，以上变动将作用于线上数据。
图片相关参数（如head_img、desc_info.imgs、qualifications、product_qua_infos[].qua_url[]、skus[].thumb_img等），请务必使用接口上传图片（参数resp_type=1），并将返回的img_url填入此处，不接受其他任何格式的图片url。若url曾经做过转换（ url前缀为mmecimage.cn/p/），则可以直接提交。
启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。此接口新增 cats_v2 字段支持新类目树，详见参数。
- 如果商户设置了 cats_v2 的信息，会优先读取 cats_v2，作为类目信息，说明商户请求使用新的类目结构（多级类目结构）。
- 如果商户未设置 cats_v2 字段，使用 cats，说明商户请求使用旧的类目结构（三级类目结构）。
- cats_v2 字段填写类目信息（与 level1 / level2 / levle3 字段同级），顺序与一，二，三，...，N 级类目严格一致，即数组下标为 0 的是一级类目，数组下标为 1 的是二级类目，数组下标 length - 1 的是 N 级类目（即最后一级叶子类目）。

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
product_id	string(uint64)	是	小店内部商品ID
title	string	是	标题，应至少含5个有效字符数（中文文字/英文字母/数字，都各算1个有效字符数，且不得仅为数字或英文，不得含非法字符，允许的特殊字符集为：`·~～!@#$%^&()！@#￥%……&（）-_——=+[]\【】、{} \\|｜;'；’:"： ‘“”,./，。、<>?《》？\u00A0\u0020\u3000），最多60字符。合规商品标题举例：* 1.糖醋排骨【预订价10元】； 2.CheddarCheese切达干酪； 3.百岁山天然矿泉水1L15瓶。不合规商品标题举例：* 1.正宗五指毛桃根√； 2.Classic Whole Wheat； 3.便携式折叠扇第Ⅲ代； 4.iPhone 13； 5.Mac999； 6.[五元]扇子
sub_title	string	否	副标题，最多18字符
head_imgs	array[string]	是	主图，多张，列表，最少3张（食品饮料和生鲜类目商品最少4张），最多9张。不得有重复图片。无形状尺寸要求，最终在商详页会显示为正方形
deliver_method	number	是	发货方式：0-快递发货；1-无需快递，手机号发货；3-无需快递，可选发货账号类型，默认为0，若为无需快递，则无需填写运费模版id
deliver_acct_type	array(number)	是	发货账号：1-微信openid；2-QQ号；3-手机号；4-邮箱。可多选，只有deliver_method=3时，本参数有意义。且当发货账号为微信、QQ和邮箱时，需要更新订单接口读取详情字段，详情参考订单接口的说明。
desc_info[]	array	否	商品详情信息
desc_info[].imgs	array[string]	否	商品详情图片（最少1张，最多20张。其中食品饮料和生鲜类目商品最少3张）。不得有重复图片
desc_info[].desc	string	否	商品详情文本
cats[]	array	是	商品类目，大小恒等于3（一二三级类目）
cats[].cat_id	number	是	类目ID，需要先通过获取所有类目接口拿到可用的cat_id；这里的cat_id顺序与一，二，三级类目严格一致，即数组下标为0的是一级类目，数组下标为1的是二级类目，数组下标为2的是三级类目。
cats_v2[]	array	是	商品类目，新类目树结构｜
cats_v2[].cat_id	string(uint64)	是	类目ID，需要先通过获取类目接口拿到可用的cat_id；这里的cat_id顺序与一，二，三，...，N 级类目严格一致，即数组下标为 0 的是一级类目，数组下标为 1 的是二级类目，数组下标 length - 1 的是 N 级类目（即最后一级叶子类目）｜
attrs[]	array	否	商品参数，部分类目有必填的参数，具体参考文档获取类目信息中的字段`attr.product_attr_list[].is_required`
attrs[].attr_key	string	是	属性键key（属性自定义用）
attrs[].attr_value	string	是	属性值value（属性自定义用） ● 当获取类目信息接口中返回的type：为 select_many， attr_value的格式：多个选项用分号;隔开示例：某商品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年 ● 当获取类目信息接口中返回的type：为 integer_unit/decimal4_unit attr_value格式：数值单位，用单个空格隔开示例：某商品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择为kg，则 attr_value的值为：18 kg ● 当获取类目信息接口中返回的type：为 integer/decimal4 attr_value 的格式：字符串形式的数字
spu_code	string	否	商品编码
brand_id	string(uint64)	否	品牌id，无品牌为“2100000000”
qualifications	array[string]	否	商品资质图片（最多5张）。该字段将被product_qua_infos代替
product_qua_infos[]	array	否	商品资质列表，取代qualifications，具体参考文档获取类目信息中的字段`product_qua_list[]`
product_qua_infos[].qua_id	string(uint64)	否	商品资质id，对应获取类目信息中的字段`product_qua_list[].qua_id`
product_qua_infos[].qua_url[]	array(string)	否	商品资质图片列表（单个商品资质id下，最多10张）
express_info.template_id	string(uint64)	否	运费模板ID（先通过获取运费模板列表接口拿到），若deliver_method=1或3，则不用填写
express_info.weight	number	否	商品重量，单位克，若当前运费模版计价方式为[按重量]，则必填
aftersale_desc	string	否	售后说明
limited_info.period_type	number	否	限购周期类型，0:无限购（默认），1:按自然日限购，2:按自然周限购，3:按自然月限购，4:按自然年限购
limited_info.limited_buy_num	number	否	限购数量
extra_service.seven_day_return	number	是	是否支持七天无理由退货，0-不支持七天无理由，1-支持七天无理由，2-支持七天无理由(定制商品除外)，3-支持七天无理由(使用后不支持)。管理规则请参见七天无理由退货管理规则。类目是否必须支持七天无理由退货，可参考文档获取类目信息中的字段`attr.seven_day_return`
extra_service.pay_after_use	number	是	先用后付，字段已废弃。若店铺已开通先用后付，支持先用后付的类目商品将在上架后自动打开先用后付。管理规则请参见「先用后付」服务商家指南
extra_service.freight_insurance	number	是	是否支持运费险，0-不支持运费险，1-支持运费险。需要商户开通运费险服务，非必须开通运费险类目的商品依据该字段进行设置，必须开通运费险类目中的商品将默认开启运费险保障，不依据该字段。规则详情请参见视频号小店「运费险」管理规则
extra_service.fake_one_pay_three	number	否	是否支持假一赔三，0-不支持假一赔三，1-支持假一赔三。
extra_service.damage_guarantee	number	否	是否支持坏损包退，0-不支持坏损包退，1-支持坏损包退。
skus[]	array	是	长度最少为1，最大为500
skus[].sku_id	string(uint64)	否	若填了已存在sku_id，则进行更新sku操作，否则新增sku
skus[].out_sku_id	string	否	商家自定义sku_id，小店后台不作任何唯一性约束，开发者自行保证，一旦添加成功后该字段无法修改，最多128字符
skus[].thumb_img	string	否	sku小图
skus[].sale_price	number	是	售卖价格，以分为单位，不超过1000000000（1000万元）
skus[].stock_num	number	是	库存
skus[].sku_code	string	否	sku编码，最多100字符
skus[].sku_attrs[]	array	是	销售属性，每个spu下面的第一个sku的sku_attr.key顺序决定商品详情页规格名称的排序。部分类目有必填的销售属性，具体参考文档获取类目信息中的字段`attr.sale_attr_list[].is_required`
skus[].sku_attrs[].attr_key	string	是	属性键key，最终展示为商详页sku规格的名称，如“尺码”、“颜色”，最多40字符
skus[].sku_attrs[].attr_value	string	是	属性值value（属性自定义用） ● 当获取类目信息接口中返回的type：为 select_many， attr_value的格式：多个选项用分号;隔开示例：某商品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年 ● 当获取类目信息接口中返回的type：为 integer_unit/decimal4_unit attr_value格式：数值单位，用单个空格隔开示例：某商品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择为kg，则 attr_value的值为：18 kg ● 当获取类目信息接口中返回的type：为 integer/decimal4 attr_value 的格式：字符串形式的数字
skus[].sku_deliver_info.stock_type	number	否	sku库存情况。0:现货（默认），1:全款预售。部分类目支持全款预售，具体参考文档获取类目信息中的字段`attr.pre_sale`
skus[].sku_deliver_info.full_payment_presale_delivery_type	number	否	sku发货节点，该字段仅对`stock_type=1`有效。0:付款后n天发货，1:预售结束后n天发货
skus[].sku_deliver_info.presale_begin_time	number	否	sku预售周期开始时间，秒级时间戳，该字段仅对`delivery_type=1`有效。
skus[].sku_deliver_info.presale_end_time	number	否	sku预售周期结束时间，秒级时间戳，该字段仅对`delivery_type=1`有效。限制：预售结束时间距离现在<=30天，即`presale_end_time - now <= 2592000`。预售时间区间<=15天，即`presale_end_time - presale_begin_time <= 1296000`
skus[].sku_deliver_info.full_payment_presale_delivery_time	number	否	sku发货时效，即付款后/预售结束后`{full_payment_presale_delivery_time}`天内发货，该字段仅对`stock_type=1`时有效。当发货节点选择“0:付款后n天发货”时，范围是`[4, 15]`的整数；当发货节点选择“1:预售结束后n天发货”时，范围是`[1, 3]`的整数
listing	number	否	更新后是否立即上架。1:是；0:否；默认0
after_sale_info.after_sale_address_id	number	否	售后地址id，使用地址管理相关接口进行添加或获取
size_chart.enable	bool	否	是否启用尺码表
size_chart.specification_list	array	否	尺码表，启用尺码表时必填
size_chart.specification_list[].name	string	是	尺码属性名称
size_chart.specification_list[].unit	string	是	尺码属性值的单位
size_chart.specification_list[].is_range	bool	是	尺码属性值是否为区间
size_chart.specification_list[].value_list	array	是	尺码值与尺码属性值的映射列表
size_chart.specification_list[].value_list[].key	string	是	尺码值，需与商品属性中的尺码规格保持一致
size_chart.specification_list[].value_list[].value	string	否	尺码属性值；属性值为单值时填写；不能超过5个字符
size_chart.specification_list[].value_list[].left	string	否	尺码属性值的左边界，需小于右边界；属性值为区间时填写；不能超过5个字符
size_chart.specification_list[].value_list[].right	string	否	尺码属性值的右边界，需大于左边界；属性值为区间时填写；不能超过5个字符

# 请求参数示例

{
    "product_id": "10000000089215",
    "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
    "sub_title": "随时随地，一起趣玩。【更新】",
    "head_imgs": [
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
    ],
    "desc_info": {
        "imgs": [
            "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
        ],
        "desc": "物美价廉"
    },
    "cats": [],
    "cats_v2": [
        {
            "cat_id": "10000111"
        },
        {
            "cat_id": "10000113"
        },
        {
            "cat_id": "6091"
        }
    ],
    "attrs": [
            {
             "attr_key": "产地",
             "attr_value": "四川成都"
            },
            {
             "attr_key": "材质",
             "attr_value": "玻璃"
            },
            {
            "attr_key": "适用人群",
            "attr_value": "青年;中年"
            },
            {
            "attr_key": "数量",
            "attr_value": "33"
            },
            {
            "attr_key": "精度",
            "attr_value": "3.001"
            },
            {
            "attr_key": "重量",
            "attr_value": "38 mg"
            },
            {
           "attr_key": "毛重",
           "attr_value": "380 kg"
            }     
    ],
    "express_info": {
        "template_id": "47428464001"
    },
    "skus": [
        {
            "sku_id": "462966903",
            "thumb_img": "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
            "sale_price": 1300,
            "stock_num": 100,
            "sku_code": "A24525252",
            "sku_attrs": [
                    {
                        "attr_key": "产地",
                        "attr_value": "四川成都"
                    },
                    {
                        "attr_key": "材质",
                        "attr_value": "玻璃"
                    },
                    {
                        "attr_key": "适用人群",
                        "attr_value": "青年;中年"
                    },
                    {
                        "attr_key": "数量",
                        "attr_value": "33"
                    },
                    {
                        "attr_key": "精度",
                        "attr_value": "3.001"
                    },
                    {
                         "attr_key": "重量",
                         "attr_value": "38 mg"
                    },
                    {
                         "attr_key": "毛重",
                         "attr_value": "380 kg"
                    } 
            ],
            "sku_deliver_info": {
                "stock_type":0
            }
        },
        {
            "thumb_img": "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
            "sale_price": 1000,
            "stock_num": 100,
            "sku_code": "A24525252",
            "sku_attrs": [
                    {
                        "attr_key": "产地",
                        "attr_value": "四川成都"
                    },
                    {
                        "attr_key": "材质",
                        "attr_value": "玻璃"
                    },
                    {
                        "attr_key": "适用人群",
                        "attr_value": "青年;中年"
                    },
                    {
                        "attr_key": "数量",
                        "attr_value": "33"
                    },
                    {
                        "attr_key": "精度",
                        "attr_value": "3.001"
                    },
                    {
                         "attr_key": "重量",
                         "attr_value": "38 mg"
                    },
                    {
                         "attr_key": "毛重",
                         "attr_value": "380 kg"
                    } 
            ],
            "sku_deliver_info": {
                "stock_type":0
            }
        }
    ],
    "product_qua_infos": [
    {
      "qua_id": "1111488",
      "qua_url": [
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn71nCC"
      ]
    },
    {
      "qua_id": "1111489",
      "qua_url": [
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn71nCC"
      ]
    }
  ]
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
data.product_id	number(uint64)	小店内部商品ID
data.update_time	string	更新时间

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "product_id": "23423523452345235",
        "update_time": "2020-06-20 10:00:00"
    }
}

# 错误码

错误码	错误描述
公共错误码	-
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过长
10020034	该商品的sku_id/sku_out_id填写有误
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	预售时间区间超出类目限制范围
10020102	预售结束时间距离现在大于30天
10020125	预售开始时间距离现在大于3天
10020103	预售发货预计时间超出类目限制范围
10020104	当前类目不支持预售，具体参考文档获取类目信息中的字段`attr.pre_sale`
10020106	请上传至少3张商品头图
10020107	请上传至少1张商品详情图
10020108	当前类目必须支持七天无理由退货，extra_service.seven_day_return必须为1或者2
10020109	商品所属类目与主营类目不符，不支持上架
10020110	商品信息检查不通过
10020111	本店铺近1天内提审次数超过限制，请1天后再试
10020113	商品参数属性值为空，请检查后重新提交
10020208	本店铺的上架功能被封禁，请登录视频号小店后台管理页查看详情
10020209	传入的skuid不属于当前商品
10020210	限购库存不能为0
10020211	当前店铺因为有未缴纳欠费，无法上架商品，请登录视频号小店后台管理页查看详情
10020212	商品副标题不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交
10020213	商品详情描述不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交
10020214	商品售后说明不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交
10020215	当前类目不支持该品牌
10020216	商品sku销售参数`skus[].sku_attrs`缺少必填项，具体参考文档获取类目信息中的字段attr.sale_attr_list[]
10020221	根据《视频号小店「运费险」管理规则》旗舰店类型小店需开通运费险服务方可上架商品，请使用网页端登录并开通
10020222	根据《视频号小店「运费险」管理规则》近7天退货率高于10%或商责纠纷率大于0.08%店铺需完成运费险开通签约方可上架商品，请使用网页端登录并开通
10020225	商品头图重复
10020226	商品详情图重复
10020228	商品头图与其他商品重复
10020229	请上传至少4张商品头图
10020230	请上传至少3张商品详情图
10020231	根据《视频号小店「运费险」管理规则》，预售功能需开通运费险功能后才可打开，当前暂未开通，请至网页端开通运费险功能后重新尝试
10020234	根据《视频号小店「运费险」管理规则》，旗舰店/服务违规小店/退货退款率较高小店需开通运费险服务方可上架商品，请使用网页端登录并开通运费险
10020235	当前店铺包含需要质检服务的类目资质，无法经营和上架其他非质检类目商品。具体可参考相关条款