微信小店
取消
中文
中文
EN
取消
  • 联盟带货机构

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

    接口应在服务器端调用，不可在前端（小程序、网页、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_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token

    # 请求体 Request Payload

    参数名类型必填示例说明
    order_idstring是123订单号，可从推客机构获取内容推广的自营商品订单列表获得
    sku_idstring是12345商品skuid，可从推客机构获取内容推广的自营商品订单列表获得

    # 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. 错误码

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

    错误码错误描述解决方案
    10024000参数错误，请开发人员检查传递参数是否正确
    10024006不存在该线索订单

    # 7. 适用范围

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