Riscos do Ambiente de Trabalho no eSocial
Condições do ambiente de trabalho e agentes nocivos (evento S-2240) que a empresa enviou ao eSocial para o trabalhador no período, com o XML oficial. Usa o certificado digital A1 da própria empresa em cada consulta; nada fica guardado.
POST/v1/esocial-riscos/consultas
- Órgão
- eSocial (Governo Federal)
- Prazo máximo
- 60 s
- Não entrega
Campos do corpo
cpfobrigatórioCPF, com ou sem máscara
CPF do trabalhador.
cnpjobrigatórioCNPJ numérico ou alfanumérico, com ou sem máscara
CNPJ do empregador (o mesmo do certificado, ou a empresa representada).
certificadoobrigatórioBase64 do arquivo
.pfxou.p12, até 20 KBCertificado digital A1 da empresa (e-CNPJ), do representante legal ou de procurador com procuração eletrônica. Usado só nesta chamada e descartado: nunca é gravado.
senhaCertificadoobrigatórioTexto, até 128 caracteres
Senha do certificado A1. Usada só nesta chamada; nunca é gravada nem aparece em log.
deobrigatórioData
DD/MM/AAAAouAAAA-MM-DDInício do período em que o eSocial recebeu os eventos.
ateobrigatórioData
DD/MM/AAAAouAAAA-MM-DDFim do período. No máximo 31 dias depois de
de.incluirXmlopcionaltrueoufalsetruedevolve o XML oficial de cada evento emdetalhe.xmls.referenciaopcionalTexto, até 80
Seu identificador. Volta na resposta, no webhook e no histórico.
filtroopcionalObjeto
Devolve só os itens de
detalhe.itensque batem:{"campo": valor}.ordenaropcionalNome de um campo do item
-na frente para a ordem decrescente.limiteopcionalInteiro de 1 a 1000
Quantos itens devolver.
Resultados possíveis
dadossem_registros
Decida pelo campo codigo. Consulta que o órgão não respondeu volta como sem_retorno ou em_processamento e não é cobrada.
Observações
- Certificado da empresa em cada chamada. Envie o certificado A1 (
.pfxou.p12em base64) e a senha. Serve o e-CNPJ da empresa, o do representante legal ou o de um procurador com procuração eletrônica no eSocial. O NexusQuery usa o certificado só nesta chamada, para assinar o pedido e se conectar ao eSocial, e descarta: nunca grava o arquivo nem a senha (nem em log). Certificado A3 (token ou cartão) não funciona. - Recusado antes do eSocial, com `422` no campo: senha errada (
senhaCertificado), arquivo que não abre, certificado vencido ou e-CNPJ de outra empresa (certificado). Nada é cobrado. - Limites do governo (não do NexusQuery): o eSocial aceita 10 acessos por dia por empresa, e cada consulta usa até 2 (listar e baixar) — até 5 consultas por empresa por dia. Esgotado, a resposta é
429limite-da-fonte. Entre os dias 1 e 7 de cada mês o eSocial não atende:503fonte-fora-do-horario. Uma consulta por empresa por vez: a segunda simultânea recebe429fonte-em-uso. Nenhum desses casos é cobrado. - O eSocial só mostra eventos recebidos até 1 hora antes da consulta.
- Traz os eventos S-2240. Em
detalhe.itens: trabalhador, início e fim nas condições, ambiente e setor, atividades, cada agente nocivo com avaliação, intensidade e limite de tolerância, uso e eficácia de EPC e EPI, certificados de aprovação e o responsável pelos registros ambientais. - O agente nocivo vem com o texto da tabela oficial do eSocial, como os demais códigos.
- O filtro de datas é pela data em que o eSocial recebeu o evento, não pela data do fato. O eSocial lista até 50 eventos por consulta (de todos os tipos do trabalhador); quando há mais,
detalhe.dadostraz "Continuar a partir de" para usar comodena próxima consulta. - Dado de saúde (LGPD): vem só nesta resposta e não fica guardado no NexusQuery. Trate no seu sistema como dado pessoal sensível.
- Com a chave de teste: CNPJ
11.222.333/0001-81com CPF000.000.001-91devolve um evento fictício; CPF000.000.002-72ou CNPJ11.444.777/0001-61,sem_registros.