微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 更新商品

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

    接口英文名：updateproduct

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

    商品管理开发指南商品更新事件通知

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 调用方法：channels.ec.product.update

    • 出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档。

    # 第三方调用

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

    # 请求体 Request Payload

    参数名类型必填说明
    product_idstring否小店内部商品 ID
    titlestring是标题，应至少含 1 个有效字符数（中文文字/英文字母/数字，都各算 1 个有效字符数，且不得仅为数字或英文，不得含非法字符，允许的特殊字符集为：·~～!@#$%^&()！@#￥%……&*（）-_——=+[]\【】、{} \|｜;'；’:"： ‘“”,./，。、<>?《》？\u00A0\u0020\u3000，最多 60 字符。

    合规商品标题举例： 1.糖醋排骨【预订价 10 元】； 2.CheddarCheese 切达干酪； 3.百岁山天然矿泉水 1L*15 瓶。

    不合规商品标题举例： 1.正宗五指毛桃根√； 2.Classic Whole Wheat ； 3.便携式折叠扇第Ⅲ代； 4.iPhone 13 ； 5.Mac999 ； 6.[五元]扇子

    sub_titlestring否副标题，最多 18 字符。该字段已废弃
    short_titlestring否商品短标题，最多 20 字符，用在礼物单等场景的对外展示上，如果没有填写该字段，默认展示商品标题 title 字段的内容。
    head_imgsarray是主图，多张，列表，最少 3 张（食品饮料和生鲜类目商品最少 4 张），最多 9 张。不得有重复图片。无形状尺寸要求，最终在商详页会显示为正方形
    deliver_methodnumber是发货方式： 0-快递发货，1-无需快递，手机号发货，3-无需快递，可选发货账号类型，默认为 0 ，若为无需快递，则无需填写运费模版 id
    deliver_acct_typenumarray是发货账号： 1-微信 openid ，2-QQ 号，3-手机号，4-邮箱。可多选，只有 deliver_method=3 时，本参数有意义。且当发货账号为微信、 QQ 和邮箱时，需要更新订单接口读取详情字段，详情参考订单接口的说明。
    desc_infoobject否商品详情
    catsobjarray是商品类目，大小恒等于 3 （一二三级类目），商品上架后不可修改一级类目
    cats_v2objarray是商品类目，新类目树结构，商品上架后不可修改一级类目
    attrsobjarray否商品参数，部分类目有必填的参数，具体参考获取类目信息中的字段 attr.product_attr_list[].is_required
    spu_codestring否商家编码
    brand_idstring否品牌 id ，无品牌为“2100000000”
    qualificationsarray否已废弃，该字段被 product_qua_infos 代替
    product_qua_infosobjarray否商品资质列表，取代 qualifications 字段。注意：不同类目下必填的资质要求不同，具体参考文档获取类目信息中的字段 product_qua_list[]
    express_infoobject否运费信息
    aftersale_descstring否售后说明
    limited_infoobject否限购信息
    extra_serviceobject是额外服务
    skusobjarray是商品 SKU ，长度最少为 1 ，最大为 500
    listingnumber否添加完成后是否立即上架。 1=是，0=否；默认 0
    after_sale_infoobject否售后/退货地址
    size_chartobject否尺码表
    hide_in_windownumber否是否在店铺首页隐藏。 0=不隐藏，1=隐藏
    timing_onsale_infoobject否商品待开售信息
    release_modenumber否发布模式。 0=普通模式，1=极简模式
    head_videosobject否商品头图视频，最多上传 1 个。不传递该字段时不会删除商品原有视频，如果需要删除视频，请显式传入一个空的 video_url 字符串。
    spu_deliver_infoobject否spu 维度配置全部 sku 预售规则
    supply_sourceobject否供货货品（商品来源）信息
    vertical_head_imgsarray否3:4主图，最多1张，尺寸比例要求3:4
    white_bg_imgsarray否白底图，最多1张，尺寸比例要求1:1

    # Body.desc_info Object Payload

    商品详情

    参数名类型必填说明
    imgsarray是商品详情图片（最少 1 张，最多 50 张。其中食品饮料和生鲜类目商品最少 3 张）。不得有重复图片
    descstring否商品详情文本

    # Body.cats(Array) Object Payload

    商品类目，大小恒等于 3 （一二三级类目），商品上架后不可修改一级类目

    参数名类型必填说明
    cat_idnumber是类目 ID ，需要先通过获取类目接口拿到可用的 cat_id ；这里的 cat_id 顺序与一，二，三级类目严格一致，即数组下标为 0 的是一级类目，数组下标为 1 的是二级类目，数组下标为 2 的是三级类目

    # Body.cats_v2(Array) Object Payload

    商品类目，新类目树结构，商品上架后不可修改一级类目

    参数名类型必填说明
    cat_idstring是类目 ID ，需要先通过获取类目信息接口拿到可用的 cat_id ；这里的 cat_id 顺序与一，二，三，...， N 级类目严格一致，即数组下标为 0 的是一级类目，数组下标为 1 的是二级类目，数组下标 length - 1 的是 N 级类目（即最后一级叶子类目）

    # Body.attrs(Array) Object Payload

    商品参数，部分类目有必填的参数，具体参考获取类目信息中的字段 attr.product_attr_list[].is_required

    参数名类型必填说明
    attr_keystring是属性键 key （属性自定义用）
    attr_valuestring是属性值 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 的格式：字符串形式的数字

    # Body.product_qua_infos(Array) Object Payload

    商品资质列表，取代 qualifications 字段。注意：不同类目下必填的资质要求不同，具体参考文档获取类目信息中的字段 product_qua_list[]

    参数名类型必填说明
    qua_idnumber否商品资质 id ，对应获取类目信息中的字段 product_qua_list[].qua_id
    qua_urlarray否商品资质图片列表（单个商品资质 id 下，最多 10 张）

    # Body.express_info Object Payload

    运费信息

    参数名类型必填说明枚举
    template_idstring否运费模板 ID （先通过获取运费模板列表接口拿到），若 deliver_method=1 或 3 ，则不用填写-
    weightnumber否商品重量，单位克，若当前运费模版计价方式为[按重量]，则必填-
    express_typenumber否是否开启“偏远地区中转集运”枚举值

    # Body.limited_info Object Payload

    限购信息

    参数名类型必填说明
    period_typenumber否0=无限购（默认）， 1=按自然日限购， 2=按自然周限购， 3=按自然月限购， 4=按自然年限购
    limited_buy_numnumber否限购数量

    # Body.extra_service Object Payload

    额外服务

    参数名类型必填说明
    seven_day_returnnumber是是否支持七天无理由退货， 0-不支持七天无理由， 1-支持七天无理由， 2-支持七天无理由(定制商品除外)， 3-支持七天无理由(使用后不支持)。管理规则请参见七天无理由退货管理规则。类目是否必须支持七天无理由退货，可参考文档获取类目信息中的字段 attr.seven_day_return
    freight_insurancenumber是是否支持运费险， 0-不支持运费险， 1-支持运费险。需要商户先开通运费险服务，才可打开商品运费险。规则详情请参见视频号小店「运费险」管理规则
    damage_guaranteenumber否是否支持坏损包退， 0-不支持坏损包退， 1-支持坏损包退。
    fake_one_pay_threenumber否是否支持假一赔三， 0-不支持假一赔三， 1-支持假一赔三。
    exchange_supportnumber否是否支持换货。0=关闭支持换货，1=打开支持换货

    # Body.skus(Array) Object Payload

    商品 SKU ，长度最少为 1 ，最大为 500

    参数名类型必填说明
    sku_idnumber否若填了已存在 sku_id ，则进行更新 sku 操作，否则新增 sku
    out_sku_idstring否商家自定义 sku_id ，小店后台不作任何唯一性约束，开发者自行保证，一旦添加成功后该字段无法修改，最多 128 字符
    thumb_imgstring否sku 小图
    sale_pricenumber否售卖价格，以分为单位，不超过 1000000000 （ 1000 万元）
    stock_numnumber是库存
    sku_codestring否sku 编码（商家自定义编码），最多 100 字符
    bar_codestring否商品条形码/69 码
    sku_attrsobjarray否规格
    statusnumber否sku 上下架状态。0=默认值，5=上架，11=下架
    sku_deliver_infoobject否sku 预售信息

    # Body.after_sale_info Object Payload

    售后/退货地址

    参数名类型必填说明
    after_sale_address_idnumber否售后/退货地址 id ，使用地址管理相关接口进行添加或获取

    # Body.size_chart Object Payload

    尺码表

    参数名类型必填说明
    enableboolean否是否启用尺码表
    specification_listobjarray否尺码表，启用尺码表时必填

    # Body.timing_onsale_info Object Payload

    商品待开售信息

    参数名类型必填说明
    statusnumber否状态枚举。0=没有待开售，1=待开售
    onsale_timetimestamp否开售时间，秒级时间戳， 0 为未配置时间
    is_hide_pricenumber否是否隐藏价格。0=不隐藏，1=隐藏

    # Body.head_videos Object Payload

    商品头图视频，最多上传 1 个。不传递该字段时不会删除商品原有视频，如果需要删除视频，请显式传入一个空的 video_url 字符串。

    参数名类型必填说明
    video_urlstring否视频链接 url ，请先通过上传接口上传视频获取 url 。如果需要删除视频，请显式传入一个空的 video_url 字符串。

    # Body.spu_deliver_info Object Payload

    spu 维度配置全部 sku 预售规则

    参数名类型必填说明
    sku_deliver_infoobject否sku 预售配置
    is_spu_rangenumber否是否生效。0=不生效，1=生效

    # Body.supply_source Object Payload

    供货货品（商品来源）信息

    参数名类型必填说明
    supply_sourcenumber否供货来源， 0=小店自营商品，2=第三方商品
    third_party_source_idnumber否第三方货源 id ，仅 supply_source==2 时有效，通过新增第三方货源信息添加

    # Body.skus(Array).sku_attrsObject Payload

    规格

    参数名类型必填说明
    attr_keystring是属性键 key ，最终展示为商详页 sku 规格的名称，如“尺码”、“颜色”，最多 40 字符
    attr_valuestring是属性值 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 的格式：字符串形式的数字

    # Body.skus(Array).sku_deliver_info Object Payload

    sku 预售信息

    以下参数也使用此结构：

    • Body.spu_deliver_info.sku_deliver_info ： sku 预售配置
    参数名类型必填说明
    stock_typenumber否sku 库存情况。 0=现货（默认）， 1=全款预售。部分类目支持全款预售，具体参考文档获取类目信息中的字段 attr.pre_sale
    full_payment_presale_delivery_typenumber否sku 发货节点，该字段仅对 stock_type=1 有效。 0=付款后 n 天发货， 1=预售结束后 n 天发货
    presale_begin_timenumber否sku 预售周期开始时间，秒级时间戳，该字段仅对 delivery_type=1 有效。
    presale_end_timenumber否sku 预售周期结束时间，秒级时间戳，该字段仅对 delivery_type=1 有效。限制：预售结束时间距离现在<=30 天，即`presale_end_time - now <= 2592000`。预售时间区间<=15 天，即 `presale_end_time - presale_begin_time <= 1296000`
    full_payment_presale_delivery_timenumber否sku 发货时效，即付款后/预售结束后`{full_payment_presale_delivery_time}` 天内发货，该字段仅对 stock_type=1 时有效。当发货节点选择“0=付款后 n 天发货”时，范围是`[4, 15]`的整数；当发货节点选择“1=预售结束后 n 天发货”时，范围是`[1, 3]`的整数
    spot_after_presale_endnumber否是否在预售结束后自动转为现货，该字段仅对 delivery_type=1 有效。 0=否，1=是

    # Body.size_chart.specification_list(Array) Object Payload

    尺码表，启用尺码表时必填

    参数名类型必填说明
    namestring是尺码属性名称
    unitstring是尺码属性值的单位
    is_rangeboolean是尺码属性值是否为区间
    value_listobjarray是尺码值与尺码属性值的映射列表

    # Body.size_chart.specification_list(Array).value_listObject Payload

    尺码值与尺码属性值的映射列表

    参数名类型必填说明
    keystring是尺码值，需与商品属性中的尺码规格保持一致
    valuestring否尺码属性值；属性值为单值时填写；不能超过 5 个字符
    leftstring否尺码属性值的左边界，需小于右边界；属性值为区间时填写；不能超过 5 个字符
    rightstring否尺码属性值的右边界，需大于左边界；属性值为区间时填写；不能超过 5 个字符

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    dataobject商品信息

    # Res.data Object Payload

    商品信息

    参数名类型示例说明
    product_idnumber小店内部商品 ID
    update_timestring2026-06-09 21:00:29更新时间，格式为 YYYY-MM-DD hh:mm:ss

    # 4. 枚举信息

    # Body.express_info.express_type Enum

    是否开启“偏远地区中转集运”

    枚举值描述
    0默认，普通类型
    1中转集运类型

    # 5. 注意事项

    • 商品有 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 级类目（即最后一级叶子类目）。

    • 关于类目属性更名的填写说明：请按照平台最新的类目属性结构进行传参。若您同时传递了新旧两个同义属性，系统将仅保留最新属性名及其属性值，旧版属性将被自动过滤。

      • 举例： 若同时传入“产地”和“商品产地”，因“产地”为最新属性名，系统将仅同步“产地”的值，“商品产地”的值将被忽略。

    # 6. 代码示例

    请求示例

    {
    "product_id":"10000000000001",
    "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
    "short_title": "任天堂 Nintendo Switch 国行续航增强版",
    "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":6000
        },
        {
            "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":1
    },
    "skus": [
        {
            "sku_id":"1000000001",
            "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": 0,
    "errmsg": "ok",
    "data": {
        "product_id":"10000000000001",
        "update_time": "2026-06-09 21:00:29"
    }
}

    # 7. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述解决方案
    1002002原因:本店铺近 1 天内提审次数超过限制，请 1 天后再试
    10020008当前商品不允许编辑
    10020011商品的类目长度不对（预期是有三级类目）
    10020012规格不合法，不属于商品所属的三级类目
    10020013商品 sku 数量不合理（ sku 数量必须在 1-500 之间）
    10020014该 spu 处于抢购状态，不能修改 sku
    10020016批量添加 sku 失败
    10020017类目非法
    10020018商家不具备当前类目资质
    10020019运费模版非法
    10020020商品标题为空
    10020021商品标题过长
    10020022商品头图为空
    10020023商品头图过多
    10020024商品描述过长
    10020025商品详情图片过多
    10020026商品详情描述过长
    10020027资质图片过多
    10020028sku 价格过高
    10020029sku 商品编码过长
    10020031sku 规格相同 key 下不能超过 100 个不同 value
    10020032sku 规格 key 过长,不能超过 40 个字符
    10020033sku 规格 value 过长,不能超过 40 个字符
    10020034该商品的 sku_id/sku_out_id 填写有误
    10020035图片/视频 url 非法， url 前缀应为 mmecimage.cn/p/
    10020036out_product_id 过长
    10020037out_sku_id 过长
    10020038上架的商品缺少 sku
    10020039SKU 价格为 0
    10020040sku 售卖价格大于市场价格
    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 天
    10020103预售发货预计时间超出类目限制范围
    10020104当前类目不支持预售，具体参考文档[获取类目信息]()中的字段 attr.pre_sale
    10020106请上传至少 3 张商品头图
    10020107请上传至少 1 张商品详情图
    10020108当前类目必须支持七天无理由退货， extra_service.seven_day_return 必须为 1 或者 2
    10020109商品所属类目与主营类目不符，不支持上架
    10020110商品信息检查不通过
    10020111本店铺近 1 天内提审次数超过限制，请 1 天后再试
    10020113商品参数属性值为空，请检查后重新提交
    10020125预售开始时间距离现在大于 3 天
    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当前店铺包含需要质检服务的类目资质，无法经营和上架其他非质检类目商品。具体可参考相关条款
    100202460 元保证金试运营商品数超出限制，上架中与审核中商品总数不得超过 100 个，解除限制请结束试运营前往补缴保证金"}
    10020247由于未在限定时间内完成升级，该店铺已被限制商品新增、编辑能力，请尽快完成升级解除限制
    10020251多 sku 规格字段 attr_key 不匹配，规格 key 字段应保持一致，请修改后重新提交
    10020252未申请当前类目，请通过类目接口提交申请，并在审核成功后上架商品
    10020252未申请当前类目，请通过类目接口提交申请，并在审核成功后上架商品"}
    10020297商品所属一级类目与最近一次上架的类目不符，不支持修改，请重新选择类目"}
    10020309商品处于待开售状态，不可编辑请立即开售或取消开售改变待开售状态，或等到开售时间后，再修改
    10020312商品待开售请求状态参数无效确认待开售中的状态参数是否正确
    10020313商品待开售请求时间参数无效确认待开售中的时间参数是否正确
    10020314商品待开售请求隐藏价格参数无效确认待开售中的隐藏价格参数是否正确
    10020315商品支持换货参数无效

    # 8. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。

    接口变更日志（18条）
    2026 年 08 月 04 日
    新增 vertical_head_imgs 、 white_bg_imgs 字段
    2026 年 08 月 03 日
    更新 sku_deliver_info 字段描述
    2026 年 07 月 24 日
    express_type 字段描述更新
    2026 年 07 月 17 日
    express_type 字段新增，新增枚举信息章节、更新注意事项等章节序号
    2026 年 07 月 07 日
    title 字段 至少1个有效字符
    2026 年 06 月 16 日
    关于类目属性更名的填写说明
    2026 年 05 月 20 日
    新增 supply_source 、 third_party_source_id 、 supply_source 字段
    2026 年 05 月 07 日
    更新 详情图 字段描述为最多50张
    2026 年 04 月 14 日
    新增 商品头图视频
    2026 年 04 月 09 日
    新增 head_videos 字段
    2026 年 03 月 23 日
    新增 hide_in_window 字段
    2026 年 03 月 09 日
    更新接口错误描述与参数说明，“销售属性”改为“规格”
    2026 年 01 月 30 日
    新增预售配置 spot_after_presale_end 字段
    2026 年 01 月 16 日
    新增spu维度的sku预售配置
    2026 年 01 月 05 日
    新增错误码10020251，10020247等
    2025 年 11 月 20 日
    新增错误码10020252，10020246，10020297
    2025 年 11 月 12 日
    sub_title字段标记为废弃
    2025 年 10 月 30 日
    新增 exchange_support 支持换货字段