债务模拟（旧版）
QI Tech 为客户提供在实际发行前模拟信贷操作金额的功能。模拟遵循与债务发行请求相同的模式，但无需提供债务人的注册信息和放款账户数据。
请求
以下示例描述了一次债务模拟请求。
ENDPOINT
/debt_simulationMÉTODO
POST请求体
- 到期日和分期金额
- 利率和分期日期
{
"borrower": {
"person_type": "natural"
},
"financial": {
"desired_installments": [
{
"total_amount": 578.69,
"due_date": "2027-04-01"
},
{
"total_amount": 304.25,
"due_date": "2028-04-01"
}
],
"interest_type": "pre_price_days",
"disbursement_date": "2026-09-06",
"fine_configuration": {
"monthly_rate": 0.0,
"interest_base": "calendar_days",
"contract_fine_rate": 0.0
},
"annual_interest_rate": 0.2387205,
"credit_operation_type": "ccb",
"interest_grace_period": 0,
"number_of_installments": 2,
"principal_grace_period": 0,
"rebates": [
{
"amount": 10,
"fee_type": "tac",
"amount_type": "absolute",
"rebate_bank_account": {
"name": "CONTA BANCARIA",
"bank_code": "329",
"account_digit": "1",
"branch_number": "0001",
"account_number": "00003",
"document_number": "32402502000135"
}
}
]
}
}
{
"borrower": {
"person_type": "natural"
},
"financial": {
"interest_type": "pre_price_days",
"disbursement_start_date": "2025-09-03",
"disbursement_end_date": "2025-09-03",
"issue_date": "2025-09-03",
"fine_configuration": {
"monthly_rate": 0,
"contract_fine_rate": 0,
"interest_base": "calendar_days"
},
"monthly_interest_rate": 0.1929244498,
"disbursed_amount": 10000.00,
"credit_operation_type": "ccb",
"interest_grace_period": 0,
"number_of_installments": 18,
"principal_grace_period": 0,
"due_dates": [
"2025-09-28",
"2025-10-28",
"2025-11-28",
"2025-12-28",
"2026-01-28",
"2026-02-28",
"2026-03-28",
"2026-04-28",
"2026-05-28",
"2026-06-28",
"2026-07-28",
"2026-08-28",
"2026-09-28",
"2026-10-28",
"2026-11-28",
"2026-12-28",
"2027-01-28",
"2027-02-28"
]
}
}
响应
STATUS
200响应体
{
"type": "debt",
"key": "bf84379c-d4cf-4f16-a63c-865c129e6fce",
"status": "finished",
"event_datetime": "2025-03-27 22:28:37",
"data": {}
}
定义
请求体
Borrower 对象
| 字段 | 类型 | 描述 | 枚举值 |
|---|---|---|---|
| person_type | object | 操作债务人的法律性质 | natural 或 legal |
Financial 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| amout | float | 信贷操作的发行/名义金额 | - |
| interest_type | object | 利率类型枚举值 - 摊销方法和利率计算方式 | - |
| credit_operation_type | object | 信贷操作类型枚举值 - 信贷合同类型 | - |
| annual_interest_rate | float | 以年化小数表示的固定利率 | - |
| disbursement_date | date | 操作放款日期 | - |
| interest_grace_period | int | 利息宽限期（月） | - |
| principal_grace_period | int | 本金宽限期 | - |
| number_of_installments | int | 信贷操作的分期数 | - |
| fine_configuration | object | fine_configuration 对象 - 逾期利息和罚款配置 | - |
Fine Configuration 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| contract_fine_rate | float | 以小数表示的逾期罚款百分比 | - |
| interest_base | enum | 利率基准枚举值 - 利率计算基准 | - |
| monthly_rate | float | 以小数表示的月逾期利率 | - |
响应体
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| data.data | object | Data 对象 | - |
| data.event_datetime | date | 模拟生成时刻 | - |
| data.key | string | 模拟的唯一密钥 | - |
| data.status | string | finished | - |
| data.type | string | debt | - |
Data 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| annual_cet | float | 以年化小数表示的总有效成本 | - |
| assignment_amount | float | 信贷操作的收购金额 | - |
| cet | float | 以月度小数表示的总有效成本 | - |
| contract_fee_amount | float | QI Tech 在操作中收取的费用 | - |
| contract_fees | object | Contract Fees 对象 - QI Tech 在操作中收取的费用列表 | - |
| credit_operation_type | enum | 信贷操作类型枚举值 - 信贷合同类型 | - |
| disbursed_issue_amount | float | 信贷操作的放款金额 | - |
| disbursement_date | date | 操作放款日期 | - |
| disbursement_options | list | 操作的放款选项列表（操作的财务金额可能因放款日期而有所不同） | - |
| external_contract_fee_amount | float | QI Tech 向合作方回扣的操作费用金额 | - |
| external_contract_fees | list | Contract Fees 对象 - QI Tech 向合作方回扣的操作费用列表 | - |
| final_disbursement_amount | float | 实际放款给债务人的金额 | - |
| installments | list | Installments 对象 - 操作分期 | - |
| interest_grace_period | int | 利息宽限期（月） | - |
| interest_payment_month_period | int | 分期利率收取频率（月） | - |
| interest_type | enum | 利率类型枚举值 - 摊销方法和利率计算方式 | - |
| iof_amount | float | IOF 总金额（基础 IOF 和附加 IOF 之和） | - |
| issue_amount | float | 信贷操作的发行/名义金额 | - |
| issue_date | date | 操作合同发行日期 | - |
| net_external_contract_fee_amount | float | QI Tech 向合作方回扣的操作净费用金额 | - |
| operation_type | enum | 操作类型枚举值 | - |
| post_fixed_interest_base | enum | 利率基准枚举值 - 利率计算基准 | - |
| post_fixed_interest_rate | object | Interest Rate 对象 - 合同浮动利率指数 | - |
| prefixed_interest_rate | object | Interest Rate 对象 - 合同名义固定利率 | - |
| principal_amortization_month_period | int | 分期本金收取频率（月） | - |
| principal_grace_period | int | 本金宽限期（月） | - |
| requester_key | string | 合作方在 QI 内的唯一标识密钥 | - |
| total_pre_fixed_amount | float | 债务人在信贷操作中支付的利息总额 | - |
Contract Fees 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| amount | float | 费用金额（以百分比或绝对值表示，取决于 amount_type 字段的值） | - |
| amount_type | enum | amount_type 枚举值 - 费用金额单位 | - |
| fee_amount | float | 操作中收取的绝对费用金额 | - |
| fee_type | enum | 费用类型枚举值 - 操作中收取的费用类型 | - |
Installments 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| business_due_date | date | 分期在工作日的到期日 | - |
| calendar_days | int | 分期之间的自然日数 | - |
| due_date | date | 分期的自然日到期日 | - |
| due_principal | float | 分期到期日付款前的剩余本金 | - |
| has_interest | boolean | true - 分期计息指示器 | - |
| installment_number | int | 分期编号 | - |
| post_fixed_amount | float | 分期支付的浮动利息金额 | - |
| pre_fixed_amount | float | 分期支付的固定利息金额 | - |
| principal_amortization_amount | float | 分期支付的摊销金额 | - |
| tax_amount | float | 分期的基础 IOF | - |
| total_amount | float | 分期总金额 | - |
| workdays | int | 分期之间的工作日数 | - |
Interest Rate 对象
| 字段 | 描述 | 最大字符数 |
|---|---|---|
| annual_rate | 以年化小数表示的固定/浮动利率 | - |
| daily_rate | 以日度小数表示的固定/浮动利率 | - |
| interest_base | 利率基准枚举值 - 利率计算基准 | - |
| monthly_rate | 以月度小数表示的固定/浮动利率 | - |
枚举值
Person Type 枚举值
| 枚举值 | 描述 |
|---|---|
| legal | 法人 |
| natural | 自然人 |
Account Type 枚举值
| 枚举值 | 描述 |
|---|---|
| checking_account | 活期账户 |
| deposit_account | 存款账户 |
| guaranteed_account | 担保账户 |
| investment_account | 投资账户 |
| payment_account | 支付账户 |
| saving_account | 储蓄账户 |
| salary_account | 工资账户 |
Amount Type 枚举值
| 枚举值 | 描述 |
|---|---|
| absolute | 绝对值 |
| percentage | 百分比值 |
Interest Type 枚举值
| 枚举值 | 描述 |
|---|---|
| pre_price_days | Price 摊销法（等额分期），按日计算固定利率 |
| pre_price | Price 摊销法（等额分期），按固定周期（30天）计算固定利率 |
| pre_sac | SAC 摊销法（等额本金），按日计算固定利率 |
| post_sac | SAC 摊销法（等额本金），按日计算基于固定利率加浮动指数（cdi、ipca 或 igpm）的利率 |
| post_price | Price 摊销法（等额分期），按固定周期（30天）计算基于固定利率加浮动指数（cdi、ipca 或 igpm）的利率 |
| post_price_days | Price 摊销法（等额分期），按日计算基于固定利率加浮动指数（cdi、ipca 或 igpm）的利率 |
Credit Operation Type 枚举值
| 枚举值 | 描述 |
|---|---|
| ccb | 银行信贷凭证 |
| cce | 出口信贷凭证 |
| cci | 房地产信贷凭证 |
| nce | 出口信贷票据 |
Interest Base 枚举值
| 枚举值 | 描述 |
|---|---|
| workdays | 以工作日为基准计算利率，按 252 天/年计算 |
| calendar_days | 以自然日为基准计算利率，按 360 天/年计算 |
| calendar_days_365 | 以自然日为基准计算利率，按 365 天/年计算 |
Fee Type 枚举值
每种费用类型必须提前由 QI Tech 启用和配置
| 枚举值 | 描述 |
|---|---|
| tac | 开户费 |
| spread | 信贷操作收购金额中收取的溢价 |
| warranty_analysis | 担保分析费 |
| ted_fee | TED 费用 |
| spread_ted_fee | 信贷操作收购金额中收取的 TED 费用溢价 |