Ficha do Trabalhador no eSocial

Admissão e alterações cadastrais e contratuais do trabalhador (eventos S-2200, S-2205, S-2206, S-2300 e S-2306) que a empresa enviou ao eSocial 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-trabalhador/consultas

Órgão
eSocial (Governo Federal)
Prazo máximo
60 s
PDF
Não entrega

Campos do corpo

  • cpfobrigatório

    CPF, com ou sem máscara

    CPF do trabalhador.

  • cnpjobrigatório

    CNPJ numérico ou alfanumérico, com ou sem máscara

    CNPJ do empregador (o mesmo do certificado, ou a empresa representada).

  • certificadoobrigatório

    Base64 do arquivo .pfx ou .p12, até 20 KB

    Certificado 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ório

    Texto, até 128 caracteres

    Senha do certificado A1. Usada só nesta chamada; nunca é gravada nem aparece em log.

  • deobrigatório

    Data DD/MM/AAAA ou AAAA-MM-DD

    Início do período em que o eSocial recebeu os eventos.

  • ateobrigatório

    Data DD/MM/AAAA ou AAAA-MM-DD

    Fim do período. No máximo 31 dias depois de de.

  • incluirXmlopcional

    true ou false

    true devolve o XML oficial de cada evento em detalhe.xmls.

  • referenciaopcional

    Texto, até 80

    Seu identificador. Volta na resposta, no webhook e no histórico.

  • filtroopcional

    Objeto

    Devolve só os itens de detalhe.itens que batem: {"campo": valor}.

  • ordenaropcional

    Nome de um campo do item

    - na frente para a ordem decrescente.

  • limiteopcional

    Inteiro 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 (.pfx ou .p12 em 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 é 429 limite-da-fonte. Entre os dias 1 e 7 de cada mês o eSocial não atende: 503 fonte-fora-do-horario. Uma consulta por empresa por vez: a segunda simultânea recebe 429 fonte-em-uso. Nenhum desses casos é cobrado.
  • O eSocial só mostra eventos recebidos até 1 hora antes da consulta.
  • Traz os eventos S-2200 (admissão ou cadastramento inicial), S-2205 (alteração cadastral), S-2206 (alteração contratual), S-2300 e S-2306 (trabalhador sem vínculo: estagiário, diretor, cooperado…).
  • A admissão só aparece se a janela incluir a data em que o eSocial a recebeu. Para a ficha de hoje, consulte o mês da admissão e depois os meses com alterações. Sem saber a data, comece pelo mês da admissão informado pelo trabalhador.
  • Em detalhe.itens: dados pessoais (nome, sexo, raça/cor, estado civil, escolaridade), nascimento, endereço, dependentes, vínculo (regime, admissão), contrato (cargo, CBO, categoria), salário, duração, local e horário de trabalho — com os códigos traduzidos dos leiautes.
  • 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.dados traz "Continuar a partir de" para usar como de na próxima consulta.
  • Dados pessoais e salário (LGPD): vem só nesta resposta e não fica guardado no NexusQuery.
  • Com a chave de teste: CNPJ 11.222.333/0001-81 com CPF 000.000.001-91 devolve eventos fictícios; CPF 000.000.002-72 ou CNPJ 11.444.777/0001-61, sem_registros.