1 - Buscar Simulação

cURL

cURL

curl --request POST \
  --url https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'IdempotencyKey: <idempotencykey>' \
  --data '
{
  "dto": {
    "CpfTrabalhador": "<string>",
    "Saldo": 123,
    "VlrEmprestimo": 123,
    "Periodo": 123,
    "TaxaMensal": 123,
    "VlrTAC": 123,
    "PercTAC": 123,
    "DtAniversario": "2023-11-07T05:31:56Z",
    "ConsultaCache": true,
    "Periodos": [
      {
        "DataRepasse": "2023-11-07T05:31:56Z",
        "VlrRepasse": 123
      }
    ]
  }
}
'

import requests

url = "https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao"

payload = { "dto": {
        "CpfTrabalhador": "<string>",
        "Saldo": 123,
        "VlrEmprestimo": 123,
        "Periodo": 123,
        "TaxaMensal": 123,
        "VlrTAC": 123,
        "PercTAC": 123,
        "DtAniversario": "2023-11-07T05:31:56Z",
        "ConsultaCache": True,
        "Periodos": [
            {
                "DataRepasse": "2023-11-07T05:31:56Z",
                "VlrRepasse": 123
            }
        ]
    } }
headers = {
    "IdempotencyKey": "<idempotencykey>",
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    IdempotencyKey: '<idempotencykey>',
    Authorization: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dto: {
      CpfTrabalhador: '<string>',
      Saldo: 123,
      VlrEmprestimo: 123,
      Periodo: 123,
      TaxaMensal: 123,
      VlrTAC: 123,
      PercTAC: 123,
      DtAniversario: '2023-11-07T05:31:56Z',
      ConsultaCache: true,
      Periodos: [{DataRepasse: '2023-11-07T05:31:56Z', VlrRepasse: 123}]
    }
  })
};

fetch('https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dto' => [
        'CpfTrabalhador' => '<string>',
        'Saldo' => 123,
        'VlrEmprestimo' => 123,
        'Periodo' => 123,
        'TaxaMensal' => 123,
        'VlrTAC' => 123,
        'PercTAC' => 123,
        'DtAniversario' => '2023-11-07T05:31:56Z',
        'ConsultaCache' => true,
        'Periodos' => [
                [
                                'DataRepasse' => '2023-11-07T05:31:56Z',
                                'VlrRepasse' => 123
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json",
    "IdempotencyKey: <idempotencykey>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao"

	payload := strings.NewReader("{\n  \"dto\": {\n    \"CpfTrabalhador\": \"<string>\",\n    \"Saldo\": 123,\n    \"VlrEmprestimo\": 123,\n    \"Periodo\": 123,\n    \"TaxaMensal\": 123,\n    \"VlrTAC\": 123,\n    \"PercTAC\": 123,\n    \"DtAniversario\": \"2023-11-07T05:31:56Z\",\n    \"ConsultaCache\": true,\n    \"Periodos\": [\n      {\n        \"DataRepasse\": \"2023-11-07T05:31:56Z\",\n        \"VlrRepasse\": 123\n      }\n    ]\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("IdempotencyKey", "<idempotencykey>")
	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao")
  .header("IdempotencyKey", "<idempotencykey>")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dto\": {\n    \"CpfTrabalhador\": \"<string>\",\n    \"Saldo\": 123,\n    \"VlrEmprestimo\": 123,\n    \"Periodo\": 123,\n    \"TaxaMensal\": 123,\n    \"VlrTAC\": 123,\n    \"PercTAC\": 123,\n    \"DtAniversario\": \"2023-11-07T05:31:56Z\",\n    \"ConsultaCache\": true,\n    \"Periodos\": [\n      {\n        \"DataRepasse\": \"2023-11-07T05:31:56Z\",\n        \"VlrRepasse\": 123\n      }\n    ]\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bmpdigital.moneyp.dev.br/FGTS/BuscarSimulacao")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["IdempotencyKey"] = '<idempotencykey>'
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dto\": {\n    \"CpfTrabalhador\": \"<string>\",\n    \"Saldo\": 123,\n    \"VlrEmprestimo\": 123,\n    \"Periodo\": 123,\n    \"TaxaMensal\": 123,\n    \"VlrTAC\": 123,\n    \"PercTAC\": 123,\n    \"DtAniversario\": \"2023-11-07T05:31:56Z\",\n    \"ConsultaCache\": true,\n    \"Periodos\": [\n      {\n        \"DataRepasse\": \"2023-11-07T05:31:56Z\",\n        \"VlrRepasse\": 123\n      }\n    ]\n  }\n}"

response = http.request(request)
puts response.read_body

200

{
  "Msg": "<string>",
  "HasError": true,
  "Messages": [
    {
      "Code": "<string>",
      "Context": "<string>",
      "Description": "<string>",
      "Field": "<string>"
    }
  ],
  "IdentificadorConsulta": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "VlrDispSaque": 123,
  "PeriodoMin": 123,
  "PeriodoMax": 123,
  "Simulacao": {
    "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,
    "VlrSeguro": 123,
    "VlrReserva": 123,
    "VlrAmortizacao": 123,
    "VlrTransferencia": 123,
    "TaxaCCB": 123,
    "SimulacaoParcelas": [
      {
        "VlrRepasse": 123,
        "DtRepasse": "2023-11-07T05:31:56Z",
        "VlrPrincipal": 123,
        "VlrIOF": 123,
        "VlrIOFAdicional": 123,
        "VlrLiberado": 123,
        "VlrJuros": 123
      }
    ]
  },
  "Consulta": {
    "cpfTrabalhador": "<string>",
    "dataSaldo": "<string>",
    "existeSaldoDesconsiderado": true,
    "qtdPedidos": 123,
    "periodos": [
      {
        "dataRepasse": "<string>",
        "valor": 123
      }
    ],
    "Cache": true
  }
}

{
  "Msg": "<string>",
  "HasError": true,
  "Messages": [
    {
      "Code": "<string>",
      "Context": "<string>",
      "Description": "<string>",
      "Field": "<string>"
    }
  ]
}

Por meio deste endpoint o parceiro executa a simulação e busca de dados referente aos valores de FGTS disponíveis para trabalhador. Após o retorno dos valores, pode realizar empréstimos com garantia do Saque Aniversário, onde posteriormente serão 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.

Mostrar Mensagens de requisições com erro

O retorno de uma requisição com status HTTP 400 (Bad Request) pode incluir as seguintes mensagens de erro:

Código	Retorno da Caixa	Retorno ao Parceiro	Tipo de Retorno
400	2. Quantidade de Períodos deve ser maior que zero.	Quantidade de períodos deve ser maior que zero	Cancela
400	4. Número de CPF inválido.	CPF informado inválido	Cancela
400	5. Existe uma Operação Fiduciária em andamento. Tente mais tarde	Existe uma Operação Fiduciária em andamento. Tente mais tarde	Reprocessa
400	9. Trabalhador não possui adesão ao saque aniversário vigente na data corrente.	Trabalhador não possui adesão ao saque aniversário vigente na data corrente.	Cancela
400	10. Operação não permitida antes de determinada data.	Operação não permitida antes de determinada data	Cancela
400	11. Não é possível realizar a operação para o CPF informado.	Não é possível realizar a operação para o CPF informado	Cancela
400	12. Trabalhador não possui saldo disponível para Operação Fiduciária.	Trabalhador não possui saldo disponível para Operação Fiduciária.	Cancela
400	13. Operação não permitida por pendência no processo de pagamento de saque-aniversário.	Operação não permitida por pendência no processo de pagamento de saque-aniversário.	Cancela
400	14. Existe uma solicitação de garantia com o mesmo número identificador.	Existe uma solicitação de garantia com o mesmo número identificador.	Cancela
400	15. Trabalhador não possui adesão ao saque aniversário para o período informado.	Trabalhador não possui adesão ao saque aniversário para o período informado.	Cancela
400	16. Uma ou mais datas de previsão do saque informadas não conferem com as previstas no sistema.	Uma ou mais datas de previsão do saque informadas não conferem com as previstas no sistema.	Cancela
400	17. Valor da alienação/cessão superior ao valor disponível para o trabalhador.	Valor da alienação/cessão superior ao valor disponível para o trabalhador.	Cancela
400	18. Trabalhador com solicitação de retorno para saque rescisão, que deve ser cancelada pelo mesmo para possibilitar a solicitação de garantia.	Trabalhador com solicitação de retorno para saque rescisão, que deve ser cancelada pelo mesmo para possibilitar a solicitação de garantia.	Cancela
400	34. Valor da reserva deve ser maior que zero.	Valor da reserva deve ser maior que zero.	Cancela
400	35. Mudanças cadastrais ou lançamentos a débito foram realizadas na conta do FGTS, impedindo a contratação. Entre em contato com o setor de FGTS da CAIXA para regularização ou acompanhe a data do débito no APP FGTS.	Foi identificado falta de dados cadastrais na conta do FGTS que impedem a contratação. Entre em contato com o setor de FGTS da Caixa.	Cancela
400	37. Trabalhador não possui saldo suficiente para a garantia necessária.	Trabalhador não possui saldo suficiente para a garantia necessária.	Cancela
400	38. Identificador da Solicitação inválido.	Identificador da Solicitação inválido.	Cancela
400	40. Foi identificado falta de dados cadastrais na conta do FGTS que impedem a contratação. Entre em contato com o setor de FGTS da Caixa.	Foi identificado falta de dados cadastrais na conta do FGTS que impedem a contratação. Entre em contato com o setor de FGTS da Caixa.	Cancela

Autorizações

Authorization · string · header · obrigatório

Informe o token

Cabeçalhos

IdempotencyKey · string · obrigatório

Corpo

application/jsontext/jsonapplication/*+json

dto · object · obrigatório

Show child attributes

Resposta

200

text/plain

OK

Msg · string | null

HasError · boolean

Messages · object[] | null

Show child attributes

IdentificadorConsulta · string<uuid> | null

VlrDispSaque · number<double>

PeriodoMin · integer<int32>

PeriodoMax · integer<int32>

Simulacao · object

Show child attributes

Consulta · object

Show child attributes