# 获取佣金单详情

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

接口英文名:get_order_detail

可通过该接口获取佣金单详情

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/talent/get_order_detail?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:190

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token

# 请求体 Request Payload

参数名类型必填说明
order_idstring订单号,可从获取佣金单列表接口获得
sku_idstring商品skuid,可从获取佣金单列表接口获得

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
commssion_orderobject佣金单结构

# Res.commssion_order Object Payload

佣金单结构

参数名类型说明
order_idstring订单号
sku_idnumber商品skuid
create_timenumber秒级时间戳
update_timenumber秒级时间戳
statusnumber佣金单状态,枚举值详情请参考下文
order_detailobject订单详情

# Res.commssion_order.order_detail Object Payload

订单详情

参数名类型说明
shop_infoobject小店商家信息
product_infoobject佣金单商品信息
order_infoobject订单信息
commission_infoobject分佣信息

# Res.commssion_order.order_detail.shop_info Object Payload

小店商家信息

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

# Res.commssion_order.order_detail.product_info Object Payload

佣金单商品信息

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

# Res.commssion_order.order_detail.order_info Object Payload

订单信息

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

# Res.commssion_order.order_detail.commission_info Object Payload

分佣信息

参数名类型说明
finder_infoobject带货达人信息
service_rationumber服务费率[0, 1000000]
service_amountnumber服务费金额
profit_sharding_suc_timenumber服务费结算时间

# Res.commssion_order.order_detail.commission_info.finder_info Object Payload

带货达人信息

参数名类型说明
nicknamestring达人昵称
ratio number佣金率[0, 1000000]
amountnumber佣金
openfinderidstring视频号openfinderid

# 4. 注意事项

status佣金单状态

枚举值 描述
20 未结算
100 已结算
200 取消结算

status订单状态

枚举值 描述
10 待付款
20 待发货
21 部分发货
30 待收货
100 完成
200 全部商品售后之后,订单取消
250 未付款用户主动取消或超时未付款订单自动取消

# 5. 代码示例

请求示例

{
    "order_id": 123"",
    "sku_id": "12345"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "commssion_order": {
        "order_id": "123",
        "sku_id": "12345",
        "create_time": 1675855175,
        "update_time": 1675855217,
        "status": 20,
        "order_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
            },
            "commission_info": {
                "finder_info": {
                    "nickname": "finder",
                    "ratio": 100000,
                    "amount": 10
                },
                "service_ratio": 300000,
                "service_amount": 30
            }
        }
    }
}

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

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

# 7. 适用范围

本接口支持「带货助手(需申请)」账号类型调用。其他账号类型如无特殊说明,均不可调用。