抖音开放平台Logo
控制台

分账明细查询-by券码（新）

更新时间 2024-09-29 06:09:20
收藏
我的收藏

接口说明

基于 sub_fulfil_id 查询分账单​，用于查询分账明细

1、券码核销之后查询对应的分账单。​

2、券码核销 1h 后（未撤销）生成分账单，记录预计分账的金额，实际的分账动作、提现动作并未发生。​

3、没有操作权限的券码对应分账单为空、券码未核销时对应的分账单为空、券码已核销 1h 内对应分的账单为空。​

使用限制

sub_fulfil_id 查询数量不得大于 50​

基本信息

名称描述
HTTP URL
https://open.douyin.com/goodlife/v1/settle/bill/query_record_by_subfulfil/
HTTP Method
GET
Scope
life.capacity.billing
权限要求
  • 需要申请权限 ，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案​
  • 需要商家授权，路径：抖音来客>店铺管理>服务应用授权​

请求头

名称字段类型是否必填示例描述
access-tokenString是clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/client_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Query

名称字段类型是否必填示例描述

请求示例

curl --location --request GET '/goodlife/v1/settle/bill/query_record_by_subfulfil/?sub_fulfil_id=7191071710976180281' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \

响应参数

Body

名称字段类型是否必填示例描述

响应示例

正常响应示例

{
  "data": {
    "records": [
      {
        "item_order_id": "800000723043033523413164978",
        "account_id": "7073845037515147278",
        "account_name": "上海沙效建材经营部",
        "pay_amount": 0,
        "ledger_id": "LRB7208820993334446138000054787278",
        "ledger_platform_ticket": 0,
        "shop_order_id": "8000007230430334978",
        "biz_time": 1678434040,
        "ledger_datail_map": {
          "goods": {
            "amount": 0,
            "commission_ratio": 0
          },
          "merchant_platform_commission": {
            "amount": 0,
            "commission_ratio": 190
          },
          "pay_handling": {
            "amount": 0,
            "commission_ratio": 60
          }
        },
        "sku_type": 2,
        "sub_fulfil_id": "7208816050052874301",
        "withdraw_id": "0",
        "commission_base_amount": 0,
        "sku_id": "1757154508291087"
      },
      {
        "account_id": "7073845037515147278",
        "shop_order_id": "8000007230430334978",
        "ledger_datail_map": {
          "goods": {
            "amount": 5,
            "commission_ratio": 0
          },
          "pay_handling": {
            "amount": 0,
            "commission_ratio": 60
          }
        },
        "ledger_platform_ticket": 0,
        "sku_type": 2,
        "sub_fulfil_id": "",
        "withdraw_id": "0",
        "item_order_id": "800000723043033549015314978",
        "ledger_id": "LRB7208821016310106171000094267278",
        "pay_amount": 5,
        "account_name": "上海沙效建材经营部",
        "biz_time": 1678434040,
        "commission_base_amount": 5,
        "sku_id": "EMPTY"
      }
    ],
    "error_code": 0,
    "description": "success"
  },
  "extra": {
    "description": "success",
    "error_code": 0,
    "logid": "202303212122159BCAA92D0F785D01E267",
    "now": 1679404935,
    "sub_description": "",
    "sub_error_code": 0
  }
}

异常响应示例

{
  "data": {
    "error_code": 2190002,
    "description": "access_token无效"
  },
  "extra": {
    "error_code": 2190002,
    "description": "access_token无效",
    "sub_error_code": 0,
    "sub_description": "access_token无效",
    "logid": "000000001",
    "now": 1727427988662
  }
}

错误码

http状态码错误码错误码描述排查建议
2002119002
系统繁忙，请稍候再试
重试
2002119003
请求太过频繁，请稍后再试
重试
2002119005
应用未获商家授权
联系合作商家在商家后台发起授权，并在服务商后台同意授权
2003000001

业务异常

对照接口文档规范参数并重试
2004000001

缺少必填参数 ​

补充参数
2004000002

参数非法 ​

对照接口文档规范参数并重试
2005000001

系统异常

联系抖音处理
2003000002

核销门店错误

检查核销门店重试