01. DADOS GERAIS

Produto:

TOTVS RH

Linha de Produto:

Linha Protheus 

Segmento:

RH 

Módulo:GESTÃO DE PESSOAS (SIGAGPE)
Função:rh.sigagpe.integration.retif1210.tlpp,
GPEM017, GPEM815C, GPEM815.app
Ticket:N/A
Story:DRHROTPRT-26383


02. SITUAÇÃO/REQUISITO

Issue centralizadora para integração com a rotina em PO UI da Retificação de informações complementares de períodos anteriores do evento S-1210.

03. SOLUÇÃO

Desenvolvimento das APIs Get/Put para os endpoints da interface vide documentação abaixo e criação da tabela RUW para gravação das informações recebidas.

1) Acesse o menu Serviços Globais | Segurança | Perfis, selecione o sistema Folha de pagamento, edite o perfil desejado, acesse Menus e permita o acesso ao cadastro 09.05.15 - Retificação Informações Complementares Períodos Anteriores - S-1210


É necessario a excecução do sistema RM.Atualizador.exe para a criação da nova tabela utilizada no processo.

Acesse o menu eSocial | Outros Processos | Retificação Informações Complementares Períodos Anteriores - S-1210


Este menu é responsável por vincular o período que será retificado.

Na tela, serão exibidos todos os funcionários que tiveram o evento S-1210 transmitido ao Governo no ano imediatamente anterior ao ano definido no parâmetro Ano Retificação.


O comportamento da tela depende diretamente do preenchimento do parâmetro Ano Retificação:

1 - Filtros

1.1 Parâmetro: Ano Retificação

O Ano Retificação deve ser informado no formato de 4 dígitos e com um valor maior ou igual a 2026.

  • Ele indica o ano em que o evento S-1210 será gerado contendo a retificação de períodos anteriores.

  • Exemplo Prático: Ao informar Ano Retificação 2026, a tela exibirá funcionários que:

    • Tiveram o evento S-1210 transmitido ao Governo (status 10- Aceito RET) no ano de 2025.

1.2 Parâmetro: CPF

  • O parâmetro CPF é de preenchimento opcional. Caso seja adicionado apresentará somente o CPF digitado.


2- Filtros Avançados

2.1 Estabelecimento

O parâmetro Estabelecimento é de preenchimento opcional. 

Serão listados os estabelecimentos de acordo com o envio do evento S-1005. Poderá selecionar mais de um estabelecimento.

Caso não selecione nenhum estabelecimento, será considerada todos.

2.2 Parâmetro: Ano Retificação

O Ano Retificação deve ser informado no formato de 4 dígitos e com um valor maior ou igual a 2026.

  • Ele indica o ano em que o evento S-1210 será gerado contendo a retificação de períodos anteriores.

  • Exemplo Prático: Ao informar Ano Retificação 2026, a tela exibirá funcionários que:

    • Tiveram o evento S-1210 transmitido ao Governo (status 10- Aceito RET) no ano de 2025.

2.3 Parâmetro: CPF

  • O parâmetro CPF é de preenchimento opcional. Caso seja adicionado apresentará somente o CPF digitado.


O botão aplicar filtros só ficará habilitado após informar o parâmetro Ano Retificação que deve ser no formado de 4 dígitos e maior ou igual a 2026. Para autônomo do TOTVS Gestão Financeira ou externo será necessário o filtro pelo CPF.

3 - Apresentação do dados

Após Aplicar Filtros, será exibida as seguintes colunas: 

ColunasCampos do sistema
CPFPPESSOA.CPF / PPAGTOAUTONOMOEXT.CPF / FCFO.CGCCFO
NomePPESSOA.NOME / PPAGTOAUTONOMOEXT.NOMEAUTONOMO/ FCFO.NOME
Tipo

Funcionário – Funcionários da folha

Funcionário/Prestador – Múltiplos vínculos de funcionário e autônomos (folha, externo ou TOTVS Gestão Financeira)

Prestador – autônomo da folha

Prestador – outros sistemas - autônomo do TOTVS Gestão Financeira ou externo

Meses Retificados/a Retificar em ano  Ano anterior ao digitado no campo Ano Retificação
EditarCampo para selecionar o meses a serem retificados



Para cada registro da lista de funcionários está disponível o botão Editar, com ícone de um lápis, onde será possível informar quais meses serão retificados. 


Após selecionar basta clicar em confirmar que evento já será gerado com a retificação dos dados complementares do mês selecionado.


O botão correspondente ao mês só ficará habilitado caso tenha o evento com status 10 na fila de eventos caso esteja na fila complementar deverá ser realizada a restauração pelo processo.


Após a seleção dos meses basta realizar a geração do xml S-1210 pelo processo normalmente, após a execução o xml que estará na fila já terá os dados complementares do mês selecionado.

A retificação por este processo é exclusiva para os valores complementares (deduções e despesas).  Restrição: Caso haja necessidade de alteração no valor de qualquer rubrica principal da folha, será obrigatório:  A reabertura da folha de pagamento na competência original.  O reenvio dos eventos (S-1200 e S-1210) daquela competência.

Foi declarado o valor total do desconto para o funcionário, porém esse valor deveria ter sido rateado com o dependente.

Observe que, no envelope de pagamento, o valor do plano de saúde está apresentado corretamente.


Declaração realizada no mês de setembro de 2025:


No mês de janeiro/2026, foi apurado que o valor do titular deveria ser R$133,33 e o valor do dependente R$100,00.
Após a verificação, foi acessado o histórico do plano de saúde e incluído o valor correspondente ao dependente em Administração de Pessoal | Funcionários | Anexos | Históricos | Históricos Assistência Saúde.


Ajustado valor do titular e adicionado o dependente:


Acesse o menu eSocial | Outros Processos | Retificação Informações Complementares Períodos Anteriores – S-1210, selecione o ano 2026 e, em seguida, o mês de setembro.


Acesse o menu eSocial | Gerar XML(Eventos Periódicos):


No menu eSocial | Eventos Periódicos, foi validado que o XML está sendo gerado corretamente, conforme o ajuste realizado no histórico.


Quando for necessário alterar o CPF do beneficiário da pensão alimentícia, por exemplo, em situações em que anteriormente era informado o CPF do responsável.

No exemplo, em 01/2025 o evento foi enviado com o desconto de pensão vinculado ao CPF 111.111.111-11.


No mês de janeiro/2026, é possível regularizar o CPF identificado como sendo do dependente.
Para isso, acesse Administração de Pessoal | Funcionários | Anexos | Folha de Pagamento | Dependentes e realize a alteração do CPF no cadastro do dependente.


Acesse o menu eSocial | Outros Processos | Retificação de Informações Complementares de Períodos Anteriores – S-1210 e selecione o ano 2026 e o mês de janeiro.


Acesse o menu eSocial | Gerar XML(Eventos Periódicos):


Acesse o menu eSocial | Eventos Periódicos. O XML será gerado corretamente, considerando o ajuste do dependente com o novo CPF.

Para alterar o CPF de um dependente do trabalhador, é obrigatório que a modificação cadastral seja primeiramente comunicada ao eSocial pelo evento S-2205 – Alteração de Dados Cadastrais do Trabalhador. Qualquer outro evento dependente só pode ser enviado após a validação do S-2205.

04. DEMAIS INFORMAÇÕES

Para esta implementação, é necessária aplicação do dicionário a ser publicado na próxima Expedição Contínua RH, com a criação da tabela RUW conforme detalhamento abaixo:

X2_CHAVEX2_NOMEX2_MODOX2_MODOUNX2_MODOEMPX2_UNICOX2_MODULO
RUWRetificação do evento S-1210EEERUW_FILIAL+RUW_ANO+RUW_CPF7


X3_ARQUIVOX3_ORDEMX3_CAMPOX3_TIPOX3_TAMANHOX3_TITULOX3_DESCRICX3_GRPSXG
RUW01RUW_FILIALC2FilialFilial do Funcionário033
RUW02RUW_ANOC4AnoAno Retificação  
RUW03RUW_CPFC11CPF Trab.CPF do Trabalhador 
RUW04RUW_MESESC50MesesMeses a retificar


INDICEORDEMCHAVEDESCRICAO
RUW1RUW_FILIAL+RUW_ANO+RUW_CPFAno + CPF Trab.

05. ASSUNTOS RELACIONADOS

        DRHROTDTS-18699- Retificação informações complementares períodos anteriores no evento S-1210