债务模拟（新版）
QI Tech 为客户提供在实际发行前模拟信贷操作金额的功能。模拟遵循与债务发行请求相同的模式，但无需提供债务人的注册信息和放款账户数据。
请求
以下示例描述了一次债务模拟请求。
ENDPOINT
/v2/credit_operation/simulationMÉTODO
POST请求体
- 到期日和分期金额
- 放款金额和分期
{
"credit_operation_type": "ccb",
"disbursed_issue_amount": 2800,
"disbursement_date": "2025-09-24",
"first_due_date": "2025-10-24",
"force_installments_on_workdays": true,
"interest_type": "pre_price_days",
"issuer_person_type": "natural",
"monthly_interest_rate": 0.04488,
"number_of_installments": 12,
"principal_amortization_month_period": 1
}
{
"credit_operation_type": "ccb",
"disbursed_issue_amount": 460,
"disbursement_date": "2025-09-24",
"first_due_date": "2025-10-24",
"force_installments_on_workdays": true,
"interest_type": "pre_price_days",
"issuer_person_type": "natural",
"number_of_installments": 3,
"principal_amortization_month_period": 1,
"interest_base": "calendar_days_365",
"installments": [
{
"due_date": "2026-02-26",
"amount": 137.48
},
{
"due_date": "2026-03-26",
"amount": 180.56
},
{
"due_date": "2026-04-27",
"amount": 180.56
}
]
}
响应
STATUS
200响应体
{
"additional_iof": 0.14,
"annual_cet": 145.08,
"assignment_amount": 36.21,
"base_iof": 0.1,
"cet": 7.76,
"disbursed_amount": 35.9,
"disbursement_date": "2024-09-06",
"fees": [],
"first_due_date": "2024-09-25",
"installments": [],
"interest_type": "pre_price_days",
"issue_amount": 36.14,
"prefixed_interest_rate": {
"interest_base": "calendar_days",
"annual_rate": 1.25219159,
"daily_rate": 0.00225783,
"monthly_rate": 0.07
},
"tax_configuration": {
"additional_rate": 0.0038,
"base_rate": 0.000082
},
"total_iof": 0.24
}
定义
请求体
Payload
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| credit_operation_type | enum | 信贷操作类型枚举值 - 信贷合同类型 | - |
| disbursed_issue_amount | float | 信贷操作的发行/名义金额 | - |
| disbursement_date | date | 操作放款日期 | - |
| first_due_date | date | 第一期分期到期日 | - |
| force_installments_on_workdays | boolean | true - 分期安排在工作日的指示器 | - |
| interest_type | enum | 利率类型枚举值 - 摊销方法和利率计算方式 | - |
| issuer_person_type | enum | Person Type 枚举值 | - |
| monthly_interest_rate | float | 合同的月固定利率 | - |
| number_of_installments | int | 信贷操作的分期数 | - |
| principal_amortization_month_period | int | 本金摊销月数 | - |
| installments | list | Installments 对象 - 操作分期 | - |
响应体
Payload
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| annual_cet | float | 以年化小数表示的总有效成本 | - |
| assignment_amount | float | 信贷操作的收购金额 | - |
| cet | float | 以月度小数表示的总有效成本 | - |
| fees | object | Fees 对象 - QI Tech 在操作中收取的费用列表 | - |
| disbursed_amount | float | 信贷操作的放款金额 | - |
| disbursement_date | date | 操作放款日期 | - |
| installments | list | Installments Response 对象 - 操作分期 | - |
| interest_type | enum | 利率类型枚举值 - 摊销方法和利率计算方式 | - |
| additional_iof | float | 附加 IOF 金额 | - |
| base_iof | float | 基础 IOF 金额 | - |
| total_iof | float | 总 IOF 金额 | - |
| issue_amount | float | 信贷操作的发行/名义金额 | - |
| tax_configuration | object | Tax Configuration 对象 - 税率值 | - |
| first_due_date | date | 第一期分期到期日 | - |
| prefixed_interest_rate | object | Interest Rate 对象 - 合同名义固定利率 | - |
Fees 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| amount | float | 费用金额（以百分比或绝对值表示，取决于 amount_type 字段的值） | - |
| amount_type | enum | amount_type 枚举值 - 费用金额单位 | - |
| fee_amount | float | 操作中收取的绝对费用金额 | - |
| fee_type | enum | 费用类型枚举值 - 操作中收取的费用类型 | - |
| type | enum | 来源类型枚举值 - 操作中收取的费用来源 | - |
Installments Request 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| due_date | date | 分期的自然日到期日 | - |
| total_amount | float | 分期总金额 | - |
Installments Response 对象
| 字段 | 类型 | 描述 | 最大字符数 |
|---|---|---|---|
| calendar_days | int | 分期之间的自然日数 | - |
| due_date | date | 分期的自然日到期日 | - |
| due_principal | float | 分期到期日付款前的剩余本金 | - |
| has_interest | boolean | true - 分期计息指示器 | - |
| installment_number | int | 分期编号 | - |
| prefixed_amount | float | 分期支付的固定利息金额 | - |
| principal_amortization_amount | float | 分期支付的摊销金额 | - |
| tax_amount | float | 分期的基础 IOF | - |
| amount | float | 分期总金额 | - |
| due_interest | float | 分期到期日付款前的剩余利息 | - |
| period | float | 分期周期 | - |
| period_workdays | float | 分期工作日周期 | - |
| period_to_disbursement | float | 到放款的周期 | - |
| period_workdays_to_disbursement | float | 到放款的工作日周期 | - |
| calendar_days_to_disbursement | int | 到放款的自然日数 | - |
| workdays | int | 分期之间的工作日数 | - |
| workdays_to_disbursement | int | 到放款的工作日数 | - |
Interest Rate 对象
| 字段 | 描述 | 最大字符数 |
|---|---|---|
| annual_rate | 以年化小数表示的固定/浮动利率 | - |
| daily_rate | 以日度小数表示的固定/浮动利率 | - |
| interest_base | 利率基准枚举值 - 利率计算基准 | - |
| monthly_rate | 以月度小数表示的固定/浮动利率 | - |
Tax Configuration 对象
| 字段 | 描述 | 最大字符数 |
|---|---|---|
| base_rate | 基础税率值 | - |
| additional_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 费用溢价 |
Origin Type 枚举值
每种费用类型必须提前由 QI Tech 启用和配置
| 枚举值 | 描述 |
|---|---|
| internal | 内部来源费用 |
| external | 外部来源费用 |