添加SKU
注意:商品有2份数据,草稿和线上数据
调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效
接口调用请求说明
请求参数示例
回包示例
请求参数说明
参数 | 类型 | 是否必填 | 说明 |
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万元),必须比sale_price 大 |
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.com
,或url前缀为mmbizurl.cn/p/
,或url前缀为mmecimage.cn/p/
),则可以直接提交。 - 字符: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 ,或url前缀不为mmbizurl.cn/p/ ,或url前缀不为mmecimage.cn/p/ (请参考文档的【注意】) |
9401052 | out_sku_id 过长 |
9401054 | sku价格为0 |
9401055 | sku售卖价格sale_price 大于等于市场价格market_price |