Listar solicitações

GET/v1/solicitacoes

🔒 Requer Bearer token

Lista, de forma paginada, as solicitações de leilão em aberto na janela informada (dataHoraInicio/dataHoraFim, ISO 8601; nroPagina 1-based), e **aplica as suas regras de filtragem**. As regras combinam em AND; sem regras publicadas, devolve tudo. O bloco filtro da resposta declara o que foi aplicado — atenção: nroTotalPaginas e nroTotalRegistros contam **antes** do filtro, enquanto qtdRegistrosPaginaAtual conta depois. Pagine por nroTotalPaginas: uma página pode vir vazia após o filtro e ainda haver as seguintes. Uma janela sem solicitações retorna um envelope vazio. Escopo: leilao:read (e regras:read para o filtro ser aplicado).

Parâmetros

dataHoraIniciostringqueryobrigatório

Data/hora início (ISO 8601), no **horário de Brasília** (America/Sao_Paulo). Sufixo de fuso é ignorado: `T16:00:00`, `T16:00:00-03:00` e `T16:00:00Z` filtram todos a partir das 16h em SP.

dataHoraFimstringqueryobrigatório

Data/hora fim (ISO 8601), no **horário de Brasília** (America/Sao_Paulo). Sufixo de fuso é ignorado — ver `dataHoraInicio`.

nroPaginastringqueryobrigatório

Número da página (1-based)

authorizationstringheaderobrigatório

ImpersonateUserstringheaderopcional

Identificação do parceiro na Socinal. **Não precisa ser enviado**: o valor é lido do claim `id_parceiro_socinal` do token. Aceito apenas como fallback para tokens emitidos antes do claim; quando enviado junto com um token que tem o claim, o claim prevalece.

Respostas

Corpo da resposta 200

nroPaginaAtualnumberobrigatório

nroTotalPaginasnumberobrigatório

Contado antes do filtro.

nroTotalRegistrosnumberobrigatório

Contado antes do filtro.

qtdRegistrosPorPaginanumberobrigatório

qtdRegistrosPaginaAtualnumberobrigatório

Contado depois do filtro (itens em `conteudo`).

dataHoraIniciostringobrigatório

dataHoraFimstringobrigatório

filtroFiltroAplicadoDtoobrigatório

aplicadobooleanobrigatório

Se o filtro de **regras do parceiro** foi aplicado. `false` quando o parceiro não tem regras publicadas ou não está habilitado ao filtro. Não diz nada sobre a blacklist da plataforma, que roda em qualquer caso — para ela, ver `bloqueados_blacklist`.

versao_regrasnumberopcional

Versão do conjunto de regras aplicado. Ausente se `aplicado: false`.

recebidos_do_upstreamnumberobrigatório

Registros que a Socinal devolveu nesta página.

aprovadosnumberobrigatório

Registros que passaram pelo filtro.

isentos_cnaenumberobrigatório

Registros cujas condições de CNAE foram ignoradas por a inscrição do empregador não ser resolvível (alfanumérica ou fora da base).

avaliados_etapa2numberobrigatório

Quantos registros chegaram à etapa 2 (resolução de CNAE). É a medida do funil: a diferença para `recebidos_do_upstream` são as consultas que a etapa 1 evitou. `0` quando nenhuma regra usa CNAE.

bloqueados_blacklistnumberobrigatório

Registros barrados pela **blacklist de CNAE da plataforma** — regra fixa, não configurável pelo parceiro. Independente de `aplicado`: pode ser maior que zero mesmo sem nenhuma regra do parceiro. Empregador que não resolve na base **não** é contado aqui (é isento, não bloqueado).

versao_blackliststringopcional

Versão da blacklist aplicada. Ausente quando a blacklist está desligada ou quando a base de CNAE não estava carregada para avaliá-la.

conteudoarray<SolicitacaoLeilaoDto>obrigatório

Solicitações aprovadas pelo filtro. Qualquer campo do item pode vir ausente.

idSolicitacaonumberopcional

Identificador da solicitação. É o `idSolicitacaoProposta` do envio de proposta.

cpfobjectopcional

CPF do trabalhador. Pode vir como número — nesse caso perde o zero à esquerda: complete com zeros até 11 dígitos.

matriculastringopcional

Matrícula do trabalhador no empregador.

inscricaoEmpregadorobjectopcional

Tipo de inscrição do empregador.

numeroInscricaoEmpregadorobjectopcional

Inscrição do empregador: CNPJ ou código alfanumérico (ex.: `GZRDDODJ`). Trate sempre como texto.

valorLiberadonumberopcional

Valor solicitado, em R$.

nroParcelasnumberopcional

Quantidade de parcelas.

dataHoraValidadeSolicitacaostringopcional

Validade da solicitação, `DDMMYYYYHHMMSS`, horário de Brasília.

nomeTrabalhadorstringopcional

Nome do trabalhador.

dataNascimentostringopcional

Data de nascimento, `DDMMYYYY`.

margemDisponivelnumberopcional

Margem consignável disponível, em R$.

elegivelEmprestimobooleanopcional

Se o trabalhador é elegível a empréstimo.

pessoaExpostaPoliticamenteobjectopcional

Pessoa exposta politicamente. `codigo` diferente de `0` ⇒ é PEP.

dataAdmissaostringopcional

Data de admissão, `DDMMYYYY`.

garantiaGarantiaSolicitacaoDtoopcional

temGarantiasbooleanopcional

Se a solicitação pede garantia. Hoje sempre `false`.

Request

curl -X GET 'https://econsignado-api-leilao.socinal.com.br/v1/solicitacoes?dataHoraInicio=valor&dataHoraFim=valor&nroPagina=valor' \
  -H 'Authorization: Bearer SEU_TOKEN'

Response

{
  "nroPaginaAtual": 1,
  "nroTotalPaginas": 12,
  "nroTotalRegistros": 587,
  "qtdRegistrosPorPagina": 50,
  "qtdRegistrosPaginaAtual": 18,
  "dataHoraInicio": "01062026000000",
  "dataHoraFim": "02062026000000",
  "filtro": {
    "aplicado": true,
    "versao_regras": 7,
    "recebidos_do_upstream": 50,
    "aprovados": 18,
    "isentos_cnae": 3,
    "avaliados_etapa2": 18,
    "bloqueados_blacklist": 4,
    "versao_blacklist": "1.0.0"
  },
  "conteudo": [
    {
      "idSolicitacao": 30843454,
      "cpf": "01234567890",
      "matricula": "000123",
      "inscricaoEmpregador": {
        "codigo": 1,
        "descricao": "CNPJ"
      },
      "numeroInscricaoEmpregador": "12345678000199",
      "valorLiberado": 5000,
      "nroParcelas": 24,
      "dataHoraValidadeSolicitacao": "21102026103000",
      "nomeTrabalhador": "FULANO DE TAL",
      "dataNascimento": "15041990",
      "margemDisponivel": 850.5,
      "elegivelEmprestimo": true,
      "pessoaExpostaPoliticamente": {
        "codigo": 0,
        "descricao": "Não"
      },
      "dataAdmissao": "01032018",
      "garantia": {
        "temGarantias": false
      }
    }
  ]
}