Esta rota é utilizada para consultar eventos utilizando filtros de pesquisa.
Rota da API
GET https://api.tecnospeed.com.br/esocial/v1/evento/consultar/filtros
Parâmetros
Query params
| Nome | Descrição | Exemplo | Valores |
| ambiente | Ambiente de envio do Evento. Campo Obrigatório | 2 | 1 - Produção ou 2 - Homologação |
| empregador | CNPJ ou CPF do empregador. Campo Obrigatório | 29062609000177 | CNPJ do empregador que esta fazendo o envio |
| versaomanual | Versão Manual dos Eventos. Campo Obrigatório | S.01.03.00 | Versão Manual |
| dtini | Data de Inicio do Evento. É permitido apenas consultar eventos no período de três meses. Campo Obrigatório | 2025-03-01 | AAAA-MM-DD |
| dtfim | Data Final do Evento. É permitido apenas consultar eventos no período de três meses. Campo Obrigatório | 2025-03-30 | AAAA-MM-DD |
| evento | Nome do Evento. Campo Obrigatório se utilizado em conjunto com o campo CPF | evtProcTrab | Os eventos podem ser consultados aqui: |
| status | Status do Evento | 1 | 1 - Eventos com retorno 201, 2 - Eventos com retorno diferente de 201 |
| cpf | CPF do Empregado. Para filtrar pelo CPF deve-se informar o parâmetro evento. | 00011122233 | CPF |
| limite | Limite de registros que serão retornados, o retorno máximo são de 10 registros. | 2 | 1-10 |
| pagina | Número de páginas para utilização em GUI. | 1 | 1-10 |
Headers
| Nome | Descrição | Exemplo | Valores |
| cnpj_sh | CNPJ da Software House | 29062609000177 | CNPJ do contrato com a Tecnospeed |
| token_sh | Token da Software House | gerar o token em https://conta.tecnospeed.com.br/ | O acesso é diferente do portal do cliente, então mesmo que já acesse o portal do cliente é necessário criar um novo acesso |
Exemplo
GET https://api.tecnospeed.com.br/esocial/v1/evento/consultar/filtros?ambiente=2&empregador=29062609000177&versaomanual=S.01.03.00&dtini=2025-03-01&dtfim=2025-03-30&evento=evtProcTrab&status=2&cpf=123456789022&limite=10&pagina=1
Retorno
O retorno será um JSON com as principais informações do lote.
Exemplo de retorno sucesso:
{
"message": "Evento retornado",
"data": [
{
"data": [
{
"_id": "4394428c-09f3-453e-bdfe-a0272e042838",
"cnpj_sh": "29062609000177",
"eventos": {
"id": "ID1290626090000002025031110300903887",
"status": {
"codigo": "402",
"mensagem": "Schema do evento inválido."
}
},
"data_criacao": 1741699808619,
"cpf": "123456789022"
}
],
"totalCount": [
{
"count": 1
}
]
}
]
}
Exemplo de retorno com erro:
{
"error": {
"message": "Parâmetros incorretos"
}
}
Comentários
0 comentário
Por favor, entre para comentar.