Evento S-2299 | Erro 17 - Destacando a tag “fatorRubr” e informando The value '0' is invalid

Erro: 17 destacando a tag “ fatorRubr” e informando The value '0' is invalid.

Causa: 

Esse erro ocorre quando, dentro do XML do evento, existe a tag <fatorRubr> preenchida com valor 0, o que não é aceito pelo eSocial. 

Identificação do erro

Após o retorno de erro 17 – TAG <fatorRubr> com valor inválido (0), é necessário identificar qual evento (rubrica) está gerando a inconsistência e causando a rejeição, dentro do XML, para isso:

• Acesse o Robomatic eSocial;
• Localize o evento reprovado;
• Duplo clique sobre ele;
• Selecione a opção “Visualizar XML de Envio”;
• No XML, localize a seção <itensRemun>;
• Dentro dessa estrutura, procure pela tag:
  • <fatorRubr>0</fatorRubr>;
• Identifique qual é o código ou descrição do evento (rubrica) relacionado a essa tag

Como corrigir:

Após identificar no XML o evento com a tag <fatorRubr> igual a 0, verifique a origem do evento (sistema ou usuário) e siga o fluxo correspondente abaixo.

Cenário 1: Quando se tratar de evento Contmatic (gerado pelo sistema)

Deve atualizar as informações do sistema e reenviar o evento, seguindo o seguinte processo:

1. Acesse: Utilitários → Elimina Versão Atual do Histórico de Versões;
2. Confirme as mensagens apresentadas clicando em Sim/OK;
3. Feche o sistema e o Robomatic;
4. Reabra ambos e realize o reenvio dos eventos rejeitados.

Cenário 2: Evento cadastrado pelo usuário e configuração incompleta de eventos que possuem percentual (ex: Horas Extras, Adicional Noturno, entre outros) 

Eventos que possuem cálculo baseado em percentual necessitam dessa informação para geração correta dos valores no eSocial.

• Aba Dados Básicos:
  • O evento está configurado com uma natureza que exige percentual para cálculo
    (ex: Horas Extras, Adicional Noturno ou eventos similares)
  • Campo Rubrica TRCT pode estar, por exemplo, como:
    • Horas Extras (códigos entre 56.1 e 56.50)
      (utilizado aqui como exemplo mais comum)
• Porém, o campo ao lado:
  “% Hr. Extra/Adic. Noturno em Hrs./outros” está sem preenchimento

Para correção, acesse o menu: Arquivos → Eventos → Eventos do Usuário:

• Acesse a aba Dados Básicos do evento;
• Localize o campo: % Hr. Extra/Adic. Noturno em Hrs./outros;
• Preencha com o percentual correspondente ao evento.

Cenário 3: Inconsistência entre a classificação do evento (eSocial) e sua configuração para cálculo

Quando o evento é classificado no eSocial como uma rubrica que exige percentual, o sistema espera que a configuração permita esse cálculo.

Se houver divergência entre a classificação e a configuração (ou ausência do percentual), o cálculo não é realizado corretamente, e a tag <fatorRubr> é gerada com valor 0, gerando rejeição.

• Aba Informações eSocial:
  • O evento está classificado com uma rubrica que pressupõe cálculo por percentual
    (ex: 1003 – Horas Extraordinárias, entre outras similares)
• Aba Dados Básicos:
  • A configuração do evento não está alinhada com essa natureza
  • O campo: “% Hr. Extra/Adic. Noturno em Hrs./outros” está sem preenchimento

Para ajustar, acesse o menu: Arquivos → Eventos → Eventos do Usuário:

• Verifique se a rubrica eSocial está correta para o tipo de evento;
• Caso esteja correta, acesse a configuração na aba Dados Básicos;
  • Preencha o campo: % Hr. Extra/Adic. Noturno em Hrs./outros com o percentual correspondente
• Caso não esteja correta: siga o procedimento do cenário 4.

Cenário 4: Classificação incorreta da rubrica eSocial

A classificação incorreta faz com que o sistema aplique regras de cálculo indevidas (como uso de percentual).

Com isso, o evento pode gerar inconsistência no envio, incluindo o preenchimento inválido da TAG <fatorRubr>.

Situação identificada:

• Aba Informações eSocial:
  • O evento está classificado com uma rubrica que não corresponde à sua natureza real
  • Exemplo comum:
    • Evento configurado como 1003 – Horas Extraordinárias, porém não se trata de horas extras ou evento percentual.

Para correção, acesse o menu: Arquivos → Eventos → Eventos do Usuário:

• Acesse a aba Informações eSocial
• Revise o campo Rubrica eSocial
• Ajuste para uma classificação compatível com a natureza real do evento

Para identificar a rubrica correta: Consulte a Tabela 3 do eSocial (link para uma nova aba).

💡 Importante:

A classificação da rubrica eSocial deve sempre refletir a natureza do evento, evitando aplicação indevida de regras de cálculo. 

Etapa final

Após realizar os ajustes conforme o cenário identificado:

1. Salve o evento;
2. Reprocesse a rescisão (se aplicável);
3. Reenvie o evento ao eSocial.

Observação: Esse erro também pode ocorrer no envio do evento S-1200.