添加商品 | 微信开放文档

# 添加商品

# 接口说明

通过该接口可对商品添加进视频号小店

# 注意事项

商品有2份数据，草稿和线上数据，调用接口新增和修改商品数据后，影响的只是草稿数据，要调上架接口，并审核通过，草稿数据才会覆盖线上数据正式生效;
商品sku数量超过25个的情况下，接口会异步更新商品信息;
在上传完成之前调用上架商品接口，会返回10020067，因此如果有更新商品并提交审核的需求，建议直接在本接口将listing参数设置为1，不需要再调用上架商品的接口；
图片相关参数（如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/add?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
out_product_id	string	否	商家自定义商品ID，小店后台不作任何唯一性约束，开发者自行保证，一旦添加成功后该字段无法修改，最多128字符
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	string(uint64)	是	类目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	是	属性值（属性自定义用）。如果添加时没录入，回包可能不包含该字段，参数规则如下： ● 当获取类目信息接口中返回的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[].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	是	属性值（属性自定义用）。如果添加时没录入，回包可能不包含该字段，参数规则如下： ● 当获取类目信息接口中返回的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个字符

# 请求示例

{
    "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": [
        {
            "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
            }
        }
    ],
    "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	错误信息
product_id	string(uint64)	商品ID
create_time	string	创建时间

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "product_id": 23423523452345235,
        "create_time": "2020-03-25 12:05:25"
    }
}

# 错误码

错误码	错误描述
公共错误码	-
10020008	当前商品不允许编辑
10020011	商品的类目长度不对（预期是有三级类目）
10020012	销售属性不合法，不属于商品所属的三级类目
10020013	商品sku数量不合理（sku数量必须在1-500之间）
10020016	批量添加sku失败
10020017	类目非法
10020018	商家不具备当前类目资质
10020019	运费模版非法
10020020	商品标题为空
10020021	商品标题过长
10020022	商品头图为空
10020023	商品头图过多
10020024	商品描述过长
10020025	商品详情图片过多
10020026	商品详情描述过长
10020027	资质图片过多
10020028	sku价格过高
10020029	sku商品编码过长
10020030	sku_out_id已存在
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	由于类目保证金不足，已禁止新增商品
10020050	没有商品权限
10020051	参数错误
10020052	商品不存在
10020066	本店铺近1小时内提审次数超过限制，请1小时后再试
10020068	当前运费模版计价方式为[按重量]，且提交商品重量为0
10020069	当前类目不允许选择无需快递的发货方式
10020070	由于类目保证金不足，已下架所有商品
10020083	该商品所需类目保证金高于当前保证金余额，请前往商家网页端添加一次该类目商品，即可完成保证金补缴。
10020088	当前类目不支持当前品牌，或商品品牌id非法，或商品品牌id未申请通过
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	本店铺的上架功能被封禁，请登录视频号小店后台管理页查看详情
10020210	限购库存不能为0
10020211	当前店铺因为有未缴纳欠费，无法上架商品，请登录视频号小店后台管理页查看详情
10020212	商品副标题不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交
10020213	商品详情描述不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交
10020214	商品售后说明不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交
10020215	当前类目不支持该品牌
10020216	商品sku销售参数`skus[].sku_attrs`缺少必填项，具体参考文档获取类目信息中的字段attr.sale_attr_list[]
10020221	根据《视频号小店「运费险」管理规则》旗舰店类型小店需开通运费险服务方可上架商品，请使用网页端登录并开通
10020222	根据《视频号小店「运费险」管理规则》近7天退货率高于10%或商责纠纷率大于0.08%店铺需完成运费险开通签约方可上架商品，请使用网页端登录并开通
10020223	根据《视频号商品质检功能服务协议》需开通质检仓方可上架商品，请使用网页端登录并开通
10020225	商品头图重复
10020226	商品详情图重复
10020228	商品头图与其他商品重复
10020229	请上传至少4张商品头图
10020230	请上传至少3张商品详情图
10020231	根据《视频号小店「运费险」管理规则》，预售功能需开通运费险功能后才可打开，当前暂未开通，请至网页端开通运费险功能后重新尝试
10020234	根据《视频号小店「运费险」管理规则》，旗舰店/服务违规小店/退货退款率较高小店需开通运费险服务方可上架商品，请使用网页端登录并开通运费险
10020235	当前店铺包含需要质检服务的类目资质，无法经营和上架其他非质检类目商品。具体可参考相关条款
10020247	由于未在限定时间内完成升级，该店铺已被限制商品新增能力，请尽快完成升级解除限制