Guide

Consultar tabelas

Este endpoint permite recuperar as tabelas de taxas de juros disponíveis para simulações de crédito relacionadas ao Saque Aniversário FGTS. Cada tabela representa um conjunto de taxas associadas a um perfil ou modalidade de operação.

Endpoint

  • URL: https://bff.v8sistema.com/fgts/simulations/fees

  • Método HTTP: GET

  • Autenticação: Requer token JWT válido no header da requisição.

Exemplo de Requisição 

GET /fgts/simulations/fees HTTP/1.1
Host: bff.v8sistema.com
Authorization: Bearer <access_token>
Content-Type: application/json

Exemplo de Resposta 

[
  {
    "active": true,
    "default": false,
    "simulation_fees": {
      "id_simulation_fees": "13c4c16a-0ace-4cca-af52-323ddf2c0894",
      "spread_value": 0,
      "annual_interest_fees": 0.23872053,
      "monthly_interest_rates": 1.8,
      "label": "milhas"
    }
  },
  {
    "active": true,
    "default": false,
    "simulation_fees": {
      "id_simulation_fees": "8beaa78b-b7ba-4f48-853e-de9f322be42f",
      "spread_value": 0,
      "annual_interest_fees": 0.23872053,
      "monthly_interest_rates": 1.8,
      "label": "turbo"
    }
  },
  {
    "active": true,
    "default": false,
    "simulation_fees": {
      "id_simulation_fees": "cd67cb02-c49d-457e-bfa9-a99316eb9dfe",
      "spread_value": 0,
      "annual_interest_fees": 0.23872053,
      "monthly_interest_rates": 1.8,
      "label": "pitstop"
    }
  }
]

Descrição dos Campos

Campo

Tipo

Descrição

active

boolean

Indica se a tabela está ativa para uso.

default

boolean

Indica se esta é a tabela padrão do sistema.

id_simulation_fees

string

Identificador único da tabela de juros.

spread_value

decimal

Valor do spread aplicado (se houver).

annual_interest_fees

decimal

Taxa de juros anual (em percentual decimal, ex: 0.23 = 23%).

monthly_interest_rates

decimal

Taxa de juros mensal (em percentual, ex: 1.8 = 1,8%).

label

string

Nome/descrição da tabela (ex: "milhas", "turbo", etc.).

Considerações

  • Apenas tabelas com o campo "active": true devem ser consideradas válidas para simulações ou operações.

  • O campo label pode ser exibido para o usuário final ou usado como filtro na aplicação.