接口说明

1、账单金额均为绝对值，不显示正负，调用时请注意账单的结算类型。

2、核销和撤销均会产生账单数据，多次核销和撤销则会产生多条数据。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/goodlife/v1/settle/bill/catering_query/
HTTP Method	GET
Scope	life.capacity.billing.detail
权限要求	商家账单明细

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

固定值"application/json"

Rpc-Transit-Life-AccountString

来客商户根账户ID

Query展开全部子属性

account_id必填String

商户id（分账收款的商户）

bill_date必填String

核销日期格式为"2006-01-02"

cursor必填String

查询游标

size必填Int64

页大小，取值范围1～50

biz_typeEnum

业务类型，团购-1，外卖-2，买单-3，点单-5

展开子属性

root_account_idString

总户id

withdraw_idString

提现单,优先级大于日期&游标

请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/settle/bill/catering_query/?cursor=4oai6loFrF&size=195437795633114253&bill_date=hAWcGRaMqx&withdraw_id=kTv9SyXGOF&root_account_id=0jYjUtBoeL&biz_type=1&account_id=ss6GIHXZ1f' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body展开全部子属性

extra必填Struct

扩展信息

展开子属性

dataStruct

返回数据

展开子属性

响应示例
正常响应示例异常响应示例
{
  "data": {
    "has_more": false,
    "cursor": "WTXlpCaF8t",
    "ledger_records": [
      {
        "group_name": "nYO3yrd9Q7",
        "shop_order_id": "ToQ9NbEkY3",
        "settle_account_poi_id": "YyK2DcTe6W",
        "gov_company_name": "hLFHuAShSv",
        "settle_time": 232745997537378560,
        "flow_id": "zPgkWmvsDC",
        "certificate_id": "WG0lxfpMNO",
        "bill_trade_type": 1,
        "settle_type": 8451582887283554000,
        "code": "0Fe6pptYc1",
        "amount": {
          "6a8EccGKjs": 1757421780668315400
        },
        "verify_poi_account_id": "TdlG5Ec2ra",
        "order_tag": "MQYl3BCJrs",
        "order_ext_id": "lALQc9GwTp",
        "book_number": "BgBy2IeIbt",
        "associated_shop_order_id": "7VfuGim8dj",
        "verify_serial_num": 1545860650022416600,
        "outer_verify_coupon_number": "Qnhw0a7YmS",
        "sku_id": "ZHhLRzqeX5",
        "fund_amount": 642124654943874800,
        "poi_id": "eXjhDWm7Qx",
        "verify_id": "ekIH75EGDo",
        "account_id": "6J2KcpCMPM",
        "settle_type_desc": "XsQwxpCh4v",
        "outer_verify_order_number": "Fbp0EUgcEp",
        "settle_sub_type": 8226298099862583000,
        "ledger_id": "HiGSv9L2NO",
        "fund_amount_type": 7706151007158514000,
        "biz_type": 1,
        "item_order_id": "Wld7LMRoKd"
      }
    ],
    "error_code": 0,
    "description": ""
  },
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "20250708195221DA1FAD3333B17C081AB2",
    "now": 1751975541
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	2100001	未知错误	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2100004	系统繁忙，此时请开发者稍候再试	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2100005	参数不合法	更换参数
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	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查看货款账户资金明细，根据收入和支出匹配货款到账情况

开发者文档

餐饮账单详情查询

接口说明

基本信息

请求参数

响应参数

错误码

餐饮账单详情查询在线调试

接口说明

基本信息

请求参数

响应参数

错误码

餐饮账单详情查询