小程序
取消
开发
中文
EN
取消
  • 平台能力

    • # 添加商品

    注意：商品有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 是 标题，最少3字符，最多60字符。注：1.商品标题只允许汉字、数字、英文字母、特殊字符集；2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合。
    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拿到）
    express_info.weight number 否 商品重量，运费模版计价方式为[按重量]时必填
    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 否 市场价格,以分为单位，不超过1000000000（1000万元），必须比sale_price大
    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。
    product_type number 否 1-实物商品 2-券码商品。不填默认为实物商品。
    couponcode_info.verify_type number 核销商品必填 0-每天都能核销 1-节假日不可用。该字段只在核销页面用作展示，不会限制核销流程，由商家自行决定是否核销。
    couponcode_info.valid_info.valid_type number 核销商品必填 1-指定时间区间生效 2-指定天数生效（购买后N天内有效）
    couponcode_info.valid_info.valid_day_num number 指定天数生效必填 valid_type为2时必填，核销商品的有效天数，从订单付款完成开始计算，自动取整为结束当天23:59:59。最小值为1，最大值为365。
    couponcode_info.valid_info.start_time number 指定区间生效必填 valid_type为1时必填，核销商品开始生效的日期。商品的实际生效时间根据该参数传入的时间戳自动取整为当天00:00:00。
    couponcode_info.valid_info.end_time number 指定区间生效必填 valid_type为1时必填，核销商品失效的日期。商品的实际失效时间根据该参数传入的时间戳自动取整为当天23:59:59。可接受的最大值为调用接口的时间戳+365天。

    # 注意

    • 图片相关参数（如head_img、desc_info.imgs、skus[].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.com，或url前缀为mmbizurl.cn/p/，或url前缀为mmecimage.cn/p/），则可以直接提交。
    • 字符：1个中文文字/1个英文字母，都各算1个字符
    • 商品product_type必须在添加商品的时候设置，之后更新商品不支持修改product_type
    • 商品标题允许的特殊字符集为

      `·~～!@#$%^&()！@#￥%……&*（）-_——=+[]\【】、{}|｜;'；’:"： ‘“”,./，。、<>?《》？\u00A0\u0020\u3000

    • 商品标题合规举例：

      糖醋排骨【预订价10元】 CheddarCheese切达干酪 百岁山天然矿泉水1L*15瓶

    • 商品标题不合规举例：

      正宗五指毛桃根√ Classic Whole Wheat 便携式折叠扇第Ⅲ代 iPhone 13 Mac999！

    # 回包参数说明

    参数 类型 说明
    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非法
    9401076 当前运费模版计价方式为[按重量]，但提交商品重量为0
    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 SKU销售属性过长
    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，或url前缀不为mmbizurl.cn/p/，或url前缀不为mmecimage.cn/p/（请参考文档的【注意】）
    9401051 out_product_id过长
    9401052 out_sku_id过长
    9401054 sku价格为0
    9401055 sku售卖价格sale_price大于等于市场价格market_price
    9401057 商品标题title字符过短
    9401060 商品标题不得仅为数字、字母、字符，不得含非法字符，请修改后重新提交审核
    9401063 商品品牌ID非法，商家需要申请品牌并通过获取品牌接口brand/get获取，如果是无品牌请填2100000000
    110111 核销信息couponcode_info不完整或错误
    110112 核销商品的有效期限超过限制