添加商品

注意:商品有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": 
    [
        "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/6059ade300096eb200000000f19f9d09000000a000004f50"
    ],
    "desc_info": 
    {
        "imgs": 
        [
            "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/6059ade300096eb200000000f19f9d09000000a000004f50"
        ]
    },
    "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": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/6059ade300096eb200000000f19f9d09000000a000004f50",
            "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二选一,需要自行保证单appid内唯一,一旦添加成功后该字段无法修改,最多32字符
title string 标题,最多60字符
sub_title string 副标题,最多18字符
head_img string array 主图,多张,列表,最多9张
desc_info.imgs string array 商品详情,图文(目前只支持图片,最多20张)
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,最多32字符
skus[].out_sku_id string skus非空时必填 商家自定义skuID,最多32字符
skus[].thumb_img string sku小图
skus[].sale_price number skus非空时必填 售卖价格,以分为单位,不超过1000000000(1000万元)
skus[].market_price number skus非空时必填 市场价格,以分为单位,不超过1000000000(1000万元)
skus[].stock_num number skus非空时必填 库存
skus[].barcode string 条形码
skus[].sku_code string 商品编码,最多20字符
skus[].sku_attrs[].attr_key string skus非空时必填 属性键key(属性自定义用),最多40字符
skus[].sku_attrs[].attr_value string skus非空时必填 属性值(属性自定义用),最多40字符,相同key下不能超过100个不同value。

注意

  • 图片相关参数(如head_imgdesc_info.imgsskus[].thumb_img等),请务必使用 https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/business-capabilities/ministore/minishopopencomponent/API/register/uploadimg.html 接口上传图片(参数resp_type=1),并将返回的temp_img_url填入此处,此处不接受任何外链图片url。若url曾经做过转换(域名为store.mp.video.tencent-cloud.commmbizurl.cn),则可以直接提交。
  • 字符:1个中文文字/1个英文字母,都各算1个字符

回包参数说明

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

返回码

返回码 错误类型
-1 系统异常
-2 token太长
9401001 SPU已经存在
9401002 SPU不存在
9401020 参数有误
9401021 无权限调用该api
9401023 SPU不允许编辑
9401026 商品的类目长度不对(预期是有三级类目)
9401032 类目非法
9401033 商家不具备当前类目资质
9401034 运费模版idexpress_info.template_id非法
9401035 商品标题title为空
9401036 商品标题title字符过长
9401037 商品主图head_img为空
9401038 商品主图head_img过多
9401039 副标题sub_title字符过长
9401040 商品详情图片desc_info.imgs过多
9401041 商品详情描述字符过长
9401042 资质图片过多
9401043 SKU价格过高
9401044 SKU商品编码sku_code过长
9401045
9401046 SKU同key属性个数过多
9401047 sku属性键keyskus[].sku_attrs[].attr_key字符过长
9401048 sku属性值skus[].sku_attrs[].attr_value字符过长
9401049 售后说明字符过长
9401050 图片url非法:为空字符串,或域名不为store.mp.video.tencent-cloud.com(请参考文档的【注意】)
9401051 out_product_id过长
9401052 out_sku_id过长