抖音开放平台Logo
控制台

分账明细查询

更新时间 2024-10-12 09:51:16
收藏
我的收藏
用于查询分账明细。​

使用限制

无​

接口说明

1、券码核销之后查询对应的分账单。​
2、券码核销 1h 后(未撤销)生成分账单,记录预计分账的金额,实际的分账动作、提现动作并未发生。​
3、没有操作权限的券码对应分账单为空、券码未核销时对应的分账单为空、券码已核销 1h 内对应分的账单为空。​

基本信息​

HTTP URL​
HTTP Method​
GET​
申请权限​
团购对账​
权限要求​
    需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案​
    需要商家授权,路径:抖音来客>店铺管理>服务应用授权​

请求头

参数
描述
必须
Content-Type​
application/json​
是​
access-token​
根据这个地址获取的token​
是​

请求参数

Query 请求

参数名称
参数类型
参数描述
必需
certificate_ids​
list​
券码的标识(验券时返回)列表,列表长度范围1~50,多个值使用,拼接​
是​

请求示例

js
复制
https://open.douyin.com/goodlife/v1/settle/ledger/query_record_by_cert/?certificate_ids=7091180835810052103,7091180835810052104

响应参数

参数名称
参数类型
参数描述
data​
struct​
.error_code​
int64​
错误码,0为成功​
.description​
string​
错误码描述​
.records​
list​
分账单列表​
..cursor​
string​
游标,无业务意义​
..ledger_id​
string​
分账记录id​
..verify_id​
string​
验券记录id​
..certificate_id​
string
券id​
..order_id​
string​
订单id​
..verify_time​
int64​
验券时间,单位秒,时间戳​
..status​
int32​
分账单状态(此字段已废弃)​
..code​
string​
券码​
..amount​
struct​
分账单金额​
...original​
int64​
券原始金额,单位分​
...pay​
int64​
用户实付金额,单位分​
...ledger_total​
int64​
应结算金额。等于用户实付金额+实际参与结算的平台优惠券金额,单位:分​
...merchant_ticket​
int64​
商家营销金额,单位分​
...actual_insured​
int64​
实付保险费用。由保司收取,单位分​
..fund_amount​
struct​
分账款项金额​
...goods​
int64​
商家货款金额,单位分 (商家实际收到金额,已经扣除支付手续费和佣金费用)​
...total_commission​
int64​
佣金汇总金额,单位分​
...pay_handling​
int64​
支付手续费,单位分 (平台收取的千分之六支付手续费)​
不给isv技术服务商展示
...talent_commission​
int64​
达人佣金,单位分 (团购上设置或者服务商引入的才会有佣金)​
不给isv技术服务商展示
...total_agent_merchant​
int64​
服务商分佣总金额,单位分​
不给isv技术服务商展示
...total_merchant_platform_service​
int64​
软件服务费。已包含支付手续费,单位:分​
不给isv技术服务商展示
..sku​
struct​
团购信息​
...sku_id​
string​
团购SKU ID​
...title​
string​
团购名称​
...market_price​
int64​
团购市场价​
...sold_start_time​
int64​
团购售卖开始时间, 单位秒,时间戳​
extra​
struct​
.error_code​
int64​
错误码,0为成功​
.description​
string​
错误码描述​
.sub_error_code​
int64​
(弃用)子错误码​
.sub_description​
string​
(弃用)子错误码描述​
.logid​
string​
请求id​
.now​
int64​
(弃用)接口响应时间,时间戳,单位秒​

响应示例

正常示例

json
复制
{
"data": {
"error_code": 0,
"description": "success",
"records": [
{
"cursor": "7064492324109305863",
"ledger_id": "7064492324109305863",
"verify_id": "7064491846000592903",
"certificate_id": "7064423012048865293",
"order_id": "7062268392329758757",
"verify_time": 1644830204,
"status": 2,
"code": "100566718260",
"amount": {
"original": 50,
"pay": 45,
"merchant_ticket": 0
},
"fund_amount": {
"goods": 50,
"pay_handling": 0,
"talent_commission": 0
},
"sku": {
"sku_id": "1721554180176909",
"title": "测试结算中台分店",
"market_price": 500,
"sold_start_time": 1641801900
}
}
]
},
"extra": {
"error_code": 0,
"description": "success",
"sub_error_code": 0,
"sub_description": "",
"logid": "xxx",
"now": 1651738946
}
}

异常示例

无​

错误码

HTTP 状态码
错误码
描述
排查建议
200
2190002
access_token无效
调用接口重新生成access_token
200
2190004
应用未获得该能力, 请去https://open.douyin.com/申请
应用申请接口权限
200
2190008
access_token过期,请刷新或重新授权
规范token刷新机制,检查是否有测试环境在同步刷新token
200
2119001
参数不合法
更换参数
200
2119002
系统繁忙,请稍候再试
重试
200
2119003
请求太过频繁,请稍后再试
重试
200
2119005
应用未获商家授权
联系合作商家在商家后台发起授权,并在服务商后台同意授权
200
3000001
根据实际业务错误返回
对照接口文档规范参数并重试
200
4000001
补充参数
200
4000002
对照接口文档规范参数并重试
200
5000001
联系抖音处理
200​
2100004​
open_merchant_thirdparty_app.CheckIPValid错误,联系上游解决​
重试​