# 获取合作商品详情
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南
接口英文名：getitem
可通过该接口获取商品详情
- 启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。此接口新增 cats_v2 字段支持新类目树，详见参数。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/item/get?access_token=ACCESS_TOKEN
# 云调用
调用方法：channels.ec.league.headsupplier.item.get
出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| appid | string | 是 | test | 机构商品 所属小店appid |
| product_id | number | 是 | 12345 | 商品id |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
| item | object | 商品详情 |
# Res.item Object Payload
商品详情
| 参数名 | 类型 | 说明 |
|---|---|---|
| appid | string | 所属小店appid |
| product_id | number | 商品id |
| product_info | object | 商品信息 |
| commission_info | object | 跟佣信息 |
# Res.item.product_info Object Payload
商品信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| title | string | 标题 |
| sub_title | string | 副标题。如果添加时没录入，回包可能不包含该字段 |
| head_imgs | array | 主图,多张,列表,最多9张,每张不超过2MB |
| desc_info | object | 商详信息 |
| cats | objarray | 类目信息 |
| express_info | object | 快递信息 |
| skus | objarray | sku信息 |
| is_hidden | boolean | 商品是否在商品列表页对外隐藏 |
| cats_v2 | objarray | 新类目树--类目信息 |
# Res.item.product_info.desc_info Object Payload
商详信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| imgs | array | 商品详情图片(最多20张)。如果添加时没录入，回包可能不包含该字段 |
| desc | string | 商品详情文字。如果添加时没录入，回包可能不包含该字段 |
# Res.item.product_info.cats(Array) Object Payload
类目信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| cat_id | string | 类目id |
| cat_name | string | 类目名称 |
# Res.item.product_info.express_info Object Payload
快递信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| send_time | string | 发货时间期限 |
| address_info | object | 发货地址 |
| shipping_method | string | 计费方式：FREE：包邮CONDITION_FREE：条件包邮NO_FREE：不包邮 |
# Res.item.product_info.express_info.address_info Object Payload
发货地址
| 参数名 | 类型 | 说明 |
|---|---|---|
| postal_code | string | 邮编 |
| province_name | string | 国标收货地址第一级地址 |
| city_name | string | 国标收货地址第二级地址 |
| county_name | string | 国标收货地址第三级地址 |
# Res.item.product_info.skus(Array) Object Payload
sku信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| sku_id | string | skuID |
| thumb_img | string | sku小图。如果添加时没录入，回包可能不包含该字段 |
| sale_price | number | 售卖价格，以分为单位 |
| stock_num | number | sku库存 |
| sku_attrs | objarray | sku_attrs |
| sku_deliver_info | object | sku_deliver_info |
# Res.item.product_info.skus(Array).sku_attrsObject Payload
Object Payloadsku_attrs
| 参数名 | 类型 | 说明 |
|---|---|---|
| attr_key | string | 属性键key（属性自定义用） |
| attr_value | string | 属性值value（属性自定义用），参数规则如下： ● 当 获取类目信息 接口中返回的type：为 select_many， attr_value的格式：多个选项用分号;隔开 示例：某商品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年 ● 当 获取类目信息 接口中返回的type：为 integer_unit/decimal4_unit attr_value格式：数值 单位，用单个空格隔开 示例：某商品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择 获取类目信息 接口中返回的type：为 integer/decimal4 attr_value 的格式：字符串形式的数字 |
# Res.item.product_info.skus(Array).sku_deliver_info Object Payload
sku_deliver_info
| 参数名 | 类型 | 说明 |
|---|---|---|
| stock_type | number | sku库存情况。0:现货（默认），1:全款预售。部分类目支持全款预售，具体参考文档 获取类目信息 中的字段attr.pre_sale |
| full_payment_presale_delivery_type | number | sku发货节点，该字段仅对stock_type=1有效。0:付款后n天发货，1:预售结束后n天发货 |
| presale_begin_time | number | sku预售周期开始时间，秒级时间戳，该字段仅对delivery_type=1有效。 |
| presale_end_time | number | sku预售周期结束时间，秒级时间戳，该字段仅对delivery_type=1有效。 |
| full_payment_presale_delivery_time | number | sku发货时效，即付款后/预售结束后{full_payment_presale_delivery_time}天内发货，该字段仅对stock_type=1时有效。 |
# Res.item.product_info.cats_v2(Array) Object Payload
新类目树--类目信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| cat_id | string | 类目id |
| cat_name | string | 类目名称 |
# Res.item.commission_info Object Payload
跟佣信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | number | 商品带货状态 ，枚举值详情请参考下文 |
| service_ratio | number | 服务费率[0, 1000000] |
| ratio | number | 佣金费率[0, 1000000] |
| start_time | number | 时间戳，合作开始时间 |
| end_time | number | 时间戳，合作结束时间 |
| link | string | 带货链接，机构商品状态上架中返回 |
| audit_info | object | 待审核信息 |
| normal_commission_info | object | 该商品普通推广下的佣金信息，机构商品上架中且普通推广上架中有效 |
# Res.item.commission_info.audit_info Object Payload
待审核信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| ratio | number | 服务费率[0, 1000000] |
| service_ratio | number | 佣金费率[0, 1000000] |
| start_time | number | 时间戳，合作开始时间 |
| end_time | number | 合作结束时间 |
# Res.item.commission_info.normal_commission_info Object Payload
该商品普通推广下的佣金信息，机构商品上架中且普通推广上架中有效
| 参数名 | 类型 | 说明 |
|---|---|---|
| ratio | number | 佣金费率[0, 1000000] |
# 4. 注意事项
status商品带货状态
| 枚举值 | 描述 |
|---|---|
| 1 | 已上架推广 |
| 2 | 已下架推广 |
| 5 | 已清退 |
# 5. 代码示例
请求示例
{
"appid": "test",
"product_id": 12345
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"item": {
"appid": "test",
"product_id": 12345,
"product_info": {
"title": "test_title",
"sub_title": "",
"head_imgs": [
"https://test.com/0"
],
"desc_info": {
"imgs": [
"https://test.com/0"
],
"desc": ""
},
"cats": [
{
"cat_id": "1421"
},
{
"cat_id": "1443"
},
{
"cat_id": "1452"
}
],
"cats_v2": [
{
"cat_id": "1421"
},
{
"cat_id": "1443"
},
{
"cat_id": "1452"
},
{
"cat_id": "1476"
}
],
"express_info": {
"send_time": "",
"address_info": {
"postal_code": "",
"province_name": "",
"city_name": "",
"county_name": ""
},
"shipping_method": "NO_FREE"
},
"skus": [
{
"sku_id": "670813472",
"thumb_img": "",
"sale_price": 500,
"stock_num": 998,
"sku_attrs": [
{
"attr_key": "产地",
"attr_value": "四川成都"
},
{
"attr_key": "材质",
"attr_value": "玻璃"
},
{
"attr_key": "适用人群",
"attr_value": "青年;中年"
},
{
"attr_key": "数量",
"attr_value": "33"
},
{
"attr_key": "精度",
"attr_value": "3.001"
},
{
"attr_key": "重量",
"attr_value": "38 mg"
},
{
"attr_key": "毛重",
"attr_value": "380 kg"
}
]
}
]
}
}
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10024000 | 参数错误，请开发人员检查传递参数是否正确 | |
| 10024003 | 不合法的appid | |
| 10024004 | 不存在该商品 |
# 7. 适用范围
本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。