# 获取佣金单详情
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名: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 调用
POST https://api.weixin.qq.com/channels/ec/league/headsupplier/order/get?access_token=ACCESS_TOKEN
# 云调用
调用方法:channels.ec.league.headsupplier.order.get
出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
order_id | number | 是 | 123 | 订单号,可从获取佣金单列表接口获得 |
sku_id | number | 是 | 12345 | 商品skuid,可从获取佣金单列表接口获得 |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 示例 | 说明 |
---|---|---|---|
errcode | number | 0 | 错误码 |
errmsg | string | ok | 错误信息 |
commssion_order | object | 佣金单结构 |
# Res.commssion_order Object Payload
佣金单结构
参数名 | 类型 | 说明 |
---|---|---|
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
订单详情
参数名 | 类型 | 说明 |
---|---|---|
shop_info | object | 小店商家信息 |
product_info | object | 佣金单商品信息 |
order_info | object | 订单信息 |
commission_info | object | 分佣信息 |
buyer_info | object | 买家信息 |
# Res.commssion_order.order_detail.shop_info Object Payload
小店商家信息
参数名 | 类型 | 说明 |
---|---|---|
appid | string | 所属小店appid |
shop_name | string | 小店名称 |
# Res.commssion_order.order_detail.product_info Object Payload
佣金单商品信息
参数名 | 类型 | 说明 |
---|---|---|
product_id | number | 商品id |
thumb_img | string | sku小图 |
title | string | 商品标题 |
actual_payment | number | 订单实付金额【单位:分】 |
# Res.commssion_order.order_detail.order_info Object Payload
订单信息
参数名 | 类型 | 说明 |
---|---|---|
status | number | 订单状态,枚举值详情请参考下文 |
create_time | number | 订单创建时间 |
pay_time | number | 订单支付时间 |
update_time | number | 订单更新时间 |
# Res.commssion_order.order_detail.commission_info Object Payload
分佣信息
参数名 | 类型 | 说明 |
---|---|---|
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 | 供货机构分佣 |
# Res.commssion_order.order_detail.commission_info.finder_info Object Payload
视频号达人信息
参数名 | 类型 | 说明 |
---|---|---|
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
推客分佣信息
参数名 | 类型 | 说明 |
---|---|---|
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
新带货达人信息
参数名 | 类型 | 说明 |
---|---|---|
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
作为推客的时候,推广的一些参数
参数名 | 类型 | 说明 |
---|---|---|
channel_type | number | 推客推广的类型 【0:无 3:私域商品推广 4:带货内容推广 6:自营内容推广】 |
finder_info | object | 推广渠道来自视频号时的视频号信息 |
mp_info | object | 推广渠道来自公众号的公众号信息 |
talent_info | object | 推广渠道来自带货内容推广时的带货助手信息 |
# Res.commssion_order.order_detail.commission_info.promotion_info.finder_info Object Payload
推广渠道来自视频号时的视频号信息
参数名 | 类型 | 说明 |
---|---|---|
finder_id | string | 视频号 id |
nickname | string | 昵称 |
openfinderid | string | 视频号的openfinderid |
# Res.commssion_order.order_detail.commission_info.promotion_info.mp_info Object Payload
推广渠道来自公众号的公众号信息
参数名 | 类型 | 说明 |
---|---|---|
appid | string | 公众号的 appid |
nickname | string | 昵称 |
# Res.commssion_order.order_detail.commission_info.promotion_info.talent_info Object Payload
推广渠道来自带货内容推广时的带货助手信息
参数名 | 类型 | 说明 |
---|---|---|
talent_appid | string | 带货助手的appid |
nickname | string | 达人昵称 |
opentalentid | string | 带货助手的opentalentid |
# Res.commssion_order.order_detail.commission_info.sub_agency_info Object Payload
帮卖机构分佣
参数名 | 类型 | 说明 |
---|---|---|
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
推客机构分佣
参数名 | 类型 | 说明 |
---|---|---|
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
供货机构分佣
参数名 | 类型 | 说明 |
---|---|---|
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
买家信息
参数名 | 类型 | 说明 |
---|---|---|
open_id | string | 购买者的openid |
union_id | string | 购买者的unionid |
# 4. 注意事项
status订单状态
枚举值 | 描述 |
---|---|
10 | 待付款 |
12 | 待收礼 |
17 | 待使用【本地生活券订单】 |
20 | 待发货 |
21 | 部分发货 |
30 | 待收货 |
100 | 完成 |
200 | 全部商品售后之后,订单取消 |
250 | 未付款用户主动取消或超时未付款订单自动取消 |
status佣金单状态
枚举值 | 描述 |
---|---|
20 | 未结算 |
100 | 已结算 |
200 | 取消结算 |
# 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. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。