产品中心

P0阶段完全取自天选。由中台网关转发。

API列表

编号	API名称	路径	版本
1.1	获取品牌信息列表	/bizPlatform/brand/page	1.0
1.2	根据品牌id列表获取品牌信息列表	/bizPlatform/brand/queryByIdList	1.0
1.3	根据品牌id获取品牌信息	/bizPlatform/brand/queryById	1.0
2.1	获取分类树	/bizPlatform/category/tree	1.0
2.2	获取分类信息列表	/bizPlatform/category/queryByIdList	1.0
2.3	获取分类信息	/bizPlatform/category/queryById	1.0
3.1	分页获取产品信息	/bizPlatform/product/page	1.0
3.2	根据产品id列表获取产品信息列表	/bizPlatform/product/queryByIdList	1.0
3.3	根据产品id获取产品信息	/bizPlatform/product/queryById	1.0
3.4	获取组合产品列表	/bizPlatform/product/queryComposeProductPage	1.0
3.5	获取组合产品下的产品详情	/bizPlatform/product/queryComposeProductDetail	1.0
3.6	根据id获取组合产品列表	/bizPlatform/product/queryComposeProductList	1.0
3.7	产品替换列表	/bizPlatform/product/queryProductReplaceList	1.0
4.1	分页获取套餐信息	/bizPlatform/combo/page	1.0
4.2	获取套餐下产品信息	/bizPlatform/combo/queryProductInfo	1.0
4.3	批量获取套餐及套餐内产品信息	/bizPlatform/combo/queryComboInfoByIdList	1.0

API调用

1、品牌管理

1.1: 获取品牌信息列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/brand/page

HTTP头： bizToken

方法：POST

请求参数

名称	类型	必填	描述
name	String	否	品牌名称
desc	String	否	品牌描述
status	Integer	否	状态 1:enable, 0:disable, -1:deleted
pageNum	Integer	是	当前页
pageSize	Integer	是	每页大小

请求示例

{
    "pageNum":1,
    "pageSize":10,
    "name":"沙发"
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
brandId	Long	是	品牌id
name	String	是	品牌名称
desc	String	否	品牌描述
imgUrl	String	否	品牌logo图片
firstLetter	String	否	检索首字母
seq	Integer	否	排序
isTop	Integer	否	是否置顶 0：不置顶 1：置顶
spuCount	Integer	否	品牌下的商品数量
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
createTime	Date	否	创建时间
updateTime	Date	否	更新时间

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "pages": 1,
        "total": 4,
        "list": [
            {
                "brandId": 4,
                "name": "联邦米尼沙发",
                "desc": null,
                "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/d70d9232e2d04f65b8f70ddcd658a832",
                "firstLetter": "L",
                "seq": 0,
                "isTop": 0,
                "spuCount": 0,
                "sysType": 1,
                "createTime": "2023-04-28 14:28:13",
                "updateTime": "2023-04-28 14:29:30"
            },
            {
                "brandId": 3,
                "name": "联邦米尼",
                "desc": "卖沙发",
                "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/fa4ee429eb2a417ab34cf243a9187bf3",
                "firstLetter": "L",
                "seq": 0,
                "isTop": 0,
                "spuCount": 0,
                "sysType": 0,
                "createTime": "2023-04-28 14:19:03",
                "updateTime": "2023-04-28 14:19:03"
            },
            {
                "brandId": 2,
                "name": "Zara",
                "desc": null,
                "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/b263f7c7f1da4ad29c7a6e9afb35f327",
                "firstLetter": "Z",
                "seq": 0,
                "isTop": 0,
                "spuCount": 0,
                "sysType": 1,
                "createTime": "2023-04-28 14:03:30",
                "updateTime": "2023-04-28 14:04:51"
            },
            {
                "brandId": 1,
                "name": "sebills",
                "desc": null,
                "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/e490b92226374c80b689f6b78b81eb33",
                "firstLetter": "S",
                "seq": 0,
                "isTop": 0,
                "spuCount": 0,
                "sysType": 1,
                "createTime": "2023-04-28 11:37:00",
                "updateTime": "2023-04-28 11:42:09"
            }
        ]
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

1.2: 根据品牌id列表获取品牌信息列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/brand/queryByIdList

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
idList	List	是	品牌id列表

请求Body描述

{
    "brandIdList":[1,2]
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
brandId	Long	是	品牌id
name	String	是	品牌名称
desc	String	否	品牌描述
imgUrl	String	否	品牌logo图片
firstLetter	String	否	检索首字母
seq	Integer	否	排序
isTop	Integer	否	是否置顶 0：不置顶 1：置顶
spuCount	Integer	否	品牌下的商品数量
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
createTime	Date	否	创建时间
updateTime	Date	否	更新时间

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
        {
            "brandId": 2,
            "name": "Zara",
            "desc": null,
            "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/b263f7c7f1da4ad29c7a6e9afb35f327",
            "firstLetter": "Z",
            "seq": 0,
            "isTop": 0,
            "spuCount": 0,
            "sysType": 1,
            "createTime": "2023-04-28 14:03:30",
            "updateTime": "2023-04-28 14:04:51"
        },
        {
            "brandId": 1,
            "name": "sebills",
            "desc": null,
            "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/e490b92226374c80b689f6b78b81eb33",
            "firstLetter": "S",
            "seq": 0,
            "isTop": 0,
            "spuCount": 0,
            "sysType": 1,
            "createTime": "2023-04-28 11:37:00",
            "updateTime": "2023-04-28 11:42:09"
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

1.3: 根据品牌id获取品牌信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/brand/queryById

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
brandId	Long	是	品牌id

请求Body描述

{
    "brandId":1
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
brandId	Long	是	品牌id
name	String	是	品牌名称
desc	String	否	品牌描述
imgUrl	String	否	品牌logo图片
firstLetter	String	否	检索首字母
seq	Integer	否	排序
isTop	Integer	否	是否置顶 0：不置顶 1：置顶
spuCount	Integer	否	品牌下的商品数量
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
createTime	Date	否	创建时间
updateTime	Date	否	更新时间

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "brandId": 1,
        "name": "sebills",
        "desc": null,
        "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/e490b92226374c80b689f6b78b81eb33",
        "firstLetter": "S",
        "seq": 0,
        "isTop": 0,
        "spuCount": 0,
        "sysType": 1,
        "createTime": "2023-04-28 11:37:00",
        "updateTime": "2023-04-28 11:42:09"
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

2.1: 获取分类树

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/category/tree

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
		无

请求Body描述

{
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
categoryId	Long	是	分类id
shopId	Long	是	店铺id
parentId	Long	是	父ID
name	String	是	分类名称
path	String	否	分类地址
desc	String	否	分类描述
icon	String	否	分类图标
imgUrl	String	否	分类的显示图片
level	Integer	是	分类层级从0开始
categoryChild	ist	否	子分类列表
deductionRate	Double	是	分类扣率
status	Integer	是	分类状态
seq	Integer	是	序号
createTime	Date	否	创建时间
updateTime	Date	否	更新时间

返回结果示例


{
    "code": "00000",
    "msg": null,
    "data": [{
            "categoryId": 10,
            "shopId": 0,
            "parentId": 0,
            "name": "文化玩乐",
            "path": "",
            "desc": "10155",
            "icon": null,
            "imgUrl": null,
            "level": 0,
            "categoryChild": [{
                    "categoryId": 1067,
                    "shopId": 0,
                    "parentId": 10,
                    "name": "乐器/吉他/钢琴/配件",
                    "path": "10",
                    "desc": "11011",
                    "icon": null,
                    "imgUrl": "",
                    "level": 1,
                    "categoryChild": [{
                            "categoryId": 2440,
                            "shopId": 0,
                            "parentId": 1067,
                            "name": "MIDI乐器/电脑音乐",
                            "path": "10-1067",
                            "desc": "11012",
                            "icon": null,
                            "imgUrl": "",
                            "level": 2,
                            "categoryChild": null,
                            "deductionRate": 0.1,
                            "status": 1,
                            "seq": 1,
                            "createTime": "2020-12-03 16:37:31",
                            "updateTime": "2020-12-03 16:37:31"
                        }
                    ],
                    "deductionRate": 0.1,
                    "status": 1,
                    "seq": 10,
                    "createTime": "2020-12-03 13:41:06",
                    "updateTime": "2020-12-03 13:41:06"
                }

            ]
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

2.2: 获取分类信息列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/category/queryByIdList

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
categoryIdList	List	是	分类id列表

请求Body描述

{
    "categoryIdList":[3415,3422]
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
categoryId	Long	是	分类id
shopId	Long	是	店铺id
parentId	Long	是	父ID
name	String	是	分类名称
path	String	否	分类地址
desc	String	否	分类描述
icon	String	否	分类图标
imgUrl	String	否	分类的显示图片
level	Integer	是	分类层级从0开始
categoryChild	ist	否	子分类列表
deductionRate	Double	是	分类扣率
status	Integer	是	分类状态
seq	Integer	是	序号
createTime	Date	否	创建时间
updateTime	Date	否	更新时间

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
        {
            "categoryId": 3422,
            "shopId": 1,
            "parentId": 0,
            "name": "数码电子",
            "path": "",
            "desc": null,
            "icon": "",
            "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/e490b92226374c80b689f6b78b81eb33",
            "level": 0,
            "categoryChild": null,
            "deductionRate": null,
            "status": 1,
            "seq": 1,
            "createTime": "2023-05-03 22:24:25",
            "updateTime": "2023-05-03 22:24:25"
        },
        {
            "categoryId": 3415,
            "shopId": 0,
            "parentId": 0,
            "name": "家装",
            "path": "",
            "desc": null,
            "icon": "",
            "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/fa4ee429eb2a417ab34cf243a9187bf3",
            "level": 0,
            "categoryChild": null,
            "deductionRate": null,
            "status": 1,
            "seq": 1,
            "createTime": "2023-04-28 14:16:37",
            "updateTime": "2023-04-28 14:16:37"
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

2.3: 获取分类信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/category/queryById

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
categoryId	Long	是	分类id

请求Body描述

{
    "categoryId":1229
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
brandId	Long	是	品牌id
name	String	是	品牌名称
desc	String	否	品牌描述
imgUrl	String	否	品牌logo图片
firstLetter	String	否	检索首字母
seq	Integer	否	排序
isTop	Integer	否	是否置顶 0：不置顶 1：置顶
spuCount	Integer	否	品牌下的商品数量
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
createTime	Date	否	创建时间
updateTime	Date	否	更新时间

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "categoryId": 1229,
        "shopId": 0,
        "parentId": 1008,
        "name": "户外照明",
        "path": "2-1008",
        "desc": "6699",
        "icon": null,
        "imgUrl": "",
        "level": 2,
        "categoryChild": null,
        "deductionRate": 0.1,
        "status": 1,
        "seq": 10,
        "createTime": "2020-12-03 16:24:04",
        "updateTime": "2020-12-03 16:24:04"
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.1: 分页获取产品信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/page

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
name	String	否	产品名称/型号/物料编码
categoryId	Long	否	分类id
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)
statusList	List	否	状态 -1:删除, 0:下架, 1:上架, 2:平台下架, 3: 等待审核, 默认是查询上架的产品
pageNum	Integer	是	当前页
pageSize	Integer	是	每页大小

请求Body描述

{
    "pageNum":1,
    "pageSize":10,
    "name":"测试"
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述	天策product字段对照
skuId	Long	是	产品id	id （订单购物车必填字段）
skuName	String	是	产品名称	--
spuId	Long	是	商品id	-- （订单购物车必填字段）
spuName	String	是	商名称	name
categoryName	String	是	分类名称	thirdClassifyName
categoryId	Long	是	分类id	thirdClassifyId
brandId	Long	是	品牌id	brandid
brandName	String	是	品牌名称	brandName
attrs	String	否	销售属性值，多个销售属性值id逗号分隔	--
imgUrl	String	否	产品图片	productUrl
priceFee	Long	否	售价，整数方式保存	price
marketPriceFee	Long	否	市场价，整数方式保存	--
scoreFee	Long	否	积分价格	--
partyCode	String	否	商品编码	--
modelId	String	否	商品条形码	--
weight	BigDecimal	否	商品重量	--
volume	Integer	否	商品体积	--
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted	status
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId	--
stockWarning	Integer	否	库存预警	--
createTime	Date	否	创建时间	createTime
updateTime	Date	否	更新时间	updateTime
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备	type
shopId	Long	是	商铺id	-- （订单购物车必填字段）
attrId	Long	否	规格属性id	--
attrName	String	否	规格属性名称	--
attrValueId	Long	否	规格属性值id	--
attrValueName	String	否	规格属性值名称	--
attrDesc	String	否	规格属性描述	--
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商	--
searchType	Integer	否	0:不需要，1:需要	--
attrType	Integer	否	0:销售属性，1:基本属性	--
serviceProductId	Long	否	服务产品id	--
serviceProductName	String	否	服务产品名称	--
externalProductCode	String	否	外部商品编码(物料编码)	ipmProductCode
productModel	String	否	产品型号	productModel
iotModelId	String	否	物模型id	modelId
panelQty	Integer	否	多路设备单路数量	panelQty
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许	panelDefine
productKey	String	否	iot产品标识	productKey
detail	String	否	商品详情	detail
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）	--
productManualUrl	String	否	产品说明书附件地址	--
spuImgUrl	String	否	商品图片,做轮播图	--
spuImgUrls	String	否	商品图片,备用	--
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品	--

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "pages": 1,
        "total": 1,
        "list": [
            {
                "skuId": 1,
                "spuId": 590099189888,
                "categoryName": "笔记本电脑配件",
                "categoryId": 2599,
                "brandId": 4,
                "brandName": "联邦米尼沙发",
                "attrs": "开关",
                "skuName": "测试产品",
                "imgUrl": "http://www.baidu.com",
                "priceFee": 9900,
                "marketPriceFee": 10000,
                "scoreFee": 0,
                "partyCode": "P465545139200",
                "modelId": "remac.light.001",
                "weight": 0,
                "volume": 0,
                "status": 1,
                "initialize": 1,
                "isVirtual": 0,
                "supplierSkuId": null,
                "stockWarning": 0,
                "shopId": 0,
                "createTime": "2023-05-03 22:29:20",
                "updateTime": "2023-05-04 16:05:04",
                "externalProductCode": "ec-1234561",
                "productModel": "pm-1234561",
                "iotModelId": "w-1234561",
                "sellingPoint": "具备调光调色功能，可调范围2700K-6000K冷暖色温；\n可满足小空间的重点照明要求；\n打光角度24°，适合重点照明。",
                "installationCondition": "开孔安装，灯具开孔尽量避开吊顶龙骨及中央空调管道；\n灯具距离天花顶高度需满足110mm，建议距离墙面200-400mm；\n需要预留电源零火线，线径推荐1.5-2.5平方。"
                "serviceProductList": [{
                  "skuId":1,
                  "serviceProductId":1,
                  "serviceProductName":"安装调试",
                  "price":1000,
                  "count":1,
                  "required":0
                }],
               "attrList": [
                   {
                       "spuId": 590099189888,
                       "attrId": 2,
                       "attrName": "哑铃",
                       "attrValueId": 5,
                       "attrValueName": "清凉",
                       "attrDesc": null,
                       "sysType": 0,
                       "searchType": 1,
                       "attrType": 1
                   }
               ]
            }
        ]
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.2: 根据产品id列表获取产品信息列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/queryByIdList

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
skuIdList	List	是	产品id列表

请求Body描述

{
    "skuIdList":[1]
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备
shopId	Long	是	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
serviceProductId	Long	否	服务产品id
serviceProductName	String	否	服务产品名称
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
panelQty	Integer	否	多路设备单路数量
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许
productKey	String	否	iot产品标识	productKey
detail	String	否	商品详情
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）
productManualUrl	String	否	产品说明书附件地址
spuImgUrl	String	否	商品图片,做轮播图
spuImgUrls	String	否	商品图片,备用
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
        {
            "skuId": 1,
            "spuId": 590099189888,
            "categoryName": "笔记本电脑配件",
            "categoryId": 2599,
            "brandId": 4,
            "brandName": "联邦米尼沙发",
            "attrs": "开关",
            "skuName": "测试产品",
            "imgUrl": "http://www.baidu.com",
            "priceFee": 9900,
            "marketPriceFee": 10000,
            "scoreFee": 0,
            "partyCode": "P465545139200",
            "modelId": "remac.light.001",
            "weight": 0,
            "volume": 0,
            "status": 1,
            "supplierSkuId": null,
            "stockWarning": 0,
            "shopId": 0,
            "createTime": "2023-05-03 22:29:20",
            "updateTime": "2023-05-04 16:05:04",
            "externalProductCode": "ec-1234561",
            "productModel": "pm-1234561",
            "iotModelId": "w-1234561",
            "sellingPoint": "具备调光调色功能，可调范围2700K-6000K冷暖色温；\n可满足小空间的重点照明要求；\n打光角度24°，适合重点照明。",
            "installationCondition": "开孔安装，灯具开孔尽量避开吊顶龙骨及中央空调管道；\n灯具距离天花顶高度需满足110mm，建议距离墙面200-400mm；\n需要预留电源零火线，线径推荐1.5-2.5平方。"
            "serviceProductList": null,
           "attrList": [
               {
                   "spuId": 590099189888,
                   "attrId": 2,
                   "attrName": "哑铃",
                   "attrValueId": 5,
                   "attrValueName": "清凉",
                   "attrDesc": null,
                   "sysType": 0,
                   "searchType": 1,
                   "attrType": 1
               }
           ]
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.3: 根据产品id获取产品信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/queryById

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
skuId	Long	是	产品id

请求Body描述

{
    "skuId":1
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备
shopId	Long	是	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
serviceProductId	Long	否	服务产品id
serviceProductName	String	否	服务产品名称
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
panelQty	Integer	否	多路设备单路数量
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许
productKey	String	否	iot产品标识	productKey
detail	String	否	商品详情
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）
productManualUrl	String	否	产品说明书附件地址
spuImgUrl	String	否	商品图片,做轮播图
spuImgUrls	String	否	商品图片,备用
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "skuId": 1,
        "spuId": 590099189888,
        "categoryName": "笔记本电脑配件",
        "categoryId": 2599,
        "brandId": 4,
        "brandName": "联邦米尼沙发",
        "attrs": "开关",
        "skuName": "测试产品",
        "imgUrl": "http://www.baidu.com",
        "priceFee": 9900,
        "marketPriceFee": 10000,
        "scoreFee": 0,
        "partyCode": "P465545139200",
        "modelId": "remac.light.001",
        "weight": 0,
        "volume": 0,
        "status": 1,
        "supplierSkuId": null,
        "stockWarning": 0,
        "shopId": 0,
        "sellingPoint": "具备调光调色功能，可调范围2700K-6000K冷暖色温；\n可满足小空间的重点照明要求；\n打光角度24°，适合重点照明。",
        "installationCondition": "开孔安装，灯具开孔尽量避开吊顶龙骨及中央空调管道；\n灯具距离天花顶高度需满足110mm，建议距离墙面200-400mm；\n需要预留电源零火线，线径推荐1.5-2.5平方。"
        "createTime": "2023-05-03 22:29:20",
        "updateTime": "2023-05-04 16:05:04",
        "externalProductCode": "ec-1234561",
        "productModel": "pm-1234561",
        "iotModelId": "w-1234561",
        "serviceProductList": null,
       "attrList": [
           {
               "spuId": 590099189888,
               "attrId": 2,
               "attrName": "哑铃",
               "attrValueId": 5,
               "attrValueName": "清凉",
               "attrDesc": null,
               "sysType": 0,
               "searchType": 1,
               "attrType": 1
           }
       ]
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.4: 获取组合产品列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/queryComposeProductPage

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
name	String	否	产品名称/物料编码
categoryId	Long	否	分类id
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)
statusList	List	否	状态 -1:删除, 0:下架, 1:上架, 2:平台下架, 3: 等待审核, 默认是查询上架的产品
pageNum	Integer	是	当前页
pageSize	Integer	是	每页大小

请求Body描述

{
    "pageNum":1,
    "pageSize":2
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
shopId	Long	是	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
detail	String	否	商品详情
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）
productManualUrl	String	否	产品说明书附件地址
spuImgUrl	String	否	商品图片,做轮播图
spuImgUrls	String	否	商品图片,备用
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "pages": 4,
        "total": 4,
        "list": [
            {
                "skuId": "256",
                "skuName": "260厘米 科技皮",
                "spuId": "631438254224",
                "spuName": "组合商品-沙发",
                "categoryName": "沙发",
                "categoryId": "3418",
                "brandId": "4",
                "brandName": "联邦米尼沙发",
                "attrs": "沙发尺寸,沙发材质",
                "imgUrl": "/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "spuImgUrl": "/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "spuImgUrls": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "priceFee": "600001",
                "marketPriceFee": "300000",
                "scoreFee": 0,
                "partyCode": "12501",
                "modelId": "12502",
                "weight": 100.0,
                "volume": 2.6,
                "status": 1,
                "supplierSkuId": null,
                "stockWarning": 0,
                "createTime": "2023-05-11 19:42:46",
                "updateTime": "2023-05-12 10:19:39",
                "shopId": "3",
                "externalProductCode": "wl15",
                "productModel": "wl15",
                "iotModelId": null,
                "attrList": null,
                "detail": "<p>balabala商品详情</p>",
                "threeDimensionalParams": "[{\"key1\":\"123\"},{\"key2\":\"456\"}]",
                "productManualUrl": "/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "skuList": [
                    {
                        "skuId": "244",
                        "skuName": "头层牛皮 黑色",
                        "spuId": "624995868800",
                        "spuName": "两人位沙发",
                        "categoryName": "沙发",
                        "categoryId": "3418",
                        "brandId": "4",
                        "brandName": "联邦米尼沙发",
                        "attrs": "沙发材质,沙发颜色",
                        "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrls": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "priceFee": "2000000",
                        "marketPriceFee": "1000000",
                        "scoreFee": 0,
                        "partyCode": "P588224336912",
                        "modelId": "",
                        "weight": null,
                        "volume": null,
                        "status": 1,
                        "supplierSkuId": null,
                        "stockWarning": 0,
                        "createTime": "2023-05-11 18:59:14",
                        "updateTime": "2023-05-11 18:59:15",
                        "nodeType": 3,
                        "panelQty": null,
                        "panelDefine": null,
                        "productKey": "393d9d59bba04e81adadc99ac19dbc43",
                        "shopId": "3",
                        "externalProductCode": "wl02",
                        "productModel": "2",
                        "iotModelId": "dad2",
                        "attrList": null,
                        "serviceProductList": null,
                        "detail": "<p>balabala</p>",
                        "threeDimensionalParams": null,
                        "productManualUrl": null,
                        "relQuantity": 1,
                        "finalPriceFee": null,
                        "finalMarketPriceFee": null
                    },
                    {
                        "skuId": "243",
                        "skuName": "头层牛皮 爱马仕橙",
                        "spuId": "624995868800",
                        "spuName": "两人位沙发",
                        "categoryName": "沙发",
                        "categoryId": "3418",
                        "brandId": "4",
                        "brandName": "联邦米尼沙发",
                        "attrs": "沙发材质,沙发颜色",
                        "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrls": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "priceFee": "2000000",
                        "marketPriceFee": "1000000",
                        "scoreFee": 0,
                        "partyCode": "P590371820544",
                        "modelId": "",
                        "weight": null,
                        "volume": null,
                        "status": 1,
                        "supplierSkuId": null,
                        "stockWarning": 0,
                        "createTime": "2023-05-11 18:59:14",
                        "updateTime": "2023-05-11 18:59:15",
                        "nodeType": 3,
                        "panelQty": null,
                        "panelDefine": null,
                        "productKey": "0dc8d89713c14d0ba3556a5f2893fa49",
                        "shopId": "3",
                        "externalProductCode": "wl01",
                        "productModel": "1",
                        "iotModelId": "dadd",
                        "attrList": null,
                        "serviceProductList": null,
                        "detail": "<p>balabala</p>",
                        "threeDimensionalParams": null,
                        "productManualUrl": null,
                        "relQuantity": 1,
                        "finalPriceFee": null,
                        "finalMarketPriceFee": null
                    }
                ]
            }
        ]
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.5: 获取组合产品下的产品详情

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/queryComposeProductDetail

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
skuId	Long	是	套餐产品id

请求Body描述

{
    "skuId":60
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备
shopId	Long	是	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
serviceProductId	Long	否	服务产品id
serviceProductName	String	否	服务产品名称
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
panelQty	Integer	否	多路设备单路数量
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许
productKey	String	否	iot产品标识	productKey
detail	String	否	商品详情	detail
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）	--
productManualUrl	String	否	产品说明书附件地址	--
relQuantity	Integer	是	关联的skuId搭配数量
finalPriceFee	Long	是	最终的售价单价，整数方式保存
finalMarketPriceFee	Long	是	最终的市场价单价，整数方式保存
spuImgUrl	String	否	商品图片,做轮播图
spuImgUrls	String	否	商品图片,备用
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
        {
            "skuId": "3",
            "skuName": "头层牛皮 320厘米",
            "spuId": "453197045888",
            "spuName": "三人位直排沙发",
            "categoryName": "沙发",
            "categoryId": "3418",
            "brandId": "4",
            "brandName": "联邦米尼沙发",
            "attrs": "沙发材质,沙发尺寸",
            "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
            "priceFee": "1000001",
            "marketPriceFee": "500000",
            "scoreFee": 0,
            "partyCode": "12302",
            "modelId": "12302",
            "weight": 150.0,
            "volume": 3.2,
            "status": 1,
            "supplierSkuId": null,
            "stockWarning": 0,
            "createTime": "2023-05-05 11:24:21",
            "updateTime": "2023-05-05 11:24:21",
            "nodeType": null,
            "panelQty": null,
            "panelDefine": null,
            "productKey": null,
            "shopId": "3",
            "externalProductCode": null,
            "productModel": null,
            "iotModelId": null,
            "attrList": null,
            "serviceProductList": null,
            "relQuantity": 3,
            "finalPriceFee": 1000,
            "finalMarketPriceFee": 100
        },
        {
            "skuId": "2",
            "skuName": "头层牛皮 260厘米",
            "spuId": "453197045888",
            "spuName": "三人位直排沙发",
            "categoryName": "沙发",
            "categoryId": "3418",
            "brandId": "4",
            "brandName": "联邦米尼沙发",
            "attrs": "沙发材质,沙发尺寸",
            "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
            "priceFee": "1000001",
            "marketPriceFee": "500000",
            "scoreFee": 0,
            "partyCode": "12301",
            "modelId": "12301",
            "weight": 100.0,
            "volume": 2.6,
            "status": 1,
            "supplierSkuId": null,
            "stockWarning": 0,
            "createTime": "2023-05-05 11:24:21",
            "updateTime": "2023-05-09 09:43:05",
            "nodeType": null,
            "panelQty": null,
            "panelDefine": null,
            "productKey": null,
            "shopId": "3",
            "externalProductCode": "ec-1234561",
            "productModel": "pm-1234561",
            "iotModelId": "w-1234561",
            "attrList": null,
            "serviceProductList": [
                {
                    "skuId": "2",
                    "serviceProductId": "3",
                    "serviceProductName": "3",
                    "price": "3",
                    "count": 3,
                    "required": 3
                }
            ],
            "relQuantity": 2,
            "finalPriceFee": 1000,
            "finalMarketPriceFee": 100
        },
        {
            "skuId": "1",
            "skuName": "测试产品",
            "spuId": "590099189888",
            "spuName": "mac笔记本",
            "categoryName": "笔记本电脑配件",
            "categoryId": "2599",
            "brandId": "1",
            "brandName": "sebills",
            "attrs": "开关",
            "imgUrl": "http://www.baidu.com",
            "priceFee": "9900",
            "marketPriceFee": "10000",
            "scoreFee": 0,
            "partyCode": "P465545139200",
            "modelId": "remac.light.001",
            "weight": 0.0,
            "volume": 0.0,
            "status": 1,
            "supplierSkuId": null,
            "stockWarning": 0,
            "createTime": "2023-05-03 22:29:20",
            "updateTime": "2023-05-09 09:43:02",
            "nodeType": null,
            "panelQty": null,
            "panelDefine": null,
            "productKey": null,
            "shopId": "1",
            "externalProductCode": "ec-1234561",
            "productModel": "pm-1234561",
            "iotModelId": "w-1234561",
            "attrList": [
                {
                    "spuId": "590099189888",
                    "attrId": "2",
                    "attrName": "哑铃",
                    "attrValueId": "5",
                    "attrValueName": "清凉",
                    "attrDesc": null,
                    "sysType": 0,
                    "searchType": 1,
                    "attrType": 1
                }
            ],
            "serviceProductList": [
                {
                    "skuId": "1",
                    "serviceProductId": "1",
                    "serviceProductName": "1",
                    "price": "1",
                    "count": 1,
                    "required": 1
                },
                {
                    "skuId": "1",
                    "serviceProductId": "2",
                    "serviceProductName": "2",
                    "price": "2",
                    "count": 2,
                    "required": 2
                }
            ],
            "relQuantity": 1,
            "finalPriceFee": 1000,
            "finalMarketPriceFee": 100
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.6: 根据id获取组合产品列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/queryComposeProductList

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
skuIdList	List	是	组合套餐id

请求Body描述

{
    "skuIdList":[255,256]
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
shopId	Long	是	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
detail	String	否	商品详情
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）
productManualUrl	String	否	产品说明书附件地址
spuImgUrl	String	否	商品图片,做轮播图
spuImgUrls	String	否	商品图片,备用
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
            {
                "skuId": "256",
                "skuName": "260厘米 科技皮",
                "spuId": "631438254224",
                "spuName": "组合商品-沙发",
                "categoryName": "沙发",
                "categoryId": "3418",
                "brandId": "4",
                "brandName": "联邦米尼沙发",
                "attrs": "沙发尺寸,沙发材质",
                "imgUrl": "/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "spuImgUrl": "/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "spuImgUrls": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "priceFee": "600001",
                "marketPriceFee": "300000",
                "scoreFee": 0,
                "partyCode": "12501",
                "modelId": "12502",
                "weight": 100.0,
                "volume": 2.6,
                "status": 1,
                "supplierSkuId": null,
                "stockWarning": 0,
                "createTime": "2023-05-11 19:42:46",
                "updateTime": "2023-05-12 10:19:39",
                "shopId": "3",
                "externalProductCode": "wl15",
                "productModel": "wl15",
                "iotModelId": null,
                "attrList": null,
                "detail": "<p>balabala商品详情</p>",
                "threeDimensionalParams": "[{\"key1\":\"123\"},{\"key2\":\"456\"}]",
                "productManualUrl": "/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                "skuList": [
                    {
                        "skuId": "244",
                        "skuName": "头层牛皮 黑色",
                        "spuId": "624995868800",
                        "spuName": "两人位沙发",
                        "categoryName": "沙发",
                        "categoryId": "3418",
                        "brandId": "4",
                        "brandName": "联邦米尼沙发",
                        "attrs": "沙发材质,沙发颜色",
                        "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrls": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "priceFee": "2000000",
                        "marketPriceFee": "1000000",
                        "scoreFee": 0,
                        "partyCode": "P588224336912",
                        "modelId": "",
                        "weight": null,
                        "volume": null,
                        "status": 1,
                        "supplierSkuId": null,
                        "stockWarning": 0,
                        "createTime": "2023-05-11 18:59:14",
                        "updateTime": "2023-05-11 18:59:15",
                        "nodeType": 3,
                        "panelQty": null,
                        "panelDefine": null,
                        "productKey": "393d9d59bba04e81adadc99ac19dbc43",
                        "shopId": "3",
                        "externalProductCode": "wl02",
                        "productModel": "2",
                        "iotModelId": "dad2",
                        "attrList": null,
                        "serviceProductList": null,
                        "detail": "<p>balabala</p>",
                        "threeDimensionalParams": null,
                        "productManualUrl": null,
                        "relQuantity": 1,
                        "finalPriceFee": null,
                        "finalMarketPriceFee": null
                    },
                    {
                        "skuId": "243",
                        "skuName": "头层牛皮 爱马仕橙",
                        "spuId": "624995868800",
                        "spuName": "两人位沙发",
                        "categoryName": "沙发",
                        "categoryId": "3418",
                        "brandId": "4",
                        "brandName": "联邦米尼沙发",
                        "attrs": "沙发材质,沙发颜色",
                        "imgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrl": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "spuImgUrls": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/1ec7f1721d8c4f2ba2db7f9f2eb50d0e",
                        "priceFee": "2000000",
                        "marketPriceFee": "1000000",
                        "scoreFee": 0,
                        "partyCode": "P590371820544",
                        "modelId": "",
                        "weight": null,
                        "volume": null,
                        "status": 1,
                        "supplierSkuId": null,
                        "stockWarning": 0,
                        "createTime": "2023-05-11 18:59:14",
                        "updateTime": "2023-05-11 18:59:15",
                        "nodeType": 3,
                        "panelQty": null,
                        "panelDefine": null,
                        "productKey": "0dc8d89713c14d0ba3556a5f2893fa49",
                        "shopId": "3",
                        "externalProductCode": "wl01",
                        "productModel": "1",
                        "iotModelId": "dadd",
                        "attrList": null,
                        "serviceProductList": null,
                        "detail": "<p>balabala</p>",
                        "threeDimensionalParams": null,
                        "productManualUrl": null,
                        "relQuantity": 1,
                        "finalPriceFee": null,
                        "finalMarketPriceFee": null
                    }
                ]
        }
    ],   
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

3.7: 产品替换列表

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/product/queryProductReplaceList

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
skuId	Long	是	产品id
debug	boolean	否	调试模式，默认为否
actions	List	否	动作key
coditions	List	否	条件key

请求Body描述

{
    "skuId":207
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备
shopId	Long	是	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
serviceProductId	Long	否	服务产品id
serviceProductName	String	否	服务产品名称
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
panelQty	Integer	否	多路设备单路数量
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许
productKey	String	否	iot产品标识	productKey
detail	String	否	商品详情
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）
productManualUrl	String	否	产品说明书附件地址
spuImgUrl	String	否	商品图片,做轮播图
spuImgUrls	String	否	商品图片,备用
orientedObject	String	否	面向群体（枚举值：c-terminal:C端、b-terminal:B端)	--
isTrigger	Integer	否	是否可以做为触发条件,0-不允许,1-允许	--
isAction	Integer	否	是否可以做为执行动作,0-不允许,1-允许	--
sellingPoint	String	否	买点	--
installationCondition	String	否	商品安装条件	--
initialize	Integer	否	可实例化 0否 1是	--
isVirtual	Integer	否	是否虚拟产品 0否 1是	--
spuMold	Integer	是	商品类别 0.实物商品(非智能商品) 1. 虚拟商品 2.智能商品 3.组合产品

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
        {
            "skuId": 1,
            "spuId": 590099189888,
            "categoryName": "笔记本电脑配件",
            "categoryId": 2599,
            "brandId": 4,
            "brandName": "联邦米尼沙发",
            "attrs": "开关",
            "skuName": "测试产品",
            "imgUrl": "http://www.baidu.com",
            "priceFee": 9900,
            "marketPriceFee": 10000,
            "scoreFee": 0,
            "partyCode": "P465545139200",
            "modelId": "remac.light.001",
            "weight": 0,
            "volume": 0,
            "status": 1,
            "supplierSkuId": null,
            "stockWarning": 0,
            "shopId": 0,
            "createTime": "2023-05-03 22:29:20",
            "updateTime": "2023-05-04 16:05:04",
            "externalProductCode": "ec-1234561",
            "productModel": "pm-1234561",
            "iotModelId": "w-1234561",
            "serviceProductList": null,
           "attrList": [
               {
                   "spuId": 590099189888,
                   "attrId": 2,
                   "attrName": "哑铃",
                   "attrValueId": 5,
                   "attrValueName": "清凉",
                   "attrDesc": null,
                   "sysType": 0,
                   "searchType": 1,
                   "attrType": 1
               }
           ]
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

4.1: 分页获取套餐信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/combo/page

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
name	String	否	套餐名称
pageNum	Integer	是	当前页
pageSize	Integer	是	每页大小

请求Body描述

{
    "pageNum":1,
    "pageSize":10
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
createTime	Date	是	创建时间
updateTime	Date	是	修改时间
comboId	Long	是	套餐id
name	name	是	套餐名称
startTime	Date	是	活动开始时间
endTime	Date	是	活动结束时间
status	Integer	是	状态 -1：已删除 0：关闭 1:进行中
price	Long	是	套餐销售价
pic	String	是	套餐图片,第一阶段用主商品图片
mainSpuId	Long	是	主商品id
mainSpuName	String	是	主商品名称

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": {
        "pages": 1,
        "total": 1,
        "list": [
            {
                "createTime": "2023-05-06 15:05:46",
                "updateTime": "2023-05-06 15:07:50",
                "comboId": 1,
                "name": "测试套餐勿动",
                "startTime": "2023-05-05 15:05:18",
                "endTime": "2023-07-29 15:05:23",
                "status": 1,
                "price": 200,
                "pic": "http://remac-tx.oss-cn-hangzhou.aliyuncs.com/2023/04/28/e490b92226374c80b689f6b78b81eb33",
                "mainSpuId": 590099189888,
                "mainSpuName": "mac笔记本"
            }
        ]
    },
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

4.2: 获取套餐下产品信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/combo/queryProductInfo

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
comboId	Long	是	套餐id

请求Body描述

{
    "comboId":1
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备
comboId	Long	是	套餐id
comboName	String	是	套餐名称
matchingPrice	Long	是	套餐搭配价格
type	Integer	是	类型：1：主商品 2：搭配商品
required	Integer	是	是否必选：1：是 0：否
leastNum	Integer	是	起搭数量
shopId	Long	否	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
serviceProductId	Long	否	服务产品id
serviceProductName	String	否	服务产品名称
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
panelQty	Integer	否	多路设备单路数量
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许
productKey	String	否	iot产品标识	productKey
detail	String	否	商品详情	detail
threeDimensionalParams	String	否	3D需要额外字段（保存json数据）	--
productManualUrl	String	否	产品说明书附件地址	--

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
       {
            "skuId": 2,
            "skuName": "头层牛皮 260厘米",
            "spuId": 453197045888,
            "spuName": null,
            "categoryName": "沙发",
            "categoryId": 3418,
            "brandId": 4,
            "brandName": "联邦米尼沙发",
            "attrs": "沙发材质,沙发尺寸",
            "imgUrl": null,
            "priceFee": 1000001,
            "marketPriceFee": 500000,
            "scoreFee": 0,
            "partyCode": "12301",
            "modelId": "12301",
            "weight": 100,
            "volume": 2.6,
            "status": 1,
            "supplierSkuId": null,
            "stockWarning": 0,
            "createTime": "2023-05-05 11:24:21",
            "updateTime": "2023-05-05 11:24:21",
            "nodeType": null,
            "comboId": 1,
            "comboName": "测试套餐勿动",
            "matchingPrice": 100,
            "type": 2,
            "required": 0,
            "leastNum": 1,
            "externalProductCode": "ec-1234561",
            "productModel": "pm-1234561",
            "iotModelId": "w-1234561",
            "serviceProductList": null,
           "attrList": [
               {
                   "spuId": 590099189888,
                   "attrId": 2,
                   "attrName": "哑铃",
                   "attrValueId": 5,
                   "attrValueName": "清凉",
                   "attrDesc": null,
                   "sysType": 0,
                   "searchType": 1,
                   "attrType": 1
               }
           ]
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}

4.3: 批量获取套餐及套餐内产品信息

请求信息

HTTP协议：HTTP,HTTPS

uri：/bizPlatform/combo/queryComboInfoByIdList

HTTP头：bizToken

方法：POST/JSON

请求参数

名称	类型	必填	描述
comboIdList	List	是	套餐id列表

请求Body描述

{
    "comboIdList":[1]
}

返回参数类型

JSON

返回参数

名称	类型	必填	描述
skuId	Long	是	产品id
skuName	String	是	产品名称
spuId	Long	是	商品id
categoryName	String	是	分类名称
categoryId	Long	是	分类id
brandId	Long	是	品牌id
brandName	String	是	品牌名称
attrs	String	否	销售属性值，多个销售属性值id逗号分隔
imgUrl	String	否	产品图片
priceFee	Long	否	售价，整数方式保存
marketPriceFee	Long	否	市场价，整数方式保存
scoreFee	Long	否	积分价格
partyCode	String	否	商品编码
modelId	String	否	商品条形码
weight	BigDecimal	否	商品重量
volume	Integer	否	商品体积
status	BigDecimal	是	状态 1:enable, 0:disable, -1:deleted
supplierSkuId	Long	否	当商品为代销商品时，供应商商品skuId
stockWarning	Integer	否	库存预警
createTime	Date	否	创建时间
updateTime	Date	否	更新时间
nodeType	Integer	否	节点类型:1直连设备 2网关 3子设备
comboId	Long	是	套餐id
comboName	String	是	套餐名称
matchingPrice	Long	是	套餐搭配价格
type	Integer	是	类型：1：主商品 2：搭配商品
required	Integer	是	是否必选：1：是 0：否
leastNum	Integer	是	起搭数量
shopId	Long	否	商铺id
attrId	Long	否	规格属性id
attrName	String	否	规格属性名称
attrValueId	Long	否	规格属性值id
attrValueName	String	否	规格属性值名称
attrDesc	String	否	规格属性描述
sysType	Integer	否	关联系统类型 1.店铺 2.平台端 3.供应商
searchType	Integer	否	0:不需要，1:需要
attrType	Integer	否	0:销售属性，1:基本属性
serviceProductId	Long	否	服务产品id
serviceProductName	String	否	服务产品名称
externalProductCode	String	否	外部商品编码(物料编码)
productModel	String	否	产品型号
iotModelId	String	否	物模型id
panelQty	Integer	否	多路设备单路数量
panelDefine	Integer	否	是否允许单路设置,0-不允许,1-允许

返回结果示例

{
    "code": "00000",
    "msg": null,
    "data": [
        {
            "createTime": "2023-05-06 15:05:46",
            "updateTime": "2023-05-06 15:07:50",
            "comboId": 1,
            "comboName": "测试套餐勿动",
            "startTime": "2023-05-05 15:05:18",
            "endTime": "2023-07-29 15:05:23",
            "status": 1,
            "price": 200,
            "skuList": [
                {
                    "skuId": 1,
                    "skuName": "测试产品",
                    "spuId": 590099189888,
                    "spuName": null,
                    "categoryName": "笔记本电脑配件",
                    "categoryId": 2599,
                    "brandId": null,
                    "brandName": null,
                    "attrs": "开关",
                    "imgUrl": "http://www.baidu.com",
                    "priceFee": 9900,
                    "marketPriceFee": 10000,
                    "scoreFee": 0,
                    "partyCode": "P465545139200",
                    "modelId": "remac.light.001",
                    "weight": 0,
                    "volume": 0,
                    "status": 1,
                    "supplierSkuId": null,
                    "stockWarning": 0,
                    "createTime": "2023-05-03 22:29:20",
                    "updateTime": "2023-05-04 16:05:04",
                    "nodeType": null,
                    "comboId": 1,
                    "comboName": "测试套餐勿动",
                    "matchingPrice": 200,
                    "type": 1,
                    "required": 0,
                    "leastNum": 1,
                    "externalProductCode": "ec-1234561",
                    "productModel": "pm-1234561",
                    "iotModelId": "w-1234561",
                    "serviceProductList": null,
                   "attrList": [
                       {
                           "spuId": 590099189888,
                           "attrId": 2,
                           "attrName": "哑铃",
                           "attrValueId": 5,
                           "attrValueName": "清凉",
                           "attrDesc": null,
                           "sysType": 0,
                           "searchType": 1,
                           "attrType": 1
                       }
                   ]
                },
                {
                    "skuId": 2,
                    "skuName": "头层牛皮 260厘米",
                    "spuId": 453197045888,
                    "spuName": null,
                    "categoryName": "沙发",
                    "categoryId": 3418,
                    "brandId": 4,
                    "brandName": "联邦米尼沙发",
                    "attrs": "沙发材质,沙发尺寸",
                    "imgUrl": null,
                    "priceFee": 1000001,
                    "marketPriceFee": 500000,
                    "scoreFee": 0,
                    "partyCode": "12301",
                    "modelId": "12301",
                    "weight": 100,
                    "volume": 2.6,
                    "status": 1,
                    "supplierSkuId": null,
                    "stockWarning": 0,
                    "createTime": "2023-05-05 11:24:21",
                    "updateTime": "2023-05-05 11:24:21",
                    "nodeType": null,
                    "comboId": 1,
                    "comboName": "测试套餐勿动",
                    "matchingPrice": 100,
                    "type": 2,
                    "required": 0,
                    "leastNum": 1,
                    "externalProductCode": "ec-1234561",
                    "productModel": "pm-1234561",
                    "iotModelId": "w-1234561",
                    "serviceProductList": null,
                   "attrList": [
                       {
                           "spuId": 453197045888,
                           "attrId": 2,
                           "attrName": "哑铃",
                           "attrValueId": 5,
                           "attrValueName": "清凉",
                           "attrDesc": null,
                           "sysType": 0,
                           "searchType": 1,
                           "attrType": 1
                       }
                   ]
                }
            ]
        }
    ],
    "version": "mall4j.v230424",
    "success": true,
    "fail": false
}