查询商品信息
接口描述 查询商品详情
API
/api/open/product/getProduct- 参数格式
POST application/x-www-form-urlencoded- 入参
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| token | string | yes | 授权时获取的 access token |
| supplierSpu | String | yes | 供应商spu编码 |
- 出参
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | spu主键Id |
| spuId | Long | spu主键Id |
| spuCode | String | 商品编码 |
| basic | ProductSaveBasicV2Vo | 基本信息 |
| attribute | ProductSaveAttributeV2Vo | 属性模版 |
| salesChannel | ProductSaveSalesChannelV2Vo | 销售渠道 |
| specsList | List<SpuSaveSpecsV2VO> | 商品SPU规格信息 |
| skuList | List<ProductSkuListV2VO> | 商品sku信息 |
| businessVersion | Integer | 业务版本 (0:未审批通过 1:已审批通过) |
| workFlowId | String | 流程Id |
| taskId | String | 任务Id |
| taskName | String | 任务名称 |
| remark | String | 提交备注 |
| submitState | String | 提交状态 SAVE:保存/SUBMIT：提交 |
| displayTimeStart | LocalDateTime | 其他销售渠道信息开始展示时间->SpuExtension |
| displayTimeEnd | LocalDateTime | 其他销售渠道信息结束展示时间->SpuExtension |
| secretPriceScope | BigDecimal | 价格保密范围(%) |
基本信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| tenantId | Long | 租户Id |
| tenantCode | String | 租户编码 |
| tenantName | String | 租户名称 |
| onlineServiceUrl | String | 在线客服链接 |
| spuCode | String | spu编码 |
| productType | String | 商品类型 |
| spuName | String | 商品名称 |
| categoryId | Long | 商品分类 |
| categoryName | String | 税号分类名称 |
| brandId | Long | 商品品牌 |
| brandName | String | 品牌名称 |
| description | String | 描述 |
| keyword | String | 搜索关键字 |
| supplierId | Long | 供应商id->SpuExtension |
| supplierName | String | 供应商名称 |
| selfSupport | String | 商家类型 |
| relationSupplierId | Long | 关联商家(供应商id)->SpuExtension |
| relationSupplierName | String | 关联供应商名称 |
| supplierSpu | String | 供应商SPU->SpuExtension |
| originalSpu | String | 原商品SPU->SpuExtension |
| supplierCategoryId | Long | 商家分类,第三方商品分类,例:京东商品分类,租户分类 |
| supplierCategoryName | String | 商家分类名称,第三方商品分类,例:京东商品分类,租户分类名称 |
| tenantContractCode | String | 租户合同号 |
| tenantContractName | String | 租户合同 |
| supplierShopType | String | 商品店铺类型 |
| supplierShopTypeName | String | 商品店铺类型名称 |
属性模版
| 参数名称 | 类型 | 描述 |
|---|---|---|
| templateId | Long | 模板Id |
| templateName | String | 模板名称 |
| groupList | List<AttributeGroupProductV2VO> | 商品属性分组 |
商品属性分组
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | Long | 分组id |
| groupCode | String | 分组编码 |
| groupName | String | 属性分组名称 |
| groupType | String | 类型 TEMPLATE:模板属性 CUSTOMIZE:自定义属性 |
| attributeList | List<AttributeProductV2VO> | 模板列表 |
模板列表
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | id主键 |
| attributeId | Long | 属性id |
| templateId | Long | 属性模板id |
| groupId | Long | 属性分组id |
| groupCode | String | 属性分组编码 |
| groupName | String | 属性分组名称 |
| attributeCode | String | 属性编号 |
| attributeName | String | 属性名称 |
| dataFormat | String | 数据格式 (INPUT:普通文本 TEXT:文本 NUMBER:数字 TIME:时间 SINGLE:单选 MULTIPLE:多选) |
| attributeType | String | 配置类型 (CUSTOMIZE:自定义 TEMPLATE:模板) |
| attributeValue | String | 属性值 |
| optionList | List<AttributeProductOptionVO> | 选择项目值 |
| maxLength | Integer | 属性值最大长度 |
| required | Integer | 是否必须，0 - 否，1 - 是 |
选择项目值
| 参数名称 | 类型 | 描述 |
|---|---|---|
| option | String | 是否必须，0 - 否，1 - 是 |
销售渠道
| 参数名称 | 类型 | 描述 |
|---|---|---|
| salesWay | String | 销售方式 |
| salesWayName | String | 销售方式名称 |
| settlementWay | String | 结算方式 |
| settlementWayName | String | 结算方式名称 |
| settlementRatio | BigDecimal | 结算比例 |
| taxCode | String | 税局分类编码 |
| taxName | String | 劳务名称(税局名称) |
| taxRate | BigDecimal | 其他销售渠道信息的税率 |
| afterSalesService | String | 售后服务->SpuExtension |
| bookedWay | String | 其他销售渠道信息的入账方式，取值数据字典->SpuExtension |
| bookedWayName | String | 入账方式名称 |
| deliveryWay | String | 配送方式 |
| deliveryWayName | String | 配送方式名称 |
| timePeriodType | String | 发货时效-时间周期类型 |
| timePeriodTypeName | String | 时间周期类型名称 |
| deliveryTimeliness | String | 发货时效->SpuExtension |
| arrivalTimeliness | String | 到货时效 |
| arrivalTimeType | String | 到货时效时间类型 |
| arrivalTimeTypeName | String | 到货时效时间类型名称 |
| spuSalesChannelList | List<SpuSaveSalesChannelVO> | 销售渠道 |
| secretPriceScope | BigDecimal | 价格保密范围 |
销售渠道
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | id主键 |
| salesChannel | String | 销售渠道 |
| salesChannelName | String | 销售渠道 |
| salesWay | String | 销售方式 |
| displayTimeStart | LocalDateTime | 其他销售渠道信息开始展示时间->SpuExtension |
| displayTimeEnd | LocalDateTime | 其他销售渠道信息结束展示时间->SpuExtension |
| sevenDaysForReturn | Integer | 是否7天无理由退货，0 - 否，1 - 是 |
| deliveryService | Integer | 是否提供配送服务，0 - 否，1 - 是 |
| deliveryDuration | String | 配送时段，多个时段用','隔开 |
| appointmentDays | Integer | 提前预定天数 |
| maxAppointmentDays | Integer | 支持客户预约天数 |
| closingTime | String | 当天截单时间 |
| state | Integer | 数据状态，0 - 无效，1 - 有效 |
| salesRegionList | List<String> | 销售区域 |
| salesRegionNameList | List<String> | 销售区域名称 |
| secretPriceScope | BigDecimal | 价格保密范围 |
商品SPU规格信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | id主键 |
| specsCode | String | 规格编号 |
| specsName | String | 规格名称 |
| specsType | String | 规格类型 |
| sorting | Integer | 排序值 |
| specAttributeValueList | List<SpuSaveSpecsAttributeV2VO> | 商品SPU规格选择信息 ,号分开 |
商品SPU规格选择信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| attributeName | String | 属性值 |
| imgUrl | String | 属性值 |
商品sku信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| tenantCode | String | 租户编码 |
| tenantId | Long | 租户id |
| skuId | Long | skuId |
| skuCode | String | sku编码 |
| specsList | List<SkuSaveSpecsVO> | 规格信息 |
| skuInfo | ProductSkuV2VO | 商品信息 |
规格信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| skuId | Long | 商品SKU的数据id |
| specsCode | String | 规格编号 |
| specsName | String | 规格名称 |
| specsType | String | 规格类型 |
| specsValue | String | 规格值 |
| specsImage | String | 规格图片 |
| sorting | Integer | 排序值 |
| optionList | List<String> | 选择项值 |
| optionVoList | List<SkuDetailSpecsOptionVO> | 选择项值 |
选择项值
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | id主键 |
| optionValue | String | 规格可选值 |
商品信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| tenantId | Long | tenantId |
| skuId | Long | skuId |
| skuCode | String | sku编码 |
| skuName | String | sku名称 |
| upc | String | 条形码 |
| specsImg | String | 规格图 |
| agreementPrice | BigDecimal | 协议价 |
| referencePrice | BigDecimal | 参考价 |
| minSettlementRatio | BigDecimal | 最低结算价比例/最低销售价比例 |
| minSalePrice | BigDecimal | 最低销售价 |
| settlementRatio | BigDecimal | 结算比例 |
| salePrice | BigDecimal | 销售价 |
| supplierSku | String | 商家SKU |
| jdSku | String | JdSKu |
| minDeliveryQuantity | Integer | 起送量 |
| quantity | Integer | 库存量 |
| saleUnit | String | 单位 |
| materialCode | String | 物料编码 |
| masterDataCode | String | 主数据编码 |
| attribute | ProductSaveAttributeV2Vo | 参数信息 |
| bundledList | List<SkuSaveBundledVO> | 关联商品 |
| checkPriceMsgList | checkPriceMsgVO | 商品SKU核价信息 |
参数信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| templateId | Long | 模板Id |
| templateName | String | 模板名称 |
| groupList | List<AttributeGroupProductV2VO> | 商品属性分组 |
商品属性分组
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | Long | 分组id |
| groupCode | String | 分组编码 |
| groupName | String | 属性分组名称 |
| groupType | String | 类型 TEMPLATE:模板属性 CUSTOMIZE:自定义属性 |
| attributeList | List<AttributeProductV2VO> | 模板列表 |
模板列表
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | id主键 |
| attributeId | Long | 属性id |
| templateId | Long | 属性模板id |
| groupId | Long | 属性分组id |
| groupCode | String | 属性分组编码 |
| groupName | String | 属性分组名称 |
| attributeCode | String | 属性编号 |
| attributeName | String | 属性名称 |
| dataFormat | String | 数据格式 (INPUT:普通文本 TEXT:文本 NUMBER:数字 TIME:时间 SINGLE:单选 MULTIPLE:多选) |
| attributeType | String | 配置类型 (CUSTOMIZE:自定义 TEMPLATE:模板) |
| attributeValue | String | 属性值 |
| optionList | List<AttributeProductOptionVO> | 选择项目值 |
| maxLength | Integer | 属性值最大长度 |
| required | Integer | 是否必须，0 - 否，1 - 是 |
关联商品
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Long | id主键 |
| bundledType | String | 商品关联类型，取值数据字典 |
| bundledTypeName | String | 商品关联类型名称 |
| bundledSkuId | Long | 关联商品的sku数据id |
| skuCode | String | sku编码 |
| skuName | String | sku名称 |
| quantity | Integer | 数量 |
| agreementPrice | BigDecimal | 关联商品的协议价 |
| suggestPrice | BigDecimal | 关联商品的参考价 |
商品SKU核价信息
| 参数名称 | 类型 | 描述 |
|---|---|---|
| outCheckPrice | BigDecimal | 核价信息 |
| attachment | String | 附件 |
| outCheckPriceUrl | String | 核价链接 |
- 入参示例
{
"token": "your_access_token",
"supplierSpu": "123456"
}- 出参示例
{
"success": true,
"code": 200,
"message": "操作成功",
"data": {
},
"stackTrace": null
}