# 获取佣金单详情
接口应在服务器端调用，不可在前端（小程序、网页、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_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（带货助手）、authorizer_access_token（服务商） |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| order_id | string | 是 | 订单号，可从获取佣金单列表接口获得 |
| sku_id | string | 是 | 商品skuid，可从获取佣金单列表接口获得 |
| special_id | string | 否 | 订单额外参数【在订单列表里面返回的参数回传】 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| base_info | object | 订单基础信息 |
| commission_info | object | 订单佣金信息 |
| channel_info | object | 下单通道信息 |
| promotion_head_supplier_info | object | 内容推广推客机构信息 |
| product_info | object | 商品信息 |
# Res.base_info Object Payload
订单基础信息
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| order_id | string | 订单id | - |
| spu_id | string | 商品spuid | - |
| sku_id | string | 商品skuid | - |
| special_id | string | 特殊id【针对本地生活】 | - |
| order_status | number | 订单状态 | 枚举值 |
| actual_payment | string | 实际支付金额【单位：分】 | - |
| order_create_time | number | 订单创建时间 | - |
| order_update_time | number | 订单更新时间 | - |
| buyer_info | object | 下单用户 | - |
# Res.commission_info Object Payload
订单佣金信息
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| state | number | 佣金单状态 | 枚举值 |
| ratio | string | 佣金比例 | - |
| expect_settle_time | number | 预期结算时间 | - |
| expect_settlement | string | 预期结算金额 | - |
| actual_settle_time | number | 实际结算时间 | - |
| actual_settlement | string | 实际结算金额 | - |
# Res.channel_info Object Payload
下单通道信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| channel_type | number | 渠道类型【1: 视频号。 2:公众号】 |
| channel_id | string | 渠道id |
| channel_name | string | 渠道名称 |
# Res.promotion_head_supplier_info Object Payload
内容推广推客机构信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 机构id |
| name | string | 机构名称 |
| ratio | string | 佣金单比例 |
| fee | string | 佣金 |
# Res.product_info Object Payload
商品信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| title | string | 商品的标题 |
| thumb_img | string | 商品的头图 |
# Res.base_info.buyer_info Object Payload
下单用户
| 参数名 | 类型 | 说明 |
|---|---|---|
| open_id | string | 下单用户的openid |
| union_id | string | 下单用户的unionid |
# 4. 枚举信息
# Res.base_info.order_status Enum
订单状态
| 枚举值 | 描述 |
|---|---|
| 1 | 待支付 |
| 2 | 待发货 |
| 3 | 已发货 |
| 4 | 已收货 |
| 5 | 售后中 |
| 6 | 已完成 |
| 7 | 已取消 |
| 8 | 已退款 |
| 9 | 部分退款 |
| 10 | 待使用 |
# Res.commission_info.state Enum
佣金单状态
| 枚举值 | 描述 |
|---|---|
| 1 | 待结算 |
| 2 | 已结算 |
| 3 | 取消结算 |
| 4 | 结算异常 |
# 5. 注意事项
本接口无特殊注意事项
# 6. 代码示例
请求示例
{
"order_id": 123"",
"sku_id": "12345"
}
返回示例
{
"errcode": "0",
"errmsg": "ok",
"base_info": {
"order_id": "202402260001",
"spu_id": "SPU123456",
"sku_id": "SKU987654",
"order_status": 2,
"actual_payment": "99.99",
"order_create_time": 1700000000,
"order_update_time": 1700003600,
"special_id": "SP12345",
"buyer_info": {
"open_id": "o1234567890abcdef",
"union_id": "u1234567890abcdef"
}
},
"commission_info": {
"state": 1,
"ratio": "0",
"expect_settle_time": 1701000000,
"expect_settlement": "9.99",
"actual_settle_time": 1702000000,
"actual_settlement": "9.99"
},
"channel_info": {
"channel_type": 2,
"channel_id": "channel_12345",
"channel_name": "某视频号"
},
"product_info": {
"title": "标题",
"thumb_img": "头像"
}
}
# 7. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10024000 | 参数错误，请开发人员检查传递参数是否正确 | |
| 10024006 | 不存在该佣金单 |
# 8. 适用范围
本接口支持「带货助手（需申请）」账号类型调用。其他账号类型如无特殊说明，均不可调用。