- 生活服务商家应用 OpenAPI SDK 总览
- OpenAPI
- 门店管理
- 团购核销
- 团购对账
- 会员接入
- 订单查询
- 三方码
- 商品发布及查询
- 酒旅
- 预置码
- 代运营
- 接入前准备
- 餐饮团购
- 线索经营
- 团购退款
餐饮账单详情查询
更新时间 2024-08-29 13:19:43
收藏用于生活服务餐饮行业商家查询账单明细。不同行业返回参数不同，其他行业商家请勿查询此接口。
使用限制
无。
接口说明
1、账单金额均为绝对值，不显示正负，调用时请注意账单的结算类型。
2、核销后 1 小时内撤销或退款的订单，不会生成账单，无法通过本接口查询。
基本信息
HTTP URL | ||||
HTTP Method | GET | |||
申请权限 | 商家账单明细 | |||
权限要求 |
| |||
请求头
参数 | 描述 | 必须 |
Content-Type | application/json | 是 |
access-token | 是 |
请求参数
参数名称 | 参数类型 | 参数描述 | 必需 |
root_account_id | string | 品牌商户 ID，响应参数返回该品牌下所有门店的账单信息 | 当没有 account_id 时，该值必传 |
account_id | string | 商户 ID，响应参数仅返回该商户 ID 的账单信息，不支持树级结构查询（入参总店账户 ID，不会返回分店收款的账户数据） | 当没有 root_account_id 时，该值必传 |
cursor | string | 查询游标，第一页查询传 0，翻页查使用上一次查询返回 cursor | 是 |
size | int32 | 页大小，取值范围 1～50 | 是 |
bill_date | string | 结算日期，格式为"2022-12-25" | 是 |
withdraw_id | string | 提现单号，可以根据该单号找到对应的分账明细 | 如果需要通过提现单号来查询账单，结算日期字段也要传，优先取withdraw_id字段生效 |
请求示例
Bash
复制https://open.douyin.com/goodlife/v1/settle/bill/catering_query/?account_id=7113893944009705516&cursor=0&size=50&bill_date=2022-08-21
响应参数
参数名称 | 参数类型 | 参数描述 | ||
cursor | string | 若有下页，通过此 cursor 查询下一页 | ||
has_more | bool | 是否有下一页 | ||
biz_type | int | 业务类型。1:团购 3:买单 5:点单 | ||
ledger_records | ledger_id | string | 账单 ID | |
account_id | string | 商家账户 ID。请注意辨别总店/分店收款，如该订单收款方式＝总店收款，则此处展示总店账户 ID，不展示分店账户 ID | ||
shop_order_id | string | shop 维度订单 ID | ||
item_order_id | string | item 维度订单 ID | ||
settle_type | int | 结算类型。枚举值包括：1-正向账单，2-退款单，3-退款手续费 | ||
settle_type_desc | string | 结算类型描述。根据结算类型，返回枚举值的中文含义，例如：退款单 | ||
settle_time | int64 | 结算时间。正向账单返回核销完成时间；退款单，退款手续费返回账单创建时间。精确到秒 | ||
amount | pay | int64 | 用户实付金额。包含支付渠道优惠的金额。单位：分。示例：用户使用抖音支付，银行卡扣款 99.4 元，抖音支付优惠 0.6 元，此处返回用户实付金额=100 元 | |
deduction_discount | int64 | 团购券抵扣金额 ，该部分金额无需参与结算。代金券团购券单独结算。单位“分” | ||
merchant_ticket | int64 | 商家优惠补贴（该部分金额无需参与与结算）。单位：分 | ||
platform_ticket | int64 | 抖音平台补贴。单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
ledger_platform_ticket | int64 | 实际参与结算的平台优惠券金额。单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
original | int64 | 交易金额、订单实收。等于抖音平台补贴＋用户实付金额＋商家优惠金额，单位：分 | ||
ledger_total | int64 | 应结算金额。等于用户实付金额＋实际参与结算的平台优惠券金额，单位：分 | ||
total_commission | int64 | 佣金汇总金额，包含平台佣金和所有达人服务费佣金金额。单位：分 24.2.29 新上线 | ||
actual_insured | int64 | 实付保险费用。由保司收取，单位：分 | ||
total_agent_merchant | int64 | 服务商分佣总金额。单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
total_merchant_platform_service | int64 | 软件服务费。已包含支付手续费，单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
total_operation_agent | int64 | 代运营服务商总佣金。非合并计算时等于服务商佣金；需要合并计算时等于服务商佣金＋达人佣金。单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
talent_commission | int64 | 达人佣金。包含星图达人、税筹达人、机构达人和非机构达人，单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
broker_commission | int64 | 撮合经纪服务费。单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
clerk_commission | int64 | 店员佣金。单位：分 24.3.31 后不给 isv 技术服务商展示 | ||
mall_store_goods | int64 | 店员佣金。单位：分 商场店铺分佣 | ||
goods | int64 | 商家实际结算金额（原名“商家货款”，来客导出数据中名称＝提现金额）。单位：分 | ||
certificate_id | string | 券 ID。券的唯一标识 | ||
verify_id | string | 核销 ID | ||
poi_id | string | 核销门店 poi ID。不等同于账户 ID | ||
verify_poi_account_id | string | 核销门店的账户 ID。不等同于收款账户 ID | ||
sku_id | string | 商品 ID | ||
order_ext_id | string | 外部订单 ID，不存在时不返回 | ||
group_name | string | 商品名称，不存在时不返回 | ||
code | string | 券码，用户实际核销时使用的券码 | ||
响应示例
正常示例
JSON复制{
"data": {
"cursor": "1000000000",
"has_more": true,
"ledger_records": [
{
"account_id": "1000000000",
"amount": {
"actual_insured": 0,
"broker_commission": 0,
"clerk_commission": 0,
"goods": 955,
"ledger_platform_ticket": 0,
"ledger_total": 990,
"merchant_ticket": 610,
"original": 1600,
"pay": 990,
"platform_ticket": 0,
"talent_commission": 0,
"total_agent_merchant": 10,
"total_merchant_platform_service": 25,
"total_operation_agent": 10
},
"certificate_id": "1000000000",
"item_order_id": "1000000000",
"ledger_id": "1000000000",
"poi_id": "1000000000",
"settle_time": 1692115093,
"settle_type": 1,
"settle_type_desc": "正向账单",
"shop_order_id": "1000000000",
"verify_id": "1000000000",
"verify_poi_account_id": "1000000000",
"sku_id": "1000000000",
"order_ext_id": "1000000000",
"group_name": "爆品任选券",
"code": "1000000000"
}
]
},
"extra": {
"description": "success",
"error_code": 0,
"logid": "1000000000",
"now": 1693481191,
"sub_description": "",
"sub_error_code": 0
}
}
异常示例
Django复制{
"data":{
"error_code":2190002,
"description":"access_token无效"
},
"extra":{
"error_code":2190002,
"description":"access_token无效",
"sub_error_code":0,
"sub_description":"access_token无效",
"logid":"1000000000",
"now":1717037904659
}
}
错误码
HTTP 状态码 | 错误码 | 描述 | 排查建议 |
200 | 3000001 | 业务异常 | 对照接口文档规范参数并重试 |
200 | 4000001 | 缺少必填参数 | 补充参数 |
200 | 4000002 | 参数非法 | 对照接口文档规范参数并重试 |
200 | 5000001 | 系统异常 | 联系抖音处理 |
200 | 6000001 | 非自动提现 | 手动提现记录无法查询对应账单，请您至 【财务首页】-【交易账户详情】https://life.douyin.com/p/finance/v2/transaction/account?groupid=1751624323825741&life_account_id=7174636309414152206查看货款账户资金明细，根据收入和支出匹配货款到账情况 |
200 | 6000002 | 无账单明细 | 商家账单已经被手动提现，请您至 【财务首页】-【交易账户详情】https://life.douyin.com/p/finance/v2/transaction/account?groupid=1751624323825741&life_account_id=7174636309414152206查看货款账户资金明细，根据收入和支出匹配货款到账情况 |
点击纠错
