Envio de Eventos 06/04/2026 · 3 min de leitura

Como corrigir erros de validação XML

Guia passo a passo

Por eSocial Brasil

Corrigindo Erros de Validação nos Eventos XML

Erros de validação XML são comuns durante o processo de envio de eventos ao eSocial. O sistema valida os dados antes do envio para evitar rejeições pelo governo, mas alguns erros podem ocorrer no retorno. Este guia ajuda a identificar e corrigir os problemas mais frequentes.

Tipos de Erros

Os erros podem ocorrer em dois momentos distintos:

  • Validação local (Status 3 - Com Erros): O próprio sistema identifica inconsistências antes do envio. Os dados precisam ser corrigidos no formulário.
  • Retorno do governo (Status 6 - Erro no Envio): O governo rejeitou o evento após a transmissão. A mensagem de retorno indica o motivo.

Erros Mais Comuns e Soluções

1. CPF Inválido

O CPF do empregado está incorreto ou com formatação inválida. Acesse o cadastro do empregado e corrija o número do CPF. O sistema valida o dígito verificador automaticamente.

2. Matrícula do Empregado

A matrícula eSocial é utilizada para vincular o empregado ao evento. Quando não informada, o sistema utiliza a categoria do trabalhador como alternativa. Verifique se a matrícula está cadastrada corretamente no perfil do empregado.

3. Datas Inconsistentes

Datas futuras ou fora do período permitido causam rejeição. Verifique:

  • Data do exame ou acidente não pode ser futura.
  • Data do ASO deve ser anterior ou igual à data atual.
  • Data da CAT deve respeitar as regras de prazo.

4. Certificado Digital

Problemas com o certificado digital A1 são frequentes:

  • Certificado vencido: renove e cadastre o novo certificado.
  • CNPJ do certificado diferente do CNPJ da empresa: use o certificado correto.
  • Certificado não cadastrado: acesse a área de certificados e faça o upload do arquivo .pfx.

5. Campos Obrigatórios Faltando

Cada tipo de evento possui campos obrigatórios específicos. Os mais comuns:

  • S-2210 (CAT): tipo de acidente, data do acidente, CID, médico emissor, parte atingida e agente causador.
  • S-2220 (ASO): tipo de ASO, data do ASO, exames realizados com código e data, médico examinador com CRM.
  • S-2240: agentes nocivos, data de início da exposição, código do ambiente.

6. Erro de Assinatura Digital

O governo pode retornar erro de assinatura quando o XML contém caracteres com acentuação em campos específicos. O sistema remove acentos automaticamente, mas dados importados podem conter caracteres especiais. Revise os campos de texto do evento.

Como Reenviar Após Correção

  1. Identifique o evento com erro na listagem (status 3 ou 6).
  2. Clique no evento para ver a mensagem de erro detalhada.
  3. Corrija os dados indicados no cadastro do empregado ou no formulário do evento.
  4. O evento retornará ao status Pronto para Envio (0).
  5. Realize o envio novamente.

Dicas de Prevenção

  • Mantenha os dados cadastrais dos empregados sempre atualizados (CPF, NIS, matrícula).
  • Verifique a validade do certificado digital periodicamente.
  • Preencha todos os campos obrigatórios antes de tentar o envio.
  • Evite caracteres especiais e acentuação em campos de texto livre.

Artigos Relacionados

Envio de Eventos 06/04/2026

Retorno de duplicidade

O que fazer ao receber um retorno de duplicidade no envio de um evento?

eSocial Brasil
Envio de Eventos 06/04/2026

Processamento

O que fazer quando o evento fica como \"Em Processamento\"?

eSocial Brasil