Simulação de dívida

Na QI Tech disponibilizamos aos nossos clientes a possibilidade de simular os valores uma operação de crédito antes da sua emissão de fato. A simulação segue o mesmo padrão da solicitação de emissão de dívida, porém não é necessário informar os dados cadastrais e de conta de desembolso do devedor.

Request

No exemplo abaixo, esta descrita uma solicitação de simulação de dívida.

ENDPOINT

/debt_simulation

MÉTODO

POST

Request Body

{
    "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.23872053,
        "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"
                }
            }
        ]
    }
}

Response

STATUS

200

Response Body

{
    "type": "debt",
    "key": "bf84379c-d4cf-4f16-a63c-865c129e6fce",
    "status": "finished",
    "event_datetime": "2025-03-27 22:28:37",
    "data": {
        "interest_type": "pre_price_days",
        "credit_operation_type": "ccb",
        "interest_grace_period": 0,
        "interest_payment_month_period": 1,
        "principal_grace_period": 0,
        "principal_amortization_month_period": 1,
        "operation_type": "structured_operation",
        "post_fixed_interest_base": "workdays",
        "post_fixed_interest_rate": null,
        "prefixed_interest_rate": {
            "interest_base": "calendar_days_365",
            "annual_rate": 0.23872053,
            "monthly_rate": 0.0179999999,
            "daily_rate": 0.0005866899
        },
        "issue_date": "2026-09-06",
        "number_of_installments": 2,
        "requester_key": "f2b3b903-aa41-4a79-8b2f-abc3cc5a6590",
        "final_disbursement_amount": 701.6,
        "total_pre_fixed_amount": 153.0,
        "iof_amount": 18.34,
        "cet": 0.0219,
        "annual_cet": 0.297,
        "disbursement_date": "2026-09-06",
        "installments": [
            {
                "calendar_days": 207,
                "workdays": 140,
                "business_due_date": "2027-04-01",
                "due_date": "2027-04-01",
                "due_principal": 729.94,
                "has_interest": true,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 94.22564648,
                "tax_amount": 8.22329794,
                "total_amount": 578.69,
                "principal_amortization_amount": 484.46435352,
                "installment_number": 1
            },
            {
                "calendar_days": 366,
                "workdays": 253,
                "business_due_date": "2028-04-03",
                "due_date": "2028-04-01",
                "due_principal": 245.47564648,
                "has_interest": true,
                "post_fixed_amount": 0,
                "pre_fixed_amount": 58.77435352,
                "tax_amount": 7.3470861,
                "total_amount": 304.25,
                "principal_amortization_amount": 245.47564648,
                "installment_number": 2
            }
        ],
        "external_contract_fees": [
            {
                "fee_type": "tac",
                "amount_type": "absolute",
                "amount": 10.0,
                "fee_amount": 10.0,
                "tax_amount": 1.42,
                "net_fee_amount": 8.58,
                "csll_amount": 0,
                "irrf_amount": 0,
                "pis_amount": 0,
                "cofins_amount": 0,
                "amount_released": 8.58,
                "description": null
            },
            {
                "fee_type": "spread_tax_free",
                "amount_type": "absolute",
                "amount": 0.0,
                "fee_amount": 0.0,
                "tax_amount": 0.0,
                "net_fee_amount": 0.0,
                "csll_amount": 0,
                "irrf_amount": 0,
                "pis_amount": 0,
                "cofins_amount": 0,
                "amount_released": 0,
                "description": null
            },
            {
                "fee_type": "tac_tax_free",
                "amount_type": "absolute",
                "amount": 0.0,
                "fee_amount": 0.0,
                "tax_amount": 0.0,
                "net_fee_amount": 0.0,
                "csll_amount": 0,
                "irrf_amount": 0,
                "pis_amount": 0,
                "cofins_amount": 0,
                "amount_released": 0,
                "description": null
            },
            {
                "fee_type": "insurance_premium",
                "amount_type": "absolute",
                "amount": 0.0,
                "fee_amount": 0.0,
                "tax_amount": 0.0,
                "net_fee_amount": 0.0,
                "csll_amount": 0,
                "irrf_amount": 0,
                "pis_amount": 0,
                "cofins_amount": 0,
                "amount_released": 0,
                "description": null
            }
        ],
        "contract_fee_amount": 3.65,
        "external_contract_fee_amount": 10.0,
        "net_external_contract_fee_amount": 8.58,
        "contract_fees": [
            {
                "fee_type": "spread",
                "amount_type": "percentage",
                "amount": 0.5,
                "fee_amount": 3.65
            },
            {
                "fee_type": "spread_ted_fee",
                "amount_type": "absolute",
                "amount": 3.0,
                "fee_amount": 3.0
            }
        ],
        "issue_amount": 729.94,
        "disbursed_issue_amount": 701.6,
        "assignment_amount": 736.59,
        "disbursement_options": [
            {
                "iof_amount": 18.34,
                "total_pre_fixed_amount": 153.0,
                "cet": 0.0219,
                "annual_cet": 0.297,
                "contract_fees": [
                    {
                        "fee_type": "spread",
                        "amount_type": "percentage",
                        "amount": 0.5,
                        "fee_amount": 3.65
                    },
                    {
                        "fee_type": "spread_ted_fee",
                        "amount_type": "absolute",
                        "amount": 3.0,
                        "fee_amount": 3.0
                    }
                ],
                "external_contract_fees": [
                    {
                        "fee_type": "tac",
                        "amount_type": "absolute",
                        "amount": 10.0,
                        "fee_amount": 10.0,
                        "tax_amount": 1.42,
                        "net_fee_amount": 8.58,
                        "csll_amount": 0.0,
                        "irrf_amount": 0.0,
                        "pis_amount": 0.0,
                        "cofins_amount": 0.0,
                        "amount_released": 8.58,
                        "description": null
                    },
                    {
                        "fee_type": "spread_tax_free",
                        "amount_type": "absolute",
                        "amount": 0.0,
                        "fee_amount": 0.0,
                        "tax_amount": 0.0,
                        "net_fee_amount": 0.0,
                        "csll_amount": 0,
                        "irrf_amount": 0,
                        "pis_amount": 0,
                        "cofins_amount": 0,
                        "amount_released": 0.0,
                        "description": null
                    },
                    {
                        "fee_type": "tac_tax_free",
                        "amount_type": "absolute",
                        "amount": 0.0,
                        "fee_amount": 0.0,
                        "tax_amount": 0.0,
                        "net_fee_amount": 0.0,
                        "csll_amount": 0,
                        "irrf_amount": 0,
                        "pis_amount": 0,
                        "cofins_amount": 0,
                        "amount_released": 0.0,
                        "description": null
                    },
                    {
                        "fee_type": "insurance_premium",
                        "amount_type": "absolute",
                        "amount": 0.0,
                        "fee_amount": 0.0,
                        "tax_amount": 0.0,
                        "net_fee_amount": 0.0,
                        "csll_amount": 0,
                        "irrf_amount": 0,
                        "pis_amount": 0,
                        "cofins_amount": 0,
                        "amount_released": 0.0,
                        "description": null
                    }
                ],
                "contract_fee_amount": 3.65,
                "external_contract_fee_amount": 10.0,
                "net_external_contract_fee_amount": 8.58,
                "disbursement_date": "2026-09-06",
                "first_due_date": "2027-04-01",
                "installments": [
                    {
                        "calendar_days": 207,
                        "workdays": 140,
                        "business_due_date": "2027-04-01",
                        "due_date": "2027-04-01",
                        "due_principal": 729.94,
                        "has_interest": true,
                        "post_fixed_amount": 0,
                        "pre_fixed_amount": 94.22564648,
                        "tax_amount": 8.22329794,
                        "total_amount": 578.69,
                        "principal_amortization_amount": 484.46435352,
                        "installment_number": 1
                    },
                    {
                        "calendar_days": 366,
                        "workdays": 253,
                        "business_due_date": "2028-04-03",
                        "due_date": "2028-04-01",
                        "due_principal": 245.47564648,
                        "has_interest": true,
                        "post_fixed_amount": 0,
                        "pre_fixed_amount": 58.77435352,
                        "tax_amount": 7.3470861,
                        "total_amount": 304.25,
                        "principal_amortization_amount": 245.47564648,
                        "installment_number": 2
                    }
                ],
                "issue_amount": 729.94,
                "disbursed_issue_amount": 701.6,
                "assignment_amount": 736.59,
                "final_disbursement_amount": 701.6,
                "prefixed_interest_rate": {
                    "interest_base": "calendar_days_365",
                    "annual_rate": 0.23872053,
                    "monthly_rate": 0.0179999999,
                    "daily_rate": 0.0005866899
                }
            }
        ]
    }
}

Definições

Request Body

Objeto Borrower

Campo	Tipo	Descrição	Enum
person_type	object	Natureza Jurídica do devedor da operação	natural ou legal

Objeto Financial

Campo	Tipo	Descrição	Máx. Caract.
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	-

Objeto Fine Configuration

Campo	Tipo	Descrição	Máx. Caract.
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	-

Response Body

Campo	Tipo	Descrição	Máx. Caract.
data.data	object	Objeto Data	-
data.event_datetime	date	Momento da geração da simulação	-
data.key	string	Chave única da simulação	-
data.status	string	finished	-
data.type	string	debt	-

Objeto Data

Campo	Tipo	Descrição	Máx. Caract.
annual_cet	float	Custo efetivo total expresso em decimal ao ano	-
assignment_amount	float	Valor de aquisição da operação de crédito	-
cet	float	Custo efetivo total expresso em decimal ao mês	-
contract_fee_amount	float	Fee da QI Tech cobrado na operação	-
contract_fees	object	Objeto Contract Fees - Lista de Fee's da QI Tech cobrados na operação	-
credit_operation_type	enum	Enumerador Credit Operation Type - Tipo do contrato de crédito	-
disbursed_issue_amount	float	Valor desembolsado na operação de crédito	-
disbursement_date	date	Data do desembolso da operação	-
disbursement_options	list	Lista de opções de desembolso da operação (os valores financeiros da operação podem variar de acordo com o dia do desembolso)	-
external_contract_fee_amount	float	Valor do Fee cobrado na operação rebatido pela QI ao parceiro	-
external_contract_fees	list	Objeto Contract Fees - Lista de Fee's cobrados na operação rebatidos pela QI ao parceiro	-
final_disbursement_amount	float	Valor efetivamente desembolsado para o devedor	-
installments	list	Objeto Installments - Parcelas da operação	-
interest_grace_period	int	Carência de juros (em meses)	-
interest_payment_month_period	int	Frequência da cobrança de juros nas parcelas (em meses)	-
interest_type	enum	Enumerador Interest Type - Método de amortização e forma de cálculo de juros	-
iof_amount	float	Valor total do iof	-
issue_amount	float	Valor de emissão/nominal da operação de crédito	-
issue_date	date	Data da emissão do cotrato da operação	-
net_external_contract_fee_amount	float	Valor líquido do Fee cobrado na operação rebatido pela QI ao parceiro	-
operation_type	enum	Enumerador Operation Type	-
post_fixed_interest_base	enum	Enumerador Interest Base - Base de cálculo de juros	-
post_fixed_interest_rate	object	Objeto Interest Rate - Indexador de juros pós-fixados do contrato	-
prefixed_interest_rate	object	Objeto Interest Rate - Taxa de juros Nominal pré-fixada do contrato	-
principal_amortization_month_period	int	Frequência da cobrança de principal nas parcelas (em meses)	-
principal_grace_period	int	Período carência de principal (em meses)	-
requester_key	string	Chave única identificadora do parceiro dentro da QI.	-
total_pre_fixed_amount	float	Total de juros pago pelo devedor na operação de crédito	-

Objeto Contract Fees

Campo	Tipo	Descrição	Máx. Caract.
amount	float	Valor do Fee (em percentual ou valor absoluto, a depender do valor informado no campo amount_type	-
amount_type	enum	Enumeradores amount_type - Unidade do valor do Fee	-
fee_amount	float	Valor absoluto do Fee cobrado na operação	-
fee_type	enum	Enumerador Fee Type - Tipo do Fee cobrado na operação	-

Objeto Installments

Campo	Tipo	Descrição	Máx. Caract.
business_due_date	date	Data do vencimento em dia útil da parcela	-
calendar_days	int	Quantos dias corridos entre uma parcela e outra	-
due_date	date	Data do vencimento em dia corrido da parcela	-
due_principal	float	Principal remanescente na data de vencimento da parcela antes de seu pagamento	-
has_interest	boolean	true - Indicador de incidência de juros na parcela	-
installment_number	int	Número da parcela	-
post_fixed_amount	float	Valor de juros pós-fixado pago na parcela	-
pre_fixed_amount	float	Valor de juros pré-fixado pago na parcela	-
principal_amortization_amount	float	Valor de amortização pago na parcela	-
tax_amount	float	IOF da parcela	-
total_amount	float	Valor total da parcela	-
workdays	int	Quantos dias úteis entre uma parcela e outra	-

Objeto Interest Rate

Campo	Descrição	Máx. Caract.
annual_rate	Taxa de juros pré/pós expressa em decimal ao ano	-
daily_rate	Taxa de juros pré/pós expressa em decimal ao dia	-
interest_base	Enumerador Interest Base - Base de cálculo de juros	-
monthly_rate	Taxa de juros pré/pós expressa em decimal ao mês	-

Enumeradores

Enumerador Person Type

Enumerador	Descrição
legal	Pessoa juridica
natural	Pesso física

Enumerador Account Type

Enumerador	Descrição
checking_account	Conta corrente
deposit_account	Conta de depósito
guaranteed_account	Conta de garantia
investment_account	Conta de investimento
payment_account	Conta de pagamento
saving_account	Conta poupança
salary_account	Conta salário

Enumerador Interest Type

Enumerador	Descrição
pre_price_days	Método de amortização Price (parcelas iguais) com cálculo do juros pré-fixado ao dia
pre_price	Método de amortização Price (parcelas iguais) com cálculo do juros pré-fixado em períodos fixos (30 dias)
pre_sac	Método de amortização SAC (amortização constante) com cálculo do juros pré-fixado ao dia
post_sac	Método de amortização SAC (amortização constante) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) ao dia
post_price	Método de amortização Price (parcelas iguais) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) em períodos fixos (30 dias)
post_price_days	Método de amortização Price (parcelas iguais) com cálculo do juros baseado em uma taxa pré-fixada + indexador pós-fixado (cdi, ipca ou igpm) ao dia

Enumerador Credit Operation Type

Enumerador	Descrição
ccb	Cédula de Crédito Bancário
cce	Cédula de Crédito à Exportação
cci	Cédula de Crédito Imobiliário
nce	Nota de Crédito à Exportação

Enumerador Interest Base

Enumerador	Descrição
workdays	Base de cálculo de juros em dias úteis considerando um ano de 252 dias
calendar_days	Base de cálculo de juros em dias corridos considerando um ano de 360 dias
calendar_days_365	Base de cálculo de juros em dias corridos considerando um ano de 365 dias

Enumerador Fee Type

Cada tipo de fee deve ser previamente habilitado e configurado pela QI Tech

Enumerador	Descrição
tac	Tarifa de abertura de cadastro
spread	Ágio cobrado no valor de aquisição da operação de crédito
warranty_analysis	Tarifa de análise de garantias
ted_fee	Tarifa de TED
spread_ted_fee	Ágio da tarifa de TED cobrado no valor de aquisição da operação de crédito

Simulação de dívida

Request​

Response​

Definições​

Request Body​

Objeto Borrower​

Objeto Financial​

Objeto Fine Configuration​

Response Body​

Objeto Data​

Objeto Contract Fees​

Objeto Installments​

Objeto Interest Rate​