# 获取佣金单详情

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

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

# 3. 返回参数

# 返回体 Response Payload

参数名类型示例说明
errcodenumber0错误码
errmsgstringok错误信息
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分佣信息
buyer_infoobject买家信息

# Res.commssion_order.order_detail.shop_info Object Payload

小店商家信息

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

# Res.commssion_order.order_detail.product_info Object Payload

佣金单商品信息

参数名类型说明
product_idnumber商品id
thumb_imgstringsku小图
titlestring商品标题
actual_paymentnumber订单实付金额【单位:分】

# Res.commssion_order.order_detail.order_info Object Payload

订单信息

参数名类型说明
statusnumber订单状态,枚举值详情请参考下文
create_timenumber订单创建时间
pay_timenumber订单支付时间
update_timenumber订单更新时间

# Res.commssion_order.order_detail.commission_info Object Payload

分佣信息

参数名类型说明
finder_infoobject视频号达人信息
service_rationumber服务费率[0, 1000000]
service_amountnumber服务费金额
profit_sharding_suc_timenumber服务费结算时间
promotion_channelnumber0-橱窗带货,1-推客带货
sharer_infoobject推客分佣信息
talent_infoobject新带货达人信息
promotion_infoobject作为推客的时候,推广的一些参数
sub_agency_infoobject帮卖机构分佣
promoter_agency_infoobject推客机构分佣
head_agency_infoobject供货机构分佣

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

视频号达人信息

参数名类型说明
nicknamestring视频号昵称
rationumber佣金率[0, 1000000]
amountnumber佣金
openfinderidstring视频号openfinderid
head_img_urlstring头像

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

推客分佣信息

参数名类型说明
sharer_appidstring推客appid
nicknamestring推客昵称
rationumber佣金率[0, 1000000]
amountnumber佣金
openshareridstring推客的opensharerid
head_img_urlstring头像

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

新带货达人信息

参数名类型说明
talent_appidstring新带货达人appid
nicknamestring达人昵称
rationumber佣金率[0, 1000000]
amountnumber佣金
opentalentidstring带货助手的opentalentid
head_img_urlstring头像

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

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

参数名类型说明
channel_typenumber推客推广的类型 【0:无 3:私域商品推广 4:带货内容推广 6:自营内容推广】
finder_infoobject推广渠道来自视频号时的视频号信息
mp_infoobject推广渠道来自公众号的公众号信息
talent_infoobject推广渠道来自带货内容推广时的带货助手信息

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

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

参数名类型说明
finder_idstring视频号 id
nicknamestring昵称
openfinderidstring视频号的openfinderid

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

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

参数名类型说明
appidstring公众号的 appid
nicknamestring昵称

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

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

参数名类型说明
talent_appidstring带货助手的appid
nicknamestring达人昵称
opentalentidstring带货助手的opentalentid

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

帮卖机构分佣

参数名类型说明
appidstring机构appid
nicknamestring帮卖机构昵称
rationumber服务费率[0, 1000000]
amountnumber服务费
profit_sharding_suc_timenumber服务费结算时间
head_img_urlstring头像

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

推客机构分佣

参数名类型说明
appidstring机构appid
nicknamestring帮卖机构昵称
rationumber服务费率[0, 1000000]
amountnumber服务费
profit_sharding_suc_timenumber服务费结算时间
head_img_urlstring头像

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

供货机构分佣

参数名类型说明
appidstring机构appid
nicknamestring帮卖机构昵称
rationumber服务费率[0, 1000000]
amountnumber服务费
profit_sharding_suc_timenumber服务费结算时间
head_img_urlstring头像

# Res.commssion_order.order_detail.buyer_info Object Payload

买家信息

参数名类型说明
open_idstring购买者的openid
union_idstring购买者的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. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。