更新商品详情
接口描述 更新商品详情
API
/api/open/product/updateProduct
- 参数格式
POST application/x-www-form-urlencoded
- 入参
参数名称 | 类型 | 是否必填 | 描述 | |
---|---|---|---|---|
token | string | yes | 授权时获取的 access token | |
supplierSpu | String | yes | 商家SPU编码 | |
spuName | String | yes | 商品名称 | |
spuImage | String | yes | 商品主图 | |
categoryId | Long | yes | 商品分类Id | |
brandName | Long | yes | 品牌名称 | |
keyword | String | no | 搜索关键字 | |
description | String | no | 商品描述 | |
pcIntroduction | String | yes | PC端图文详情 | |
appIntroduction | String | no | APP端图文详情 | |
salesWay | String | yes | 销售方式 DIRECT_SELLING: 直销, CONSIGNMENT: 代销, DIRECT_SELLING_OR_CONSIGNMENT: 直销 | 代销 | |
settlementWay | String | yes | 结算方式 PROPORTIONAL: 比例结算, SETTLEMENT_PRICE: 结算价结算 | |
deliveryWay | String | yes | 配送方式。FACTORY_DELIVERY:厂家配送,JD_DELIVERY:京东配送,THIRD_PART_DELIVERY:第三方配送 | |
deliveryTimeliness | Number | yes | 发货时效 | |
timePeriodType | String | no | 发货时效单位(小时HOUR/天DAY) | |
salesChannelList | String | yes | 商品销售渠道集合JSON字符串 | |
mediaList | String | yes | 商品媒体文件集合JSON字符串 | |
attributeList | String | no | 商品属性JSON字符串 | |
skuList | String | yes | 商品sku信息JSON字符串 |
商品销售渠道信息
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
salesChannel | String | yes | 销售渠道编码 |
displayTimeStart | String | yes | 上架时间 yyyy-MM-dd hh:mm:ss |
displayTimeEnd | String | yes | 下架时间 yyyy-MM-dd hh:mm:ss |
sevenDaysForReturn | Integer | yes | 是否7天无理由退货,0 - 否,1 - 是 |
salesRegionList | List |
yes | 销售区域 |
商品属性
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
attributeName | String | yes | 属性名称 |
attributeValue | String | yes | 属性值 |
sorting | Integer | no | 排序 |
商品媒体文件信息
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
mediaType | String | yes | 媒体类型 (MAIN_PICTURE:主图,CAROUSEL_PICTURE:轮播图,VIDEO_PICTURE:视频封面,VIDEO:视频) |
mediaUrl | String | yes | 媒体文件路径 |
mediaName | String | yes | 媒体文件名称 |
sorting | Integer | no | 排序 |
商品SKU信息
参数名称 | 类型 | 是否必填 | 描述 | |
---|---|---|---|---|
supplierSku | String | yes | 商家sku编码 | |
skuName | String | yes | sku名称 | |
skuImage | String | yes | 商品SKU主图 | |
saleUnit | String | yes | sku售卖单位 | |
agreementPrice | Number | yes | 协议价 | |
referencePrice | Number | yes | 参考价 | |
minDeliveryQuantity | Number | yes | 起送量 | |
quantity | Number | no | 库存量 | |
weight | Number | no | 重量 | |
upc | String | no | 条行码 | |
productArea | String | no | 产地 | |
keyword | String | no | 搜索关键字 | |
description | String | no | 商品描述 | |
materialCode | String | no | 物料编码 | |
pcIntroduction | String | no | PC端图文详情 | |
appIntroduction | String | no | APP端图文详情 | |
skuSpecs | List |
yes | 商品SKU规格信息JSON数组 | |
skuMediaList | List |
no | 商品SKU媒体文件集合JSON数组 | |
skuAttributeList | List |
no | 商品属性JSON数组 | |
checkPriceMsgList | List |
平台商家:no 联营商家:yes | 商品SKU核价信息JSON数组 |
商品SKU规格信息
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
specsCode | String | yes | 规格编号 |
specsName | String | yes | 规格名称 |
specsValue | String | yes | 规格值 |
specsImage | String | no | 规格图片 |
sorting | Integer | no | 排序值 |
商品SKU媒体文件信息
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
mediaType | String | yes | 媒体类型 (MAIN_PICTURE:主图,CAROUSEL_PICTURE:轮播图,VIDEO_PICTURE:视频封面,VIDEO:视频) |
mediaUrl | String | yes | 媒体文件路径 |
mediaName | String | yes | 媒体文件名称 |
sorting | Integer | no | 排序 |
商品SKU属性
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
attributeName | String | yes | 属性名称 |
attributeValue | String | yes | 属性值 |
sorting | Integer | no | 排序 |
商品SKU核价信息
参数名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
outCheckPrice | BigDecimal | yes | 核价信息 |
attachment | String | yes | 附件 |
outCheckPriceUrl | String | yes | 核价链接 |
- 入参示例
{
"token": "your_access_token",
"supplierSpu": "SPU12345",
"spuName": "商品名称示例",
"spuImage": "http://example.com/image.jpg",
"categoryId": 1,
"brandName": "品牌名称示例",
"keyword": "搜索关键字示例",
"description": "商品描述示例",
"pcIntroduction": "PC端图文详情示例",
"appIntroduction": "APP端图文详情示例",
"salesWay": "DIRECT_SELLING",
"settlementWay": "PROPORTIONAL",
"deliveryWay": "FACTORY_DELIVERY",
"deliveryTimeliness": 24,
"timePeriodType": "DAY",
"salesChannelList": "[{\"salesChannel\":\"CHANNEL_1\",\"displayTimeStart\":\"2023-10-01 00:00:00\",\"displayTimeEnd\":\"2023-10-31 23:59:59\",\"sevenDaysForReturn\":1,\"salesRegionList\":[\"区域1\", \"区域2\"]}]",
"mediaList": "[{\"mediaType\":\"MAIN_PICTURE\",\"mediaUrl\":\"http://example.com/media.jpg\",\"mediaName\":\"主图\",\"sorting\":1}]",
"attributeList": "[{\"attributeName\":\"颜色\",\"attributeValue\":\"红色\"}]",
"skuList": "[{\"supplierSku\":\"SKU12345\",\"skuName\":\"SKU名称示例\",\"skuImage\":\"http://example.com/sku_image.jpg\",\"saleUnit\":\"件\",\"agreementPrice\":100.00,\"referencePrice\":120.00,\"minDeliveryQuantity\":1,\"quantity\":100,\"weight\":0.5,\"upc\":\"1234567890123\",\"productArea\":\"中国\",\"keyword\":\"SKU搜索关键字示例\",\"description\":\"SKU描述示例\",\"materialCode\":\"物料编码示例\",\"pcIntroduction\":\"PC端SKU图文详情示例\",\"appIntroduction\":\"APP端SKU图文详情示例\",\"skuSpecs\":[{\"specsCode\":\"SPEC123\",\"specsName\":\"规格名称示例\",\"specsValue\":\"规格值示例\"}],\"skuMediaList\":[{\"mediaType\":\"CAROUSEL_PICTURE\",\"mediaUrl\":\"http://example.com/sku_carousel.jpg\",\"mediaName\":\"SKU轮播图\",\"sorting\":2}],\"skuAttributeList\":[{\"attributeName\":\"属性名称示例\",\"attributeValue\":\"属性值示例\"}],\"checkPriceMsgList\":[{\"outCheckPrice\":98.00,\"attachment\":\"核价附件示例\",\"outCheckPriceUrl\":\"http://example.com/checkPrice\"}]}]"
}
- 出参示例
{
"success": true,
"code": 200,
"message": "操作成功"
}