接口说明

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

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

使用限制

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

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

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": "OsJXOFfMta",
    "ledger_records": [
      {
        "bill_fund_id": "S8cXhoiTFv",
        "amount": {
          "WjV0OrwyYL": 5499884773575883000
        },
        "verify_out_order_id": "0krHmAEvOR",
        "account_id": "zjspS6ElMX",
        "gov_company_name": "EW9mysAlEu",
        "code": "mxHGmo3d2E",
        "biz_type": 1,
        "fund_amount": 8168396824922579000,
        "bill_trade_type": 1,
        "sku_id": "3YYaQeOOG3",
        "book_number": "6w6pk9Em37",
        "associated_shop_order_id": "pdDDIIx5lD",
        "shop_order_id": "1Fj8sfrysK",
        "poi_id": "EHSwmFrjJi",
        "certificate_id": "0TW0BpMdja",
        "order_tag": "vkgFd1DYI3",
        "settle_sub_type": 9108091106893924000,
        "verify_serial_num": 6005894934195992000,
        "outer_verify_order_number": "v0mxecSuJ6",
        "verify_poi_account_id": "2JrJ56MCmW",
        "outer_verify_coupon_number": "XOEkySslmG",
        "settle_account_poi_id": "UhD2TELIDQ",
        "settle_type_desc": "k2GRXRYgsf",
        "verify_id": "vmgzoxKrNJ",
        "group_name": "IVTRTRl8ns",
        "ledger_id": "shoAZ5f3B1",
        "settle_time": 8099684210043958000,
        "flow_id": "TPB5cjx1sr",
        "fund_amount_type": 4282994068069546500,
        "settle_type": 4067328937170467300,
        "order_ext_id": "xmVbVmCUko",
        "item_order_id": "BU3mfTrrwF"
      }
    ],
    "error_code": 0,
    "description": ""
  },
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "2025092318494381F827B88C2EE619C399",
    "now": 1758624583
  }
}

切换单列布局

错误码

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

开发者文档

餐饮账单详情查询

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

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

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

餐饮账单详情查询