Simulação - Emissão BNPL

Resumo

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

Request

ENDPOINT

/v2/credit_operation/simulation

MÉTODO

POST

Testar no Playground

Request Body

{
    "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
}

Detalhes do Request Body

Campo	Tipo	Descrição	Caracteres
credit_operation_type*	string	Tipo de operação de crédito	Enumerador Credit Operation Type
disbursed_issue_amount*	float	Valor efetivamente liberado ao tomador	15,2
disbursement_date*	string	Data em que os recursos do empréstimo serão disponibilizados	10
first_due_date*	string	Data de vencimento da primeira parcela	10
force_installments_on_workdays*	boolean	Se verdadeiro, garante que todas as datas de vencimento das parcelas sejam movidas para o próximo dia útil	5
interest_type*	string	Método de amortização	Enumerador Interest Type
issuer_person_type*	string	Define se o emissor é pessoa física ou jurídica	Enumerador Person Type
monthly_interest_rate*	float	Taxa de juros mensal aplicada sobre o saldo principal	10,6
number_of_installments*	integer	Número de parcelas	3
principal_amortization_month_period*	integer	Período, em meses, entre as parcelas	1

Enumerador Credit Operation Type

Valor	Descrição
ccb	Cédula de Crédito Bancário

Enumerador Interest Type

Valor	Descrição
pre_price_days	Juros pré-fixados com amortização Price por dias corridos
pre_price	Juros pré-fixados com amortização Price por meses
pre_sac	Juros pré-fixados com amortização SAC

Enumerador Person Type

Valor	Descrição
natural	Pessoa física
legal	Pessoa jurídica

Response

STATUS

200

Response Body

{
    "disbursement_date": "2025-09-24",
    "issue_amount": 2821.32,
    "interest_type": "pre_price_days",
    "assignment_amount": 2829.78,
    "base_iof": 10.6,
    "total_iof": 21.32,
    "additional_iof": 10.72,
    "cet": 5.09,
    "annual_cet": 81.39,
    "first_due_date": "2025-10-24",
    "disbursed_amount": 2800,
    "prefixed_interest_rate": {
        "annual_rate": 0.6935459998,
        "daily_rate": 0.0014644728,
        "interest_base": "calendar_days",
        "monthly_rate": 0.04488
    },
    "tax_configuration": {
        "base_rate": 8.2e-05,
        "additional_rate": 0.0038
    },
    "fees": [
        {
            "amount": 0.3,
            "fee_amount": 8.46,
            "amount_type": "percentage",
            "fee_type": "spread",
            "type": "internal"
        }
    ],
    "installments": [
        {
            "due_date": "2025-10-24",
            "amount": 1507.4,
            "due_principal": 2821.32,
            "due_interest": 0,
            "has_interest": true,
            "period": 1,
            "period_workdays": 1.1,
            "calendar_days": 30,
            "workdays": 22,
            "installment_number": 1,
            "period_to_disbursement": 1,
            "prefixed_amount": 126.62083829,
            "period_workdays_to_disbursement": 1.1,
            "calendar_days_to_disbursement": 30,
            "workdays_to_disbursement": 22,
            "tax_amount": 3.39671674,
            "principal_amortization_amount": 1380.77916171
        },
        {
            "due_date": "2025-11-24",
            "amount": 1507.4,
            "due_principal": 1440.54083829,
            "due_interest": 0,
            "has_interest": true,
            "period": 1,
            "period_workdays": 1,
            "calendar_days": 31,
            "workdays": 20,
            "installment_number": 2,
            "period_to_disbursement": 2,
            "prefixed_amount": 66.85916171,
            "period_workdays_to_disbursement": 2.1,
            "calendar_days_to_disbursement": 61,
            "workdays_to_disbursement": 42,
            "tax_amount": 7.20558527,
            "principal_amortization_amount": 1440.54083829
        }
    ]
}

Detalhes do Response Body

Campo	Tipo	Descrição
annual_cet	float	Custo Efetivo Total anualizado expresso em decimal
assignment_amount	float	Valor de cessão da operação de crédito
cet	float	Custo Efetivo Total mensal expresso em decimal
fees	array	Objeto Fees - Lista de taxas da QI Tech cobradas na operação
disbursed_amount	float	Valor desembolsado na operação de crédito
disbursement_date	string	Data de desembolso da operação
installments	array	Objeto Installments - Parcelas da operação
interest_type	string	Método de amortização e cálculo de juros
additional_iof	float	IOF adicional aplicado sobre o principal da transação
base_iof	float	Base de cálculo do IOF
total_iof	float	Valor total do IOF aplicado na transação
issue_amount	float	Valor nominal da operação de crédito
tax_configuration	object	Objeto Tax Configuration - Valores das taxas de IOF
first_due_date	string	Data de vencimento da primeira parcela
prefixed_interest_rate	object	Objeto Interest Rate - Taxa de juros nominal

Objeto Fees

Campo	Tipo	Descrição
amount	float	Valor ou percentual da taxa
fee_amount	float	Valor monetário da taxa
amount_type	string	Tipo do valor (percentage ou fixed)
fee_type	string	Tipo da taxa
type	string	Classificação da taxa (internal ou external)

Objeto Installments

Campo	Tipo	Descrição
due_date	string	Data de vencimento da parcela
amount	float	Valor total da parcela
due_principal	float	Saldo devedor no momento da parcela
installment_number	integer	Número da parcela
prefixed_amount	float	Valor dos juros pré-fixados
tax_amount	float	Valor do IOF na parcela
principal_amortization_amount	float	Valor de amortização do principal
calendar_days	integer	Dias corridos entre parcelas
workdays	integer	Dias úteis entre parcelas

Objeto Tax Configuration

Campo	Tipo	Descrição
base_rate	float	Taxa base do IOF
additional_rate	float	Taxa adicional do IOF

Objeto Interest Rate

Campo	Tipo	Descrição
annual_rate	float	Taxa de juros anual
daily_rate	float	Taxa de juros diária
interest_base	string	Base de cálculo dos juros
monthly_rate	float	Taxa de juros mensal