添加商品

新增成功后会直接提交审核,可通过商品审核回调,或者通过get接口的edit_status查看是否通过审核。

商品有2份数据,草稿和线上数据。

调用接口新增或修改商品数据后,影响的只是草稿数据,审核通过后草稿数据才会覆盖线上数据,正式生效。

注意:

  1. third_cat_id请根据获取类目接口拿到,并确定其qualification_type类目资质是否为必填,若为必填,那么要先调类目资质审核接口进行该third_cat_id的资质审核;
  2. qualification_pics请根据获取类目接口中对应third_cat_idproduct_qualification_type为依据,若为必填,那么该字段需要加上该商品的资质图片;
  3. 若需要上传某品牌商品,需要按照微信小商店开通规则开通对应品牌使用权限。微信小商店品牌开通规则:点击跳转,若无品牌可指定无品牌(无品牌brand_id: 2100000000)。

接口调用请求说明

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