添加SKU

注意:商品有2份数据,草稿和线上数据 调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效

接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/product/sku/add?access_token=xxxxxxxxx

请求参数示例

{
       "product_id": 23423523452345235,
       "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": 
        {
            "sku_id":2342523452352345,
            "create_time": "2020-03-25 12:05:25"
        }
}

请求参数说明

参数 类型 是否必填 说明
product_id number 小商店内部商品ID,与out_product_id二选一
out_product_id string 商家自定义商品ID,与product_id二选一
out_sku_id string 商家自定义sku_id,需要自行保证单appid内唯一,一旦添加成功后该字段无法修改,最多32字符
thumb_img string sku小图
sale_price number 售卖价格,以分为单位,不超过1000000000(1000万元)
market_price number 市场价格,以分为单位,不超过1000000000(1000万元)
stock_num number 库存
barcode string 条形码
sku_code string 商品编码,最多20字符
sku_attrs[].attr_key string 属性键key(属性自定义用),最多40字符
sku_attrs[].attr_value string 属性值(属性自定义用),最多40字符,相同key下不能超过100个不同value。

注意

  • 图片相关参数(如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.sku_id number 交易组件内部skuID
data.create_time string 创建时间

返回码

返回码 错误类型
-1 系统异常
-2 token太长
9401020 参数有误
9401006 SKU不存在
9401005 SKU已经存在
9401025 SKU不允许编辑
9401043 SKU价格过高
9401044 SKU商品编码sku_code过长
9401045
9401046 SKU同key属性个数过多
9401047 sku属性键keyskus[].sku_attrs[].attr_key字符过长
9401048 sku属性值skus[].sku_attrs[].attr_value字符过长
9401050 图片url非法:为空字符串,或域名不为store.mp.video.tencent-cloud.com(请参考文档的【注意】)
9401052 out_sku_id过长