Pular para o conteúdo principal
cURL
curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacaoMultiPeriodo \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "dto": {
    "Saldo": 123,
    "VlrEmprestimo": 123,
    "TaxaMensal": 123,
    "VlrTAC": 123,
    "PercTAC": 123,
    "DtAniversario": "2023-11-07T05:31:56Z",
    "CpfTrabalhador": "<string>",
    "ConsultaCache": true,
    "Periodos": [
      {
        "DataRepasse": "2023-11-07T05:31:56Z",
        "VlrRepasse": 123
      }
    ]
  }
}
'
{
  "Msg": "<string>",
  "HasError": true,
  "Messages": [
    {
      "MessageType": 1,
      "Code": "<string>",
      "Context": "<string>",
      "Description": "<string>",
      "Field": "<string>"
    }
  ],
  "VlrDispSaque": 123,
  "PeriodoMin": 123,
  "PeriodoMax": 123,
  "Simulacoes": [
    {
      "Saldo": 123,
      "Periodo": 123,
      "DtInicio": "2023-11-07T05:31:56Z",
      "DtFim": "2023-11-07T05:31:56Z",
      "TaxaMensal": 123,
      "TaxaCETMensal": 123,
      "TaxaCETAnual": 123,
      "TaxaJurosAnual": 123,
      "VlrEmprestimoCliente": 123,
      "VlrJuros": 123,
      "VlrIOF": 123,
      "VlrIOFAdicional": 123,
      "VlrLiberado": 123,
      "VlrOperacao": 123,
      "VlrTAC": 123,
      "VlrReserva": 123,
      "VlrAmortizacao": 123,
      "VlrTransferencia": 123,
      "VlrOutrasDespesas": 123,
      "TaxaCCB": 123,
      "SimulacaoParcelas": [
        {
          "VlrRepasse": 123,
          "DtRepasse": "2023-11-07T05:31:56Z",
          "VlrPrincipal": 123,
          "VlrIOF": 123,
          "VlrIOFAdicional": 123,
          "VlrLiberado": 123,
          "VlrJuros": 123
        }
      ]
    }
  ],
  "SimulacoesErro": [
    {
      "Msg": "<string>",
      "HasError": true,
      "Messages": [
        {
          "MessageType": 1,
          "Code": "<string>",
          "Context": "<string>",
          "Description": "<string>",
          "Field": "<string>"
        }
      ],
      "Periodo": 123
    }
  ],
  "Consulta": {
    "cpfTrabalhador": "<string>",
    "dataSaldo": "<string>",
    "existeSaldoDesconsiderado": true,
    "qtdPedidos": 123,
    "periodos": [
      {
        "dataRepasse": "<string>",
        "valor": 123
      }
    ],
    "Cache": true
  }
}
Por meio deste endpoint o parceiro realiza a busca e simulação de dados referente aos valores de FGTS disponíveis para o trabalhador. Após o retorno dos valores, pode realizar empréstimos com garantia do Saque Aniversário, onde serão posteriormente inclusos em uma proposta. Esta ação antecede a inclusão e efetivação da proposta no sistema. Regras:
  • Caso seja informado o campo “Saldo”, não utilizamos o saldo verdadeiro do cliente na Caixa Econômica Federal e o cálculo será com base nos valores da nossa calculadora.
  • Caso o mês de aniversário esteja incorreto, o sistema retorna um erro no momento da simulação.
  • Em caso de preenchimento do campo CPF, a consulta é realizada na Caixa Econômica Federal
Quando o valor do campo ConsultaCache for false, a requisição consultará o saldo do FGTS atualizado diretamente na Caixa Econômica Federal (CEF); quando for true, o saldo será obtido do cache da BMP. Este campo não é obrigatório, caso não seja informado, o sistema assume o valor true como padrão.

​
Mensagens de erro

A tabela abaixo representa as mensagens de erro que podem ser retornadas ao tentar realizar uma requisição.

Autorizações

​
Authorization
string
header
obrigatório

Informe o token

Cabeçalhos

​
IdempotencyKey
string
obrigatório

Corpo

​
dto
object

Resposta

OK

​
Msg
string | null
​
HasError
boolean
​
Messages
object[] | null
​
VlrDispSaque
number<double>
​
PeriodoMin
integer<int32>
​
PeriodoMax
integer<int32>
​
Simulacoes
object[] | null
​
SimulacoesErro
object[] | null
​
Consulta
object