# 推客机构获取内容推广的自营商品订单详情
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:getclue
直播间等内容分销场景会有挂自营品的情况,这种情况不会给带货机构分佣,平台给到销售订单线索,达人和机构自行协商。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/clue/get?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
order_id | string | 是 | 123 | 订单号,可从[推客机构获取内容推广的自营商品订单列表](https://developers.weixin.qq.com/doc/store/leagueheadsupplier/API/promotion/content/clue/getcluelist.html)获得 |
sku_id | string | 是 | 12345 | 商品skuid,可从[推客机构获取内容推广的自营商品订单列表](https://developers.weixin.qq.com/doc/store/leagueheadsupplier/API/promotion/content/clue/getcluelist.html)获得 |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 示例 | 说明 |
---|---|---|---|
errcode | number | 0 | 错误码 |
errmsg | string | ok | 错误信息 |
commssion_clue | object | 线索订单结构 |
# Res.commssion_clue Object Payload
线索订单结构
参数名 | 类型 | 说明 |
---|---|---|
order_id | string | 订单号 |
sku_id | number | 商品skuid |
create_time | number | 秒级时间戳 |
update_time | number | 秒级时间戳 |
clue_detail | object | 线索订单详情 |
# Res.commssion_clue.clue_detail Object Payload
线索订单详情
参数名 | 类型 | 说明 |
---|---|---|
shop_info | object | 小店商家信息 |
product_info | object | 佣金单商品信息 |
order_info | object | 订单信息 |
sharer_info | object | 推客信息 |
buyer_info | object | 买家信息 |
# Res.commssion_clue.clue_detail.shop_info Object Payload
小店商家信息
参数名 | 类型 | 说明 |
---|---|---|
appid | string | 所属小店appid |
# Res.commssion_clue.clue_detail.product_info Object Payload
佣金单商品信息
参数名 | 类型 | 说明 |
---|---|---|
product_id | string | 商品id |
thumb_img | string | sku小图 |
title | string | 商品标题 |
actual_payment | number | 可分佣金额 |
# Res.commssion_clue.clue_detail.order_info Object Payload
订单信息
参数名 | 类型 | 说明 |
---|---|---|
order_status | number | 订单状态,枚举值详情请参考下文 |
# Res.commssion_clue.clue_detail.sharer_info Object Payload
推客信息
参数名 | 类型 | 说明 |
---|---|---|
sharer_appid | string | 推客appid |
nickname | string | 推客昵称 |
opensharerid | string | 分享者和机构的关系信息 |
# Res.commssion_clue.clue_detail.buyer_info Object Payload
买家信息
参数名 | 类型 | 说明 |
---|---|---|
open_id | string | 购买者的openid |
union_id | string | 购买者的unionid |
# 4. 注意事项
status订单状态
枚举值 | 描述 |
---|---|
10 | 待付款 |
20 | 待发货 |
21 | 部分发货 |
30 | 待收货 |
100 | 完成 |
200 | 全部商品售后之后,订单取消 |
250 | 未付款用户主动取消或超时未付款订单自动取消 |
# 5. 代码示例
请求示例
{
"order_id": "123",
"sku_id": "12345"
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"commssion_clue": {
"order_id": "123",
"sku_id": "12345",
"create_time": 1675855175,
"update_time": 1675855217,
"status": 20,
"clue_detail": {
"shop_info": {
"appid": "wxxxx"
},
"product_info": {
"product_id": "12345",
"thumb_img": "https://test.com/0",
"title": "test_123",
"actual_payment": 100
},
"order_info": {
"order_status": 20
},
"sharer_info": {
"sharer_appid": "",
"nickname": "",
"opensharerid": ""
},
"buyer": {
"open_id": "",
"union_id": ""
}
}
}
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
10024000 | 参数错误,请开发人员检查传递参数是否正确 | |
10024006 | 不存在该线索订单 |
# 7. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。