Simulando um refinanciamento
Request para uma Operação refinanciada não existente
ENDPOINT
/debt_simulationMÉTODO
POSTRequest Body
{
"complex_operation": true,
"operation_batch": [
{
"borrower": {
"person_type": "natural"
},
"refinanced_credit_operations": [
{
"original_deadline": 5,
"monthly_interest_rate": "0.0133",
"disbursement_date": "2024-06-30",
"due_balance": 1050,
}
],
"financial": {
"amount": 1900.83,
"interest_type": "pre_price_days",
"credit_operation_type": "ccb",
"annual_interest_rate": 2.32,
"disbursement_date": "2023-04-01",
"interest_grace_period": 0,
"principal_grace_period": 0,
"number_of_installments": 2,
"fine_configuration": {
"contract_fine_rate": 0.02,
"interest_base": "calendar_days",
"monthly_rate": 0.01
}
}
}
]
}
Atenção!
Os campos "disbursement_date" e "monthly_interest_rate" dentro do "refinanced_credit_operations" são obrigatórios apenas na necessidade de calcular o valor de quitação da operação refinanciada para as diversas opções de desembolso.
Request para uma Operação refinanciada já existente
ENDPOINT
/debt_simulationMÉTODO
POSTRequest Body
{
"complex_operation": true,
"operation_batch": [
{
"borrower": {
"person_type": "natural"
},
"refinanced_credit_operations": [
{
"operation_key": "a9630d51-f08f-4763-b269-c1947e97c260"
}
],
"financial": {
"amount": 1900.83,
"interest_type": "pre_price_days",
"credit_operation_type": "ccb",
"annual_interest_rate": 2.32,
"disbursement_date": "2023-04-01",
"interest_grace_period": 0,
"principal_grace_period": 0,
"number_of_installments": 2,
"fine_configuration": {
"contract_fine_rate": 0.02,
"interest_base": "calendar_days",
"monthly_rate": 0.01
}
}
}
]
}
Atenção!
Os payloads ultilizados na simulação de um refinanciamento são os mesmos ultilizados na simulação de uma divida simples, com a adição da lista de operações que serão quitadas em "refinanced_credit_operations" com os seus dados para o cálculo da quitação.
Response
STATUS
200Response Body
[
{
"data": {
"annual_cet": 0.6252134981759837,
"assignment_amount": 1919.84,
"cet": 0.0413,
"contract_fee_amount": -179.13,
"contract_fees": [
{
"amount": 1.0,
"amount_type": "percentage",
"fee_amount": -179.13,
"fee_type": "tac"
}
],
"credit_operation_type": "ccb",
"disbursed_issue_amount": 2079.96,
"disbursement_date": "2023-04-01",
"disbursement_options": [
{
"annual_cet": 0.6252134981759837,
"assignment_amount": 1919.84,
"cet": 0.0413,
"contract_fee_amount": -179.13,
"contract_fees": [
{
"amount": 1.0,
"amount_type": "percentage",
"fee_amount": -179.13,
"fee_type": "tac"
}
],
"disbursed_issue_amount": 2079.96,
"disbursement_date": "2023-04-01",
"external_contract_fee_amount": 19.01,
"external_contract_fees": [
{
"amount": 1.0,
"amount_released": 17.25,
"amount_type": "percentage",
"cofins_amount": 0,
"csll_amount": 0,
"description": null,
"fee_amount": 19.01,
"fee_type": "spread",
"irrf_amount": 0,
"net_fee_amount": 17.25,
"pis_amount": 0,
"tax_amount": 1.76
}
],
"first_due_date": "2023-05-01",
"installments": [
{
"business_due_date": "2023-05-02",
"calendar_days": 30,
"due_date": "2023-05-01",
"due_principal": 1900.83,
"has_interest": true,
"installment_number": 1,
"post_fixed_amount": 0,
"pre_fixed_amount": 199.90606482231624,
"principal_amortization_amount": 904.6839351776838,
"tax_amount": 0.0,
"total_amount": 1104.59,
"workdays": 18.0
},
{
"business_due_date": "2023-06-01",
"calendar_days": 31,
"due_date": "2023-06-01",
"due_principal": 996.1460648223162,
"has_interest": true,
"installment_number": 2,
"post_fixed_amount": 0,
"pre_fixed_amount": 108.43818022618876,
"principal_amortization_amount": 996.1418197738112,
"tax_amount": 0.0,
"total_amount": 1104.58,
"workdays": 23.0
}
],
"iof_amount": 0.0,
"issue_amount": 1900.83,
"net_external_contract_fee_amount": 17.25,
"prefixed_interest_rate": {
"annual_rate": 2.32,
"daily_rate": 0.0033388,
"interest_base": "calendar_days",
"monthly_rate": 0.10516767
},
"total_pre_fixed_amount": 308.344245048505
}
],
"external_contract_fee_amount": 19.01,
"external_contract_fees": [
{
"amount": 1.0,
"amount_released": 17.25,
"amount_type": "percentage",
"cofins_amount": 0,
"csll_amount": 0,
"description": null,
"fee_amount": 19.01,
"fee_type": "spread",
"irrf_amount": 0,
"net_fee_amount": 17.25,
"pis_amount": 0,
"tax_amount": 1.76
}
],
"final_disbursement_amount": -17733.89,
"installments": [
{
"business_due_date": "2023-05-02",
"calendar_days": 30,
"due_date": "2023-05-01",
"due_principal": 1900.83,
"has_interest": true,
"installment_number": 1,
"post_fixed_amount": 0,
"pre_fixed_amount": 199.90606482231624,
"principal_amortization_amount": 904.6839351776838,
"tax_amount": 0.0,
"total_amount": 1104.59,
"workdays": 18.0
},
{
"business_due_date": "2023-06-01",
"calendar_days": 31,
"due_date": "2023-06-01",
"due_principal": 996.1460648223162,
"has_interest": true,
"installment_number": 2,
"post_fixed_amount": 0,
"pre_fixed_amount": 108.43818022618876,
"principal_amortization_amount": 996.1418197738112,
"tax_amount": 0.0,
"total_amount": 1104.58,
"workdays": 23.0
}
],
"interest_grace_period": 0,
"interest_payment_month_period": 1,
"interest_type": "pre_price_days",
"iof_amount": 0.0,
"issue_amount": 1900.83,
"issue_date": "2023-04-01",
"net_external_contract_fee_amount": 17.25,
"number_of_installments": 2,
"operation_type": "refinancing",
"post_fixed_interest_base": "workdays",
"post_fixed_interest_rate": null,
"prefixed_interest_rate": {
"annual_rate": 2.32,
"daily_rate": 0.0033388,
"interest_base": "calendar_days",
"monthly_rate": 0.10516767
},
"principal_amortization_month_period": 1,
"principal_grace_period": 0,
"refinanced_credit_operations": [
{
"due_balance": 19813.85,
"due_balance_reference_date": "2023-03-29",
"original_deadline": 1084,
"refinanced_credit_operation_key": "a9630d51-f08f-4763-b269-c1947e97c260",
"refinanced_credit_operation_status": null
}
],
"requester_key": "ef48fbe4-267b-45c1-9049-75345c075486",
"total_pre_fixed_amount": 308.344245048505
},
"event_datetime": "2023-03-29 19:19:28",
"key": "0fc07785-7f74-45b0-a8ca-8ca48f8c17ed",
"status": "finished",
"type": "debt"
}
]
STATUS
400Response Body
{
"data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}
Definições
Request Body
| Campo | Tipo | Descrição |
|---|---|---|
| complex_operation | boolean | true - indica que multiplas simulações podem ser realizadas na mesma request |
| operation_batch | object | Lista de solicitações de simulação - Objeto da Lista Operation Batch |
Objeto da Lista Operation Batch
| Campo | Tipo | Descrição |
|---|---|---|
| borrower | object | Objeto Borrower - Devedor da operação de crédito |
| financial | object | Objeto Financial - Dados financeiros da operação |
Objeto Borrower
| Campo | Tipo | Descrição |
|---|---|---|
| person_type | object | Enumerador Person Type - Natureza Jurídica do devedor da operação |
Objeto Financial
| Campo | Tipo | Descrição |
|---|---|---|
| amout | float | Valor de emissão/nominal da operação de crédito |
| interest_type | object | Enumerador Interest Type - Método de amortização e forma de cálculo de juros |
| credit_operation_type | object | Enumerador Credit Operation Type - Tipo do contrato de crédito |
| annual_interest_rate | float | Taxa de juros pré-fixada expressa em decimal ao ano |
| disbursement_date | date | Data do desembolso da operação |
| interest_grace_period | int | Carência de juros (em meses) |
| principal_grace_period | int | Período carência de principal |
| number_of_installments | int | Número de parcelas da operação de crédito |
| fine_configuration | object | Objeto fine_configuration - Configuração de juros e multa por atraso |
| refinanced_credit_operations | array of objects | Lista de objetos contendo informações sobre as operações que serão refinanciadas |
Objeto Refinanced Credit Operations
Objeto no caso da operação refinanciada não existir
| Campo | Tipo | Descrição |
|---|---|---|
| due_balance | number | Valor necessário para a quitação da operação refinanciada. |
| original_deadline | int | Prazo total em dias da Operação de Crédito refinanciada. |
| monthly_interest_rate | float | Taxa de juros mensal da operação refinanciada. |
| disbursement_date | date | Data de desembolso da operação refinanciada. |
Objeto no caso da operação refinanciada já existir
| Campo | Tipo | Descrição |
|---|---|---|
| operation_key | string uuid | Chave da operação que será refinanciada. |
Objeto Fine Configuration
| Campo | Tipo | Descrição |
|---|---|---|
| contract_fine_rate | float | Percentual de multa por atraso expresso em decimal |
| interest_base | enum | Enumerador Interest Base - Base de cálculo de juros |
| monthly_rate | float | Percentual de juros de atraso ao mês expresso em decimal |