全部
淘宝
拼多多
抖音
京东
快手
当当
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 每个用户每次下单至少购买的件数

请求示例

请求代码示例

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 未授权店铺 根据返回链接进行扫码授权