Calculations Engine

O Building Block Calculations Engine fornece calculadoras financeiras para empréstimos na Catalisa Platform.

Visão Geral

O módulo Calculations Engine é tenant-scoped e oferece:

• Cálculo de parcelas (PMT)
• Cálculo de coeficientes de amortização
• Cálculo de custos totais
• Conversão de taxas de juros
• Geração de tabelas de amortização (8 métodos)
• Cálculo de CET (Custo Efetivo Total)
• Cálculo de IOF

Base URL

https://calculations-engine.stg.catalisa.app

Recursos

Recurso	Descrição
Calculadoras	Todas as calculadoras financeiras

Permissão

Todas as calculadoras requerem a permissão CALCULATIONS_EXECUTE.

Endpoints

Endpoint	Descrição
/api/v1/calculations/loan-payment-calculator/calculations	Calcular parcela mensal
/api/v1/calculations/loan-coefficient-calculator/calculations	Calcular coeficiente
/api/v1/calculations/loan-costs-calculator/calculations	Somar custos
/api/v1/calculations/loan-interest-rate-calculator/calculations	Converter taxas
/api/v1/calculations/loan-payment-dates-calculator/calculations	Gerar datas de pagamento
/api/v1/calculations/loan-cet-rate-calculator/calculations	Calcular CET
/api/v1/calculations/loan-iof-calculator/calculations	Calcular IOF
/api/v1/calculations/loan-amortization-schedule-calculator/calculations	Gerar tabela de amortização
/api/v1/calculations/loan-amortization-tir-overpayment-calculator/calculations	Calcular TIR (overpayment)
/api/v1/calculations/loan-amortization-tir-principal-sum-calculator/calculations	Calcular TIR (principal sum)

Exemplo Prático

Veja o Exemplo de Empréstimo Pessoal para um fluxo completo de simulação de crédito integrando Products e Calculations Engine.

Métodos de Amortização

Método	Descrição	Configuração
PRICE	Tabela Price - parcelas fixas, amortização crescente	-
SAC	Sistema de Amortização Constante - amortização fixa, parcelas decrescentes	-
BALLOON	Parcelas menores + balão no final	balloonConfig
BULLET	Apenas juros até o vencimento, principal integral no final	-
INTEREST_ONLY	Carência de amortização, depois PRICE ou SAC	interestOnlyConfig
STEP_UP	Parcelas crescentes periodicamente	stepConfig
STEP_DOWN	Parcelas decrescentes periodicamente	stepConfig
CUSTOM	Cronograma de pagamentos personalizado	customConfig

Novos Métodos

Os métodos BALLOON, BULLET, INTEREST_ONLY, STEP_UP, STEP_DOWN e CUSTOM foram adicionados para suportar diferentes cenários de financiamento, como imobiliário, capital de giro e crédito com parcelas progressivas.

Conceitos Financeiros

Taxa de Juros

As taxas são expressas em decimal:

• 0.0199 = 1.99% ao mes
• 0.26 = 26% ao ano

CET (Custo Efetivo Total)

O CET representa o custo real do empréstimo, incluindo:

• Taxa de juros
• Tarifas de cadastro
• Seguro
• IOF

IOF (Imposto sobre Operações Financeiras)

Composto por:

• IOF Adicional: 0.38% sobre o valor total
• IOF Diario: 0.0082% ao dia (limite de 3%)

Estrutura de Request/Response

Todas as calculadoras seguem o padrão JSON:API:

Request

{
  "data": {
    "type": "calculation-type",
    "attributes": {
      "campo1": "valor1",
      "campo2": "valor2"
    }
  }
}

Response

{
  "data": {
    "type": "calculation-type",
    "attributes": {
      "resultado1": "valor1",
      "resultado2": "valor2"
    }
  }
}