添加商品 | 微信开放文档

# 添加商品

注意：商品有2份数据，草稿和线上数据调用接口新增和修改商品数据后，影响的只是草稿数据，要调上架接口，并审核通过，草稿数据才会覆盖线上数据正式生效

# 接口调用请求说明

http请求方式：POST
https://api.weixin.qq.com/product/spu/add?access_token=xxxxxxxxx

# 请求参数示例

{
    "out_product_id": "1234566",
    "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
    "sub_title": "JD自营更放心】【国行Switch，更安心的保修服务，更快的国行服务器】一台主机三种模式，游戏掌机，随时随地，一起趣玩。",
    "head_img": 
    [
        "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
    ],
    "desc_info": 
    {
        "imgs": 
        [
            "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
        ]
    },
    "brand_id": 2100000000,
    "cats": 
    [
        {
            "cat_id": 6033,
            "level": 1
        },
        {
            "cat_id": 6057,
            "level": 2
        },
        {
            "cat_id": 6091,
            "level": 3
        }
    ],
    "attrs": 
    [
        {
            "attr_key": "商品毛重",
            "attr_value": "380g"
        },
        {
            "attr_key": "商品产地",
            "attr_value": "中国大陆"
        }
    ],
    "model": "国行续航增强版",
    "express_info": 
    {
        "template_id": 5189
    },
    "skus":
    [
        {
            "out_product_id": "1234566",
            "out_sku_id": "1024",
            "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
            "sale_price": 1300,
            "market_price": 1500,
            "stock_num": 100,
            "sku_code": "A24525252",
            "barcode": "13251454",
            "sku_attrs": 
            [
                {
                    "attr_key": "选择颜色",
                    "attr_value": "红蓝主机"
                },
                {
                    "attr_key": "选择套装",
                    "attr_value": "主机+保护套"
                }
            ]
        }
    ] 
}

# 回包示例

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

# 请求参数说明

参数	类型	是否必填	说明
out_product_id	string	是	商家自定义商品ID，与product_id二选一
title	string	是	标题
sub_title	string	否	副标题
head_img	string array	是	主图,多张,列表
desc_info.imgs	string array	是	商品详情，图文(目前只支持图片)
brand_id	number	是	品牌ID，商家需要申请品牌并通过获取品牌接口brand/get获取，如果是无品牌请填2100000000
cats[].cat_id	number	是	类目ID，如果brand_id=2100000000，需要先通过获取类目接口category/get拿到可用的cat_id；如果brand_id!=2100000000，则这里的cat_id需要与获取品牌接口brand/get中的1,2,3级类目一一对应
cats[].level	number	是	类目层级
attrs[].attr_key	string	是	属性键key（属性自定义用）
attrs[].attr_value	string	是	属性值（属性自定义用）
model	string	否	商品型号
express_info.template_id	number	是	运费模板ID（先通过获取运费模板接口delivery/get_freight_template拿到）
skus[]	array	否	该 skus 列表非必填，可另行通过 BatchAddSKU 添加 SKU
skus[].out_product_id	string	skus非空时必填	商家自定义商品ID
skus[].out_sku_id	string	skus非空时必填	商家自定义skuID
skus[].thumb_img	string	skus非空时必填	sku小图
skus[].sale_price	number	skus非空时必填	售卖价格,以分为单位
skus[].market_price	number	skus非空时必填	市场价格,以分为单位
skus[].stock_num	number	skus非空时必填	库存
skus[].barcode	string	否	条形码
skus[].sku_code	string	否	商品编码
skus[].sku_attrs[].attr_key	string	skus非空时必填	属性键key（属性自定义用）
skus[].sku_attrs[].attr_value	string	skus非空时必填	属性值（属性自定义用）

# 回包参数说明

参数	类型	说明
errcode	number	错误码
errmsg	string	错误信息
data.product_id	number	小商店内部商品ID
data.out_product_id	string	商家自定义商品ID
data.create_time	string	创建时间

# 返回码

返回码	错误类型
-1	系统异常
-2	token太长
9401020	参数有误
9401021	无权限调用该api
9401002	SPU不存在
9401001	SPU已经存在
9401023	SPU不允许编辑