📘 S-2210 no RM/SMT: erro na validação do campo codAgntCausador

Data de publicação: 10/06/2026

🎯 Objetivo

Orientar a causa e a correção do erro de validação do campo codAgntCausador no evento S-2210 – Comunicação de Acidente de Trabalho, no ambiente RM / Segurança e Saúde Ocupacional. (Central de Atendimento TOTVS)

🧩 Ambiente

TOTVS RH – Linha RM – TOTVS Segurança e Saúde Ocupacional
Aplicável a partir das versões 12.1.2302.235, 12.1.2306.182, 12.1.2310.116 e superiores. (Central de Atendimento TOTVS)

🔎 Visão geral

Ao gerar o XML do evento S-2210, pode ocorrer a mensagem informando que o campo codAgntCausador deve conter um código válido e existente na Tabela 14 do eSocial, quando dtAcid for igual ou superior a 2024-01-22 e tpAcid for 1 ou 3. (Central de Atendimento TOTVS)

Segundo a TOTVS, isso acontece porque o código gerado para essa tag está diferente do código previsto na Tabela 14, exigida pela regra do leiaute S-1.3 nesse cenário. (Central de Atendimento TOTVS)

⚠️ Mensagem apresentada

A ocorrência descrita pela TOTVS é:

Erro na validação do campo 'codAgntCausador': Se dtAcid = [2024-01-22] e se tpAcid = [1, 3], deve ser um código válido e existente na Tabela 14. (Central de Atendimento TOTVS)

🧠 Causa

A causa do erro é o preenchimento de um código de agente causador que não corresponde a um valor válido da Tabela 14 do eSocial. A validação passou a ser exigida, conforme o leiaute S-1.3, para acidentes com data a partir de 22/01/2024 e tipo de acidente 1 ou 3. (Central de Atendimento TOTVS)

🛠️ Como corrigir

1. Acessar o cadastro da CAT

Entre no cadastro da CAT e exclua o código do agente causador que foi informado anteriormente. (Central de Atendimento TOTVS)

2. Incluir o agente causador novamente

Ao incluir um novo registro, pesquise o código desejado e edite o cadastro do agente. (Central de Atendimento TOTVS)

3. Ajustar o tipo de agente

Na janela de edição, altere o campo Tipo de agente para:

Agente Causador Acidente de Trabalho. (Central de Atendimento TOTVS)

4. Selecionar o código correto do eSocial

Após ajustar o tipo, o campo Cód. eSocial Agente Causador Acidente de Trabalho passará a listar os códigos válidos da Tabela 14 do eSocial. Selecione o item correto, grave a alteração e gere o XML novamente. (Central de Atendimento TOTVS)

✅ Resultado esperado

Depois de reenquadrar o agente causador no tipo correto e selecionar um código válido da Tabela 14, o XML do S-2210 pode ser gerado novamente e o evento fica apto para envio. (Central de Atendimento TOTVS)

💡 Boas práticas

• revisar o tipo de agente antes da geração do S-2210;

• validar se o código informado pertence realmente à Tabela 14 do eSocial;

• redobrar a conferência em acidentes com dtAcid a partir de 22/01/2024;

• testar a correção antes de retransmitir em produção. (Central de Atendimento TOTVS)

❓ FAQ

1. Quando esse erro costuma ocorrer?

Quando o evento S-2210 é gerado com dtAcid a partir de 2024-01-22 e tpAcid igual a 1 ou 3, mas o campo codAgntCausador não contém um código válido da Tabela 14. (Central de Atendimento TOTVS)

2. Qual é a causa principal?

O código do agente causador foi gerado com valor diferente do que é aceito pela Tabela 14 do eSocial. (Central de Atendimento TOTVS)

3. Onde fazer a correção?

No cadastro da CAT, removendo e incluindo novamente o agente causador com o tipo correto. (Central de Atendimento TOTVS)

4. Qual tipo deve ser usado?

Deve ser selecionado Agente Causador Acidente de Trabalho. (Central de Atendimento TOTVS)

5. Como garantir que o código esteja correto?

Ao escolher o tipo correto, o sistema passa a listar no campo específico os códigos válidos da Tabela 14 do eSocial. (Central de Atendimento TOTVS)

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria