Módulo · Compliance

eSocial

Transmissão de eventos eSocial direto do Nodus, sem terceirizar. Suporta certificado A1, assinatura XML, envio em lote, consulta automática de status e correção de rejeições.

Onde: Menu 🦺 Compliance → eSocial

Quem acessa: admin / gestor_rh

Ambiente: Homologação · Produção (alternável)

1. Setup inicial (certificado A1)

Adquira um certificado e-CNPJ A1 com sua certificadora (Serasa, Soluti, Certisign, etc).
Menu eSocial → Configurações → upload do arquivo .pfx e senha.
Sistema cifra o arquivo e a senha com AES-256-GCM autenticado antes de gravar.
Escolha o ambiente: Homologação (testes) ou Produção (vai pro governo de verdade).
Use Prévia empregador (S-1000) apenas para conferir os dados. Esse download não substitui o envio oficial.

⚠️ Sempre teste em Homologação primeiro

O governo separa os 2 ambientes. Você pode mandar quantos eventos quiser em Homologação sem efeito legal. Só troque pra Produção quando estiver confiante.

Leiaute em uso: S-1.3

O Nodus gera os eventos no leiaute S-1.3 do eSocial — o XML sai com o namespace oficial http://www.esocial.gov.br/schema/evt/<evento>/v_S_01_03_00. A referência acompanhada é o documento Leiautes eSocial v. S-1.3 — NT 06/2026 rev. 09/04/2026, publicado em gov.br/esocial → Documentação Técnica. A NT 07/2026 (vigência em produção a partir de 26/10/2026) está em acompanhamento e entra por atualização do Nodus antes da data.

🔎 Como conferir sem precisar de conta

O endpoint público /api/index.php?action=version devolve o bloco esocial com leiaute, namespace, referencia e a lista de eventos. O valor vem da mesma constante que assina o namespace do XML — não é texto de marketing. Se o leiaute mudar no código, muda ali no mesmo deploy.

Eventos suportados

13 eventos gerados nativamente (a mesma lista publicada em ?action=version):

Código	Nome	Quando dispara
S-1000	Informações do empregador	1ª vez (manual)
S-1005	Estabelecimentos	1ª vez (manual) + alteração de filial
S-1010	Rubricas	Alteração na tabela de rubricas
S-1200	Remuneração (folha)	Fechamento da folha do mês
S-1210	Pagamentos	Após o pagamento da folha
S-1299	Fechamento dos eventos periódicos	Depois do S-1200/S-1210 do período
S-2200	Admissão	Automático ao cadastrar colab (CLT)
S-2206	Alteração contratual	Mudança de cargo, salário, jornada
S-2210	CAT (acidente de trabalho)	Registro de CAT no módulo SST
S-2220	Monitoramento da saúde (ASO)	Exame ocupacional registrado no SST
S-2230	Afastamento temporário	Atestado/afastamento e retorno
S-2299	Desligamento	Automático ao finalizar desligamento
S-2300	TSV (sem vínculo)	Estagiário, terceirizado, autônomo

Antes de transmitir, o Nodus valida os campos obrigatórios de cada evento e confere o XML contra os esquemas XSD oficiais S-1.3 empacotados no sistema. Evento inválido ou validador indisponível é barrado antes do envio (código xsd_invalido), sem gastar uma tentativa em produção.

Prévias cadastrais e periódicas

⚠️ Prévia não é lote oficial

Os downloads S-1000, S-1005, S-1010, S-1200 e S-1210 agrupam eventos já validados em um contêiner proprietário previaConferenciaNodus. Servem somente para conferência: não têm assinatura, protocolo ou valor fiscal, não são transmitidos ao governo e não alteram o estado dos pagamentos.

O Nodus não gera a prévia S-1299 enquanto não puder comprovar, por recibos oficiais da competência, quais eventos periódicos foram aceitos. Faça o fechamento somente no fluxo oficial autorizado e confira o resultado com o contador.

Fluxo de transmissão

Sistema detecta evento (admissão, desligamento, alteração) → cria registro pendente.
Menu eSocial → Eventos Pendentes → selecione até 50 eventos no lote.
Click Gerar Lote → sistema monta XML conforme leiaute vigente.
Click Assinar XML → usa o certificado A1 da empresa.
Click Enviar → submete ao governo.
Status muda pra Processando. Cron esocial_consultar_lotes_cron consulta a cada 6h.
Eventualmente: Processado ✅ OU Rejeitado ❌ com mensagem específica do governo.

Rejeições e correção

Quando um evento rejeita, o sistema mostra a mensagem oficial do governo com o código (ex: MS-2200-201) e linha do XML problemática. Causas mais comuns:

CPF inválido na Receita — colab digitou errado ou nunca declarou IR. Cliente precisa regularizar.
CBO inexistente — código de ocupação fora da lista oficial. Sistema valida no cadastro.
Endereço incompleto — falta CEP, número ou bairro. Volta na ficha do colab.
Categoria errada — autônomo lançado como CLT, etc.

Corrigir: ajuste os dados na ficha do colaborador → o evento volta automaticamente pra fila de pendentes pra re-envio.

CBO & rubricas

O Nodus mantém:

Tabela de CBOs vigentes (Classificação Brasileira de Ocupações) atualizada — dropdown na ficha do colab.
Tabela de rubricas eSocial com mapeamento pros tipos do Nodus (salário, HE, VT, INSS, IRRF…).

Quando o governo publica um leiaute novo ou uma Nota Técnica, o Nodus aplica via update automático — você não precisa fazer nada além de aceitar o aviso no rodapé. A versão em uso está sempre em ?action=version (ver Leiaute em uso).

📚 Doc de campos obrigatórios

A planilha completa de quais campos cada evento exige tá em eSocial → Ajuda → Documentos por evento. Vale consultar antes do primeiro envio em produção.