# 获取商品推广参数详情

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：getitempromotiondetail

可通过该接口，获取合作商品的推广参数（如佣金率、推广链接等）；商品的基础信息（如商品图，类目等信息）请通过获取商品基础详情接口获取

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/league/headsupplier/item/promotiondetail/get?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token

# 请求体 `Request Payload`

参数名	类型	必填	示例	说明
head_supplier_item_link	string	是	weixinstorehs/123456	机构推广商品链接

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	示例	说明
errcode	number	0	-
errmsg	string	ok	-
item	object		商品推广详情

# Res.item `Object Payload`

商品推广详情

参数名	类型	说明
product_id	number	商品id
shop_appid	string	商品所属店铺 appid
spu_source	number	1-商家供货；2-机构供货
commission_info	object	商品佣金信息
head_supplier_info	object	供货机构信息
cooperative_info	object	商品合作信息

# Res.item.commission_info `Object Payload`

商品佣金信息

参数名	类型	说明
plan_type	number	商品的计划类型 1：定向计划 2：公开计划
commission_type	number	佣金分配类型 0：商家指定达人佣金 1：机构指定达人佣金【如果为1，那么一定需要创建子计划才能添加到达人橱窗，因为这种计划是没有达人佣金率的，需要创建子计划来指定达人佣金率】
ratio	number	佣金费率[0, 1000000]
service_ratio	number	服务费率[0, 1000000]
start_time	number	计划开始时间
end_time	number	计划结束时间
normal_commission_info	object	该商品普通推广下的佣金信息，机构商品上架中且普通推广上架中有效

# Res.item.commission_info.normal_commission_info `Object Payload`

该商品普通推广下的佣金信息，机构商品上架中且普通推广上架中有效

参数名	类型	说明
ratio	number	佣金费率[0, 1000000]

# Res.item.head_supplier_info `Object Payload`

供货机构信息

参数名	类型	说明
name	string	供货机构昵称
head_img	string	机构头像
appid	string	机构appid

# Res.item.cooperative_info `Object Payload`

商品合作信息

参数名	类型	说明
cooperative_status	number	商品合作状态 1：合作中
is_hidden	boolean	商品是否在商品列表页对外隐藏
link	string	带货链接，机构商品状态上架中返回

# 4. 注意事项

本接口已升级迭代，请开发者尽快适配。旧接口当前仍可调用，旧接口地址获取合作商品详情

# 5. 代码示例

请求示例

{
    "head_supplier_item_link": "weixinstorehs/123456"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "item": {
        "product_id": 0,
        "shop_appid": "",
        "spu_source": 0,
        "commission_info": {
            "plan_type": 0,
            "commission_type": 0,
            "ratio": 0,
            "service_ratio": 0,
            "start_time": 0,
            "end_time": 0,
            "normal_commission_info": {
                "ratio": 0
            }
        },
        "head_supplier_info": {
            "name": "",
            "appid": ""
        },
        "cooperative_info": {
            "cooperative_status": 0,
            "is_hidden": false,
            "link": ""
        }
    }
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
10024000	参数错误

# 7. 适用范围

本接口支持「联盟带货机构」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（1条）

2025 年 11 月 03 日

调整 head_supplier_info 回参，新增 head_img 「机构头像」字段