添加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 |