接口说明

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": {
    "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",
        "OrderExtId": "1000000000",
        "GroupName": "爆品任选券",
        "Code": "1000000000"
      }
    ],
    "error_code": 0,
    "description": ""
  },
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202412262139240662DC59C75BC95E5C72",
    "now": 1735220365
  }
}

切换单列布局

错误码

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查看货款账户资金明细，根据收入和支出匹配货款到账情况

开发者文档

「OpenAPI」餐饮账单详情查询

接口说明

基本信息

请求参数

响应参数

错误码

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

接口说明

基本信息

请求参数

响应参数

错误码

「OpenAPI」餐饮账单详情查询