分账明细查询

更新时间 2024-09-09 08:11:29

我的收藏

用于查询分账明细。

使用限制

无

接口说明

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

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

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

基本信息

HTTP URL	https://open.douyin.com/goodlife/v1/settle/ledger/query_record_by_cert/
HTTP Method	GET
申请权限	团购对账
权限要求	•需要申请权限，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 •需要商家授权，路径：抖音来客>店铺管理>服务应用授权

请求头

参数	描述	必须
Content-Type	application/json	是
access-token	根据这个地址获取的token	是

请求参数

Query 请求

参数名称	参数类型	参数描述	必需
certificate_ids	list	券码的标识（验券时返回）列表，列表长度范围1～50，多个值使用,拼接	是

请求示例

js复制
https://open.douyin.com/goodlife/v1/settle/ledger/query_record_by_cert/?certificate_ids=7091180835810052103,7091180835810052104

响应参数

参数名称	参数类型	参数描述
data	struct
.error_code	int64	错误码，0为成功
.description	string	错误码描述
.records	list	分账单列表
..cursor	string	游标，无业务意义
..ledger_id	string	分账记录id
..verify_id	string	验券记录id
..certificate_id	string	券id
..order_id	string	订单id
..verify_time	int64	验券时间，单位秒，时间戳
..status	int32	分账单状态（此字段已废弃）
..code	string	券码
..amount	struct	分账单金额
...original	int64	券原始金额，单位分
...pay	int64	用户实付金额，单位分
...ledger_total	int64	应结算金额。等于用户实付金额+实际参与结算的平台优惠券金额，单位：分
...merchant_ticket	int64	商家营销金额，单位分
...actual_insured	int64	实付保险费用。由保司收取，单位分
..fund_amount	struct	分账款项金额
...goods	int64	商家货款金额，单位分（商家实际收到金额，已经扣除支付手续费和佣金费用）
...total_commission	int64	佣金汇总金额，单位分
...pay_handling	int64	支付手续费，单位分（平台收取的千分之六支付手续费）不给isv技术服务商展示
...talent_commission	int64	达人佣金，单位分（团购上设置或者服务商引入的才会有佣金）不给isv技术服务商展示
...total_agent_merchant	int64	服务商分佣总金额，单位分不给isv技术服务商展示
...total_merchant_platform_service	int64	软件服务费。已包含支付手续费，单位：分不给isv技术服务商展示
..sku	struct	团购信息
...sku_id	string	团购SKU ID
...title	string	团购名称
...market_price	int64	团购市场价
...sold_start_time	int64	团购售卖开始时间，单位秒，时间戳
extra	struct
.error_code	int64	错误码，0为成功
.description	string	错误码描述
.sub_error_code	int64	（弃用）子错误码
.sub_description	string	（弃用）子错误码描述
.logid	string	请求id
.now	int64	（弃用）接口响应时间，时间戳，单位秒

响应示例

正常示例

json复制
{
  "data": {
    "error_code": 0,
    "description": "success",
    "records": [
      {
        "cursor": "7064492324109305863",
        "ledger_id": "7064492324109305863",
        "verify_id": "7064491846000592903",
        "certificate_id": "7064423012048865293",
        "order_id": "7062268392329758757",
        "verify_time": 1644830204,
        "status": 2,
        "code": "100566718260",
        "amount": {
          "original": 50,
          "pay": 45,
          "merchant_ticket": 0
        },
        "fund_amount": {
          "goods": 50,
          "pay_handling": 0,
          "talent_commission": 0
        },
        "sku": {
          "sku_id": "1721554180176909",
          "title": "测试结算中台分店",
          "market_price": 500,
          "sold_start_time": 1641801900
        }
      }
    ]
  },
  "extra": {
    "error_code": 0,
    "description": "success",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "xxx",
    "now": 1651738946
  }
}

异常示例

无

错误码

HTTP 状态码	错误码	描述	排查建议
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	4000001		补充参数
200	4000002		对照接口文档规范参数并重试
200	5000001		联系抖音处理
200	2100004	open_merchant_thirdparty_app.CheckIPValid错误，联系上游解决	重试