# 添加商品
详细商品规则传送门
# 接口调用请求说明
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:视频号 "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 |