全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
添加商品
接口地址： http://api.vv-tool.com/tool/erps/wd-item-add
接口介绍： 创建商品
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺 id |
| attrList | array | 否 | 规格信息列表 |
| --attrTitle | string | 是 | 属性标题， 比如颜色 |
| --attrValues | array | 是 | 属性值：一个属性标题下面会挂多个属性值，比如颜色属性下面会挂：红色，黑色，灰色……属性值 |
| ----attrId | number | 是 | 属性值 id |
| ----attrValue | string | 是 | 属性值，比如红色，黑色 |
| ----img | string | 否 | 属性上的图片 |
| cateIds | string | 否 | 商品分类 id，逗号，分隔 |
| stock | number | 是 | 无 sku 场景下的库存数量 |
| crossedPrice | string | 否 | 划线价 |
| price | string | 否 | 商品价格 |
| minPrice | number | 否 | 最低售价（连锁店业务） |
| maxPrice | number | 否 | 最高售价（连锁店业务） |
| costPrice | number | 否 | 成本价 日历类型和充值中心商品不支持 |
| expressFeeTemplateId | number | 否 | 运费模板 id |
| deliveryTime | object | 否 | 发货时间 |
| --deliveryAtAfterPayBefore | number | 否 | 0-当日，1-次日，结合 deliveryTimeType 为 1 时使用，x 点前付款，付款后 xx 天发货 |
| --deliveryTimeType | number | 是 | 发货时间选择类型，0-x 点前付款，付款后 xx 天发货；1-现在付款，预计当日/次日发货 |
| --payBefore | number | 否 | 结合 deliveryTimeType 为 0 时使用，x 点前付款 |
| --afterPayDeliveryAt | number | 否 | 结合 deliveryTimeType 为 0 时使用，付款后 xx 天发货；枚举参数：8 小时、16 小时、1 天、2 天、3 天、4 天、5 天、6 天、7 天、15 天、30 天、45 天，3600000*8=8 小时，其余枚举传参以此类推 |
| freeDelivery | bool | 否 | 是否包邮，true-包邮；false-不包邮 |
| remoteFreeDelivery | bool | 否 | 偏远地区是否包邮，true-包邮；false-不包邮 |
| imgs | array | 是 | 主图列表 |
| --title | string | 否 | 图片描述 |
| --url | string | 是 | 图片地址 |
| itemComment | string | 否 | 商品分享文案 |
| itemDeliveryList | array | 是 | 商品配送方式，4-快递发货;8-同城配送;16-到店自提 |
| itemDetails | array | 是 | 商品详情 |
| --type | number | 是 | type =1 文字模块，type=2 图片，type=12 富文本 |
| --text | string | 否 | 文字内容 |
| --url | string | 否 | 图片地址 |
| --data | string | 否 | 富文本内容 |
| itemName | string | 是 | 商品标题 |
| status | number | 否 | 商品状态，1-上架，2-下架;不传默认上架 |
| merchantCode | string | 否 | 商户编码 |
| skus | array | 否 | 商品型号列表，商品最多只能有 500 个 sku |
| --attrIds | array | 是 | 多级 sku 属性 Id 列表，比如 1-黑色；3-X 码； |
| --costPrice | number | 否 | 成本价单位元，0.01-999999999 |
| --merchantCode | string | 否 | sku 的商户编码 |
| --price | number | 是 | sku 价格 |
| --minPrice | number | 否 | sku 级别最低售价（连锁店业务） |
| --maxPrice | number | 是 | sku 级别最高售价（连锁店业务） |
| --stock | number | 是 | 库存 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| code | int | 返回状态码 | |
| msg | string | 返回码描述 | |
| msec | int | 接口执行时间 | |
| time | int | 接口返回时间 | |
| data | object | 数据信息 | |
| --status | object | null | |
| ----status_reason | string | null | |
| ----status_code | number | null | |
| --result | object | 操作结果 | |
| ----addSkuIds | array | 添加的 skuid | |
| ----itemId | number | 商品 id | |
| --withholding_money | int | 该接口扣费金额（点券） |
返回数据
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |