发布商品
接口描述 发布商品
API
/api/open/product/publishProduct- 参数格式
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 | String | yes | 品牌名称 | |
| keyword | String | yes | 搜索关键字 | |
| description | String | yes | 商品描述 | |
| 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）默认值：DAY | |
| salesChannelList | String | yes | 商品销售渠道集合JSON字符串 | |
| mediaList | String | yes | 商品媒体文件集合JSON字符串 | |
| attributeList | String | yes | 商品属性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": "操作成功"
}