接口说明

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

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

使用限制

若查询的订单中包含“权益子品”类商品（例如0元兑换的权益商品），则响应参数的amount结构体不会返回 goods字段。这类商品因实际支付金额为0，系统在账单中不记录其商品明细金额信息。

在餐饮账单详情查询接口中使用总户 ID 作为 root account ID，并保持 account ID 与 root account ID 都传总户 ID；则可以查询到总户下的账单

SLA：支持的最大QPS:50;

基本信息

名称	描述
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

（入参root_account_id，可以拉到品牌账户下总账户，区域账户，门店账户的全量账单）

withdraw_idString

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

请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/settle/bill/catering_query/?biz_type=1&root_account_id=7893435465&account_id=7893435465&size=1261490637197288555&settle_unit_id=7893435465&cursor=KqgHOXPzX7&bill_date=2006-01-02&withdraw_id=789053535' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body展开全部子属性

extra必填Struct

扩展信息

展开子属性

dataStruct

返回数据

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "2026081914233540CDAC02ECD33364348E",
    "now": 1787120615
  },
  "data": {
    "has_more": false,
    "cursor": "q6TiFuHHbi",
    "ledger_records": [
      {
        "settle_type_desc": "RrWKyoSldV",
        "product_type": "WDtCmsjE1K",
        "settlement_time": 190027572564571100,
        "settle_unit_id": "dEizX7oHMV",
        "amount": {
          "351UXHn7tp": 9144354872013417000
        },
        "associated_shop_order_id": "4q5QkDNDjt",
        "biz_type": 1,
        "settle_type": 1225944276142780200,
        "order_tag": "2ni4y2zgPN",
        "verify_out_order_id": "l3AJu8HIsN",
        "settle_sub_type": 1822997234656297500,
        "ledger_id": "MsUWfza6RT",
        "order_ext_id": "j09jX4R1ye",
        "account_id": "KarmYJFpeD",
        "code": "BvR7mmPKP3",
        "bill_fund_id": "7UsxUm0HZK",
        "product_sub_type": "mgAjTImwBM",
        "bill_trade_type": 1,
        "outer_verify_coupon_number": "BisBBHjkBU",
        "group_name": "smLKiPcWLB",
        "gov_company_name": "8mOewygmmZ",
        "order_source_platform": 1,
        "outer_verify_order_number": "cmoCDeVpdR",
        "shop_order_id": "0GeM0nVihX",
        "book_number": "sUShe51cQF",
        "sku_id": "d2aRka8wLO",
        "poi_id": "byqWd9TRui",
        "certificate_id": "B76aDcME0t",
        "flow_id": "hio9GsZ2jU",
        "verify_serial_num": 2367263384019574000,
        "verify_poi_account_id": "GNNLhN8mBq",
        "fund_amount_type": 7518034697148486000,
        "settle_time": 5541553388906565000,
        "verify_id": "rl7T3hxgfa",
        "item_order_id": "1wwjpobbpt",
        "fund_amount": 8155047516144207000,
        "settle_account_poi_id": "ElRmngeJrr"
      }
    ],
    "error_code": 0,
    "description": ""
  }
}

切换单列布局

错误码

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

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

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

餐饮账单详情查询