新增商品
`POST` `https://qw-openapi-tx.dustess.com/java-data-exchange-srv/api/goods/v1/create`
Content-Type: application/json
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
accessToken | String | Token认证信息 | true |
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
categoryName | String | 分类名称 层级以“/”分割 一级分类/二级分类/三级分类 | true |
code | String | 商品编码(全局非空不重复),长度不能超过100个字符 | true |
customField | String | 客户自定义字段,字段值的长度不能超过1000个字符 | false |
marketPrice | String | 市场价格(单位:元),"199.9",商品详情页面划线展示“市场价199.9元,最多允许2位小数 | true |
newCode | String | 需要更新商品code时使用,将对应商品的code更新成newCode | false |
name | String | 商品名称,长度不能超过200个字符 | true |
resource | Object[] | 资源 | false |
remark | String | 商品描述,长度不能超过200个字符 | false |
resource.detailImageList | Object[] | 详情图, 最多20个 | false |
resource.detailImageList.imageId | String | 接口上传获取图片id | false |
resource.detailVideoCoverList | String[] | 详情视频封面图片ID | false |
resource.detailVideoList | Object[] | 详情视频 | false |
resource.detailVideoList.videoId | String | 接口上传视频的ID | false |
resource.imageList | Object[] | 头图图片,最多5个 | false |
resource.imageList.imageId | String | 接口上传的图片ID | false |
skuList | Object[] | sku列表,最多1000条sku,如果为空,参数skuList需要保留,内容传空数组 | false |
skuList.attributeList | Object[] | 规格属性 | false |
skuList.attributeList.imageId | String | 图片地址ID | false |
skuList.attributeList.name | String | 规格名称 | false |
skuList.attributeList.value | String | 规格值 | false |
skuList.code | String | sku标识-单个商品下唯一 | false |
skuList.cost | String | 成本(单位:元) | false |
skuList.inventory | Int | 库存 | false |
skuList.name | String | sku名称(已过时) | false |
skuList.price | String | sku价格(单位:元),sku不为空时必传 | false |
goodsInventory | Int | 商品库存,skuList为空时,指定商品库存 | false |
goodsPrice | String | 标准价格(单位:元),"199.9",skuList为空时,指定商品标准价格,最多允许2位小数 | false |
type | Int | 商品类型 1:普通商品,2:虚拟商品 | true |
unit | String | 商品单位[件],长度不能超过5个字符 | true |
status | Int | 商品上下架状态 1上架 2下架(不传默认下架) | false |
displayStatus | Int | 商品显示状态 1在商城中显示 2不在商城中显示 | false |
{
"categoryName": "衣服/毛衣",
"code": "7b1eecbed04f42e38ee0dca627e7540a",
"newCode": "",
"customField": "",
"marketPrice": "10.01",
"name": "白色毛衣",
"remark": "商品描述",
"resource": {
"detailImageList": [
{
"imageId": "5fb72529ce93e33dd5c48a89"
}
],
"detailVideoCoverList": ["5fb72529ce93e33dd5c48a89"],
"detailVideoList": [
{
"videoId": "5fb72529ce93e33dd5c48a89"
}
],
"imageList": [
{
"imageId": "5fb72529ce93e33dd5c48a89"
}
]
},
"skuList": [
{
"attributeList": [
{
"imageId": "5fb72529ce93e33dd5c48a89",
"name": "颜色",
"value": "红色"
}
],
"code": "7b1eecbed04f42e38ee0dca627e7540a",
"cost": "10.00",
"inventory": 5,
"name": "红色毛衣",
"price": "20.00"
}
],
"goodsInventory":100,
"goodsPrice":"19.99",
"type": 1,
"unit": "件",
"status":1
}
{
"code": 500200,
"msg": "成功",
"data": {
"goodsId": "1363899420990509056",
"code": "0010",
"skuList": [
{
"skuId": "c2e37cf8-fb89-11eb-b113-52ba2767467d",
"code": "00025"
},
{
"skuId": "c2e37d07-fb89-11eb-b113-52ba2767467d",
"code": "00027"
}
]
},
"logMessageId": "ed15a7a8c8884175a094bd678dbebf6b",
"success": true
}
响应参数名 | 类型 | 说明 |
---|---|---|
success | Bool | 请求状态, true: 成功; false: 失败 |
code | Int | 响应代码 |
msg | String | 消息提示 |
data | Object | 数据信息 |
logMessageId | String | 调用链日志id |
data
字段类型说明参数名称 | 类型 | 描述 |
---|---|---|
goodsId | String | 商品ID |
code | String | 商品编码 |
skuList | Object[] | sku 列表 |
skuList.skuId | String | skuId |
skuList.code | String | sku 编码 |