添加商品 | 微信开放文档

# 添加商品

详细商品规则传送门

# 接口调用请求说明

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

# 请求参数示例

{
    "out_product_id": "1234566",
    "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
    "path": "pages/productDetail/productDetail?productId=2176180",
    "direct_path": "pages/productDetail/productDetail?productId=2176180&direct=true",
    "head_img": 
    [
        "https://mmecimage.cn/p/wx77e672d6d34a4bed/HNTiaPWTllJ5R2pq9Jv9jRD5bZOWmq2svUUzJcZbcg"
    ],
    "qualification_pics": [
        "https://mmecimage.cn/p/wx77e672d6d34a4bed/HNTiaPWTllJ5R2pq9Jv9jRD5bZOWmq2svUUzJcZbcg"
    ],
    "desc_info": 
    {
        "desc": "xxxxx",
        "imgs": 
        [
            "https://mmecimage.cn/p/wx77e672d6d34a4bed/HNTiaPWTllJ5R2pq9Jv9jRD5bZOWmq2svUUzJcZbcg"
        ]
    },
    "third_cat_id": 6666,
    "brand_id": 2100000000,
    "info_version": "xxx",
    "skus":
    [
        {
            "out_product_id": "1234566",
            "out_sku_id": "1024",
            "thumb_img": "https://mmecimage.cn/p/wx77e672d6d34a4bed/HNTiaPWTllJ5R2pq9Jv9jRD5bZOWmq2svUUzJcZbcg",
            "sale_price": 1300,
            "market_price": 1500,
            "stock_num": 100,
            "sku_code": "A24525252",
            "barcode": "13251454",
            "sku_attrs": 
            [
                {
                    "attr_key": "选择颜色",
                    "attr_value": "红蓝主机"
                },
                {
                    "attr_key": "选择套装",
                    "attr_value": "主机+保护套"
                }
            ]
        }
    ],
    "scene_group_list": [1]
}

# 回包示例

{
    "errcode": 0,
    "errmsg":"ok",
    "data": 
    {
        "product_id": 23423523452345235,
        "out_product_id": "1234566",
        "create_time": "2020-03-25 12:05:25",
        "skus":
        [
            {
                "sku_id": 123,
                "out_sku_id": "1024"
            },
            ...
        ]
    }
}

# 请求参数说明

参数	类型	是否必填	说明
out_product_id	string	是	商家自定义商品ID
title	string	是	标题，字符类型，最少不低于3，最长不超过60。注：1.商品标题只允许汉字、数字、英文字母、特殊字符集；2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合。
path	string	是	绑定的小程序商品路径
direct_path	string	否	商品立即购买链接
head_img	string array	是	主图，多张，列表，图片类型，最多不超过9张
qualification_pics	string array	否	商品资质图片，图片类型，最多不超过5张
desc_info.desc	string	否	商品详情图文，字符类型，最长不超过2000
desc_info.imgs	string array	否	商品详情图片，图片类型，最多不超过50张
third_cat_id	number	是	第三级类目ID
brand_id	number	是	品牌id
info_version	string	否	预留字段，用于版本控制
skus[]	object array	是	sku数组
skus[].out_product_id	string	是	商家自定义商品ID
skus[].out_sku_id	string	是	商家自定义skuID
skus[].thumb_img	string	是	sku小图
skus[].sale_price	number	是	售卖价格，以分为单位，数字类型，最大不超过10000000（1000万元）
skus[].market_price	number	是	市场价格，以分为单位，数字类型，最大不超过10000000（1000万元）
skus[].stock_num	number	是	库存，数字类型，最大不超过10000000（1000万）
skus[].barcode	string	否	条形码
skus[].sku_code	string	否	商品编码，字符类型，最长不超过20
skus[].sku_attrs[].attr_key	string	是	销售属性key（自定义），字符类型，最长不超过40
skus[].sku_attrs[].attr_value	string	是	销售属性value（自定义），字符类型，最长不超过40，相同key下不能超过100个不同value
scene_group_list	enum array	是	商品使用场景,1:视频号 ~~，3:订单中心（非视频号订单中心，未明确开通此场景的商家请勿传值）。~~ 组件开通流程中以及未接入场景时，请保持为空`"scene_group_list":[]`

# 回包参数说明

参数	类型	说明
errcode	number	错误码
errmsg	string	错误信息
data.product_id	number(uint64)	交易组件平台内部商品ID
data.out_product_id	string	商家自定义商品ID
data.skus	object array	sku数组
data.skus[].sku_id	string	交易组件平台自定义skuID
data.skus[].out_sku_id	string	商家自定义skuID