# 推客机构获取内容推广的自营商品订单详情

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

参数名类型必填示例说明
order_idstring123订单号,可从[推客机构获取内容推广的自营商品订单列表](https://developers.weixin.qq.com/doc/store/leagueheadsupplier/API/promotion/content/clue/getcluelist.html)获得
sku_idstring12345商品skuid,可从[推客机构获取内容推广的自营商品订单列表](https://developers.weixin.qq.com/doc/store/leagueheadsupplier/API/promotion/content/clue/getcluelist.html)获得

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
commssion_clueobject线索订单结构

# Res.commssion_clue Object Payload

线索订单结构

参数名类型说明
order_idstring订单号
sku_idnumber商品skuid
create_timenumber秒级时间戳
update_timenumber秒级时间戳
clue_detailobject线索订单详情

# Res.commssion_clue.clue_detail Object Payload

线索订单详情

参数名类型说明
shop_infoobject小店商家信息
product_infoobject佣金单商品信息
order_infoobject订单信息
sharer_infoobject推客信息
buyer_infoobject买家信息

# Res.commssion_clue.clue_detail.shop_info Object Payload

小店商家信息

参数名类型说明
appidstring所属小店appid

# Res.commssion_clue.clue_detail.product_info Object Payload

佣金单商品信息

参数名类型说明
product_idstring商品id
thumb_imgstringsku小图
titlestring商品标题
actual_paymentnumber可分佣金额

# Res.commssion_clue.clue_detail.order_info Object Payload

订单信息

参数名类型说明
order_statusnumber订单状态,枚举值详情请参考下文

# Res.commssion_clue.clue_detail.sharer_info Object Payload

推客信息

参数名类型说明
sharer_appidstring推客appid
nicknamestring推客昵称
openshareridstring分享者和机构的关系信息

# Res.commssion_clue.clue_detail.buyer_info Object Payload

买家信息

参数名类型说明
open_idstring购买者的openid
union_idstring购买者的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. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。