商户应付总额

编号  :  003

请求参数

返回值

{
    "status": 200,
    "msg": "获取商户应付总额成功",
    "data": {
        "vid": 66, // 商户ID
        "platform_type": "platform", // 平台类型：platform=平台，third_party=第三方
        "company_id": 0, // 主体ID：0=全部主体
        "year_boundary": 2026, // 年份边界
        "before_2026_initial_remaining_payable": "1000.00", // 2026年前期初剩余应付合计；third_party返回0.00
        "after_2026_reconciled_payable": "9000.00", // 2026年及以后已对账应付合计，对应all_month_remaining_payment
        "total_payable": "10000.00", // 期初剩余应付 + 已对账应付
        "total_remaining_payable": "12000.00", // 期初剩余应付 + 月度账单剩余总应付；third_party对应all_carry_over_price
        "before_2026": {
            "years": [], // 2026年前年份分组
            "items": [] // 2026年前月份明细
        },
        "after_2026": {
            "years": [], // 2026年及以后年份分组
            "items": [] // 2026年及以后月份明细
        }
    }
}

备注

查询搜索条件：vid=商户ID，必填；platform_type=平台类型，选填，platform=平台，third_party=第三方，不传默认platform；company_id=主体ID，选填，对应bbc_company_info.id，不传查询全部主体。返回total_payable=2026年前期初剩余应付+2026年及以后已对账应付。返回total_remaining_payable=2026年前期初剩余应付+大于等于2026年月度账单剩余总应付；月度账单剩余总应付=已对账应付+未对账金额-本年剩余预付款。第三方无期初，before_2026_initial_remaining_payable为0.00；第三方total_remaining_payable对应douyinMonthlyBill的all_carry_over_price；platform_type=third_party且传company_id时，只统计该第三方主体。

2026年及以后已对账应付合计

编号  :  002

请求参数

返回值

{
    "status": 200,
    "msg": "获取2026年及以后已对账应付合计成功",
    "data": {
        "vid": 66, // 商户ID
        "platform_type": "platform", // 平台类型：platform=平台，third_party=第三方
        "year_boundary": 2026, // 年份边界
        "after_2026_reconciled_payable": "9000.00", // 2026年及以后已对账应付合计，对应all_month_remaining_payment
        "years": [
            {
                "year": 2026, // 年份
                "year_total": "9000.00", // 年份合计
                "items": [
                    {
                        "year_month": "2026-04", // 款项年月
                        "remaining_payment": "4000.00" // 已对账应付
                    },
                    {
                        "year_month": "2026-05", // 款项年月
                        "remaining_payment": "5000.00" // 已对账应付
                    }
                ]
            }
        ],
        "items": [
            {
                "year_month": "2026-04", // 款项年月
                "remaining_payment": "4000.00" // 已对账应付
            }
        ]
    }
}

备注

查询搜索条件：vid=商户ID，必填；platform_type=平台类型，选填，platform=平台，third_party=第三方，不传默认platform。平台口径：对应飞驴商户月度账单monthlyBill的all_month_remaining_payment。第三方口径：复刻douyinMonthlyBill的all_month_remaining_payment，主体过滤company_id>1，不包含期初表；每月已对账应付=对账单应付-对账单质保-抹零-已付。

2026年前期初剩余应付合计

编号  :  001

请求参数

返回值

{
    "status": 200,
    "msg": "获取2026年前期初剩余应付合计成功",
    "data": {
        "vid": 66, // 商户ID
        "platform_type": "platform", // 平台类型：platform=平台，third_party=第三方
        "year_boundary": 2026, // 年份边界
        "before_2026_initial_remaining_payable": "1000.00", // 2026年前期初剩余应付合计；third_party返回0.00
        "years": [
            {
                "year": 2025, // 年份
                "year_total": "1000.00", // 年份合计
                "items": [
                    {
                        "year_month": "2025-12", // 款项年月
                        "remaining_payment": "1000.00" // 剩余应付
                    }
                ]
            }
        ],
        "items": [
            {
                "year_month": "2025-12", // 款项年月
                "remaining_payment": "1000.00" // 剩余应付
            }
        ]
    }
}

备注

查询搜索条件：vid=商户ID，必填；platform_type=平台类型，选填，platform=平台，third_party=第三方，不传默认platform。平台口径：根据指定商户ID查询2026年以前的期初剩余应付合计，按 期初应付 - 期初质保金 - 配置起始时间之后的抹零 - 配置起始时间之后的已付款 计算，且只返回有期初应付基础数据、剩余应付不为0的月份。第三方口径：第三方没有期初概念，不读取bbc_init_carry_over_price/bbc_init_carry_over_quality，返回0.00和空明细。