添加商品
新增成功后会直接提交审核,可通过商品审核回调,或者通过get接口的edit_status查看是否通过审核。
商品有2份数据,草稿和线上数据。
调用接口新增或修改商品数据后,影响的只是草稿数据,审核通过后草稿数据才会覆盖线上数据,正式生效。
注意:
third_cat_id
请根据获取类目接口拿到,并确定其qualification_type
类目资质是否为必填,若为必填,那么要先调类目资质审核接口进行该third_cat_id
的资质审核;qualification_pics
请根据获取类目接口中对应third_cat_id
的product_qualification_type
为依据,若为必填,那么该字段需要加上该商品的资质图片;- 若需要上传某品牌商品,需要按照微信小商店开通规则开通对应品牌使用权限。微信小商店品牌开通规则:点击跳转,若无品牌可指定无品牌(无品牌
brand_id: 2100000000
)。 - 库存字段
stock_num
注意如果是0则无法在视频号直播上架该商品,库存和价格字段可以通过免审更新接口更新 - 部分特殊品类商品标题需要按照规范上传,请仔细阅读,避免审核不通过。商品标题规则:点击跳转。
- 商品详情字段
desc_info.desc
desc_info.imgs
虽然非必填,但一些特殊品类仍然需要上传商品详情,请仔细阅读,避免审核不通过。商品详情规则:点击跳转。
接口调用请求说明
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",
"head_img":
[
"http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
],
"qualification_pics": [
"http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
],
"desc_info":
{
"desc": "xxxxx",
"imgs":
[
"http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
]
},
"third_cat_id": 6666,
"brand_id": 2100000000,
"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",
"skus":
[
{
"sku_id": 123,
"out_sku_id": "1024"
},
...
]
}
}
请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
out_product_id | string | 是 | 商家自定义商品ID |
title | string | 是 | 标题 |
path | string | 是 | 绑定的小程序商品路径 |
head_img | string array | 是 | 主图,多张,列表 |
qualification_pics | string array | 否 | 商品资质图片 |
desc_info.desc | string | 否 | 商品详情图文 |
desc_info.imgs | string array | 否 | 商品详情图片 |
third_cat_id | number | 是 | 第三级类目ID |
brand_id | number | 是 | 品牌id |
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 | 是 | 售卖价格,以分为单位 |
skus[].market_price | number | 是 | 市场价格,以分为单位 |
skus[].stock_num | number | 是 | 库存 |
skus[].barcode | string | 否 | 条形码 |
skus[].sku_code | string | 否 | 商品编码 |
skus[].sku_attrs[].attr_key | string | 是 | 销售属性key(自定义) |
skus[].sku_attrs[].attr_value | string | 是 | 销售属性value(自定义) |
回包参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data.product_id | number | 交易组件平台内部商品ID |
data.out_product_id | string | 商家自定义商品ID |
data.create_time | string | 创建时间 |
data.skus | object array | sku数组 |
data.skus[].sku_id | string | 交易组件平台自定义skuID |
data.skus[].out_sku_id | string | 商家自定义skuID |