全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
新版创建商品接口
接口地址： http://api.vv-tool.com/tool/erps/productaddV2
接口介绍： 新的商品发布接口，一次性完成商品-规格-SKU 的发布，更高效的上传商品方式。
注意： out_sku_id 可以传数字；outer_sku_id 可以传数字/英文字符串 ，推荐使用 outer_sku_id点击查看详情
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺 id |
| outer_product_id | String | 否 | 推荐使用，外部商家编码，支持字符串 |
| product_type | String | 是 | 0-普通，3-虚拟，6 玉石闪购，7 云闪购 |
| category_leaf_id | String | 否 | 叶子类目 ID 通过/shop/getShopCategory 接口获取 |
| first_cid | String | 否 | 一级分类 id（三个分类级别请确保从属正确） ，即将废弃建议使用 category_leaf_id |
| second_cid | String | 否 | 二级分类 id ，即将废弃建议使用 category_leaf_id |
| third_cid | String | 否 | 三级分类 id ，即将废弃建议使用 category_leaf_id |
| product_format | String | 是 | 属性名称丨属性值 之间用丨分隔， 多组之间用 ^ 分开 |
| name | String | 是 | 商品名称，最多 60 个字符(30 个汉字)，不能含 emoj 表情 = |
| recommend_remark | String | 否 | 商家推荐语，不能含 emoj 表情 |
| pic | String | 是 | 商品轮播图，多张图片用 "丨" 分开，第一张图为主图，最多 5 张，至少 600x600，大小不超过 1M 注："pic"、"description"、"spec_pic"这三个字段里的传入的图片数量总和，不得超过 50 张。超过会报错：图片转链失败 |
| description | String | 是 | 商品描述，目前只支持图片。多张图片用 "丨" 分开。不能用其他网站的文本粘贴，这样会出现 CSS 样式不兼容 注："pic"、"description"、"spec_pic"这三个字段里的传入的图片数量总和，不得超过 50 张。超过会报错：图片转链失败 |
| pay_type | String | 是 | 支付方式，0 货到付款 1 在线支付，2，货到付款 + 在线支付 |
| market_price | String | 是 | 划线价，单位分 |
| discount_price | String | 是 | 售价，单位分 |
| reduce_type | String | 是 | 减库存类型：1-拍下减库存 2-付款减库存 |
| assoc_ids | String | 否 | 同店商品推荐：为空表示使用系统推荐；多个 product_id 使用“丨”分开 |
| freight_id | String | 是 | 运费模板 id，传 0 表示包邮，通过/freightTemplate/list 接口获取 |
| weight | String | 是 | 重量 |
| weight_unit | String | 是 | 重量单位，0-kg, 1-g |
| delivery_delay_day | String | 是 | 承诺发货时间，单位是天 不传则默认为 2 天，presell_type 为 0 或 2 均只支持传入 2，presell_type 为 1 时支持可选值为： 2、3、5、7、10、15 |
| presell_type | String | 否 | 发货模式，0-现货发货，1-预售发货，2-阶梯发货，默认 0 |
| presell_delay | String | 否 | 预售模式下结束后，几天发货/阶梯模式下阶梯发货时间，2-15 |
| presell_end_time | String | 否 | 预售结束时间，格式 2020-02-21 18:54:27，最多支持设置距离当前 30 天 |
| supply_7day_return | String | 是 | 是否支持 7 天无理由，0 不支持，1 支持，2 支持（拆封后不支持） |
| mobile | String | 是 | 客服电话号码 |
| commit | String | 是 | false 仅保存，true 保存 + 提审 |
| brand_id | String | 否 | 品牌 id (请求店铺授权品牌接口获取) (效果即为商品详情页面中的品牌字段) 哪些类目必需上传品牌 |
| remark | String | 否 | 商家可见备注 |
| quality_report | String | 否 | 商品创建和编辑操作支持设置质检报告链接，多个图片以逗号分隔 |
| class_quality | String | 否 | 商品创建和编辑操作支持设置品类资质链接，多个图片以逗号分隔 |
| out_product_id | String | 否 | 外部 product_id |
| quality_list | List | 否 | 系统资质列表，类目与商品资质映射表 |
| spec_name | String | 否 | 如果不填，则规格名为各级规格名用 "-" 自动生成 |
| specs | String | 是 | 店铺通用规格，能被同类商品通用。多规格用 ^ 分隔，规格与规格值用丨分隔，多个规格值用，分隔丨 |
| spec_prices | String | 是 | sku 详情，数量应该等于规格 1 规格 2 规格 3，sku 数量和规格组合数必须一致 sku 不可售时，库存可设置为 0。 JSON string，具体字段的含义见下表 |
| --spec_detail_name1 | String | 是 | 规格 1 名称，最多三级 |
| --spec_detail_name2 | String | 否 | 规格 2 名称 |
| --spec_detail_name3 | String | 否 | 规格 3 名称 |
| --stock_num | Number | 是 | 库存 (可以为 0) |
| --price | Number | 是 | 售价 (单位 分) |
| --code | String | 否 | 商品编码 |
| --step_stock_num | Number | 否 | 阶梯库存数，不传为 0 |
| --supplier_id | String | 否 | 供应商 ID |
| --out_sku_id | Number | 否 | 外部 sku id |
| --outer_sku_id | String | 否 | 推荐使用，外部商家 sku_id，支持字符串类型 |
| spec_pic | String | 否 | 如颜色-尺寸， 颜色就是主规格， 颜色如黑，白，黄，它们图片 url 以逗号分隔 注："pic"、"description"、"spec_pic"这三个字段里的传入的图片数量总和，不得超过 50 张。超过会报错：图片转链失败图片数量和规格数量对应 |
| maximum_per_order | number | 否 | 每个用户每次下单限购件数 |
| limit_per_buyer | number | 否 | 每个用户累计限购件数 |
| minimum_per_order | number | 否 | 每个用户每次下单至少购买的件数 |
| vvtype | String | 是 | 2 高级版（必须填 2,不填默认是 2） |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| property_id | Number | 3472490447010721067 | 商品 id |
| out_product_id | String | 1617004369 | 外部商家编码 |
| outer_product_id | String | 见响应示例 | 外部商家编码 string 版本 |
| create_time | String | 2021-03-29 15:52:53 | 创建时间 |
| sku | array | [] | 商品规格 |
| sku_id | SKU_id | ||
| --out_sku_id | 外部 sku id | ||
| --outer_sku_id | 外部 sku id string 版本 | ||
| --code | 外部 sku 码 | ||
| --spec_detail_id1 | 一级规格 ID | ||
| --spec_detail_id2 | 二级规格 ID | ||
| --spec_detail_id3 | 三级规格 ID |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"product_id": 3472490447010721067,//商品id
"out_product_id": 1617004369,//外部商家编码
"outer_product_id": "1617004369",//外部商家编码string版本
"create_time": "2021-03-29 15:52:53",//创建时间
"sku": [
{
"sku_id": 1695459998495774,//SKU_id
"out_sku_id": 0,//外部sku id
"outer_sku_id": "",//外部sku id string版本
"code": "",//外部sku码
"spec_detail_id1": 1695459998494734,//一级规格ID
"spec_detail_id2": 1695459998494766,//二级规格ID
"spec_detail_id3": 0//三级规格ID
},
{
"sku_id": 1695459998495758,
"out_sku_id": 0,
"outer_sku_id": "",
"code": "",
"spec_detail_id1": 1695459998447672,
"spec_detail_id2": 1695459998494766,
"spec_detail_id3": 0
},
{
"sku_id": 1695459998494782,
"out_sku_id": 123456788,
"outer_sku_id": "123456788",
"code": "16076589507w",
"spec_detail_id1": 1695459998447656,
"spec_detail_id2": 1695459998494766,
"spec_detail_id3": 0
}
]
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 202 | 系统错误，请稍后再试 | 稍后重试，或者联系对接群 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |