Calculations Engine

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

Visão Geral

O módulo Calculations Engine e 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 (PRICE/SAC)
• Cálculo de CET (Custo Efetivo Total)
• Cálculo de IOF

Base URL

https://api.catalisa.io/calculations-engine

Recursos

Recurso	Descrição
Calculadoras	Todas as calculadoras financeiras

Permissão

Todas as calculadoras requerem a permissão CALCULATIONS_EXECUTE.

Endpoints

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

Métodos de Amortização

Método	Descrição
PRICE	Tabela Price - parcelas fixas, amortização crescente
SAC	Sistema de Amortização Constante - amortização fixa, parcelas decrescentes

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