# 获取佣金单详情

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：getorder

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

你可以看到你自己实收服务费和分给下一个角色的总服务费，举例：

> 最复杂的情况下，一个分佣单有5个分账方：
>
> 商家（支出服务费¥10） ->带货机构（服务费¥10，支出费用¥6，实收¥4） ->帮卖带货机构（服务费¥6，支出费用¥ 4，实收¥2）->达人（佣金¥4，支出费用¥2，实收¥2） ->推客机构（服务费¥2，支出费用 ¥1，实收¥1）->推客（服务费¥1）
>
> 带货机构的视角查看佣金单：可以看到实收服务费是¥4（service_amount），帮卖带货机构服务费¥6（sub_agency_info）. 推客机构视角查看佣金单：可以看到实收服务费是¥1，推客服务费¥1（SharerInfo ） 带货机构和推客机构是同一个人的情况：可以看到实收服务费是¥5，帮卖带货机构服务费¥6，推客服务费¥1
>
> 推客机构的分佣见promoter_agency_info

如果带货达人已经升级成新的带货者身份，可以通过Talentinfo获取达人佣金。

如果仍是视频号身份，可以通过Finderinfo获取达人佣金信息。

## 1. 调用方式

### HTTPS 调用

```bash
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/order/get?access_token=ACCESS_TOKEN
```

### 云调用

- 调用方法：channels.ec.league.headsupplier.order.get

- 出入参和 HTTPS 调用相同，调用方式可查看 [云调用](/doc/oplatform/developers/dev/cloudCall.md) 说明文档。

### 第三方调用

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

## 2. 请求参数

### 查询参数 `Query String Parameters`

```json
[
  {
    "参数名": "access_token",
    "类型": "string",
    "必填": "是",
    "示例": "ACCESS_TOKEN",
    "说明": "接口调用凭证，可使用 [access_token](/doc/store/leagueheadsupplier/api/basic/api_getaccesstoken)"
  }
]
```

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "order_id",
    "类型": "number",
    "必填": "是",
    "示例": "123",
    "说明": "订单号，可从[获取佣金单列表接口](api_getorderlist)获得"
  },
  {
    "参数名": "sku_id",
    "类型": "number",
    "必填": "是",
    "示例": "12345",
    "说明": "商品skuid，可从[获取佣金单列表接口](api_getorderlist)获得"
  }
]
```

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "errcode",
    "类型": "number",
    "示例": "0",
    "说明": "错误码"
  },
  {
    "参数名": "errmsg",
    "类型": "string",
    "示例": "ok",
    "说明": "错误信息"
  },
  {
    "参数名": "commssion_order",
    "类型": "object",
    "示例": "",
    "说明": "佣金单结构"
  }
]
```

### Res.commssion_order `Object Payload`

佣金单结构

```json
[
  {
    "参数名": "order_id",
    "类型": "string",
    "说明": "订单号"
  },
  {
    "参数名": "sku_id",
    "类型": "number",
    "说明": "商品skuid"
  },
  {
    "参数名": "create_time",
    "类型": "number",
    "说明": "秒级时间戳"
  },
  {
    "参数名": "update_time",
    "类型": "number",
    "说明": "秒级时间戳"
  },
  {
    "参数名": "status",
    "类型": "number",
    "说明": "佣金单状态，枚举值详情请参考下文"
  },
  {
    "参数名": "order_detail",
    "类型": "object",
    "说明": "订单详情"
  }
]
```

### Res.commssion_order.order_detail `Object Payload`

订单详情

```json
[
  {
    "参数名": "shop_info",
    "类型": "object",
    "说明": "小店商家信息"
  },
  {
    "参数名": "product_info",
    "类型": "object",
    "说明": "佣金单商品信息"
  },
  {
    "参数名": "order_info",
    "类型": "object",
    "说明": "订单信息"
  },
  {
    "参数名": "commission_info",
    "类型": "object",
    "说明": "分佣信息"
  },
  {
    "参数名": "buyer_info",
    "类型": "object",
    "说明": "买家信息"
  }
]
```

### Res.commssion_order.order_detail.shop_info `Object Payload`

小店商家信息

```json
[
  {
    "参数名": "appid",
    "类型": "string",
    "说明": "所属小店appid"
  },
  {
    "参数名": "shop_name",
    "类型": "string",
    "说明": "小店名称"
  }
]
```

### Res.commssion_order.order_detail.product_info `Object Payload`

佣金单商品信息

```json
[
  {
    "参数名": "product_id",
    "类型": "number",
    "说明": "商品id"
  },
  {
    "参数名": "thumb_img",
    "类型": "string",
    "说明": "sku小图"
  },
  {
    "参数名": "title",
    "类型": "string",
    "说明": "商品标题"
  },
  {
    "参数名": "actual_payment",
    "类型": "number",
    "说明": "订单实付金额【单位：分】"
  },
  {
    "参数名": "product_cnt",
    "类型": "number",
    "说明": "商品数量"
  }
]
```

### Res.commssion_order.order_detail.order_info `Object Payload`

订单信息

```json
[
  {
    "参数名": "status",
    "类型": "number",
    "说明": "订单状态，枚举值详情请参考下文"
  },
  {
    "参数名": "create_time",
    "类型": "number",
    "说明": "订单创建时间"
  },
  {
    "参数名": "pay_time",
    "类型": "number",
    "说明": "订单支付时间"
  },
  {
    "参数名": "update_time",
    "类型": "number",
    "说明": "订单更新时间"
  }
]
```

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

分佣信息

```json
[
  {
    "参数名": "finder_info",
    "类型": "object",
    "说明": "视频号达人信息"
  },
  {
    "参数名": "service_ratio",
    "类型": "number",
    "说明": "服务费率[0, 1000000]"
  },
  {
    "参数名": "service_amount",
    "类型": "number",
    "说明": "实际结算服务费"
  },
  {
    "参数名": "profit_sharding_suc_time",
    "类型": "number",
    "说明": "服务费结算时间"
  },
  {
    "参数名": "promotion_channel",
    "类型": "number",
    "说明": "0-橱窗带货，1-推客带货"
  },
  {
    "参数名": "sharer_info",
    "类型": "object",
    "说明": "推客分佣信息"
  },
  {
    "参数名": "talent_info",
    "类型": "object",
    "说明": "新带货达人信息"
  },
  {
    "参数名": "promotion_info",
    "类型": "object",
    "说明": "作为推客的时候，推广的一些参数"
  },
  {
    "参数名": "sub_agency_info",
    "类型": "object",
    "说明": "帮卖机构分佣"
  },
  {
    "参数名": "promoter_agency_info",
    "类型": "object",
    "说明": "推客机构分佣"
  },
  {
    "参数名": "head_agency_info",
    "类型": "object",
    "说明": "供货机构分佣"
  },
  {
    "参数名": "platform_amount",
    "类型": "number",
    "说明": "联盟技术服务费金额"
  },
  {
    "参数名": "platform_commission_status",
    "类型": "number",
    "说明": "联盟技术服务费计算状态，枚举值请参考下文"
  },
  {
    "参数名": "service_total_amount",
    "类型": "number",
    "说明": "服务费总额，包含技术服务费"
  }
]
```

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

视频号达人信息

```json
[
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "视频号昵称"
  },
  {
    "参数名": "ratio",
    "类型": "number",
    "说明": "佣金率[0, 1000000]"
  },
  {
    "参数名": "amount",
    "类型": "number",
    "说明": "佣金"
  },
  {
    "参数名": "openfinderid",
    "类型": "string",
    "说明": "视频号openfinderid"
  },
  {
    "参数名": "head_img_url",
    "类型": "string",
    "说明": "头像"
  }
]
```

### Res.commssion_order.order_detail.commission_info.sharer_info `Object Payload`

推客分佣信息

```json
[
  {
    "参数名": "sharer_appid",
    "类型": "string",
    "说明": "推客appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "推客昵称"
  },
  {
    "参数名": "ratio",
    "类型": "number",
    "说明": "佣金率[0, 1000000]"
  },
  {
    "参数名": "amount",
    "类型": "number",
    "说明": "佣金"
  },
  {
    "参数名": "opensharerid",
    "类型": "string",
    "说明": "推客的opensharerid"
  },
  {
    "参数名": "head_img_url",
    "类型": "string",
    "说明": "头像"
  }
]
```

### Res.commssion_order.order_detail.commission_info.talent_info `Object Payload`

新带货达人信息

```json
[
  {
    "参数名": "talent_appid",
    "类型": "string",
    "说明": "新带货达人appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "达人昵称"
  },
  {
    "参数名": "ratio",
    "类型": "number",
    "说明": "佣金率[0, 1000000]"
  },
  {
    "参数名": "amount",
    "类型": "number",
    "说明": "佣金"
  },
  {
    "参数名": "opentalentid",
    "类型": "string",
    "说明": "带货助手的opentalentid"
  },
  {
    "参数名": "head_img_url",
    "类型": "string",
    "说明": "头像"
  }
]
```

### Res.commssion_order.order_detail.commission_info.promotion_info `Object Payload`

作为推客的时候，推广的一些参数

```json
[
  {
    "参数名": "channel_type",
    "类型": "number",
    "说明": "推客推广的类型 【0：无 3:私域商品推广 4:带货内容推广 6:自营内容推广】"
  },
  {
    "参数名": "finder_info",
    "类型": "object",
    "说明": "推广渠道来自视频号时的视频号信息"
  },
  {
    "参数名": "mp_info",
    "类型": "object",
    "说明": "推广渠道来自公众号的公众号信息"
  },
  {
    "参数名": "talent_info",
    "类型": "object",
    "说明": "推广渠道来自带货内容推广时的带货助手信息"
  },
  {
    "参数名": "custom_token",
    "类型": "string",
    "说明": "机构自定义关联参数【针对推客带货的商品卡分享直接成交场景】"
  }
]
```

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

推广渠道来自视频号时的视频号信息

```json
[
  {
    "参数名": "finder_id",
    "类型": "string",
    "说明": "视频号 id"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "昵称"
  },
  {
    "参数名": "openfinderid",
    "类型": "string",
    "说明": "视频号的openfinderid"
  }
]
```

### Res.commssion_order.order_detail.commission_info.promotion_info.mp_info `Object Payload`

推广渠道来自公众号的公众号信息

```json
[
  {
    "参数名": "appid",
    "类型": "string",
    "说明": "公众号的 appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "昵称"
  }
]
```

### Res.commssion_order.order_detail.commission_info.promotion_info.talent_info `Object Payload`

推广渠道来自带货内容推广时的带货助手信息

```json
[
  {
    "参数名": "talent_appid",
    "类型": "string",
    "说明": "带货助手的appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "达人昵称"
  },
  {
    "参数名": "opentalentid",
    "类型": "string",
    "说明": "带货助手的opentalentid"
  }
]
```

### Res.commssion_order.order_detail.commission_info.sub_agency_info `Object Payload`

帮卖机构分佣

```json
[
  {
    "参数名": "appid",
    "类型": "string",
    "说明": "机构appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "帮卖机构昵称"
  },
  {
    "参数名": "ratio",
    "类型": "number",
    "说明": "服务费率[0, 1000000]"
  },
  {
    "参数名": "amount",
    "类型": "number",
    "说明": "服务费"
  },
  {
    "参数名": "profit_sharding_suc_time",
    "类型": "number",
    "说明": "服务费结算时间"
  },
  {
    "参数名": "head_img_url",
    "类型": "string",
    "说明": "头像"
  }
]
```

### Res.commssion_order.order_detail.commission_info.promoter_agency_info `Object Payload`

推客机构分佣

```json
[
  {
    "参数名": "appid",
    "类型": "string",
    "说明": "机构appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "帮卖机构昵称"
  },
  {
    "参数名": "ratio",
    "类型": "number",
    "说明": "服务费率[0, 1000000]"
  },
  {
    "参数名": "amount",
    "类型": "number",
    "说明": "服务费"
  },
  {
    "参数名": "profit_sharding_suc_time",
    "类型": "number",
    "说明": "服务费结算时间"
  },
  {
    "参数名": "head_img_url",
    "类型": "string",
    "说明": "头像"
  }
]
```

### Res.commssion_order.order_detail.commission_info.head_agency_info `Object Payload`

供货机构分佣

```json
[
  {
    "参数名": "appid",
    "类型": "string",
    "说明": "机构appid"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "帮卖机构昵称"
  },
  {
    "参数名": "ratio",
    "类型": "number",
    "说明": "服务费率[0, 1000000]"
  },
  {
    "参数名": "amount",
    "类型": "number",
    "说明": "服务费"
  },
  {
    "参数名": "profit_sharding_suc_time",
    "类型": "number",
    "说明": "服务费结算时间"
  },
  {
    "参数名": "head_img_url",
    "类型": "string",
    "说明": "头像"
  }
]
```

### Res.commssion_order.order_detail.buyer_info `Object Payload`

买家信息

```json
[
  {
    "参数名": "open_id",
    "类型": "string",
    "说明": "购买者的openid"
  },
  {
    "参数名": "union_id",
    "类型": "string",
    "说明": "购买者的unionid"
  }
]
```

## 4. 注意事项

**status订单状态**

| 枚举值 | 描述 |
| - | - |
| 10 | 待付款 |
| 12 | 待收礼 |
| 17     | 待使用【本地生活券订单】                                     |
| 20 | 待发货 |
| 21 | 部分发货 |
| 30 | 待收货 |
| 100 | 完成 |
| 200 | 全部商品售后之后，订单取消 |
| 250 | 未付款用户主动取消或超时未付款订单自动取消 |

**status佣金单状态**

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

**status联盟技术服务费计算状态**

| 枚举值 | 描述 |
| - | - |
| 0 | 已计算 |
| 1 | 计算中 |

## 5. 代码示例

请求示例

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

返回示例

```json
{
    "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. 错误码

以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。

```json
[
  {
    "错误码": "10024000",
    "错误描述": "参数错误，请开发人员检查传递参数是否正确"
  },
  {
    "错误码": "10024006",
    "错误描述": "不存在该佣金单"
  },
  {
    "错误码": "10024034",
    "错误描述": "订单已换sku，当前sku不存在分佣单"
  }
]
```

## 7. 适用范围

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

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（5条）
2026 年 04 月 23 日更新  `service_amount`  字段描述，新增  `platform_commission_status` 、 `service_total_amount`  字段，更新  `status`  枚举值
2026 年 03 月 31 日新增  `product_cnt`  字段
2026 年 03 月 12 日新增 custom_token 字段，用户自定义关联参数
2026 年 03 月 06 日新增  `platform_amount`  字段
2026 年 02 月 26 日新增错误码和错误信息