Sumário
Descrição #
Esta operação retorna, de forma paginada, as solicitações de proposta de crédito consignado CLT disponíveis para o parceiro em uma janela de tempo. Cada solicitação representa um trabalhador que pediu empréstimo e está aguardando ofertas das instituições financeiras participantes do leilão.
A janela de consulta é obrigatória e delimitada por data e hora de início e fim.
Endpoints #
Requisição (GET) #
Segue exemplo de requisição:
curl "https://hmlapi2.bancosemear.com.br/<contexto>/v1/leiloes/solicitacoes-propostas?dataHoraInicio=10092026000000&dataHoraFim=10092026235959&nroPagina=1" \
--header "Content-Type: application/json" \
--header "client_id: <CLIENT_ID>" \
--header "access_token: <ACCESS_TOKEN>" \
--header "X-Parceiro-Id: <IDENTIFICADOR_DO_PARCEIRO>" \
--header "X-Correlacao-Id: <UUID_OPCIONAL>"
Parâmetros de Requisição #
Cabeçalho #
| Cabeçalho | Descrição | Obrigatório |
| Content-Type | Indica o tipo do corpo da requisição. Sempre application/json | Sim |
| client_id | ID de cliente usado para controle de acesso do gateway de APIs | Sim |
| access_token | Token recebido após executar o método oAuth | Sim |
| X-Parceiro-Id | Identificador do parceiro. Usado para segregar os dados e registrar a trilha de auditoria | Sim |
| X-Correlacao-Id | Identificador de correlação para rastreio ponta a ponta. Se omitido, a API gera um | Não |
Query #
| Parâmetro | Descrição | Tipo |
| dataHoraInicio | Início da janela de consulta, no formato ddMMyyyyHHmmss | String |
| dataHoraFim | Fim da janela de consulta, no formato ddMMyyyyHHmmss | String |
| nroPagina | Número da página desejada, começando em 1 | String |
Resposta #
Segue exemplo de resposta:
{
"nroPaginaAtual": 1,
"nroTotalPaginas": 3,
"nroTotalRegistros": 612,
"qtdRegistrosPorPagina": 250,
"qtdRegistrosPaginaAtual": 250,
"dataHoraInicio": "10092026000000",
"dataHoraFim": "10092026235959",
"conteudo": [
{
"idSolicitacao": 32051605,
"cpf": 12345678901,
"matricula": "MAT000000123",
"inscricaoEmpregador": {
"codigo": 1,
"descricao": "CNPJ"
},
"numeroInscricaoEmpregador": "00000000000191",
"valorLiberado": 2000.00,
"nroParcelas": 6,
"dataHoraValidadeSolicitacao": "11092026150055",
"nomeTrabalhador": "Fulano de Tal",
"dataNascimento": "10091995",
"margemDisponivel": 770.41,
"elegivelEmprestimo": true,
"pessoaExpostaPoliticamente": {
"codigo": 0,
"descricao": "Pessoa Nao Exposta Politicamente"
},
"dataAdmissao": "26052025",
"garantia": {
"temGarantias": false
},
"alertas": []
}
],
"parceiro": {
"identificador": "PARCEIRO_EXEMPLO"
},
"correlacaoId": "9a5e6bc5579047b8b5a6f7bc578a3ff1"
}
Parâmetros de Resposta #
Corpo (JSON) #
| Propriedade | Descrição | Tipo |
| nroPaginaAtual | Número da página retornada | int32 |
| nroTotalPaginas | Total de páginas disponíveis na janela consultada | int32 |
| nroTotalRegistros | Total de solicitações na janela consultada | int32 |
| qtdRegistrosPorPagina | Tamanho máximo da página | int32 |
| qtdRegistrosPaginaAtual | Quantidade de itens retornados nesta página | int32 |
| dataHoraInicio | Início da janela efetivamente consultada | String |
| dataHoraFim | Fim da janela efetivamente consultada | String |
| conteudo | Lista das solicitações de proposta | Array |
| conteudo.idSolicitacao | Identificador da solicitação. Usado depois no envio da proposta | int64 |
| conteudo.cpf | CPF do trabalhador, sem máscara | int64 |
| conteudo.matricula | Matrícula do trabalhador no empregador | String |
| conteudo.inscricaoEmpregador.codigo | Tipo de inscrição do empregador | int32 |
| conteudo.inscricaoEmpregador.descricao | Descrição do tipo de inscrição | String |
| conteudo.numeroInscricaoEmpregador | Número da inscrição do empregador | String |
| conteudo.valorLiberado | Valor solicitado pelo trabalhador | decimal |
| conteudo.nroParcelas | Quantidade de parcelas pretendida | int32 |
| conteudo.dataHoraValidadeSolicitacao | Prazo final para envio de proposta, em ddMMyyyyHHmmss | String |
| conteudo.nomeTrabalhador | Nome do trabalhador | String |
| conteudo.dataNascimento | Data de nascimento, em ddMMyyyy | String |
| conteudo.margemDisponivel | Margem consignável disponível | decimal |
| conteudo.elegivelEmprestimo | Indica se o trabalhador está elegível | boolean |
| conteudo.pessoaExpostaPoliticamente.codigo | Indicador de pessoa exposta politicamente | int32 |
| conteudo.pessoaExpostaPoliticamente.descricao | Descrição do indicador | String |
| conteudo.dataAdmissao | Data de admissão, em ddMMyyyy | String |
| conteudo.garantia.temGarantias | Indica se há garantias vinculadas | boolean |
| conteudo.garantia.valorSaldoDisponivelGarantiaFgts | Saldo de FGTS disponível como garantia | decimal |
| conteudo.garantia.valorMultaRescisoriaGarantiaFgts | Multa rescisória disponível como garantia | decimal |
| conteudo.garantia.percVerbaRescisoriaGarantia | Percentual de verba rescisória oferecido em garantia | decimal |
| conteudo.alertas | Eventos de afastamento, desligamento ou aviso prévio do trabalhador | Array |
| parceiro.identificador | Identificador do parceiro que realizou a consulta | String |
| correlacaoId | Identificador de correlação da requisição | String |